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Apache ANT 教程 


ANT fá fT - ANT 
ANT 环 境 安装 设置 - ANT 
Ant 构 建文 件 - ANT 
Ant 属 性 任务 - ANT 
Ant 属 性 文件 - ANT 

Ant 数 据 类 型 - ANT 

Ant 构 建 项 目 - ANT 
Ant 构 建文 档 - ANT 
Ant 创 建 JAR 文 件 - ANT 
Ant 创 建 WAR 文 件 - ANT 
Ant#] 8 xi FH - ANT 
Ant 部 署 应 用 程序 - ANT 
Ant 执 行 Java 代 码 - ANT 
Ant 和 Eclipse 集 成 - ANT 
Ant Junit 集 成 - ANT 


Apache POI 教 程 
Apache POI - Java Excel APIs - POI 教 程 


Apache POI 环 境 设 置 - POI 教 程 
POI 核 心 类 - POI 教 程 
Apache POIT {F$ - POI 教 程 


Apache POI 电 子 表 格 /Spreadsheet - POI 教 程 


Apache POI 单 元 格 /Cells - POI 教 程 
Apache POI 字 体 /Fonts - PO| 教 程 
Apache POI 公 式 - POI 
Apache POI 超 链接 - POI 教 程 
Apache POI 打 印 区 域 - POI 教 程 
Apache POI 数 据 库 - POI 教 程 


AWT 教程 


AWT 概述 介绍 - AWT 
AWT 环境 设置 - AWT 
AWT 控 件 (Controls) - AWT 
AWT Component 类 - AWT 
AWT Label 类 - AWT 
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AWT Button # - AWT 3.6 
AWT CheckBox X - AWT 3.7 
AWT List 类 - AWT 3.8 
AWT Choice # - AWT 3.9 
AWT 事 件 义理 - AWT 3.10 
AWT Event 类 - AWT 3.11 
AWT 事件 监听 器 (Event Listeners) - AWT 3.12 
AWT 适配器 (Adapters) - AWT 3.13 
AWT 布局 (Layouts) - AWT 3.14 
AWT 容器 (Containers) - AWT 3.45 
AWT 菜 单 控制 - AWT 3.16 
AWT 图 形 控件 - AWT 3.17 
EasyMock 教 程 4 
EasyMock 环 境 安装 - EasyMock 教 程 4.1 
EasyMock# 8i 4418 - EasyMock 教 程 4.2 
EasyMock JUnit 集 成 - EasyMock 教 程 4.3 
EasyMock 添 加 行为 - EasyMock 教 程 4.4 
EasyMock 验 证 行为 - EasyMock 教 程 4.5 
EasyMock 期 望 调 用 - EasyMock 教 程 4.6 
EasyMock 改 变调 用 - EasyMock 教 程 4.7 
EasyMockse $$ 4418 - EasyMock 教 程 4.8 
EasyMock createMock - EasyMock 教 程 4.9 
EasyMock createStrictMock - EasyMock 教 程 4.10 
EasyMock createNiceMock - EasyMock 教 程 4.11 
EasyMock EasyMockSupport - EasyMock 教 程 4.12 
Eclipse 教程 5 
Eclipse 安装 5.1 
Eclipse 窗口 说 明 5.2 
Eclipse 菜单 5.3 
Eclipse 视图 5.4 
Eclipse 工作 空间 (Workspace) 5.5 
Eclipse 创建 Java 项 目 5.6 
Eclipse 创建 Java 包 5.7 
Eclipse 创建 Java 类 5.8 
Eclipse 创建 Java 接口 5.9 
Eclipse 创建 XML 文件 5.10 
Eclipse Java 构建 路 径 5.11 
Eclipse 运行 配置 (Run Configuration) 5.12 
Eclipse 运行 程序 5.13 
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Eclipse 生成 jar 包 
Eclipse X ij] xA El 
Eclipse 编译 项 目 
Eclipse Debug 配置 
Eclipse Debug 调试 


Eclipse 首选 项 (Preferences) 


Eclipse 内 容 辅 助 
Eclipse 快速 修复 
Eclipse 着 浮 提示 
Eclipse 查找 


Eclipse 浏览 (Navigate) 菜 单 


Eclipse 重 构 菜单 
Eclipse 添加 书签 
Eclipse 任务 管理 
Eclipse 安装 插件 
Eclipse 代码 模板 
Eclipse 快捷 键 
Eclipse 重启 选项 
Eclipse 内 置 浏览 器 


EJB 教 程 - EJB 


EJB 概 述 - EJB 
EJB 创 建 应 用 - EJB 
EJB 无 状态 Bean - EJB 
EJB 有 状态 Bean - EJB 
EJB 持 久 性 - EJB 
EJB 消 息 驱动 Bean - EJB 
EJB 注 解 /注释 - EJB 
EJB 回 调 - EJB 
EJB 定 时 器 服务 - EJB 
EJB 依 赖 注入 - EJB 

EJB 拦 截 - EJB 
EJBERA xt & - EJB 

EJB - Blobs/Clobs - EJB 
EJB#4 - EJB 

EJB 安 全 - EJB 
EJBJNDI 绑 定 - EJB 
EJB 实 体 关 系 - EJB 
EJB 访 问 数据 库 - EJB 
EJB 查 询 语言 - EJB 
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EJB Web Services - EJB 
EJB 封 装 应 用 - EJB 


Guava 教 程 


Guava 环 境 设 置 - Guava 教 程 
Guava Optional% - Guava Af 
Guava Preconditions 类 - Guava 教 程 
Guava Ordering X - Guava 教 程 
Guava Objects # - Guava 教 程 
Guava Range X - Guava 教 程 
Guava Throwables X - Guava 教 程 
Guava 集 合 工 具 - Guava 教 程 
Guava#z #18 - Guava 教 程 
Guava 字 符 串 工具 - Guava 教 程 
Guavalii& LA - Guava 教 程 
Guava 数 学 工具 - Guava 教 程 


Hibernate 教程 


ORM 是 什么 ?2ORM 介 绍 - hibernate 
Hibernate 概 述 ,Hibernate 是 什么 ? - hibernate 
Hibernate 架 构 - hibernate 
Hibernate 环 境 配置 - hibernate 
Hibernate 配 置 - hibernate 
Hibernate Sessions - hibernate 
Hibernate 持 久 化 类 - hibernate 
Hibernate 映 射 文件 - hibernate 
Hibernate 映 射 类 型 - hibernate 
Hibernate 实 例 - hibernate 
Hibernate O/R 映 射 - hibernate 
Hibernate 注 解 - hibernate 
Hibernate & i4; 5 - hibernate 
Hibernate & i438 (# - hibernate 
Hibernate R ^ SQL - hibernate 
Hibernate: fz - hibernate 
Hibernatedit = 4438 - hibernate 
Hibernate 拦 截 器 - hibernate 


iBATIS 教程 


iBATIS 介 绍 ，iBATIS 是 什么 ? - ibatis 
iBATIS 配 置 环境 - ibatis 
iBATIS 创 建 操作 - ibatis 
iBATIS 读 取 操 作 - ibatis 
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iBATIS 更 新 操作 - ibatis 
iBATIS 删 除 操作 - ibatis 
iBATIS 结 果 映 射 - ibatis 
iBATIS 存 储 过 程 ibatis 
iBATIS 动 态 SQL - ibatis 
iBATIS 调 试 ibatis 
iBATIS 和 Hibernate 区 别 - ibatis 
iBATOR 介 绍 ， 什 么 是 iBATOR ? - ibatis 
Jackson 教 程 
Jackson 环 境 安装 设置 - Jackson 教 程 
Jackson 第 一 个 程序 - Jackson 教 程 
Jackson ObjectMapper 3: - Jackson 教 程 
Jackson xt RFP FINE - Jackson 
Jackson 数 据 绑 定 - Jackson 教 程 
Jackson 全 数据 绑 定 - Jackson 教 程 
Jackson 数 据 绑 定 泛 型 - Jackson 教 程 
Jackson 树 模型 - Jackson 教 程 
Jackson API - Jackson 教 程 
JasperReports 教 程 


JasperReports 和 人 门 ，JasperReports 是 什么 ? - JasperReports 教 程 


JasperReport 环 境 设置 - JasperReports 教 程 
JasperReport 生 命 周 期 - JasperReports 
JasperReport 报 表 设 计 - JasperReports 教 程 
JasperReport 编 译 报表 设计 - JasperReports 教 程 
JasperReport 填 充 报 表 - JasperReports 教 程 
JasperReport 查 看 和 打印 报告 - JasperReports 教 程 
JasperReport 导 出 报表 - JasperReports 教 程 
JasperReport 报 表 参 数 - JasperReports 教 程 
JasperReports 报 表 数 据 源 - JasperReports 教 程 
JasperReports 报 表 字 段 - JasperReports 教 程 
JasperReports 报 表 表 达 式 - JasperReports 教 程 
JasperReports 报 表 变 量 - JasperReports 教 程 
JasperReports 报 表 区 段 - JasperReports 教 程 
JasperReports 报 表 组 - JasperReports 教 程 
Java 教程 

Java 基础 

Java 简介 

Java 开 发 环境 配置 

Java 基 础 语法 
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Java xt R All 3E 

Java 基 本 数据 类 型 

Java 变 量 类 型 

Java 修 饰 符 

Java 运 算 符 

Java 循 环 结构 - for, while 及 do...while 
Java xc 24 44 - if...else/switch 
Java Number X: 

Java Character # 

Java String # 

Java StringBuffersllStringBuilder 3E 
Java 数组 

Java 日 期 时 间 

Java 正 则 表达 式 

Java 方法 

Java 流 (Stream)、 文 件 (File) 和 IO 
Java 异常 处 理 


Java 面向 对 象 


Java 继承 

Java 重 写 (Override) 与 重 载 (Overload) 
Java 多 态 

Java 抽象 类 

Java 接口 

Java 包 (package) 


Java 高 级 教程 


Java 数据 结构 

Java Enumeration 接 口 
Java Bitset 类 

Java Vector # 

Java Stack # 

Java Dictionary # 
Java Hashtable 接口 
Java Properties 接口 
Java 集合 框架 

Java 泛 型 

Java 序 列 化 

Java 网 络 编程 

Java 发 送 邮 件 

Java 多 线程 编程 
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Java Applet 基 础 
Java 文档 注释 


Java8 教 程 


Java8 环 境 设 置 - Java8 教 程 

Java8 Lambda 表 达 式 - Java8 教 程 
Java8 方 法 引用 - Java8 教 程 
Java8 男 数 式 接口 - Java8 教 程 
Java8 默 认 方 法 - Java8 教 程 

Java8 数 据 流 - Java8 教 程 

Java8 Optional 类 - Java8 教 程 

Java8 Nashorn JavaScript 引 擎 - Java8 教 程 
Java8 日 期 时 间 API - Java8 教 程 

Java8 Base64 - Java8 教 程 


java 实 例 教程 


编译 /执行 Java 程 序 

Java 环 境 - java 实 例 教程 

Java String/ 字 符 串 操作 实例 - java 实 例 教程 
Java Arrays/ 数 组 实例 -java 实例 教程 

Java 日 期 、 时 间 Date/Time - java 实 例 教程 
Java 方 法 实例 - java 实 例 教程 
Java 文 件 操作 实例 - java 实 例 教程 

Java 目 录 操 作 实 例 - java 实 例 教程 

Java Exception/# &$ & ll -java 实例 教程 
Java 数 据 结构 实例 - java 实 例 教程 
Java 集 合 实例 - java 实 例 教程 
Java 网 络 编程 实例 - java 实 例 教程 

Java Applet 实 例 -java 实例 教程 

Java 简 单 的 图 形 用 户 界 面 -GUI -java 实例 教程 
Java JDBC 实 例 -java 实例 教程 
Java 正 则 表达 式 实例 -java 实例 教程 


JavaFX 教 程 


JavaFX 是 什么 ? - JavaFX 教 程 

JavaFX - Scene Builder - JavaFX 教 程 

JavaFX - 创建 JavaFX 项 目 - JavaFX 教 程 
JavaFX - Scene Builder 设 计 界 面 - JavaFX 教 程 
JavaFX - 创建 主 应 用 程序 - JavaFX 教 程 
JavaFX - Model 和 TableView - JavaFX 教 程 
JavaFX - 用 户 交 互 - JavaFX 教 程 

JavaFX - CSS 样 式 - JavaFX 教 程 
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JavaFX - XML 格式 存储 - JavaFX 教 程 
JavaFX - 统计 图 - JavaFX 教 程 
JavaFX - 部 署 - JavaFX 教 程 


Java.io 包 教程 


Java.io.BufferedlnputStream 类 实例 - Java.io 包 
Java.io.BufferedOutputStream 类 使 用 例子 - Java.io 包 
Java.io.BufferedReader X - Java.io 包 
Java.io.BufferedWriter 类 - Java.io 包 
Java.io.ByteArrayInputStream X - Java.io 包 
Java.io.ByteArrayOutputStream # - Java.io 包 
Java.io.CharArrayReader X - Java.io 包 
Java.io.CharArrayWriter # - Java.io tJ 
Java.io.Console X - Java.io 包 
Java.io.DatalnputStream X - Java.io 包 
Java.io.DataOutputStream # - Java.io cJ 
Java.io.FileX€ - Java.io 8 
Java.io.FileDescriptor # - Java.io® 
Java.io.FilelnputStream X: - Java.io® 
Java.io.FileOutputStream # - Java.io 包 
Java.io.FilePermission X - Java.io® 
Java.io.FileReader X: - Java.io 包 
Java.io.FileWriter # - Java.io 包 
Java.io.FilterlnputStream XX - Java.io 包 
Java.io.FilterOutputStream # - Java.io 包 
Java.io.FilterWriter# - Java.io 包 
Java.io.InputStream X - Java.io 包 
Java.io.InputStreamReader # - Java.io 包 
Java.io.LineNumberlnputStream # - Java.io 包 
Java.io.LineNumberReader X - Java.io@ 
Java.io.ObjectInputStream # - Java.io 包 
Java.io.ObjectInputStream.GetField # - Java.io dl 
Java.io.ObjectOutputStream # - Java.io ©% 
Java.io.ObjectOutputStream.PutField # - Java.io 8l 
Java.io.ObjectStreamClass X - Java.io 包 
Java.io.ObjectStreamField # - Java.io 包 
Java.io.OutputStreamWriter # - Java.io 包 
Java.io.PipedinputStream # - Java.io 包 


Java.io.PipedlnputStream.available() 方 法 实例 - Java.io 包 


Java.io.PipedOutputStream # - Java.io 包 
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Java.io.PipedReader # - Java.io 包 16.36 
Java.io.PipedWriter # - Java.io® 16.37 
Java.io.PrintStream # - Java.io 包 16.38 
Java.io.PrintWriter # - Java.io® 16.39 
Java.io.PushbacklnputStream X - Java.io 包 16.40 
Java.io.RandomAccessFile X - Java.io 包 16.41 
Java.io.Reader X - Java.io 包 16.42 
Java.io.SequencelnputStream # - Java.io 包 16.43 
Java.io.SerializablePermission # - Java.io 包 16.44 
Java.io.StreamTokenizer # - Java.io 包 16.45 
Java.io.StringBufferlnputStream # - Java.io 包 16.46 
Java.io.StringReader # - Java.io® 16.47 
Java.io.Writer# - Java.io 包 16.48 
Java.io.Interfaces - Java.io 包 16.49 
java.lang 17 
java.lang.Boolean X - java.lang 17.1 
java.lang.Byte X - java.lang 17.2 
java.lang.Character - java.lang 17.3 
java.lang.Character.Subset X - java.lang 17.4 
java.lang.Character.UnicodeBlock X - java.lang 17.5 
java.lang.Class X - java.lang 17.6 
java.lang.ClassLoader # - java.lang 17.7 
java.lang.Compiler 类 - java.lang 17.8 
java.lang.Double # - java.lang 17.9 
java.lang.Enum X - java.lang 17.10 
java.lang.Float# - java.lang 17.11 
java.lang.InheritableThreadLocal X - java.lang 17.12 
java.lang.Integer # - java.lang 17.13 
java.lang.Long X - java.lang 17.14 
java.lang.Math X - java.lang 17.15 
java.lang.Number % - java.lang 17.16 
java.lang.Object% - java.lang 17.17 
java.lang.Package X - java.lang 17.18 
java.lang.Process X - java.lang 17.19 
java.lang.ProcessBuilder # - java.lang 17.20 
java.lang.Runtime # - java.lang 17.21 
java.lang.RuntimePermission X - java.lang 17.22 
java.lang.SecurityManager X - java.lang 17.23 
java.lang.Short X - java.lang 17.24 
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java.lang.StackTraceElement Xt - java.lang 17.25 
java.lang.StrictMath 3X - java.lang 17.26 
java.lang.String XX - java.lang 17.27 
java.lang.StringBuffer # - java.lang 17.28 
java.lang.StringBuilder # - java.lang 17.29 
java.lang.System X - java.lang 17.30 
java.lang.Thread X - java.lang 17.31 
java.lang.ThreadLocal # - java.lang 17.32 
java.lang.Throwable # - java.lang 17.33 
java.lang.Void X - java.lang 17.34 
java.lang.Errors - java.lang 17.35 
java.lang.Interfaces - java.lang 17.36 
Java.math BAZ 18 
Java.math.BigDecimal X - Java.math e 18.1 
Java.math.BigInteger # 3: 9l - Java.math al 18.2 
Java.math.MathContext # % {l| - Java.math © 18.3 
Java.util 包 教程 19 
Java.util.ArrayDeque X - Java.util 包 19.1 
Java.util. ArrayList # - Java.util 包 19.2 
Java.util.Arrays # - Java.util 包 19.3 
Java.util.BitSet # - Java.util 包 19.4 
Java.util.Calendar# - Java.util 包 19.5 
Java.util.Collections 3X - Java.util 包 19.6 
Java.util.Currency # - Java.util 包 19.7 
java.util.Date # - Java.util ©% 19.8 
java.util.Dictionary XX - Java.util 包 19.9 
java.util.EnumMap # - Java.util 包 19.10 
java.util.EnumSet # - Java.util 包 19.11 
java.util.Formatter3€ - Java.util © 19.12 
java.util.GregorianCalendarX - Java.util 包 19.13 
java.util.HashMap # - Java.util 包 19.14 
java.util.HashSet# - Java.util 包 19.15 
java.util.Hashtable 3€ - Java.util 包 19.16 
java.util.lIdentityHashMap X: - Java.util 包 19.17 
java.util.LinkedHashMap X - Java.util 包 19.18 
java.util.LinkedHashSet # - Java.util 包 19.19 
java.util.LinkedList # - Java.util 包 19.20 
java.util.ListResourceBundle X - Java.utila 19.21 
java.util.Locale # - Java.util 包 19.22 
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java.util.Observable # - Java.util 包 19.23 
java.util.PriorityQueue # - Java.util 包 19.24 
java.util.Properties # - Java.util 包 19.25 
java.util.PropertyPermission # - Java.util@ 19.26 
java.util. PropertyResourceBundle X - Java.util 包 19.27 
java.util.Random # - Java.util 包 19.28 
java.util.ResourceBundle X - Java.util 包 19.29 
java.util.ResourceBundle.Control X - Java.utila 19.30 
java.util. Scanner # - Java.util 包 19.31 
java.util. ServiceLoader # - Java.util 包 19.32 
java.util.SimpleTimeZone # - Java.util 包 19.33 
java.util.Stack # - Java.util 包 19.34 
java.util.StringTokenizer # - Java.util 包 19.35 
java.util. Timer # - Java.util 包 19.36 
java.util. TimerTask 3€ - Java.util 包 19.37 
java.util. TimeZone # - Java.util 包 19.38 
java.util. TreeMap X: - Java.util 包 19.39 
java.util. TreeSet # - Java.util 包 19.40 
java.util. UUID # - Java.util 包 19.41 
java.util. WeakHashMap # - Java.util@ 19.42 
java.util.Interfacesf£ 0O - Java.util 包 19.43 
java.util.Exceptions 接 口 - Java.util 包 19.44 
java.util.Formatter.BigDecimalLayoutForm 接 口 - Java.util 包 19.45 
Java XML 教程 20 
Java XML 解析 器 - Java XML 教程 20.1 
Java DOM 解 析 器 - Java XML 教程 20.2 
Java DOM 解 析 器 - 解析 XML 文档 - Java XML 教程 20.3 
Java DOM 解 析 器 - 查询 XML 文档 - Java XML 教程 20.4 
Java DOM 解 析 器 - 修改 XML 文档 - Java XML 教程 20.5 
Java SAX 解 析 器 - Java XML 教程 20.6 
Java SAX 解 析 器 - 解析 XML 文档 - Java XML 教程 20.7 
Java SAX 解 析 器 - 查询 XML 文档 - Java XML 教程 20.8 
Java SAX 解 析 器 - 修改 XML 文档 - Java XML 教程 20.9 
Java JDOM 解 析 器 - Java XML 教程 20.10 
Java JDOM 解 析 器 - 解析 XML 文档 - Java XML 教程 20.11 
Java JDOM 解 析 器 - 查询 XML 文档 - Java XML 教程 20.12 
Java JDOM 解 析 器 - 创建 XML 文档 - Java XML 教程 20.13 
Java JDOM 解 析 器 - 修改 XML 文档 - Java XML 教程 20.14 
Java StAX 解 析 器 - Java XML 教程 20.15 
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Java StAX 解 析 器 - 解析 XML 文档 - Java XML 教程 
Java StAX 解 析 器 - 查询 XML 文档 - Java XML 教程 
Java StAX 解 析 器 - 创建 XML 文档 - Java XML 教程 
Java StAX 解 析 器 - 修改 XML 文档 - Java XML 教程 
Java XPath 解析 器 - Java XML 教程 
Java XPath 解析 器 - 解析 XML 文档 - Java XML 教程 
Java XPath 解析 器 - 查询 XML 文档 - Java XML 教程 
Java DOM4J 解 析 器 - Java XML 教程 
Java DOM4J 解 析 器 - 解析 XML 文档 - Java XML 教程 
Java DOM4J 解 析 器 - 查询 XML 文档 - Java XML 教程 
Java DOM4J 解 析 器 - 创建 XML 文档 - Java XML 教程 
Java DOM4J 解 析 器 - 修改 XML 文档 - Java XML 教程 
Java XML 学 习 资源 - Java XML 教程 

JavaMail API 教程 
JavaMail API 概述 - JavaMail 
JavaMail API 环境 设置 - JavaMail 
JavaMail API 核心 类 - JavaMail 
JavaMail API 发 送 电子 邮件 - JavaMail 
JavaMail 查询 电子 邮件 - JavaMail 
JavaMail 获取 电子 邮件 - JavaMail 
JavaMail 认 证 /验证 - JavaMail 
JavaMail 电子 邮件 答复 /回复 - JavaMail 
JavaMail 转发 电子 邮件 - JavaMail 
JavaMail 删除 电子 邮件 - JavaMail 
JavaMail Gmail SMTP 服 务 器 - JavaMail 
JavaMail 邮件 文件 夹 管理 - JavaMail 
JavaMail 限额 管理 - JavaMail 
JavaMail 退回 邮件 - JavaMail 
JavaMail SMTP 服 务 器 - JavaMail 
JavaMail IMAP 服 务 器 - JavaMail 
JavaMail POP3 服 务 器 - JavaMail 

JDBC 教 程 
JDBC4 简 介 ，JDBC 是 什么 2 - JDBC 教 程 
JDBC SQL 语法 - JDBC 教 程 
JDBC 环 境 设置 - JDBC 教 程 
JDBC 示 例 代 码 - JDBC 教 程 
JDBC 了 驱动 类 型 - JDBC 教 程 
JDBC 连 接 数据 库 - JDBC 教 程 


20.16 
20.17 
20.18 
20.19 
20.20 
20.21 
20.22 
20.23 
20.24 
20.25 
20.26 
20.27 
20.28 
21 
21.1 
21.2 
21.3 
21.4 
21.5 
21.6 
21.7 
21.8 
21.9 
21.10 
21.11 
21.12 
21.13 
21.14 
21.15 
21.16 
21.17 
22 
22.1 
22.2 
22.3 
22.4 
22.5 
22.6 


JDBC Statements,PreparedStatement4#]CallableStatement - JDBC 教 程 
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JDBC PreparedStatementsxt & 32 lj - JDBC 教 程 22.8 22.7 
JDBC CallableStatement 对 象 实例 - JDBC 教 程 22.9 
JDBC 结 果 集 Result/Sets - JDBC 教 程 22.10 
JDBC 数 据 类 型 - JDBC 教 程 22.11 
JDBC 事 务 - JDBC 教 程 22.12 
JDBC 异 常 处 理 - JDBC 教 程 22.13 
JDBC 批 量 处 理 - JDBC 教 程 22.14 
JDBC 存 储 过 程 - JDBC 教 程 22.15 
JDBC 流 ASCII 和 二 进 制 数 据 - JDBC 教 程 22.16 
JDBC Statement 对 象 实例 - JDBC 教 程 22.17 
JDBC 创 建 数 据 库 实例 - JDBC 教 程 22.18 
JDBC 选 择 数 据 库 实例 - JDBC 教 程 22.19 
JDBC 删 除 /Delete 数 据 库 实例 - JDBC 教 程 22.20 
JDBC 创 建 表 /Create 实 例 - JDBC 教 程 22.21 
JDBC 删 除 /Delete 表 实例 - JDBC 教 程 22.22 
JDBC 插 和 /Insert 记录 示例 - JDBC 教 程 22.23 
JDBC 查 询 Select 记 录 实 例 - JDBC 教 程 22.24 
JDBC 更 新 /Update 记 录 实 例 - JDBC 教 程 22.25 
JDBC it FR/Deleteiz, x ll - JDBC 教 程 22.26 
JDBC WHERE 子 句 实例 - JDBC 教 程 22.27 
JDBC LIKE 子 句 实 例 - JDBC 教 程 22.28 
JDBC 排 序 实 例 - JDBC 教 程 22.29 
JDBC 快 速 入 门 教程 - JDBC 教 程 22.30 
JDBC 是 什么 ? 22.31 
先决 条 件 : 22.32 
JDBC - 环境 设置 : 22.33 
创建 JDBC 应 用 程序 : 22.34 
第 一 个 JDBC 程序 : 22.35 
SQLException 方 法 : 22.36 
JDBC - 数据 类 型 : 22.37 
JDBC - 批量 处 理 : 22.38 
JDBC - 数据 流 : 22.39 
JFreeChart 教 程 23 
JFreeChart 安 装 - JFreeChart 教 程 23.1 
JFreeChart 架 构 - JFreeChart 教 程 23.2 
JFreeChart£API - JFreeChart 教 程 23.3 
JFreeChart5t Æ - JFreeChart 教 程 23.4 
JFreeChart 条 形 图 - JFreeChart 教 程 23.5 
JFreeChart 线 型 图 - JFreeChart 教 程 23.6 
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JFreeChart XY Ø - JFreeChart 教 程 


JFreeChart 3D 饼 图 /条 形 图 - JFreeChart 教 程 
JFreeChart 气 泡 图 表 - JFreeChart 教 程 


JFreeChart 时 序 图 - JFreeChart 教 程 


JFreeChart 文 件 接口 - JFreeChart 教 程 
JFreeChart 数 据 库 接口 - JFreeChart 教 程 


JMeter 教 程 
JMeter 环 境 设置 - JMeter 教 程 
JMeter 创 建 测试 计划 - JMeter 教 程 
JMeter 数 据 库 测 试 计划 - JMeter 教 程 
JMeter Web 测 试 计划 - JMeter 教 程 
JMeter 数 据 库 测试 计划 - JMeter 教 程 
jMeter FTP 测 试 计划 - JMeter 教 程 


jMeter Webservice 测 试 计划 - JMeter 教 程 


jMeter JMS 测 试 计划 - JMeter 教 程 
JMeter 监 视 测试 计划 - JMeter 教 程 
jMeter 监 听 器 - JMeter 教 程 
JMeter 函 数 - JMeter 教 程 
jMeter 正 则 表达 式 - JMeter 教 程 
JMeter 最 佳 实践 - JMeter 教 程 
JOGL 教 程 
JOGL 安 装 - JOGL 教 程 
JOGL 基 本 模板 - JOGL 教 程 
JOGL 图 形 形 状 - JOGL 教 程 
JOGL 转 化 对 象 - JOGL 教 程 
JOGL 3D 图 形 - JOGL 教 程 
JPA 教 程 
JPA 架 构 - JPA 教 程 
JPA ORM 组 件 - JPA 教 程 
JPA 安 装配 置 - JPA 教 程 
JPA 实 体 管 理 器 - JPA 教 程 
JPA JPQL/ 持 久 化 查询 语言 - JPA 教 程 
JPA 高 级 映射 - JPA 教 程 
JPA 实 体 关 系 - JPA 教 程 
JPA 标 准 API - JPA 教 程 
JSP 教程 
JSP 基础 
JSP 简介 
JSP 开发 环境 搭建 


23.7 
23.8 
23.9 
23.10 
23.11 
23.12 
24 
24.1 
24.2 
24.3 
24.4 
24.5 
24.6 
24.7 
24.8 
24.9 
24.10 
24.11 
24.12 
24.13 
25 
20.1 
25.2 
25.3 
25.4 
25.5 
26 
26.1 
26.2 
26.3 
26.4 
26.5 
26.6 
26.7 
26.8 
27 
27.1 
27.1.1 
27.1.2 
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JSP 结构 

JSP 生命 周期 

JSP 语法 

JSP #89 

JSP 动作 元 素 

JSP 动作 元 素 

JSP 人 隐 合 对 象 

JSP 客户 端 请 求 

JSP 服务 器 响应 

JSP HTTP KA 

JSP 表单 处 理 

JSP it yeas 

JSP Cookies 4418 

JSP Session 

JSP 文件 上 传 

JSP 日 期 义理 

JSP 页 面 重 定向 

JSP 点 击 量 统计 

JSP 自动 刷新 

JSP 发 送 邮 件 
JSP 高 级 教程 

JSP 标准 标签 库 (JSTL) 

JSP 连接 数据 库 

JSP XML 数据 处 理 

JSP JavaBean 

JSP 自 定义 标签 

JSP 表达 式 语言 

JSP 异常 处 理 

JSP 调试 

JSP 国际 化 

Log4j 教 程 

log4j 安 装配 置 - Log4j 教 程 
log4j 架 构 - Log4j 教 程 
log4j 配 置 - Log4j 教 程 
log4j 示 例 程 序 - Log4j 教 程 
log4j Logger 方 法 - Log4j 教 程 
log4j 日 志 记 录 级 别 - Log4j 教 程 
log4j 日 志 格 式 化 - Log4j 教 程 
log4j HTMLLayout - Log4j 教 程 
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log4j PatternLayout - Log4j 教 程 28.9 
log4j 日 志 记 录 到 文件 - Log4j 教 程 28.10 
log4j 日 志 记录 到 数据 库 - Log4j 教 程 28.11 
Lucene 教 程 29 
Lucene 环 境 设置 - Lucene 教 程 29.1 
Lucene 第 一 个 应 用 程序 - Lucene 教 程 29.2 
Lucene 索 引 类 - Lucene 教 程 29.3 
Lucene Searching X - Lucene 教 程 29.4 
Lucene 索 引 过 程 - Lucene 教 程 29.5 
Lucene 索 引 操 作 - Lucene 教 程 29.6 
Lucene 搜 索 操 作 - Lucene 教 程 29.7 
Lucene 查 询 编程 - Lucene 教 程 29.8 
Lucene 分 析 - Lucene 教 程 29.9 
Lucene 排 序 - Lucene 教 程 29.10 
Maven 教 程 30 
Maven 安 装配 置 - Maven 教 程 30.1 
Maven 启 用 代理 访问 - Maven 教 程 30.2 
Maven 本 地 资源 库 - Maven 教 程 30.3 
Maven 中 央 存 储 库 - Maven 教 程 30.4 
如 何 从 Maven 远 程 存储 库 下 载 ? - Maven 教 程 30.5 
Maven 添 加 远程 仓库 - Maven 教 程 30.6 
Maven 依 赖 机 制 - Maven 教 程 30.7 
定制 库 到 Maven 本 地 资源 库 - Maven 教 程 30.8 
使 用 Maven 创 建 Java 项 目 - Maven 教 程 30.9 
使 用 Maven 创 建 Web 应 用 程序 项 目 - Maven 教 程 30.10 
Maven 外 部 依赖 - Maven 教 程 30.11 
Maven 项 目 文档 - Maven 教 程 30.12 
Maven 项 目 模板 - Maven 教 程 30.13 
Maven 快 照 - Maven 教 程 30.14 
Maven 构 建 自动 化 -Hudson - Maven 教 程 30.15 
Maven 依 赖 管理 - Maven 教 程 30.16 
Maven 自 动 化 部 署 - Maven 教 程 30.17 
Maven Web; FH - Maven 教 程 30.18 
Eclispe IDE 集 成 Maven - Maven Uf 30.19 
NetBeans IDE 集 成 Maven - Maven 教 程 30.20 
Eclipse 构建 Maven 项 目 - Maven 教 程 30.21 
转换 基于 Maven 的 Web 应 用 程序 支持 Eclipse IDE - Maven 教 程 30.22 
使 用 Maven 模 板 创建 项 目 - Maven 教 程 30.23 
使 用 Maven 构 建 项 目 - Maven 教 程 30.24 
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使 用 Maven 清 理 项 目 - Maven 教 程 30.25 
使 用 Maven 运 行 单元 测试 - Maven 教 程 30.26 
将 项 目 安装 到 Maven 本 地 资源 库 - Maven 教 程 30.27 
生成 基于 Maven 的 项 目 文档 站 点 - Maven UE 30.28 
使 用 “mvn site-deploy” 部 署 站 点 (WebDAV 例 子 ) - Maven 教 程 30.29 
部 署 基 于 Maven 的 war 文 件 到 Tomcat - Maven 教 程 30.30 
MyBatis 教 程 31 
MyBatis 环 境 配置 及 入 门 - MyBatis 教 程 31.1 
Mybatis 接 口 注 解 - MyBatis 教 程 31.2 
Mybatis 增 删改 查 (CURD) - MyBatis 教 程 31.3 
Mybatis 表 关联 一 对 多 - MyBatis 教 程 31.4 
Mybatis 表 关联 多 对 一 - MyBatis 教 程 31.5 
Mybatis 多 对 多 - MyBatis 教 程 31.6 
Mybatis 与 Spring 集成 - MyBatis 教 程 31.7 
MyBatis 整 合 Spring MVC - MyBatis 教 程 31.8 
MyBatis 分 页 - MyBatis 教 程 31.9 
MyBatis a) ASQLiZ 4) - MyBatis 教 程 31.10 
MyBatis SqlSessionDaoSupport 实 例 - MyBatis 教 程 31.11 
MyBatis 打 印 输出 SQL 语句 - MyBatis 教 程 31.12 
Quartz f 32 
Quartz 特 点 - Quartz 教 程 32.1 
Quartz2 第 一 个 程序 - Quartz 教 程 32.2 
Quartz2 作 业 监 听 - Quartz 教 程 32.3 
Quartz 执 行 多 作业 - Quartz 教 程 32.4 
Quartz 列 出 调度 器 所 有 作业 - Quartz 教 程 32.5 
Servlet 教程 33 
Servlet 简介 33.1 
Servlet 环境 设置 33.2 
Servlet 生命 周期 33.3 
Servlet 实例 33.4 
Servlet 表单 数据 33.5 
Servlet 客户 端 HTTP 请 求 33.6 
Servlet 服务 器 HTTP 响应 33.7 
Servlet HTTP 状态 码 33.8 
Servlet 编写 过 滤器 33.9 
Servlet 异常 处 理 33.10 
Servlet Cookies 处 理 33.11 
Servlet Session 跟踪 33.12 
Servlet 数据 库 访问 33.13 


18 


TutorialsPoint Java 技术 教程 


Servlet 文件 上 传 33.14 
Servlet 义理 日 期 33.15 
Servlet 网 页 重 定向 33.16 
Servlet 点 击 计 数 器 33.17 
Servlet 自动 刷新 页 面 33.18 
Servlet 发 送 电 子 邮 件 33.19 
Servlet & 33.20 
Servlet 调试 33.21 
Servlet 国际 化 33.22 
Spring 教程 34 
Spring hello world 实 例 - Spring 教程 34.1 
Spring 松 耦 合 实例 - Spring 教程 34.2 
Spring JavaConfig 实 例 - Spring 教程 34.3 
Spring JavaConfig @Import 实 例 - Spring 教程 34.4 
Spring 依赖 注入 (DI) - Spring 教程 34.5 
Spring 使 用 Setter 依 赖 注 入 - Spring 教程 34.6 
Spring 通过 构造 方法 依赖 注入 - Spring 教程 34.7 
Spring Bean 引 用 例子 - Spring 教程 34.8 
如 何 注入 值 到 Spring bean 属 性 - Spring 教程 34.9 
Spring bean 加 载 多 个 配置 文件 - Spring 教程 34.10 
Spring 内 部 bean 实 例 - Spring 教程 34.11 
Spring Bean 作 用 域 实例 - Spring 教程 34.12 
Spring 集合 (List,Set,Map,Properties) 实例 - Spring 教程 34.13 
Spring ListFactoryBean 实 例 - Spring 教程 34.14 
Spring SetFactoryBean 实 例 - Spring 教程 34.15 
Spring MapFactoryBean 例 子 - Spring 教程 34.16 
Spring 注入 日 期 到 bean 属 性 -CustomDateEditor - Spring 教程 34.17 
Spring PropertyPlaceholderConfigurer 实 例 - Spring 教程 34.18 
Spring bean 配 置 继承 - Spring 教程 34.19 
Spring 依赖 检查 - Spring 教程 34.20 
Spring 使 用 @Required 注 解 依 赖 检查 - Spring 教程 34.21 
Spring 自 定义 @Required-style 注 解 - Spring 教程 34.22 


Spring Bean InitializingBean 和 DisposableBean 实 例 - Spring 教程 34.23 
Spring Bean init-method 和 destroy-method 实 例 - Spring 教程 34.24 


Spring @PostConstruct 和 @PreDestroy 实 例 - Spring 教程 34.25 
Spring EL hello world 实 例 - Spring 教程 34.26 
Spring EL bean 引 用 实例 - Spring 教程 34.27 
Spring EL 方法 调用 实例 - Spring 教程 34.28 
Spring EL 运算 符 实例 - Spring 教程 34.29 
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Spring EL 三 元 运算 (if-then-else) 实 例 - Spring 教程 34.30 
Spring EL Lists,Maps 实 例 - Spring 教程 34.31 
Spring EL 正则 表达 式 实 例 - Spring 教程 34.32 
Spring 自动 扫描 组 件 - Spring 教程 34.33 
Spring 过 滤器 组 件 自动 打 描 - Spring 教程 34.34 
Spring 自动 装配 Beans - Spring 教程 34.35 
Spring AOP 通 知 实例 — Advice - Spring 教程 34.36 
Spring AOP 实 例 (Pointcut,Advisor) - Spring 教程 34.37 
Spring 自动 代理 创建 者 实例 - Spring 教程 34.38 
Spring AOP+AspectJ 注 解 实例 - Spring 教程 34.39 
Spring Object 到 XML 映射 实例 - Spring 教程 34.40 
Spring+JDBC 实 例 - Spring 教程 34.41 
Spring JdbcTemplate+JdbcDaoSupport 实 例 - Spring 教程 34.42 
Spring JdbcTemplate & 39 & PI - Spring 教程 34.43 
Spring SimpleJdbcTemplate & i4 zn fJ - Spring 教程 34.44 
Spring SimpleJdbcTemplate 类 命名 参数 实例 - Spring 教程 34.45 
Spring+Hibernate+MySql 实 例 - Spring 教程 34.46 
Spring AOP 在 Hibernate 事 务 管理 - Spring 教程 34.47 
Spring 在 bean 配 置 文件 中 定义 电子 邮件 模板 - Spring 教程 34.48 
Spring 发 送 带 附件 邮件 - Spring 教程 34.49 
Spring 依赖 注入 servlet 会 话 监听 器 - Spring 教程 34.50 
Spring 资源 捆绑 ResourceBundleMessageSource 示 例 - Spring 教程 
Struts2 教 程 35 34.51 
Struts 2 hello world (XML 版 本 ) - Struts2 教 程 35.1 
Struts2 注 解 示例 - Struts2 教 程 35.2 
Struts2 @ResultPath 注 释 示 例 - Struts2 教 程 35.3 
Struts2 include( 包 含 ) 多 个 配置 文件 - Struts2 教 程 35.4 
Struts2 命 名 空间 配置 和 解释 - Struts2 教 程 35.5 
Struts2 开 发 者 模式 - Struts2 教 程 35.6 
如 何 删 除 Struts2 动 作 的 后 缀 扩展 名 - Struts2 教 程 35.7 
使 用 Struts2 动 作 - Struts2 教 程 35.8 
Struts2 的 ActionError&ActionMessage 示 例 - Struts2 教 程 35.9 
Struts2 模 型 驱动 实例 - Struts2 教 程 35.10 
Struts2 映 射 拦截 动作 - Struts2 教 程 35.11 
Struts2 重 写 拦 截 器 参数 - Struts2 教 程 35.12 
Struts2 拦 截 器 栈 的 例子 - Struts2 教 程 35.13 
Struts2 execAndWait 拦 截 器 例子 - Struts2 教 程 35.14 
Struts2 文 件 上 传 例子 - Struts2 教 程 35.15 
Struts2 资 源 包 使 用 示例 - Struts2 教 程 35.16 
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Struts2 本 地 化 和 国际 化 - Struts2 教 程 35.17 
Struts2 key 键 属性 示例 - Struts2 教 程 35.18 
Struts2 中 文本 地 化 问题 - Struts2 教 程 35.19 
Struts2+Spring 集 成 实例 - Struts2 教 程 35.20 
Struts2+Hibernate 使 用 Full Hibernate Plugin 集 成 - Struts2 教 程 35.21 
Struts2+Hibernate 集 成 实例 - Struts2 教 程 35.22 
Struts2+Spring+Hibernate 集 成 实例 - Struts2 教 程 35.23 
Struts2+Log4j 集 成 - Struts2 教 程 35.24 
Struts2 配 置 Action 类 的 静态 参数 - Struts2 教 程 35.25 
Struts2 下 载 文件 实例 - Struts2 教 程 35.26 
Struts2 和 JSON 实 例 - Struts2 教 程 35.27 
SWING 教程 36 
读者 36.1 
前 提 条 件 36.2 
Swing 介绍 - Swing 36.3 
Swing 开发 环境 安装 - Swing 36.4 
Swing 控件 - Swing 36.5 
Swing (4 4418 - Swing 36.6 
Swing 事件 监听 器 - Swing 36.7 
Swing 事件 适配器 - Swing 36.8 
Swing Layout 布 局 - Swing 36.9 
Swing Menu 菜 单 类 - Swing 36.10 
TestNG 教 程 37 
TestNG 介 绍 - TestNG 教 程 37.1 
TestNG 环 境 设置 (配置 安装 ) - TestNG 教 程 37.2 
TestNG 编 写 测试 - TestNG 教 程 37.3 
TestNG 基 本 注解 (注释 ) - TestNG 教 程 37.4 
TestNG 执 行程 序 - TestNG 教 程 37.5 
TestNG 执 行 测试 - TestNG 教 程 37.6 
TestNG 套 件 测试 - TestNG 教 程 37.7 
TestNG 忽 略 测试 - TestNG 教 程 37.8 
TestNG 组 测试 - TestNG 教 程 37.9 
TestNG 异 常 测试 - TestNG 教 程 37.10 
TestNG 依 赖 测试 - TestNG 教 程 37.11 
TestNG 参 数 化 测试 - TestNG 教 程 37.12 
TestNG 运 行 JUnit 测 试 - TestNG 教 程 37.13 
TestNG 测 试 结果 报告 - TestNG 教 程 37.14 
TestNG 插 件 与 ANT - TestNG 教 程 37.15 
TestNG Eclipse 插件 - TestNG 教 程 37.16 
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Tika 教 程 38 
TIKAZR 4j - Tika 教 程 38.1 
TIKA 环 境 配置 - Tika 教 程 38.2 
TIKA 参 考 API - Tika 教 程 38.3 
TIKA 文 件 格式 - Tika 教 程 38.4 
TIKA 文 件 类 型 检测 - Tika 教 程 38.5 
TIKA 内 容 提 取 - Tika 教 程 38.6 
TIKA 元 数据 提取 - Tika 教 程 38.7 
TIKA;& &1& 3t] - Tika 教 程 38.8 
TIKA 图 形 界面 /GUI - Tika 教 程 38.9 
TIKA 提 取 PDF - Tika 教 程 38.10 
TIKA 提 取 ODF - Tika 教 程 38.11 
TIKA 提 取 MS Office 文 件 - Tika 教 程 38.12 
TIKA 提 取 文 本 文档 - Tika 教 程 38.13 
TIKA 提 取 HTML 文 档 - Tika 教 程 38.14 
TIKA 提 取 XML 文 档 - Tika 教 程 38.15 
TIKA 提 取 .class 文 件 - Tika 教 程 38.16 
TIKA 提 取 JAR 文 件 - Tika 教 程 38.17 
TIKA 提 取 图 像 文 件 - Tika 教 程 38.18 
TIKA 提 取 mp4 文 件 - Tika 教 程 38.19 
TIKA 提 取 MP3 文 件 - Tika 教 程 38.20 

XStream 教 程 39 
XStream 环 境 设置 - XStream 教 程 39.1 
XStream 入 门 应 用 程序 - XStream 教 程 39.2 
XStreami& & - XStream 教 程 39.3 
XStream 注 解 - XStream 教 程 39.4 
XStream 对 象 流 - XStream 教程 39.5 
XStream 对 象 流 - XStream 教程 39.6 
XStream 编 写 JSON - XStream 教 程 39.7 
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Apache ANT 教程 


Apache Ant 是 由 Apache 软 件 基 金 会 一 个 基于 Java 的 构建 工具 。Apache Ant 的 构建 
文件 是 用 XML 编写 ， 并 采取 了 开放 的 标准 ， 便 于 携带 和 易于 理解 的 XML 性 质 的 优 


Ho 


本 教程 将 教 你 如 何 使 用 Apache Ant 自动 构建 和 部 署 过 程 。 


读者 


本 教程 是 专 为 初学 者 ， 帮 助 他 们 了 解 了 Apache Ant 工 具 来 自动 构建 和 部 署 过 程 的 基 
本 功能 。 


必 各 要 求 


我 们 假设 你 有 软件 开发 知识 使 用 编程 语言 ，Java 编 程 和 软件 构建 和 部 署 过 程 。 


ANT à - ANT 


为 什么 你 需要 一 个 构建 工具 ? 

理解 Apache Ant 定 义 之 前 ， 必 须 了 解 需要 一 个 构建 工具 。 为 什么 我 需要 Ant， 或 者 
更 具体 地 说 ， 为 什么 我 需要 一 个 构建 工具 ? 

花 你 一 天 做 以 下 工作 ? 

e 编译 代码 

。 打 包 二 进 制 文件 

e 部 署 二 进 制 文件 到 测试 服务 器 

。 测试 您 的 代码 更 改 

。 从 一 个 位 置 复制 代码 到 另 一 个 地 方 

如 果 你 回答 是 肯定 的 上 述 任何 一 项 ， 那 么 现在 是 时 候 实现 过 程 的 自动 化 。 


平均 而 言 ， 开 发 人 员 花 费 3 小 时 (工作 日 超出 8 小 时 ) 做 这 样 构建 和 部 署 平 凡 的 任 
务 。 难道 你 会 很 高 兴 多 要 回 3 个 小 时 ? 


Apache Ant 是 可 以 在 命令 行 中 执行 一 个 操作 系统 构建 和 部 署 工 具 。 


Apache Ant 的 历史 


e Ant 代表 着 另 一 种 简洁 的 工具 


e Ant 是 由 詹姆斯 :邓肯 :戴维森 (Tomcat 的 原作 者 ) 创建 的 ， 在 他 欧洲 飞 往 美国 
时 。 


Ant 最 初 是 用 来 构建 Tomcat， 被 捆绑 Tomcat 作 为 分 发 的 一 部 分 
Ant 诞生 制造 工具 出 有 关 的 问题 和 复 条 性 

Ant 于 2000 年 晋升 为 在 Apache 的 一 个 独立 项 目 。 

Apache Ant (截至 2011 年 7 月 ) 的 当前 版 本 是 1.8.2 

NAnt 是 .NET 构 建 工 具 ， 它 类 似 于 Ant， 但 用 于 构建 .NET 应 用 程序 


Apache Ant 功 能 


e Ant 是 最 完整 的 Java 构 建 和 部 署 工具 。 


Ante@ZACAN, TUABRETANBE, WxH SA. 

Ant 可 以 用 于 执行 特定 任务 的 平台 ， 例 如 使 用 "触摸 ' 命 令 修 改 文件 的 修改 时 间 。 
Ant 脚本 使 用 的 是 纯 XML 编 写 的 。 如 果 你 已 经 熟悉 XML， 你 可 以 学 习 Ant 很 
快 


o 


Ant 擅 长 复杂 的 自动 化 重复 的 任务 。 

Ant 自 带 的 预定 义 任务 的 大 名 单 。 

Ant 提 供 了 开发 自 定义 任务 的 界面 。 

Ant 可 以 在 命令 行 中 很 容易 地 调用 ， 它 可 以 与 免费 的 和 商业 的 IDE 和 集成 。 


ANT 环 境 安装 设置 - ANT 


安装 Apache Ant 
假定 您 已 经 下 载 并 安装 Java 开 发 工具 包 (JDK) 在 您 的 电脑 上 。 如 果 没有 ， 请 按照 
这 里 的 说 明 。 


Apache Ant 是 Apache 软 件 许 可 证 ， 由 开放 源码 倡议 认证 一 个 完全 成 熟 的 开源 许可 
下 发 布 。 


最 新 的 Apache Ant 版 本 ， 包 括 完整 的 源 代码 ， 类 文件 和 文档 可 以 在 这 里 找到 
http://ant.apache.org. 


e 确保 将 JAVA_HOME 环 境 变量 设置 到 安装 JDK 的 文件 夹 。 
e 下 载 的 二 进 制 文件 从 http:Want.apache.org 


e 使 用 Winzip，WinRAR，7-zip 或 类 似 工 具 解 压缩 zip 文 件 到 一 个 方便 的 位 置 
c:folder. 


e 创建 一 个 名 为 ANT_HOME， 一 个 新 的 环境 变量 指向 Ant 的 安装 文件 夹 ， 在 
c:apache-ant-1.8.2-bin 文件 夹 。 


附加 的 路 径 Apache Ant 批 义理 文件 添加 到 PATH 环境 变量 中 。 在 我 们 的 例子 是 
c:apache-ant-1.8.2-binin 文 件 夹 。 


验证 Apache Ant 的 安装 


要 验证 Apache Ant 已 成 功 安装 在 您 的 计算 机 上 ， 打 开 一 个 命令 提示 符 ， 然 后 输入 
ant。 


你 应 该 会 看 到 类 似 的 输出 : 


C:>ant -version 
Apache Ant(TM) version 1.8.2 compiled on December 20 2010 


AUARÁÍSUETS EIL ETEBS, BAR AVEOC SERRE IER. 


安装 Eclipse 


本 教程 还 包括 集成 Ant 到 Eclipse IDE 中 。 所 以 ， 如 果 你 还 没有 安装 Eclipse， 请 下 
载 并 安装 Eclipse 


想 要 Eclipse: 


e 从 下 载 最 新 的 Eclipse 二 进 制 文件 www.eclipse.org 
e 解压 Eclipse 的 二 进 制 文件 到 一 个 方便 的 位 置 如 c: 


e 运行 c:eclipseeclipse.exe 


Ant 构 建文 件 - ANT 
通常 情况 下 ，Ant 构 建文 件 build.xml 应 该 在 项 目的 基础 目录 。 可 以 自由 使 用 其 他 文 
件 名 或 将 构建 文件 中 其 他 位 置 。 
在 本 练习 中 ， 创 建 一 个 名 为 build.xml 在 电脑 的 任何 地 方 的 文件 。 
<?xml version="1.0"?> 
<project name="Hello World Project" default="info"> 
<target name="info"> 
<echo>Hello World - Welcome to Apache Ant!</echo> 


</target> 
</project> 


请 注意 ， 应 该 有 XML 声明 之 前 没有 空 行 或 空格 。 该 处 理 指令 目标 匹配 "[xX][ImM][IL]" 
是 不 允许 的 - 如 果 你 这 样 做 ， 这 可 能 在 运行 Ant 构 建 时 造成 的 错误 消息 。 


所 有 构建 文件 要 求 项 目 元 素 和 至 少 一 个 目标 元 素 。 
XML 元 素 的 项 目 有 三 个 属性 : 

属性 描述 

name The Name of the project. (Optional) 


The default target for the build script. A project may contain any 
default number of targets. This attribute specifies which target should be 
considered as the default. (Mandatory) 


basedir The base directory (or) the root folder for the project. (Optional) 


一 个 目标 是 要 作为 一 个 单元 运行 的 任务 的 集合 。 在 我 们 的 例子 中 ， 我 们 有 一 个 简单 
的 目标 ， 以 提供 一 个 信息 性 消息 给 用 户 。 


目标 可 以 对 其 他 目标 的 依赖 关系 。 例 如 ， 部 署 目标 可 能 对 封装 对 象 的 依赖 和 包 的 目 
标 可 能 具有 依赖 于 compile 目 标 等 等 。 依 赖 关 系 是 使 用 依赖 属性 表示 。 例 如 : 


<target name="deploy" depends="pacakge"> 


</target> 
<target name="pacakge" depends="clean, compile"> 
</target> 
«target name="clean" > 
</target> 
<target name="compile" > 
</target> 
目标 元 素 具 有 以 下 属性 : 
属性 描述 
name The name of the target (Required) 
depends Comma separated list of all targets that this target depends on. 


(Optional) 
description A short description of the target. (optional) 


if Allows the execution of a target based on the trueness of a 
conditional attribute. (optional) 


Adds the target to the dependency list of the specified Extension 
unless Point. An Extension Point is similar to a target, but it does not 
have any tasks. (Optional) 


在 上 面 的 例子 中 的 echo 任务 是 打印 一 条 消息 一 个 简单 的 任务 。 在 我 们 的 例子 ， 它 
打印 出 Hello World 消 息 。 


要 运行 Ant 构 建文 件 ， 打 开 命 令 提 示 符 并 导航 到 build.xml 文 件 所 在 的 文件 夹 ， 然 
输入 ant info。 也 可 以 只 输入 ant 来 代替 。 既 会 工作 ， HERBAS UR 
文件 。 应 该 看 到 下 面 的 输出 : 


C:>ant 
Buildfile: C:uild.xml 


Info : 
[echo] Hello World - Welcome to Apache Ant! 


BUILD SUCCESSFUL 
Total time: 0 seconds 


Cie 


Ant 属 性 任务 - ANT 


Ant 构 建文 件 是 用 XML 编写 的 ， 它 不 迎合 声明 变量 ， 你 在 最 喜欢 的 编程 语言 做 的 。 


然而 ， 正 如 你 可 能 已 经 想 


码 目录 等 有 用 


到 ， 它 会 如 果 人 允许 Ant 声 明 变 量 ， 如 项 目 名 称 ， 项 目 源 代 


Ant 使 用 属性 元 素 ， 它 允许 你 指定 的 属性 。 这 人 允许 属性 从 一 个 版 本 改变 为 另 一 个 。 


或 者 从 一 个 环境 到 另 一 个 


[`o 


默认 情况 下 ，Ant 提 供 了 可 以 在 构建 文件 中 使 用 下 列 预定 义 的 属性 


属性 
ant.file 


ant.version 
basedir 
ant.java.version 
ant.project.name 


ant.project.default- 
target 


ant.project.invoked- 
targets 


ant.core.lib 


ant.home 


ant.library.dir 


The full location of the build file. 
The version of the Apache Ant installation. 


The basedir of the build, as specified in the basedir 
attribute of theproject element. 


The version of the JDK that is used by Ant. 


The name of the project, as specified in the name 
atrribute of theproject element 


The default target of the current project 

Comma separated list of the targets that were invoked 
in the current project 

The full location of the ant jar file 

The home directory of Ant installation 


The home directory for Ant library files - typically 
ANT HOME!/lib folder. 


Ant 也 使 得 系统 性 能 〈 例 如 : 文件 分 割 符 ) ， 可 用 于 构建 文件 。 


除了 以 上 所 述 ， 用 户 可 以 使 用 属性 元 素 定义 附加 属性 。 一 个 例子 介绍 如 下 展示 了 如 
何 定义 一 个 名 为 站 点 名 称 (sitename) 属性 : 


<?xml version="1.0"?> 
<project name="Hello World Project" default="info"> 
«property name-"sitename" value="www.yiibai.com"/> 
«target name="info"> 
<echo>Apache Ant version is ${ant.version} - You are 
at ${sitename} </echo> 
</target> 
</project> 


上 述 构 建文 件 运 行 ant 应 该 产生 下 面 的 输出 : 


C:>ant 
Buildfile: C:uild.xml 


info: 
[echo] Apache Ant version is Apache Ant(TM) version 1.8.2 
compiled on December 20 2010 - You are at www.yiibai.com 


BUILD SUCCESSFUL 
Total time: 0 seconds 
C> 


Ant 属 性 文件 - ANT 


直接 在 构建 文件 中 设置 属性 是 好 的 ， 如 果 你 使 用 的 是 少数 属性 。 然 而 ， 对 于 一 个 大 
型 项 目 ， 是 要 存储 在 一 个 单独 的 属性 文件 中 。 


存储 在 一 个 单独 的 文件 中 的 属性 可 以 让 你 重复 使 用 相同 的 编译 文件 ， 针 对 不 同 的 执 
行 环境 不 同 的 属性 设置 。 例 如 ， 生 成 属性 文件 可 以 单独 维持 DEV，TEST 和 PROD 
环境 。 


指定 在 一 个 单独 的 文件 属性 是 有 用 的 ， 当 你 不 知道 一 个 属性 (在 一 个 特定 的 环境 
中 ) 前 面 的 值 。 这 使 您 可 以 在 属性 值 是 已 知 的 其 他 环境 进行 构建 。 


没有 硬性 规定 ， 但 一 般 属性 文件 名 为 build.properties 文 件 ， 并 放 在 治 一 侧 的 
build.xml 文 件 。 如 build.properties.dev 和 build.properties.test - 你 可 以 根据 部 署 环境 
中 创建 多 个 生成 属性 文件 


构建 属性 文件 的 内 容 类 似 于 普通 的 Java 属 性 文件 。 他 们 每 行 包含 一 个 属性 。 每 个 属 
性 由 一 个 名 称 和 一 个 值 对 来 表示 。 名 称 和 值 对 由 等 号 分 开 。 强 烈 建议 属性 标注 了 正 
确 的 注释 。 注 释 列 出 所 使 用 的 哈 希 字符 。 


下 面 显示 了 一 个 build.xml 文 件 和 相关 build.properties 文 件 
build.xml 


<?xml version="1.0"?> 
<project name="Hello World Project" default="info"> 
<property file="build.properties"/> 
<target name="info"> 
<echo>Apache Ant version is ${ant.version} - You are 
at ${sitename} </echo> 
</target> 
</project> 


build.properties 


# The Site Name 
sitename-www.yiibai.com 
buildversion=3.3.2 


在 上 面 的 例子 中 ， 站 点 名 是 被 映射 到 该 站 点 的 名 称 自 定义 属性 ， 可 以 声明 任意 数目 
以 这 种 方式 自 定义 属性 。 在 上 面 的 例子 中 所 列 的 另 一 个 自 定义 属性 是 buildversion， 
其 中 ， 在 这 种 情况 下 指 的 是 创建 的 版 本 。 除 上 述 者 外 ，Ant 附 带 了 一 些 预定 义 的 构 
建 属性 ， 它 已 被 列 入 上 一 节 中 ， 但 下 面 是 代表 一 次 。 


属性 
ant.file 


ant.version 
basedir 
ant.java.version 
ant.project.name 


ant.project.default- 
target 


ant.project.invoked- 
targets 


ant.core.lib 


ant.home 


ant.library.dir 


The full location of the build file 
The version of the Apache Ant installation 


The basedir of the build, as specified in the basedir 
attribute of theproject element. 


The version of the JDK that is used by Ant. 


The name of the project, as specified in the name 
atrribute of theproject element. 


The default target of the current project 

Comma separated list of the targets that were invoked 
in the current project 

The full location of the ant jar file 

The home directory of Ant installation 


The home directory for Ant library files - typically 
ANT HOME!/lib folder. 


在 本 节 的 例子 中 ， 我 们 使 用 内 置 的 属性 ant.version。 


Ant 数 据 类 型 - ANT 


Ant 提 供 了 一 些 预 定义 的 数据 类 型 。 不 要 混淆 ， 也 可 在 编程 语言 中 的 数据 类 型 ， 而 
是 考虑 数据 类 型 的 设置 被 内 置 到 产品 中 服务 。 


下 面 是 一 个 由 Apache Ant 的 提供 的 数据 类 型 的 列表 


文件 集合 


该 文件 集 的 数据 类 型 表示 文件 的 集合 。 该 文件 集 的 数据 类 型 通常 是 作为 一 个 过 滤 
器 ， 以 包括 和 排除 匹配 特定 模式 的 文件 。 


例如 : 


<fileset dir="${src}" casesensitive="yes"> 
«include namez"**/*,java"/» 
«exclude namez"**/*Stub*"/» 

</fileset> 


在 上 面 的 例子 中 的 src 属 性 指向 项 目的 源 文件 夹 。 


在 上 面 的 例子 中 ， 文 件 集 的 选择 ， 除 了 那些 包含 在 其 中 单词 “Stub” 源 文件 夹 中 的 所 
有 java 文 件 。 在 大 小 写 敏 感 的 过 滤器 应 用 到 文件 集 这 意味 着 名 为 Samplestub.java 一 
个 文件 不 会 被 排除 在 文件 集 


模式 集 


一 个 模式 集 是 一 个 模式 ， 可 以 非常 方便 地 逢 选 基 于 某 种 模式 的 文件 或 文件 夹 。 可 以 
使 用 下 面 的 元 字符 来 创建 模式 。 


e ?- 只 匹配 一 个 字符 
a 匹配 需 个 或 多 个 字符 
e ** - LACS RST A HR A 


下 面 的 例子 应 该 给 一 个 模式 集 的 用 法 的 想法 。 


<patternset id="java.files.without.stubs"> 
«include name="src/**/*.java"/> 
<exclude name="src/**/*Stub*"/> 
</patternset> 


patternset 可 以 用 一 个 文件 集 重用 如 下 : 


<fileset dir="${src}" casesensitive="yes"> 
«patternset refid="java.files.without.stubs"/> 
</fileset> 


文件 列表 
在 文件 列表 的 数据 类型 类 似 设置 ， 除 了 在 文件 列表 中 包含 显 式 命名 的 文件 列表 ， 不 
支持 通配符 的 文件 


文件 列表 和 文件 组 的 数据 类 型 之 间 的 另 一 个 主要 区 别 是 ， 在 文件 列表 的 数据 类 型 可 
应 用 于 可 能 会 或 可 能 还 不 存在 的 文件 。 
以 下 是 文件 列表 的 数据 类 型 的 一 个 例子 
<filelist id="config.files" dir="${webapp.src.folder}"> 
«file name="applicationConfig.xml"/> 
«file name="faces-config.xml"/> 
«file namez"web.xml"/» 


«file namez"portlet.xml"/- 
</filelist> 


在 上 面 的 例子 中 webapp.src.folder 属 性 指向 该 项 目的 Web 应 用 程序 的 源 文件 夹 。 


过 滤器 集 
使 用 与 复制 任务 筛选 器 集 的 数据 类 型 ， 你 可 以 匹配 一 个 替代 值 的 模式 ， 所 有 的 文件 
替换 一 定 的 文本 。 
一 个 常见 的 例子 是 附加 版 本 号 的 发 行 说 明文 件 ， 如 下 面 的 示例 所 示 
«copy todir="${output.dir}"> 
«fileset dir="${releasenotes.dir}" includes="**/*.txt"/> 
<filterset> 
<filter token="VERSION" value="${current.version}"/> 


</filterset> 
</copy> 


在 上 面 的 例子 中 output.dir 属 性 指向 项 目的 输出 文件 夹 。 

在 上 面 的 例子 点 releasenotes.dir 属 性 的 发 行 说 明 的 项 目 文件 夹 中 。 

在 上 面 的 例子 中 current.version 属 性 指向 的 项 目的 当前 版 本 中 的 文件 夹 。 
副本 任务 ， 顾 名 思 义 是 用 来 从 一 个 位 置 复制 到 另 一 个 文件 。 


path 数据 类 型 通常 用 来 代表 一 个 类 路 径 。 在 路 笃 项 用 分 号 或 冒号 隔 开 。 然 而 ， 这 些 
字符 会 被 正在 运行 的 系统 的 路 径 分 隔 符 蔡 换 一 个 运行 时 间 。 


最 常见 的 类 路 径 设置 为 项 目 中 的 jar 文 件 和 类 的 列表 ， 如 下 面 的 例子 : 


<path id="build.classpath.jar"> 
<pathelement path="${env.J2EE_HOME}/${j2ee.jar}"/> 
«fileset dir="lib"> 
«include namez"**/*,jar"/» 
</fileset> 
</path> 


在 上 面 的 例子 中 envJ2EE_HOME 属 性 指向 环境 变量 J2EE_HOME。 
在 上 面 的 例子 中 的 j2ee.jar 属 性 指向 在 J2EE 基 础 文件 夹 J2EE 的 jar 文 件 的 名 称 。 


Ant/4 8 - ANT 

现在 ， 我 们 已 经 了 解 了 Ant 数 据 类 型 ， 现 在 是 时 候 把 这 些 转化 为 行动 。 考 虑 下 面 的 

项 目 结构 

项 目 将 形成 的 Hello World 传 真 应 用 程序 项 目 在 本 教程 的 其 余部 分 。 
C:workFaxWebApplication>tree 


Folder PATH listing 
Volume serial number is 00740061 EC1C:ADB1 


Cu. 
+---db 
+---Src 
十 faxapp 
+---dao 
+---entity 
+---util 
+---web 
+---war 
+---images 
*---js 
+---META-INF 
+---styles 
+---WEB-INF 
*---classes 
+> 5p 
+---lib 


解释 一 下 项 目 结构 。 


e 数据 库 脚本 存储 在 db 文件 夹 。 

e Java 源 代码 存储 在 src 文 件 夹 。 

e AR, JS, META-INF, #30 (CSS) 被 存储 在 war XH R. 
e JSP 被 保存 在 jsp 中 文件 夹 。 

e 第 三 方 jar 文 件 都 存储 在 lib 文 件 夹 。 

e Java 类 文件 将 被 存储 在 WEB-INF classes 文 件 夹 。 


这 个 练习 的 目的 是 建立 一 个 编译 的 java 类 ， 并 将 它们 放置 在 WEB-INF classes 文 件 
夹 Ant 文 件 。 


下 面 是 项 目 所 需 的 build.xml 文 件 。 让 我 们 看 看 它 内 容 : 


<?xml version="1.0"?> 
<project name="fax" basedir="." default="build"> 
«property name-"src.dir" value="src"/> 
«property name="web.dir" value="war"/> 
«property name="build.dir" value="${web.dir}/WEB-INF/classes"/: 
<property name="name" value="fax"/> 


<path id="master-classpath"> 
«fileset dir="${web.dir}/wWEB-INF/1ib"> 
«include name="*.jar"/> 
</fileset> 
<pathelement path="${build.dir}"/> 
</path> 


<target name="build" description="Compile source tree java file 
<mkdir dir="${build.dir}"/> 
«javac destdir="${build.dir}" source="1.5" target="1.5"> 
«src path="${src.dir}"/> 
<classpath refid="master-classpath"/> 
</javac> 
</target> 


<target name-"clean" description="Clean output directories"> 
<delete> 
«fileset dir="${build.dir}"> 
<include name="**/*.class"/> 
</fileset> 
</delete> 
</target> 
</project> 


SSS 33S 
首先 ， 让 我 们 为 源 ， 网 上 声明 某 些 属性 ， 并 建立 文件 夹 。 





<property name="src.dir" value="src"/> 
«property name="web.dir" value="war'"/> 
«property name-"build.dir" value="${web.dir}/wEB-INF/classes"/> 


在 这 个 例子 中 ， 对 于 src.dir 是 指 项 目 〈 即 ， 这 里 的 java 源 文件 可 以 找到 ) 的 源 文 件 
夹 。 


web.dir 指 的 是 项 目的 网 页 源 文 件 夹 。 在 这 里 ， 您 可 以 找到 JSP，web.xml，CSS,， 
JavaScript 和 其 他 Web 相 关 的 文件 


最 后 ，build.dir 是 指 在 项 目 编译 的 输出 文件 夹 。 


属性 可 以 参考 其 他 属性 。 如 图 所 示 ， 在 上 述 例子 中 ，build.dir 属 性 使 得 参考 web.dir 
属性 。 


在 这 个 例子 中 ， 对 于 src.dir 是 指 项 目的 源 的 文件 夹 。 


我 们 的 项 目的 默认 目标 compile 目 标 。 但 首先 ， 让 我 们 看 看 clean 目 标 。 
clean 目 标 ， 顾 名 思 义 删除 build 文 件 夹 中 的 文件 。 


<target name="clean" description="Clean output directories"> 
<delete> 
<fileset dir="${build.dir}"> 
<include name="**/*.class"/> 
</fileset> 
</delete> 
</target> 


在 主 类 路 径 保 存在 类 路 径 的 信息 。 在 这 种 情况 下 ， 它 包含 在 build 文 件 夹 中 的 类 和 在 
lib 文 件 夹 中 的 jar 文 件 。 


<path id="master-classpath"> 
«fileset dir="${web.dir}/WEB-INF/1ib"> 
«include name="*.jar"/> 
</fileset> 
<pathelement path="${build.dir}"/> 
</path> 


最 后 ， 构 建 目 标 构 建文 件 。 首 先 ， 我 们 创建 构建 目录 ， 如 果 它 不 存在 。 然 后 我 们 执 
行 javac 命 令 〈 指 定 JDK1.5 作 为 我 们 的 目标 编译 ) 。 我 们 提供 的 源 文件 夹 和 类 路 径 
javac 任 务 ， 并 要 求 它 砸 在 build 文 件 夹 中 的 类 文件 。 


<target name-"build" description="Compile main source tree java fi. 
«mkdir dir="${build.dir}"/> 
<javac destdir="${build.dir}" source="1.5" target="1.5" debug="1 
deprecation="false" optimize-"false" failonerror="true 
«src path="${sre.dir}"/> 
<classpath refid="master-classpath"/> 
</javac> 
</target> 





在 这 个 文件 运行 ant 将 编译 java 源 文件 ， 并 将 类 build 文 件 夹 中 。 
下 面 的 结果 是 运行 Ant 文 件 的 结果 : 


C:>ant 
Buildfile: C:uild.xml 


BUILD SUCCESSFUL 
Total time: 6.3 seconds 


该 文件 被 编译 并 放置 在 build.dir 文 件 夹 中 。 


Ant 构 建文 档 - ANT 


文档 是 一 个 为 任何 项 目 所 必须 的 。 文 档 在 项 目的 维护 起 到 了 极 大 的 作用 。 通 过 使 用 
内 置 的 javadoc 工 具 的 Java 使 得 文档 更 容易 。Ant 使 得 它 甚至 产生 对 需求 文档 更 容 
Ze 


如 你 所 知 ，javadoc 工 具 具 有 高 度 的 灵活 性 ， 并 人 允许 一 些 配 置 选项 。Ant 通 过 
Javadoc 任 务 公 开 这 些 配 置 选 项 。 如 果 您 不 熟悉 javadoc， 建 议 在 开始 使 用 此 Java 文 
档 教 程 。 


以 下 部 分 列 出 了 使 用 的 Ant 最 常用 的 Javadoc 选 项 。 


属性 


源 可 以 使 用 源 路 径 ，sourcepathref 或 将 源 文件 的 规定 。 源 路 径 是 用 来 指向 源 文件 
(如 src 文 件 夹 ) 的 文件 夹 。 Sourcepathref 用 于 参考 ， 是 由 路 径 属 性 (例如 ， 
delegates.src.dir) 引用 的 路 径 。 而 当 你 要 指定 的 单个 文件 以 吾 号 分 隔 的 列表 时 的 源 
文件 使 用 。 


使 用 destdir 文 件 夹 (例如 build.dir) 指定 的 目标 路 径 


你 可 以 由 指定 要 包含 在 包 名 过 滤 Javadoc 任 务 。 这 是 通过 使 用 packagenames 属 性 
来 实现 ， 用 逗号 分 隔 的 包 文 件 列表 。 


你 可 以 过 滤 javadoc 的 过 程 中 ， 只 显示 了 公共 ， 和 私有， 包装 或 保护 类 和 成 员 。 这 是 
通过 使 用 CREE) 的 私有 ， 公 共 ， 封 装 和 保护 的 属性 来 实现 。 


你 也 可 以 告诉 javadoc 的 任务 ， 包 括 使 用 相应 属性 的 作者 和 版 本 信息 。 
你 也 可 以 组 包 一 起 使 用 的 组 属性 ， 因 此 ， 它 是 易于 浏览 。 


全 部 放 在 一 起 


让 我 们 继续 我 们 的 主题 Hello world Fax 应 用 程序 。 让 我 们 添加 一 个 文件 的 目标 我 
们 的 传真 应 用 程序 项 目 。 


下 面 是 我 们 的 项 目 中 使 用 的 例子 Javadoc 任 务 。 


<target name="generate-javadoc"> 
<javadoc packagenames="faxapp.*" sourcepath="${src.dir}" 
destdir="doc" version="true" windowtitle="Fax Application": 
<doctitle><![CDATA[= Fax Application =]]></doctitle> 
<bottom> 
<![CDATA[Copyright © 2011\. All Rights Reserved. ]]> 
</bottom> 
<group title="util packages" packages="faxapp.util.*"/> 
«group title-"web packages" packages="faxapp.web.*"/> 
<group title="data packages" 
packages="faxapp.entity.*:faxapp.dao.*"/: 
</javadoc> 
<echo message="java doc has been generated!" /> 
</target> 


s] ER 


在 这 个 例子 中 ， 我 们 指定 使 用 对 于 src.dir 作 为 源 目 录 和 文档 作为 目标 目录 中 的 
javadoc。 我 们 还 定制 了 窗口 标题 ， 页 眉 和 出 现 的 Java 文 档 页 面 上 的 页 脚 信 息 。 


此 外 ， 我 们 已 经 创建 了 三 组 。 一 个 用 于 为 用 户 界 面 类 和 一 组 数据 库 相 关 类 在 我 们 的 
源 文件 夹 ， 一 组 实用 程序 类 。 你 可 能 会 注意 到 数据 包 组 有 两 个 包 - faxapp.entity 和 
faxapp.dao。 


运行 javadoc 的 Ant 任 务 现在 将 生成 并 放置 在 doc 文 件 夹 中 的 Java 文 档 文 件 。 
当 执 行 javadoc target， 它 会 产生 以 下 结果 : 





C:>ant generate-javadoc 
Buildfile: C:uild.xml 


java doc has been generated! 
BUILD SUCCESSFUL 
Total time: 10.63 second 


Java 文 档 文 件 现在 出 现在 doc 文 件 夹 。 
常情 况 下 ， 产 生 的 释放 或 包 的 目标 部 分 的 Javadoc 文 件 。 


Ant 创 建 JAR 文 件 - ANT 


编译 Java 源 文件 后 的 下 一 个 合乎 逻辑 的 步骤 ， 是 建立 在 Java 为 档 ，JAR 文 件 。 创 建 
JAR 文 件 与 Ant 用 jar 任 务 很 容易 。 以 下 展示 的 是 jar 任 务 的 常用 属性 


属性 
basedir 


compress 


keepcompression 


destfile 


duplicate 


excludes 


excludesfile 


inlcudes 
includesfile 


update 


摘 述 


The base directory for the output JAR file. By default, this 
is set to the base directory of the project. 


Advises ant to compress the file as it creates the JAR file. 


While the compress attribute is applicable to the 
individual files, thekeepcompression attribute does the 
same thing, but it applies to the entire archive. 


The name of the output JAR file 


Advises Ant on what to do when duplicate files are found. 
You could add, preserve or fail the duplicate files. 


Advises Ant to not include these comma separated list of 
files in the package. 


Same as above, except the exclude files are specified 
using a pattern. 


Inverse of excludes 
Inverse of excludesfile. 


Advises ant to overwrite files in the already built JAR file. 


继续 我 们 的 Hello World 传 真 应 用 程序 项 目 ， 让 我 们 添加 一 个 新 的 目标 ， 产 生 的 jar 文 
件 。 但 在 此 之 前 ， 让 我 们 考虑 一 下 jar 任 务 : 


<jar destfile="${web.dir}/lib/util.jar" 
basedir="${build.dir}/classes" 
includes="faxapp/util/**" 
excludes="**/Test.class" 


/> 


在 这 个 例子 中 ，web.dir 属 性 指向 的 网 页 源 文件 的 路 径 。 在 我 们 的 例子 中 ， 这 是 其 中 


的 utiljar 将 被 放置 。 


在 这 个 例子 中 ，build.dir 属 性 指向 build 文 件 夹 在 哪里 可 以 找到 util.jar 的 类 文件 。 


在 这 个 例子 中 ， 我 们 创建 了 一 个 名 为 util,jar 使 用 的 类 从 faxapp.util 一 个 jar 文 件 。* 
包 。 然 而 ， 我 们 不 包括 用 名 称 测试 结束 课程 。 输 出 的 jar 文 件 会 发 生 在 webapp 的 lib 
文件 夹 。 


如 果 我 们 想 使 utiljar 一 个 可 执行 JAR 文 件 ， 我 们 需要 添加 清单 与 主 Classmeta 属 性 。 
因此 ， 上 面 的 例子 将 被 更 新 为 : 


<jar destfile="${web.dir}/lib/util.jar" 
basedir="${build.dir}/classes" 
includes="faxapp/util/**" 
excludes="**/Test.class"> 
<manifest> 
«attribute name="Main-Class" value-"com.yiibai.util.FaxUtil", 
«/manifest» 

</jar> 





要 执行 jar 任 务 ， 一 个 目标 里 面 把 它 包 (最 常见 ， 构 建 或 包 的 目标 ， 并 运行 它们 。 


<target name="build-jar"> 

<jar destfile="${web.dir}/lib/util.jar" 
basedir="${build.dir}/classes" 
includes="faxapp/util/**" 
excludes="**/Test.class"> 
<manifest> 
«attribute name="Main-Class" value-"com.yiibai.util.FaxUtil", 
«/manifest» 

</jar> 

</target> 


BJ E) 





在 这 个 文件 运行 Ant 会 为 我 们 创建 utiljar 文 件 
下 面 的 结果 是 运行 Ant 文 件 的 结果 : 


C:>ant build-jar 
Buildfile: C:uild.xml 


BUILD SUCCESSFUL 
Total time: 1.3 seconds 


现在 的 util.jar 文 件 放 置 在 输出 文件 夹 。 


Ant 创 建 WAR 文 件 - ANT 


创建 WAR 文 件 与 Ant 是 非常 简单 ， 非 常 类 似 于 创建 JAR 文 件 的 任务 。 毕 竟 WAR 文 件 
是 像 JAR 文 件 只 是 另 一 个 ZIP 文 件 。 


WAR 任 务 是 一 个 扩展 的 JAR 任 务 ， 但 它 有 一 些 很 好 的 补充 操纵 什么 进入 的 WEB- 
INF/classes 文 件 夹 中 ， 并 生成 web.xml 文 件 。 在 WAR 的 任务 是 非常 有 用 的 指定 
WAR 文 件 的 特定 布局 。 


由 于 WAR 的 任务 是 jar 任 务 的 扩展 ，jar 任 务 的 所 有 属性 应 用 到 WAR 任 务 。 下 面 是 被 
指定 到 WAR 任 务 的 扩展 属性 : 


Attributes 描述 

webxml Path to the web.xml file 

lib A grouping to specify what goes into the WEB-INFlib folder. 
classes A grouping to specify what goes into the WEB-INFclasses folder. 
metainf Specifies the instructions for generating the MANIFEST.MF file. 


继续 我 们 Hello World 传 真 应 用 程序 项 目 ， 让 我 们 添加 一 个 新 的 目标 ， 产 生 的 jar 文 
件 。 但 在 此 之 前 ， 让 我 们 考虑 WAR 任 务 。 请 看 下 面 的 例子 : 


«war destfile="fax.war" webxml="${web.dir}/web. xm1"> 
<fileset dir="${web.dir}/webContent"> 
«include name="**/* ,*"/> 
</fileset> 
<lib dir="thirdpartyjars"> 
«exclude name="portlet.jar"/> 
</lib> 
<classes dir="${build.dir}/web"/> 
</war> 


按照 前 面 的 例子 中 ，web.dir 变 量 指 的 是 源 Web 文 件 夹 ， 即 包含 了 JSP 的 文件 夹 ， 
CSS，JavaScript 文 件 等 。 


build.dir 变 量 是 指 输出 文件 夹 - 这 是 在 哪里 可 以 找到 类 的 WAR 包 。 通 常情 况 下 ， 这 
些 类 将 被 捆绑 到 WAR 文 件 的 WEB-INF/classes 文 件 夹 中 。 


在 这 个 例子 中 ， 我 们 创建 一 个 名 为 fax.war 的 war 文 件 。 从 网 页 源 文 件 夹 中 获得 的 
web.xml 文 件 。 所 有 从 网 上 下 了 “WebContent" 文 件 夹 中 的 文件 复制 到 WAR 文 件 。 


WEB-INF/lib 文 件 夹 中 填充 了 来 自 第 三 方 的 jar 文 件 夹 中 的 jar 文 件 。 然 而 ， 我 们 不 包 
括 portlet.jar， 因 为 这 是 已 经 存在 于 应 用 服务 器 的 lib 文 件 夹 。 最 后 ， 我 们 从 构建 目录 
的 Web 文 件 夹 中 复制 所 有 的 类 和 放 入 放 在 WEB-INF/classes 文 件 夹 中 。 


SZEWARÍfEABJAntE 4; (通常 包 ) 内 ， 并 运行 它 。 这 将 在 指定 的 位 置 创 建 WAR 文 
件 。 


这 是 完全 可 以 馈 套 类 ， 库 ，metainf 和 WEBINF 董 事 ， 使 他 们 生活 在 分 散 的 文件 夹 中 
的 项 目 结构 的 任何 地 方 。 但 最 佳 实践 建议 ， 您 的 Web 项 目 应 具 各 的 Web 内 容 结构 类 
似 于 WAR 文 件 的 结构 。Fax 应 用 程序 项 目 都 有 使 用 这 个 基本 原则 概述 结构 。 


要 执行 WAR 任 务 ， 一 个 目标 里 面 把 它 包 应 (最 常见 ， 构 建 或 包 的 目标 ， 并 运行 它 
们 。 


<target name="build-war"> 
«war destfile="fax.war" webxml="${web.dir}/web. xml"> 
<fileset dir="${web.dir}/webContent"> 
«include name="**/*,*"/> 
</fileset> 
«lib dir="thirdpartyjars"> 
«exclude name="portlet.jar"/> 
«/lib» 
«classes dir="${build.dir}/web"/> 
</war> 
</target> 


在 这 个 文件 运行 Ant 会 为 我 们 创建 了 fax.war 文 件 
下 面 的 结果 是 运行 Ant 文 件 的 结果 


C:>ant build-war 
Buildfile: C:uild.xml 


BUILD SUCCESSFUL 
Total time: 12.3 seconds 


现在 的 fax.war 文 件 放 和 置 在 输出 文件 夹 。 war 文 件 的 内 容 将 是 : 


fax.war: 
*---jsp This folder contains the jsp files 
+---CSS _This folder contains the stylesheet files_ 
*t---js _This folder contains the javascript files 
*---images _This folder contains the image files 
*---META-INF _This folder contains the Manifest.Mf 
t---WEB-INF 
*---classes | This folder contains the compiled classes _ 
*---lib Third party libraries and the utility jar f: 


WEB. xml Configuration file that defines the WAR pac! 











Ant} 22 Fd - ANT 


我 们 已 经 知道 Ant 使 用 的 Hello World Fax 的 Web 应 用 程序 中 零碎 的 不 同 。 


现在 是 时 候 把 一 切 融合 在 一 起 ， 以 创建 一 个 完整 的 和 完整 的 build.xml 文 件 。 考 虑 
build.properties 和 build.xml 文 件 列表 如 下 : 


build.properties 
deploy.path=c: omcat6webapps 
build.xml 


<?xml version="1.0"?> 


<project name="fax" basedir="." default="usage"> 
<property file="build.properties"/> 
«property name-"src.dir" value="src"/> 
«property name="web.dir" value="war'"/> 
«property name="javadoc.dir" value="doc"/> 
«property name="build.dir" value="${web.dir}/wWEB-INF/classes"/: 
<property name="name" value="fax"/> 


<path id="master-classpath"> 
«fileset dir="${web.dir}/wEB-INF/1ib"> 
«include name="*.jar"/> 
</fileset> 
<pathelement path="${build.dir}"/> 
</path> 


<target name="javadoc"> 
<javadoc packagenames-"faxapp.*" sourcepath="${src.dir}" 
destdir="doc" version="true" windowtitle="Fax Application"> 
<doctitle><! [CDATA[<h1>= Fax Application 
=</h1>]]></doctitle> 
<bottom><![CDATA[Copyright © 2011\. All 
Rights Reserved. ]]></bottom> 
«group title-"util packages" packages="faxapp.util.*"/> 
«group title-"web packages" packages-"faxapp.web.*"/» 
«group title-"data packages" 
packages="faxapp.entity.*:faxapp.dao.*"/> 
</javadoc> 
</target> 


«target name="usage"> 


<echo message=""/> 

<echo message="${name} build file"/> 

«echo message="----------------------------------- "/> 

<echo message=""/> 

«echo message-"Available targets are:"/» 

«echo message=""/> 

«echo message="deploy --» Deploy application 
as directory"/> 

«echo message-"deploywar --» Deploy application 
as a WAR file"/» 

«echo message=""/> 

«/target» 


«target name-"build" description="Compile main 
source tree java files"> 
«mkdir dir="${build.dir}"/> 
«javac destdir="${build.dir}" source="1.5" 
target="1.5" debug="true" 
deprecation="false" optimize-"false" failonerror="true"> 
«src path="${src.dir}"/> 
<classpath refid="master-classpath"/> 
</javac> 
</target> 


<target name="deploy" depends="build" 
description="Deploy application"> 
<copy todir="${deploy.path}/${name}" 
preservelastmodified="true"> 
«fileset dir="${web.dir}"> 
<include name="**/*.*"/> 
</fileset> 
</copy> 
</target> 


<target name="deploywar" depends="build" 
description="Deploy application as a WAR file"> 
<war destfile="${name}.war" 
webxml="${web.dir}/wEB-INF/web. xmL"> 
«fileset dir="${web.dir}"> 
«include name="**/*.*"/> 
</fileset> 
</war> 
<copy todir="${deploy.path}" preservelastmodified="true"> 
<fileset dir="."> 
«include namez"*.war"/» 
</fileset> 
</copy> 
</target> 


<target name-"clean" description="Clean output directories"> 
<delete> 
«fileset dir="${build.dir}"> 
<include name="**/*.class"/> 


</fileset> 
</delete> 
</target> 


</project> 
‘| — g 


在 这 个 例子 中 ， 我 们 首先 声明 的 路 径 的 webapps 文 件 夹 中 的 Tomcat 在 生成 属性 文件 
作为 deploy.path 变 量 。 我 们 还 声明 的 源 文件 夹 src.dir 的 变量 的 java 文 件 。 然 后 我 们 
声明 的 源 文件 夹 中 web.dir 变 量 的 网 页 文件 。 javadoc.dir 是 用 于 存储 Java 文 档 的 文 
件 夹 ，build.dir 是 用 于 存储 生成 的 输出 文件 的 路 径 。 


然后 我 们 声明 的 Web 应 用 程序 ， 这 是 Fax 在 我 们 的 例子 中 的 名 称 。 


我 们 还 定义 了 主 类 路 径 的 conains 存 在 于 项 目的 WEB-INFWib 文 件 夹 中 的 JAR 文 件 。 
我 们 还 包括 了 类 文件 呈现 在 build.dir 在 主 类 路 径 


Javadoc 的 目标 生产 项 目 所 需 的 Javadoc 和 使 用 对 象 是 用 来 打印 ， 是 目前 在 构建 文 
件 的 共同 目标 。 


上 面 的 例子 显示 了 两 个 部 署 目标 - 部 署 和 deploywar 目 标 


部 署 目标 文件 从 web 目 录 下 的 文件 复制 到 deploy 目 录 保 留 最 后 修改 的 日 期 时 间 玲 
记 。 部 署 到 支持 热 部 署 一 台 服 务 器 时 ， 这 是 很 有 用 的 。 


clean 目 标清 除 所 有 先前 建立 的 文件 。 
部 署 war 目 标 构 建 war 文 件 ， 然 后 复制 war 文 件 到 应 用 服务 器 的 部 署 目录 。 








Ant 部 署 应 用 程序 - ANT 


在 前 面 的 章节 中 ， 我 们 已 经 学 会 了 如 何 打包 应 用 程序 并 将 其 部 署 到 一 个 文件 夹 中 。 
在 这 个 例子 中 ， 我 们 打算 把 它 更 进一步 。 


我 们 要 部 署 Web 应 用 程序 直接 到 应 用 程序 的 服务 器 的 部 署 文件 夹 ， 然 后 我 们 将 添加 
一 些 Ant 目 标 来 启动 和 停止 服务 。 让 我 们 继续 的 Hello World 传 真 的 Web 应 用 程序 。 
这 是 一 个 延续 前 一 章 ， 新 元 件 在 突出 红色 


build.properties 


# Ant properties for building the springapp 


appserver .home=c: \install\apache-tomcat-7.0.19 
# for Tomcat 5 use $appserver.home}/server/1lib 
# for Tomcat 6 use $appserver.home)/lib 
appserver .lib=${appserver .home}/1lib 


deploy.path=${appserver.home}/webapps 


tomcat.manager.url-http://www.yiibai.com:8080/manager 
tomcat.manager.username-yiibai 
tomcat.manager.password-secret 


build.xml 


<?xml version="1.0"?> 


<project name="fax" basedir="." default="usage"> 
<property file="build.properties"/> 
«property name-"src.dir" value="src"/> 
«property name="web.dir" value-'war"/» 
«property name="javadoc.dir" value="doc"/> 
«property name="build.dir" value="${web.dir}/wWEB-INF/classes"/: 
<property name="name" value="fax"/> 


<path id="master-classpath"> 
«fileset dir="${web.dir}/wEB-INF/1ib"> 
«include name="*.jar"/> 
</fileset> 
<pathelement path="${build.dir}"/> 
</path> 


<target name="javadoc"> 


«javadoc packagenames-"faxapp.*" sourcepath="${src.dir}" 
destdir="doc" version="true" windowtitle="Fax Application"> 
<doctitle><! [CDATA[<h1>= Fax Application 
=</h1>]]></doctitle> 
«bottom»«![CDATA[Copyright © 2011\. All 
Rights Reserved. ]]></bottom> 
<group title="util packages" packages="faxapp.util.*"/> 
«group title-"web packages" packages-"faxapp.web.*"/» 
«group title-"data packages" 
packages="faxapp.entity.*:faxapp.dao.*"/> 
</javadoc> 
</target> 


<target name="usage"> 
<echo message=""/> 
<echo message="${name} build file"/> 
«echo message=""----------------------------------- ye 
<echo message=""/> 
«echo message-"Available targets are:"/» 
«echo message=""/> 
«echo message="deploy --» Deploy application 
as directory"/> 
«echo message-"deploywar --» Deploy application 
as a WAR file"/» 
«echo message=""/> 
«/target» 


«target name="build" description="Compile main 
source tree java files"> 
<mkdir dir="${build.dir}"/> 
<javac destdir="${build.dir}" source="1.5" 
target="1.5" debug="true" 
deprecation-"false" optimize-"false" failonerror="true"> 
«src path="${srce.dir}"/> 
«classpath refid="master-classpath"/> 
</javac> 
</target> 


<target name="deploy" depends="build" 
description="Deploy application"> 
«copy todir="${deploy.path}/${name}" 
preservelastmodified="true"> 
<fileset dir="${web.dir}"> 
«include name="**/*.*"/> 
</fileset> 
</copy> 
</target> 


<target name="deploywar" depends="build" 
description="Deploy application as a WAR file"> 
<war destfile="${name}.war" 
webxml="${web.dir}/wEB-INF/web. xmL"> 
<fileset dir="${web.dir}"> 


«include name="**/*,*"/> 
</fileset> 
</war> 
<copy todir="${deploy.path}" preservelastmodified="true"> 
<fileset dir="."> 
«include name="*.war"/> 
</fileset> 
</copy> 
</target> 


«target name="clean" description="Clean output directories"> 
<delete> 
<fileset dir="${build.dir}"> 
«include name="**/*.class"/> 
</fileset> 
</delete> 
</target> 


7 | 


<path id="catalina-ant-classpath"> 
<!-- We need the Catalina jars for Tomcat --> 
«!-- * for other app servers - check the docs --> 
«fileset dir="${appserver .lib}"> 
<include name="catalina-ant.jar"/> 
</fileset> 
</path> 


<taskdef name="install" 
classname="org.apache.catalina.ant.InstallTask"> 
<classpath refid="catalina-ant-classpath"/> 

</taskdef> 

<taskdef name="reload" 
classname="org.apache.catalina.ant.ReloadTask"> 
<classpath refid="catalina-ant-classpath"/> 

</taskdef> 

«taskdef name="list" 
classname="org.apache.catalina.ant.ListTask"> 
<classpath refid="catalina-ant-classpath"/> 

</taskdef> 

«taskdef name="start" 
classname="org.apache.catalina.ant.StartTask"> 
<classpath refid="catalina-ant-classpath"/> 

</taskdef> 

<taskdef name="stop" 
classname="org.apache.catalina.ant.StopTask"> 
<classpath refid="catalina-ant-classpath"/> 

</taskdef> 


<target name="reload" description="Reload application in Tomcat 
«reload url="${tomcat .manager.url}" 
username="${tomcat.manager .username}" 
password="${tomcat.manager .password}" 
path="/${name }"/> 
</target> 
</project> 


n ————————— eee 


在 本 练习 中 ， 我 们 使 用 Tomcat 作 为 我 们 的 应 用 服务 器 。 首 先 ， 在 构建 属性 文件 中 ， 
我 们 定义 了 一 些 附 加 属性 。 


e appserver.home 应 用 指向 安装 路 径 到 Tomcat 应 用 服务 器 。 
e appserver.lib 指 向 Tomcat 的 安装 文件 夹 中 的 库 文件 。 
e deploy.path 变 量 现在 指向 Tomcat 中 的 web 应 用 文件 夹 。 





在 Tomcat 中 的 应 用 程序 可 以 停止 和 startedusing Tomcat 管 理应 用 程序 。 也 是 在 
build.properties 文 件 中 指定 的 URL 管 理 器 应 用 程序 ， 使 用 用 户 名 和 密码 。 接 下 来 我 
们 声明 一 个 新 的 CLASSPATH 中 包含 catalina-ant.jar 文 件 。 这 个 jar 文 件 是 必需 通过 
Apache Ant 来 执行 Tomcat 任务 。 


catalina-ant jar 文件 提供 了 以 下 任务 : 


Properties 描述 
InstallTask Installs a web application. Class Name: 


org.apache.catalina.ant.InstallTask 


Reload a web application. Class Name: 


Poor org.apache.catalina.ant.ReloadTask 

Herak Lists all web applications. Class Name: 
org.apache.catalina.ant.ListTask 
Starts a web application. Class Name: 

> a org.apache.catalina.ant.StartTask 
Stops a web application. Class Name: 

dio org.apache.catalina.ant.StopTask 

Reload Task Reloads a web application without stopping. Class Name: 


org.apache.catalina.ant.ReloadTask 


重 装 任务 需要 以 下 附加 参数 。 


e 1) URL 到 管理 器 应 用 程序 2) 用 户 名 重新 启动 Web 应 用 程序 3) 密码 重新 启动 
Web 应 用 程序 重新 启动 Web 应 用 程序 4) 名 称 


让 我 们 发 出 的 deploy-war 命 令 的 web 应 用 程序 复制 到 Tomcat 的 webapps 文 件 夹 中 ， 
然后 让 我 们 重新 加 载 该 传真 的 Web 应 用 程序 。 下 面 的 结果 是 运行 Ant 文 件 的 结果 : 


C:>ant deploy-war 
Buildfile: C:uild.xml 


BUILD SUCCESSFUL 
Total time: 6.3 seconds 


C:>ant reload 
Buildfile: C:uild.xml 


BUILD SUCCESSFUL 
Total time: 3.1 seconds 


一 旦 上 述 任务 运行 时 ，Web 占 用 程序 部 署 和 Web 应 用 程序 重新 加 载 。 


Ant 执 行 Java 代 码 - ANT 


您 可 以 使 用 Ant 来 执行 java 代 码 。 在 下 面 这 个 例子 中 ，java 类 中 取 一 个 参数 (管理 员 
的 电子 邮件 地 址 ) ， 并 发 送 了 一 封 电子 邮件 。 


public class NotifyAdministrator 
{ 
public static void main(String[] args) 
{ 
String email = args[0]; 
notifyAdministratorviaEmail(email); 
System.out.println("Administrator "-email-" has been notified" 


} 


public static void notifyAdministratorviaEmail(String email) 





下 面 是 执行 这 个 java 类 简单 的 构建 。 


<?xml version="1.0"?> 
«project name="Sample" basedir="." default="notify"> 
<target name="notify"> 
«java fork="true" failonerror="yes" classname="NotifyAdministré 
«arg line="admin@test.com"/> 
</java> 
</target> 
</project> 


LEN a 





当 执 行 构建 时 ， 它 会 产生 以 下 结果 : 
C:>ant 


Buildfile: C:uild.xml 


notify: 
[java] Administrator admin@test.com has been notified 


BUILD SUCCESSFUL 
Total time: 1 second 


在 这 个 例子 中 ，java 代 码 做 一 个 简单 的 事情 - 发 送 电 子 邮 件 。 我 们 也 可 以 使 用 内 置 
的 Ant 任 务 来 做 到 这 一 点 。 不 过 ， 现 在 你 已 经 得 到 了 你 的 想法 可 以 扩展 你 的 构建 文 
件 来 调用 java 代 码 执 行 复杂 的 东西 ， 例 如 : 加 密 你 的 源 代 码 。 


Ant 和 Eclipse 集成 - ANT 

如 果 您 已 经 下 载 并 已 经 安装 了 Eclipse， 你 很 少 做 上 手 。 Eclipse 中 预 装 捆绑 在 一 起 
的 Ant 的 插件 ， 随 时 供 您 使 用 。 

按照 简单 的 步骤 ， 到 Ant 集 成 到 Eclipse 中 。 


e 确保 build.xml 文 件 就 是 java 项 目的 一 部 分 ， 并 没有 生活 在 一 个 位 置 ， 是 外 部 的 
项 目 。 


通过 将 启用 Ant 视 图 Window > Show View > Other > Ant > Ant 
e 打开 项 目 资 源 管 理 器 中 ， 拖 动 的 build.xml 到 Ant 祝 图 
Ant 视 图 中 显示 现在 看 起 来 类 似 于 : 


«o4 QO xX % 
& sm 
=- @ build 
(€ dean 
由 & usage [default] 


md E build / clean / usage 将 运行 Ant 你 的 目标 。 
点 击 "fax" ， 将 执行 默认 的 目标 - usage 


Ant 的 Eclipse 插件 还 附带 了 一 个 很 好 的 编辑 器 来 编辑 的 build.xml 文 件 。 该 编辑 器 是 
知 道 的 build. xml 架 构 ， 可 以 帮助 您 提供 代码 完成 。 


要 使 用 Ant 编 辑 器 ， 右 键 单 击 您 的 build.xml (从 项 目 资源 管理 器 ) ， 然 后 选择 打开 
方式 >Ant Editor, Ant Editor 应 该 loook 类 似 于 : 


F bulld.xml. 名 = O] F outline £3 \ [E] Taklit 
i ^ HOS CN 
= t Fax 


<project name="fax" basedir="." default="usage"> 


D> file=bulld. properties 
(property file="huild.properties"/> ae eke 

D web.dir 
«property name-"src.dir" value*"src"/» > buld.dr 
<property nare-"yeb.dir" value="war"/> emia 
«property n&me*"build.dir" valuee"$i(web.dir WEB-INF/ -<> master-dasspath 
(property name="name” value="fax"/> z & usage [defaut] 
«path id*"master lasspath"> 4 @ buid 

+ @ clean 


«fileset dir="$(web.dir) /VEB-INF/ lib"> 
«include neme="*.jar"/> 
</fileset> 
<pathelement path="Si{build.dir 
</path> 


A eo 


P anatina | MP masses | Nd naba Ea uea Fimlanar | Kl Eninaate 


Ant 编辑 器 列 出 了 右手 边 的 目标 ， 该 目标 列表 作为 一 个 书签 ， 让 你 直接 跳 到 编辑 特 
定 的 目标 。 


Ant Junit 集 成 - ANT 


JUnit 是 基于 Java 常 用 的 单元 测试 框架 进行 开发 。 


它 是 易于 使 用 和 易于 延伸 。 有 许 


多 JUnit 扩 展 可 用 。 如 果 你 不 熟悉 Junit 的 ， 你 应 该 从 www.junit.org 下 载 JUnit 和 阅读 


JUnit 的 使 用 手册 。 
本 教程 讨论 了 关于 执行 使 用 Ant 的 JUnit 测 试 。Ant 通过 


单 。 


这 个 简单 Junit 的 任务 变 得 简 


以 下 展示 的 是 JUnit 任务 的 属性 。 


Properties 
dir 
jvm 
fork 
errorproperty 
failureproperty 
haltonerror 
haltonfailure 
printsummary 


showoutput 


tempdir 


timeout 


描述 


Where to invoke the VM from. This is ignored when fork is 
disabled. 


Command used to invoke the JVM. This is ignored when 
fork is disabled. 


Runs the test in a separate JVM 

The name of the property to set if there is a Junit error 
The name of the property to set if there is a Junit failure 
Stops execution when a test error occurs 

Stops execution when a failure occurs 

Advices Ant to display simple statistics for each test 
Adivces Ant tosend the output to its logs and formatters 
Path to the temporary file that Ant will use 


Exits the tests that take longer to run than this setting (in 
milliseconds). 


让 我 们 继续 的 Hello World fax web 应 用 程序 的 主题 ， 并 添加 一 个 JUnit 目 标 。 
下 面 的 例子 展示 了 一 个 简单 的 JUnit 测 斌 执行 


<target name="unittest"> 
<junit haltonfailure="true" printsummary="true"> 
<test name="com.yiibai.UtilsTest"/> 
</junit> 
</target> 


上 面 的 例子 显示 的 Junit 对 com.yiibai.UtilsTest JUnit 类 执行 。 运 行 上 面 
输出 


会 产生 下 面 的 


test: 


[echo] Testing the application 
[junit] Running com.yiibai.UtilsTest 


[junit] Tests run: 12, Failures: ©, Errors: ©, Time elapsed: 16.2 : 
BUILD PASSED 


| P 





»] 





POI 教 程 


很 多 时 候 ， 一 个 软件 应 用 程序 需要 生成 Microsoft Excel 文 件 格式 的 报告 。 有 时 ， 一 
个 应 用 程序 其 至 希望 怪 Excel 文 件 作 为 输入 数据 。 例 如 ， 一 个 公司 开发 的 应 用 程序 
将 财务 部 门 需要 所 有 输出 生成 自己 的 Excel。 


任何 Java 程 序 员 愿意 将 MS Office 文 件 的 输出 ， 可 以 使 用 预定 义 和 只 读 API 来 做 到 。 


什么 是 Apache POI ? 


Apache POI 是 一 种 流行 的 APl， 它 允许 程序 员 使 用 Java 程 序 创 建 ， 修 改 和 显示 MS 
Office 文 件 。 这 由 Apache 软 件 基金 会 开发 使 用 Java 分 布 式 设计 或 修改 Microsoft 
Office 文 件 的 开源 库 。 它 包含 类 和 方法 对 用 户 输入 数据 或 文件 到 MS Office 文 档 进行 
解码 。 


Apache POI 组 件 


Apache POI 包 含 类 和 方法 ， 来 将 MS Office 所 有 OLE 2 文档 复合 。 此 API 组 件 的 列表 
如 下 。 


POIFS ( 较 差 混淆 技术 实现 文件 系统 ) : 此 组 件 是 所 有 其 他 POI 元 件 的 基本 因 
素 。 它 被 用 来 明确 地 污 取 不 同 的 文件 。 


HSSF (可 怕 的 电子 表格 格式 ) : 它 被 用 来 读 取 和 写 入 MS-Excel 文 件 的 xls 格 式 。 
XSSF (XML 格 式 ) : 它 是 用 于 MS-Excel 中 XLSX 文 件 格 式 。 
HPSF (可 怕 的 属性 设置 格式 ) : 它 用 来 提取 MS-Office 文 件 属性 设置 。 


HWPF (可 怕 的 字 处 理 器 格式 ) : 它 是 用 来 读 取 和 写 入 MS-Word 的 文档 扩展 名 的 
文件 。 


XWPF (XML 字 处 理 器 格式 ) : 它 是 用 来 读 取 和 写 入 MS-Word 的 docx 扩 展 名 的 文 
件 。 


HSLF (可 怕 的 幻灯 片 版 式 格式 ) : 它 是 用 于 读 取 ， 创 建 和 编辑 PowerPoint 演 示 
文稿 。 


HDGF (可 怕 的 图 表格 式 ) : 它 包含 类 和 方法 为 MS-Visio 的 二 进 制 文件 。 
HPBF (可 怕 的 出 版 商 格式 ) : 它 被 用 来 读 取 和 写 入 MS-Publisher 文 件 。 


本 教程 将 指导 使 用 Java Excel 文 件 完成 工作 过 程 。 因 此 ， 本 教程 仅 限 于 HSSF 和 
XSSF 组 件 。 


SX 
X: 


旧版 本 的 POI 支 持 二 进 制 文件 格式 ， 如 DOC，XLS，PPT 等 从 版 本 3.5 起 ，POI 


支持 微软 Office 的 OOXML 文 件 格 式 ， 如 DOCX，XLSX，PPTX 等 。 


如 Apache POI， 还 有 由 不 同 的 供应 商 为 Excel 文 件 的 生成 提供 的 其 他 库 。 这 些 措施 
包括 Aspose 面 向 Java 的 Aspose，JXL 通过 共享 库 由 JExcel 团 队 开发 。 


Apache POI - Java Excel APIs - POI 教 程 


本 章 将 介绍 一 些 Java ExcelAPI 和 它们 的 特征 。 有 许多 厂商 谁 提供 Java Excel 相 关 的 
APl; 其 中 一 些 将 在 这 一 章 中 讨论 。 


Java Aspose Cells 


Java Aspose Cells 是 一 种 纯粹 的 Java 授 权 的 Excel API， 开 发 和 供应 商 Aspose 发 
布 。 这 个 API 的 最 新 版 本 是 8.1.2， 发 布 于 2014 年 7 月 ， 是 一 个 丰富 而 厚重 的 API( 普 
通 Java 类 和 AWT 类 的 组 合 ) 设 计 ， 可 以 读 、 写 和 操纵 电子 表格 Excel 的 组 件 。 此 API 
常见 用 途 如 下 : 


Excel 报 表 ， 建 立 动态 Excel 报 表 

高 保 真 的 Excel 泻 染 和 打印 

从 Excel 电 子 表 格 中 导入 和 导出 数据 
生成 ， 编 辑 ， 转 换 和 电子 表格 


JXL 


JXL 是 一 款 专 为 Selenium 第 三 方 框架 ， 支 持 基 于 Web 浏 览 器 (数据 是 Web 浏 览 器 自动 
更 新 ) 数 据 驱 动 的 自动 化 。 然 而 ， 它 也 被 用 来 作为 JExcel API 的 一 个 共同 的 支持 库 ， 
因为 它 的 基本 功能 是 可 创建 ， 读 取 和 写 入 电子 表格 。 基 本 特征 如 下 : 


e 生成 Exce| 文 件 
e. 从 工作 簿 和 电子 表格 导入 数据 
e. 获得 行 和 列 的 总 数 


注意 : JXL 只 支持 xls 档 案 格 式 ， 并 且 不 能 处 理 大 数据 量 。 


JExcel 


JExcel 是 由 Team Dev 开 发 提供 纯 行货 API。 利 用 这 一 点 程序 员 可 以 很 容易 地 污 取 ， 
宇 入 ， 显 示 和 修改 Excel 工 作 簿 中 的 两 种 格式 : .xls 和 .XLSX。 这 个 API 可 以 很 容易 地 
棒 入 Java 的 Swing 和 AWT。 这 个 API 的 最 新 版 本 是 Jexcel-2.6.12， 发 布 于 2009 年 ， 
主要 特点 如 下 。 


e 自动 化 Excel 应 用 程序 ， 工 作 筹 ， 工 作 表 等 

e 在 Java Swing 应 用 程序 作为 普通 的 Swing 组 件 戏 入 到 工作 簿 
e 事件 侦 听 器 添加 到 工作 筹 和 电子 表格 

e. 添加 事件 处 理 程 序 来 处 理 的 工作 筹 和 电子 表格 事件 的 行为 
e. 添加 本 地 对 等 开发 定制 功能 


Apache POI 


Apache POI 是 Apache 软 件 基 金 会 提供 的 100% 开 源 库 。 大 多 数 中 小 规模 的 应 用 程 
序 开 发 主要 依赖 于 Apache POI (HSSF+ XSSF) 。 它 支持 Excel 库 的 所 有 基本 功 
能 ; 然而 ， 呈 现 和 文本 提取 是 它 的 主要 特点 。 


es Create Charts 
* Apply Formats 
* Apply Formulae 


Apache POI 


(HSSF+XSSF) 


e ResultSet 
es Arrays 
* Collections 


Rendering 


Set Print Area 
Print Spreadsheets 
Print Workbooks 
Print Formulae 





Apache POI 环 境 设置 - POI 教 程 


本 章 将 指导 完成 Apache POI 在 Windows 和 Linux 系 统 为 基础 的 设置 过 程 。 Apache 
POI 可 以 轻松 地 安装 和 集成 ,下 面 没 有 任何 复杂 的 设置 过 程 ,通过 几 个 简单 步骤 ， 目 前 
Java 环 境 ， 用 户 管理 是 必需 安装 的 。 


JDK Java SE 2 JDK 1.5 或 以 上 
AF 1 GB RAM (推荐 ) 

磁盘 空间 没有 最 小 要 求 

操作 系统 版 本 Windows XP 或 以 上 , Linux 


现在 让 我 们 继续 安装 Apache POI 的 步骤 。 


第 1 步 : 验证 Java 安 装 
首先 ， 需 要 在 系统 上 安装 Java 软 件 开发 工具 包 (SDK)。 为 了 验证 这 一 点 ， 执 行 任何 
根据 使 用 的 平台 上 的 以 下 两 个 命令 。 


如 果 Java 安 装 已 完成 正确 ， 那 么 它 会 显示 Java 安 装 的 当前 版 本 和 规范 。 样 本 输出 给 
FRA, 


平台 命 全 样本 输出 


Java version "1.7.0 60" Java (TM) SE 
打开 命令 控制 台 然 后 键 Run Time Environment (build 


Windows A: 1.7.0 60-b19) Java Hotspot (TM) 64- 
N&gt;java -version bit Server VM (build 24.60-b09, mixed 
mode) 
java version "1.7.0 25" Open JDK 
TT Runtime Environment (rhel- 
fps ZR 22 
Linux FT Fons 2m, A 2.3.10.4.e6 4-x86 64) Open JDK 64- 


Wee cuneo Bit Server VM (build 23.7-b01, mixed 


mode) 


e 我 们 假设 本 教程 的 读者 安装 的 是 Java SDK 版 本 1.7.0_60 安 装 在 他 们 的 系统 中 。 


e 如 果 没 有 Java SDK, M 
http://www.oracle.com/technetwork/java/javase/downloads/index.html 下 载 其 
当前 版 本 并 安装 它 。 


第 2 步 : 设置 Java 环 境 


设置 环境 变量 JAVA_HOME 指 向 安装 了 机 器 上 Java 的 基本 目录 位 置 。 例 如 ， 


平台 描述 
Windows Set JAVA HOME to C:\ProgramFiles\java\jdk1.7.0_60 
Linux Export JAVA_HOME=/usr/local/java-current 


添加 Java 编 译 器 位 置 的 完整 路 径 到 系统 路 径 。 


平台 描述 
Windows Linux 


添加 字符 串 "C:\Program 
Files\Java\jdk1.7.0_60\bin" 到 系统 环境 变 
量 PATH 的 尾部 。 


Export 
PATH=$PATH:$JAVA_HOME/bin/ 


从 命令 提示 符 下 执行 命令 java-version 如 上 所 述 。 


第 3 步 : 安装 Apache POL 


从 http://poi.apache.org/download.htmll 下 载 Apache POI 的 最 新 版 本 ， 并 解压 缩 所 
需要 的 库 ， 可 以 链接 到 Java 程 序 的 文件 夹 。 我 们 假设 该 文件 在 C 意 的 文件 夹 中 。 


下 面 的 图 像 显 示 所 下 载 的 文件 夹 内 的 目录 和 文件 结构 。 











E docs 
Jk lib e folde 
Jj ooxml-lib 8/8/20142:24PM_ File folder 
|.) LICENSE 11/25/2012 3:23PM File 
|. NOTICE 11/25/2012 323PM — File B 
| £5 poi-3.9-20121203 jar 11/26/2012 5:22 PM — Executable Jar File 1,826 KB 
d docs |S) poi-examples-3.9-20121203.jar 11/26/2012 5:22PM — Executable Jar File KB 
Ak lib [É poi-excelant-3.9-20121203 jar 11/26/2012 22 PM — Executable Jar File 
J|». ooxml-lib |S) poi-ooxml-3.9-20121203 jar 11/26/2012 22 PM — Executable Jar File 
|S) poi-ooxml-schemas-3.9-20121203.jar 11/26/2012 $22 PM — Executable Jar File 4,691 KB 
|S) poi-scratchpad-3.9-20121203.jar 11/26/2012 22 PM — Executable Jar File 1,198 KB 
4 | poi-39 
d docs 
E 
[éj stax-api-1.0.1 jar 2/23/2011 12:31PM — Executable Jar File 26 KB 








[é| xmlbeans-2.3 0 jar 4/5/20092:29PM Executable Jar File 2,605 KB 





添加 的 五 个 jar 文 件 的 完整 路 径 ， 在 上 面 的 图 片 路 径 到 CLASSPATH。 
Windows: 添加 以 下 字符 串 到 用 户 变 量 的 末尾 


CLASSPATH: 

“C:\poi-3.9\poi-3.9-20121203.jar;” 
“C:\poi-3.9\poi-ooxml-3.9-20121203.jar;” 
“C:\poi-3.9\poi-ooxml-schemas-3.9-20121203.jar;” 
“C:\poi-3.9\ooxml-1lib\dom4j-1.6.1.jar;” 
"C:Npoi-3.9Nooxml-libNxmlbeans-2.3.0.jar;.;" 


Linux: 


Export CLASSPATH=$CLASSPATH: 
/Uusr/share/poi-3.9/poi-3.9-20121203.tar: 
/Uusr/share/poi-3.9/poi-ooxml-schemas-3.9-20121203.tar: 
/Uusr/share/poi-3.9/poi-ooxml-3.9-20121203.tar: 
/usr/share/poi-3.9/ooxml-lib/dom4j-1.6.1.tar: 
/usr/share/poi-3.9/ooxml-lib/xmlbeans-2.3.0.tar 


到 这 里 ， 整 个 POI 环 境 设 置 已 经 完成 ， 下 一 节 我 们 来 学 习 如 何 使 用 。 


POI 核 心 类 - POI 教 程 


本 章 介 绍 了 Apache POI 的 API， 它 是 至 关 重 要 的 工作 ， 使 用 Java 程 序 操作 Excel 文 
件 有 下 面 几 个 类 和 方法 。 


THES 


这 是 创建 或 维护 Excel 工作 簿 的 所 有 类 的 超 接口 。 它 属于 
org.apache.poi.ss.usermodel 包 。 是 实现 此 接口 的 两 个 类 ， 如 下 所 示 : 


e HSSFWorkbook : 这 个 类 有 读 取 和 .xls 格式 和 写 入 Microsoft Exce| 文 件 的 方 
法 。 它 与 微软 Office97-2003 版 本 兼容 。 


e XSSFWorkbook : 这 个 类 有 读 写 Microsoft Excel 和 OpenOffice 的 XML 文件 的 格 
式 .xls 或 .xlsx 的 方法 。 它 与 MS-Office 版 本 2007 或 更 高 版 本 兼容 。 


HSSFWorkbook 


它 是 在 org.apache.poi.hssf.usermodel 包 的 高 层次 的 类 。 它 实现 了 Workbook 接 
口 ， 用 于 Excel 文 件 中 的 .xls 格 式 。 下 面 列 出 的 是 一 些 本 类 下 的 方法 和 构造 男 数 。 


类 的 构造 画 数 


S.No. ERAAN BA 


1 HSSFWorkbook() 从 头 开始 创建 一 个 新 的 HSSFWorkbook 对 象 时 。 
HSSFWorkbook(DirectoryNode directory, boolean 
2 preserveNodes) 创建 一 个 特定 的 目录 中 一 个 新 的 HSSFWworkbook 对 


o 


HSSFWorkbook(DirectoryNode directory, POIFSFileSystem fs, 


3 boolean preserveNodes) 给 定 一 个 POIFSFileSystem 对 象 和 特定 的 
目录 中 ， 它 创建 了 一 个 SSFWorkbook 对 象 读 取 指 定 的 工作 筹 。 

4 HSSFWorkbook(java.io.InputStream s) 创建 使 用 输入 流 中 的 新 
HSSFWorkbook 对 象 时 。 

5 HSSFWorkbook(java.io.InputStream s, boolean preserveNodes) 
构建 在 输入 流 的 POI 文 件 系统 。 

6 HSSFWorkbook(POIFSFileSystem fs) 使 用 POIFSFileSystem 对 象 


构造 的 新 HSSFWorkbook 对 象 时 。 


HSSFWorkbook(POIFSFileSystem fs, boolean preserveNodes) 
7 给 定 一 个 POIFSFileSystem 对 象 时 ， 它 会 创建 一 个 新 的 
HSSFWorkbook xt & i i3: dB EA LES. 


这 些 构 造 内 的 常用 参数 : 
e directory : 这 是 从 POI| 文 件 系统 处 理 的 目录 。 
e fs : 它 是 包含 簿 流 该 POI 的 文件 系统 。 


e preservenodes : 这 是 决定 是 否 保留 其 他 节点 像 宏 的 可 选 参 数 。 它 消耗 大 量 的 
内 存 ， 因 为 它 存 储 在 内 存 中 的 所 有 POIFileSystem( 如 果 设 置 )。 


注意 : HSSFWorkbook 类 包含 了 许多 方法 ;然而 ， 它 们 仅 与 XLS 格式 兼容 。 在 本 教程 
中 ， 重 点 是 在 Excel 文 件 格式 的 最 新 版 本 。 因 此 ，HSSFWorkbook 类 的 方法 ， 这 里 
没有 列 出 。 如 果 需 要 这 些 类 的 方法 ， 那 么 请 参照 POI-HSSFWorkbook 类 API 在 
https://poi.apache.org/apidocs/org/apache/poi/hssf/usermodel/HSSFWorkbook.ht 
ml. 


XSSFWorkbook 


它 是 用 于 表示 高 和 低层 次 Excel 文 件 格式 的 类 。 它 属于 org.apache.xssf.usemodel 
包 ， 并 实现 Workbook 接 口 。 下 面 列 出 的 是 这 个 类 的 方法 和 构造 画 数 。 


类 的 构造 西数 


S.No. IE BS EXAM i, BA 


1 XSSFWorkbook() 从 头 开始 创建 一 个 新 的 XSSFworkbook 对 象 。 

XSSFWorkbook(java.io.File file) 构造 从 给 定 文件 中 的 
XSSFWorkbook 对 象 。 
XSSFWorkbook(java.io.InputStream is) 构造 一 个 XSSFWorkbook 

3 对 象 ， 通 过 缓冲 整个 输入 流 到 内 存 中 ， 然 后 为 它 打 开 一 个 
OPCPackage 对 象 。 

4 XSSFWorkbook(java.lang.String path) 构建 一 个 给 定 文件 的 完整 路 
径 的 XSSFWorkbook 对 象 。 

类 方法 

S.No. 方法 及 描述 

1 createSheet() t i£ — 7 XSSFSheetK TF, FERIER, HR 
回 高 层 表示 。 

2 createSheet(java.lang.String sheetname) 创建 此 工作 簿 的 新 表 ， 并 
返回 高 层 表 示 。 

3 createFont() 创建 一 个 新 的 字体 ， 并 将 其 添加 到 工作 筹 的 字体 表 。 

4 createCellStyle() 创建 一 个 新 的 XSSFCellStyle 并 将 其 添加 到 工作 簿 的 
样式 表 。 

5 createFont() 创建 一 个 新 的 字体 ， 并 将 其 添加 到 工作 筹 的 字体 表 。 

6 setPrintArea(int sheetindex, int startColumn, int endColumn, int 


startRow,int endRow) 设置 一 个 给 定 的 表 按 照 指 定 参 数 的 打印 区 域 。 
对 于 此 类 的 其 余 的 方法 ， 请 参阅 完整 的 API 文 


档 : http://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFWorkbook. 
html. 列 出 了 所 有 方法 。 


Sheet 
Sheet 是 在 org.apache.poi.ss.usermodel 包 的 接口 ， 它 是 创建 具有 特定 名 称 的 高 或 


低级 别 的 电子 表格 的 所 有 类 的 超 接 口 。 电 子 表格 的 最 常见 的 类 型 是 工作 表 ， 它 被 表 
示 为 单元 的 网 格 。 


HSSFSheet 


这 是 在 org.apache.poi.hssf.usermodel 包 的 类 。 它 可 以 创建 Excel 电 子 表格 ， 它 允许 
在 sheet 方式 和 表 数 据 格式 。 


S.No. 4438s EEN Be TER 

1 HSSFSheet(HSSFWorkbook workbook) 创建 新 HSSFSheet 通 过 调 
用 HSSFWorkbook 从 头 开始 创建 一 个 表 。 

2 HSSFSheet(HSSFWorkbook workbook, InternalSheet sheet) 创建 


HSSFSheet 表 示 给 定 表 对 象 。 


XSSFSheet 
这 是 代表 了 Excel 电 子 表 格 的 高 级 别 代 表 的 一 类 。 这 在 


org.apache.poi.hssf.usermodel 包 下 。 


3 B3 4435 RM 
S.No. HERJA S 388 ih 
1 XSSFSheet() 创造 了 新 的 XSSFSheet- 调用 XSSFWorkbook 从 头 开始 
创建 一 个 表 。 
2 XSSFSheet(PackagePart part, PackageRelationship rel) 创建 
XSSFSheet 表 示 给 定 包 的 一 部 分 和 关系 。 
类 方法 
S.No. 方法 和 描述 
1 addMergedRegion(CellRangeAddress region) 添加 单元 的 合并 区 
域 (因此 这 些 单元 格 合并 形成 一 
2 autoSizeColumn(int column) 调整 列 帘 ， 以 适应 的 内 容 。 
3 iterator() 此 方法 是 用 于 rowlterator() 的 别名 ， 以 允许 foreach 循 环 
4 addHyperlink(XSSFHyperlink hyperlink) 注册 超 链 接 的 集合 中 的 超 
链接 此 工作 表格 上 


对 于 此 类 的 其 余 的 方法 ， 请 参阅 完整 的 API 在 : 
https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFSheet.html. 


^ 


T 


这 是 在 org.apache.poi.ss.usermodel 包 的 接口 。 它 是 用 于 一 排 的 电子 表格 的 高 层 表 
示 。 它 是 代表 了 POI 库 的 行 所 有 类 的 超 接 口 。 


XSSFRow 


这 是 在 org.apache.poi.xssf.usermodel 包 的 类 。 它 实现 了 Row 接口 ， 因 此 它 可 以 在 
电子 表格 中 创建 行 。 下 面 列 出 的 是 这 个 类 在 方法 和 构造 加 数 。 


类 方法 
S.No. 描述 
1 createCell(int columnIndex) 创建 新 单元 行 并 返回 。 
2 setHeight(short height) 设置 短 单位 的 高 度 。 


对 于 此 类 的 其 余 的 方法 ， 参 考 如 下 链接 : 
https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFRow.html 


单元 格 


这 是 在 org.apache.poi.ss.usermodel 包 的 接口 。 它 是 代表 了 单元 在 电子 表格 中 的 行 
中 的 所 有 类 的 超 接 口 。 


单元 格 可 以 使 用 各 种 属性 ， 例 如 空白 ， 数字， 日 期 ， 错 误 等 单元 格 被 添加 到 一 个 行 
之 前 应 具有 (基于 0) 自己 的 编号 。 


XSSFCell 


这 是 在 org.apache.poi.xssf.usermodel 包 的 类 。 它 实现 了 单元 格 界面 。 它 是 单元 在 
电子 表格 中 的 行 的 一 个 高 层次 的 表示 。 


字段 摘要 


下 面 列 出 的 是 一 些 XSSFCell 类 的 字段 以 及 它们 的 描述 。 


单元 格 类 型 描述 
CELL_TYPE_BLANK 代表 空白 单元 格 
CELL_TYPE_BOOLEAN 代表 布尔 单元 (truezkfalse) 
CELL_TYPE_ERROR 表示 在 单元 的 误差 值 
CELL_TYPE_FORMULA 表示 一 个 单元 格 公式 的 结果 
CELL_TYPE_NUMERIC 表示 对 一 个 单元 的 数字 数据 


CELL_TYPE_STRING Sue Seu ER d) 


S.No. 描述 

1 setCellStyle(CellStyle style) 为 单元 格 设置 样式 。 

2 3 cellType) 设置 单元 格 的 类 型 (数字 ， 公 式 或 字符 
3 setCellValue(boolean value) 设置 单元 格 一 个 布尔 值 

4 setCellValue(java.util.Calendar value) 设置 一 个 日 期 值 的 单元 格 。 
5 setCellValue(double value) 设置 为 单元 格 的 数值 。 

6 setCellValue(java.lang.String str) 设置 为 单元 格 的 字符 串 值 。 

7 setHyperlink(Hyperlink hyperlink) 分 配 超 链接 到 该 单元 格 。 


对 于 这 个 类 的 剩余 方法 和 字段 ， 请 访问 以 下 链接 查看 详细 : 
https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFCell.html 


XSSFCellStyle 
这 是 在 org.apache.poi.xssf.usermodel 包 的 类 。 它 将 提供 关于 在 电子 表格 的 单元 格 


中 的 内 容 的 格式 可 能 的 信息 。 它 也 提供 了 用 于 修正 该 格式 的 选项 。 它 实现 了 
CellStyle 接 口 。 


字段 摘要 
下 表 列 出 了 从 CellStyle 接 口 继承 一 些 字 段 。 


字段 名 称 
ALIGN_CENTER 
ALIGN_CENTER_SELECTION 
ALIGN_FILL 
ALIGN_JUSTIFY 
ALIGN_LEFT 
ALIGN_RIGHT 
BORDER_DASH_DOT 
BORDER. DOMED 
BORDER_DASHED 
BORDER_THICK 
BORDER_THIN 
VERTICAL_BOTTOM 
VERTICAL_CENTER 
VERTICAL_JUSTIFY 


字段 描述 
中 心 对 齐 单元 格 内 容 
中 心 选择 水 平 对 齐 方 式 
单元 格 适应 于 内 容 的 大 小 
适应 单元 格 内 容 的 宽度 
左 对 齐 单元 格 内 容 
右 对 齐 单 元 格 内 容 
使 用 破 折 号 和 点 单元 格 样式 
用 虚线 边框 的 单元 格 样 式 
用 虚线 边框 的 单元 格 样 式 
厚 厚 的 边框 单元 格 样式 
薄 边 框 的 单元 格 样式 
齐 单 元 格 内 容 的 垂直 下 方 
齐 单 元 格 内 容 垂 直 居 中 


VERTICAL_TOP 顶部 对 齐 为 垂直 对 齐 
S.No. 构造 本 数 及 描述 
XSSFCellStyle(int cellXfld, int cellStyleXfld, StylesTable 
1 stylesSource, ThemesTable theme) 创建 一 个 单元 格 样式 ， 从 所 提 
供 的 部 分 
2 XSSFCellStyle(StylesTable stylesSource) 创建 一 个 空 的 单元 样式 
类 方法 


设置 边框 的 类 型 为 单元 格 的 底部 边界 


S.No 方法 及 描述 


1 setAlignment(short align) 设置 单元 格 为 水 平 对 齐 的 类 型 

2 setBorderBottom(short border) 

3 setBorderColor(XSSFCellBorder.BorderSide side, XSSFColor 
color) 选 定 的 边框 颜色 

4 setBorderLeft(Short border) 设置 边界 的 类 型 单元 格 的 左边 框 

5 setBorderRight(short border) 设置 边框 的 类 型 为 单元 格 的 右边 界 

6 setBorderTop(short border) 设置 边界 的 类 型 的 单元 上 边框 


ee eee color) 设置 表示 为 XSSFColor 


值 背景 填充 颜色 。 

8 setFillForegroundColor(XSSFColor color) 设置 表示 为 XSSFColor 的 
值 前 景 填充 颜色 。 

9 setFillPattern(short fp) 指定 单元 格 的 填充 信息 模式 和 纯色 填充 单元 。 


10 setFont(Font font) 设置 此 样式 的 字体 。 

11 setRotation(short rotation) 设置 的 旋转 为 在 单元 格 中 文本 的 程度 。 

12 setVerticalAlignment(short align) 设置 单元 类 型 为 垂直 取向 。 
对 于 这 个 类 剩 下 的 方法 和 字段 ， 通 过 以 下 链接 : 
https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFCellStyle.html 


HSSFColor 


这 是 在 org. apache.poi.hssf.util 包 的 类 。 它 提供 了 不 同 的 颜色 作为 藤 套 类 常 这 些 
嵌 套 类 是 使 用 自己 的 索引 来 表示 。 它 实现 了 Color 接 口 。 


所 有 户 套 类 这 个 类 是 静态 的 ， 每 个 类 都 有 其 索引 。 i 
如 单元 格 内 容 ， 边 框 ， 前 景 和 背景 。 下 面 列 出 了 一 些 的 嵌 套 类 


S.No. 类 名 (RB) 
HSSFColorAQUA 
HSSFColorAUTOMATIC 
HSSFOolor.BLACK 
HSSFOolor.BLUE 
HSSFOolor.BRIGHT GREEN 
HSSFOolor.BRIGHT GRAY 
HSSFColor.CORAL 
HSSFOColor.DARK BLUE 
HSSFOColor.DARK GREEN 
HSSFOColor.SKY BLUE 
HSSFColor.WHITE 

12 HSSFColor. YELLOW 
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类 方法 
这 个 类 的 只 有 一 个 方法 是 很 重要 的 ， 并 且 用 于 获取 索引 值 。 


S.No. 方法 和 描述 
1 getindex() 这 种 方法 被 用 来 获得 一 个 柑 套 类 的 索引 值 


对 于 其 余 的 方法 和 巾 套 类 ， 请 参阅 以 下 链接 : 
https://poi.apache.org/apidocs/org/apache/poi/hssf/uti/HSSF Color.html. 


XSSFColor 


这 是 在 org.apache.poi.xssf.usermodel 包 的 类 。 它 是 用 来 表示 在 电子 表格 中 的 颜 
色 。 它 实现 了 颜色 的 接口 。 下 面 列 出 的 是 它 的 一 些 方法 和 构造 加 数 。 
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S.No. Constructor and 描述 


1 XSSFColor() 创建 XSSFColor 的 新 实例 。 

2 XSSFColor(byte[] rgb) 创建 XSSFColor 使 用 RGB 的 新 实例 。 

3 XSSFColor(java.awt.Color clr) 创建 XSSFColor 使 用 Color 类 从 AWT 
包 的 新 实例 。 

类 方法 

S.No. 方法 和 描述 

1 setAuto(boolean auto) 设置 一 个 布尔 值 ， 表 示 ctColor 是 自动 的 ， 系 
统 ctColor 依 赖 。 

2 setindexed(int indexed) 设置 素 引 ctColor 值 系统 ctColor。 


对 于 其 余 的 方法 ， 请 访问 以 下 链接 : 
https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFColor.html. 


XSSFFont 


这 是 在 org.apache.poi.xssf.usermodel 包 的 类 。 它 实现 了 Font 接 口 ， 因 此 它 可 以 处 
理工 作 簿 中 不 同 的 字体 。 
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S.No. TS ES A TER 
1 XSSFFont() 创建 一 个 新 的 XSSFont 实 例 。 
类 方法 
S.No. 方法 和 描述 
1 setBold(boolean bold) 设置 “bold" 属 性 的 布尔 
2 setColor(short color) 设 a 
3 setColor(XSSFColor color) 设置 为 标准 Alpha RGB 颜色 值 的 字体 颜 
4 setFontHeight(short height) 设置 在 点 的 字体 高 度 。 
5 setFontName(java.lang.String name) 设置 字体 的 名 称 。 


6 setltalic(boolean italic) 设置 "italic" 属 性 一 个 布尔 值 。 


对 于 其 余 的 方法 ， 通 过 以 下 链接 : 
https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFFont.html. 


XSSFHyperlink 


这 是 在 org.apache.poi.xssf.usermodel 包 的 类 。 它 实现 了 Hyperlink 接 口 。 它 是 用 来 
连结 设置 为 电子 表格 的 单元 格 内 容 。 


字段 


属于 此 类 的 字段 如 下 。 这 里 ， 字 段 意味 着 使 用 超 链 接 的 类 型 。 


字段 描述 

LINK_DOCUMENT 用 于 连接 任何 其 他 文件 
LINK_EMAIL 用 于 链接 的 电子 邮件 

LINK_FILE 用 于 以 任何 格式 链接 任何 其 他 文件 
LINK_URL 用 来 连接 一 个 网 页 URL 
类 方法 

S.No. 方法 及 描述 

1 setAddress(java.lang.String address) 超 链 接地 址 。 


对 于 其 余 的 方法 ， 请 访问 以 下 链接 : 
https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFHyperlink.htm 
| 


XSSFCreationHelper 


这 是 在 org.apache.poi.xssf.usermodel 包 的 类 。 它 实现 了 CreationHelper 接 口 。 它 被 
用 作 公 式 求 值 和 设置 超 文本 链接 支持 类 。 
类 方法 


S.No. 方法 和 描述 


createFormulaEvaluator() 创建 一 个 XSSFFormulaEvaluator 例 如 ， 
结果 计算 公式 的 单元 格 的 对 象 。 


2 createHyperlink(int type) Creates a new XSSFHyperlink. 


1 


对 于 其 余 的 方法 ， 请 参考 以 下 链 
接 : https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFCreation 
Helper.html. 


XSSFPrintSetup 


这 是 在 org.apache.poi.xsssf.usermodel 包 下 的 类 。 它 实现 了 PrintSetup 接 口 。 它 是 
用 来 设置 打印 页 面 大 小 ， 面 积 ， 选 项 和 设置 。 


类 方法 
S.No. 方法 及 说 明 
1 setLandscape(boolean Is) 设置 一 个 布尔 值 ， 人 允许 或 阻止 横向 打印 。 
2 setLeftToRight(boolean Itor) 设置 是 否 向 左 走向 右 或 自 上 而 下 的 顺 
序 ， 同 时 打印 。 
3 setPaperSize(short size) 设置 纸张 尺寸 。 


对 于 其 余 的 方法 ， 请 访问 以 下 链 
接 : https://poi.apache.org/apidocs/org/apache/poi/hssf/usermodel/HSSFPrintSetu 
p.html 


Apache POI 工 作 短 - POI 教 程 


此 处 的 术语 "Workbook” 指 的 Microsoft Excel 文 件 。 本 章 完 成 后 ， 您 将 能 够 创建 新 的 
工作 得， 并 可 以 使 用 Java 程 序 打 开 现 有 工作 筹 。 


创建 空白 工作 簿 
下 面 简单 的 程序 来 创建 一 个 空白 Microsoft Excel THS., 


import java.io.*; 
import org.apache.poi.xssf.usermodel.*; 
public class CreateWorkBook 


{ 
public static void main(String[] args)throws Exception 
{ 
//Create Blank workbook 
XSSFWorkbook workbook = new XSSFWorkbook(); 
//Create file system using specific name 
FileOutputStream out = new FileOutputStream( 
new File("createworkbook.xlsx")); 
//write operation workbook using file out object 
workbook.write(out); 
out.close(); 
System.out.println(" 
createworkbook.xlsx written successfully"); 
} 
} 


让 我 们 保存 上 面 的 Java 代 码 为 CreateWorkBook.java， 然 后 编译 并 从 命令 提示 符 如 
下 执行 它 : 


$javac CreateWworkBook. java 
$java CreateWorkBook 


如 果 系 统 环 境 配置 了 POI 库 ， 它 会 编译 和 执行 ， 并 生成 一 个 名 为 
createworkbook.xlsx 在 当前 目录 下 的 空白 Excel 文 件 并 显示 在 命 合 提示 符 处 键入 以 
下 输出 。 


createworkbook.xlsx written successfully 
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使 用 下 面 的 代码 打开 现 有 的 工作 簿 。 


import java.io.*; 
import org.apache.poi.xssf.usermodel.*; 
public class OpenWorkBook 
{ 
public static void main(String args[])throws Exception 
{ 
File file = new File("openworkbook.xlsx"); 
FileInputStream fIP = new FileInputStream(file); 
//Get the workbook instance for XLSX file 
XSSFWorkbook workbook = new XSSFWorkbook(fIP); 
if(file.isFile() && file.exists()) 
{ 
System.out.println( 
"openworkbook.xlsx file open successfully."); 
} 
else 
{ 
System.out.println( 
"Error to open openworkbook.xlsx file."); 


保存 上 面 的 Java 代 码 为 OpenWorkBook.java， 然 后 编译 并 从 命令 提示 符 如 下 执行 


它 : 


$javac OpenWorkBook. java 
$java OpenworkBook 


这 将 编译 和 执行 生成 以 下 输出 。 
openworkbook.xlsx file open successfully. 


打开 工作 敌后 ， 可 以 进行 读 取 ， 并 在 上 面 写 操作 。 


Apache POI 电 子 表 格 /Spreadsheet - POI 教 程 

本 章 将 介绍 如 何 创建 一 个 电子 表格 ， 并 使 用 Java 操 纵 它 。 电 子 表格 是 在 Excel 文 件 
中 的 页 面 ; 它 包含 具有 特定 名 称 的 行 和 列 。 

读 完 本 章 后 ， 将 能 够 创建 一 个 电子 表格 ， 并 能 在 其 上 执行 读 取 操 作 。 


创建 电子 表格 


首先 ， 让 我 们 创建 一 个 使 用 在 前 面 的 章节 中 讨论 的 引用 的 类 的 电子 表格 。 按 照 前 面 
的 章节 中 ， 首 先 创 建 一 个 工作 矫 ， 然 后 我 们 就 可 以 去 ， 并 创建 一 个 表 。 


下 面 的 代码 片段 用 于 创建 电子 表格 。 


//Create Blank workbook 

XSSFWorkbook workbook = new XSSFWorkbook(); 

//Create a blank spreadsheet 

XSSFSheet spreadsheet = workbook.createSheet("Sheet Name"); 


在 电子 表格 的 行 


电子 表格 有 一 个 网 格 布局 。 行 和 列 被 标识 与 特定 的 名 称 。 该 列 标 识字 母 和 行 用 数 
字 。 


下 面 的 代码 片段 用 于 创建 一 个 行 。 


XSSFRow row = spreadsheet.createRow((short)1); 


写 人 到 电子 表格 
让 我 们 考虑 屠 员 数据 的 一 个 例子 。 这 里 的 履 员 数据 给 出 以 表格 形式 。 
Emp Id Emp Name 称号 
Tp01 Gopal Technical Manager 
TP02 Manisha Proof Reader 
Tp03 Masthan Technical Writer 
Tp04 Satish Technical Writer 


Tp05 Krishna Technical Writer 


以 下 代码 是 用 来 写 上 述 数据 到 电子 表格 。 


import java.io.File; 

import java.io.FileOutputStream; 

import java.util.Map; 

import java.util.Set; 

import java.util.TreeMap; 

import org.apache.poi.ss.usermodel.Cell; 

import org.apache.poi.xssf.usermodel.XSSFRow; 
import org.apache.poi.xssf.usermodel.XSSFSheet; 
import org.apache.poi.xssf.usermodel.XSSFWorkbook; 
public class Writesheet 


{ 


public static void main(String[] args) throws Exception 
{ 
//Create blank workbook 
XSSFWorkbook workbook = new XSSFWorkbook(); 
//Create a blank sheet 
XSSFSheet spreadsheet = workbook.createSheet ( 
" Employee Info "); 
//Create row object 
XSSFROW row; 
//This data needs to be written (Object[]) 
Map < String, Object[] > empinfo = 
new TreeMap < String, Object[] >(); 
empinfo.put( "1", new Object[] { 
"EMP ID", "EMP NAME", "DESIGNATION" }); 
empinfo.put( "2", new Object[] { 
"tp0i", "Gopal", "Technical Manager" }); 
empinfo.put( "3", new Object[] { 
"tpo2", "Manisha", "Proof Reader" }); 
empinfo.put( "4", new Object[] { 
"tpo3", "Masthan", "Technical Writer" }); 
empinfo.put( "5", new Object[] { 
"tpo4", "Satish", "Technical Writer" }); 
empinfo.put( "6", new Object[] { 
"tpob", "Krishna", "Technical Writer" }); 
//Iterate over data and write to sheet 
Set « String » keyid - empinfo.keySet(); 
int rowid - 0; 
for (String key : keyid) 
{ 
row = spreadsheet .createRow(rowid++) ; 
Object [] objectArr = empinfo.get(key); 
int cellid - 0; 
for (Object obj : objectArr) 


Cell cell = row.createCell(cellid++); 
cell.setCellValue((String)obj); 
j 
j 
//Write the workbook in file system 
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FileOutputStream out = new FileOutputStream( 
new File("Writesheet.xlsx")); 
workbook.write(out); 

out.close(); 

System.out.println( 

"Writesheet.xlsx written successfully" ); 


上 面 的 Java 代 码 保存 为 Writesheetjava， 然 后 并 在 命令 提示 符 下 编译 运行 ， 如 下 所 
ZN: 


$javac Writesheet.java 
$java Writesheet 


这 将 编译 和 执行 来 生成 一 个 Exce| 文 件 名 为 Writesheet.xlsx 在 当前 目录 中 ， 在 命令 提 
示 符 处 键入 以 下 输出 。 


Writesheet.xlsx written successfully 


Writesheet.xlsx 文 件 的 内 容 如 下 所 示 。 


E Writesheet.xlsx - Excel ? f- 


HOME INSERT | PAGELAYOUT FORMULAS’ DATA 


fi 
B C D 
EMP NAME DESIGNATION 
Gopal Technical Manager 
Manisha Proof Reader 
Masthan Technical Writer 
Satish Technical Writer 
Krishna Technical Writer 


Employee Info 





让 我 们 考虑 上 述 excel 文 件 命名 Writesheet.xslx 作 为 输入 文件 。 注 意 下 面 的 代码 ; 它 是 
用 于 从 电子 表格 中 读 取 数据 。 


import java.io.File; 

import java.io.FileInputStream; 

import java.util.Iterator; 

import org.apache.poi.ss.usermodel.Cell; 

import org.apache.poi.ss.usermodel.Row; 

import org.apache.poi.xssf.usermodel.XSSFRow; 
import org.apache.poi.xssf.usermodel.XSSFSheet; 
import org.apache.poi.xssf.usermodel.XSSFWorkbook; 
public class Readsheet 


{ 
static XSSFRow row; 
public static void main(String[] args) throws Exception 
{ 
FileInputStream fis = new FileInputStream( 
new File("WriteSheet.xlsx")); 
XSSFWorkbook workbook = new XSSFWorkbook( fis); 
XSSFSheet spreadsheet = workbook.getSheetAt (0); 
Iterator < Row > rowIterator = spreadsheet.iterator(); 
while (rowIterator.hasNext()) 
{ 
row = (XSSFRow) rowIterator.next(); 
Iterator < Cell > cellIterator = row.cellIterator(); 
while ( cellIterator.hasNext()) 
Cell cell = cellIterator.next(); 
switch (cell.getCellType()) 
{ 
case Cell.CELL_TYPE_NUMERIC: 
System. out. print( 
cell.getNumericCellValue() + " \t\t " ); 
break; 
case Cell.CELL_TYPE_STRING: 
System. out. print( 
cell.getStringCellValue() + " \t\t " ); 
break; 
} 
} 
System.out.println(); 
} 
fis.close(); 
} 
} 


让 我 们 把 上 面 的 代码 保存 在 Readsheet.java 文 件 ， 然 后 编译 并 在 命令 提示 符 下 运 
行 ， 如 下 所 示 : 


$javac Readsheet.java 
$java Readsheet 


如 果 您 的 系统 环境 配置 了 POI 库 ， 它 会 编译 和 执行 产生 在 命 合 提 示 符 处 键入 以 下 输 
出 。 


EMP ID EMP NAME DESIGNATION 

tpoi Gopal Technical Manager 
tpe2 Manisha Proof Reader 

tpo03 Masthan Technical Writer 
tp04 Satish Technical Writer 
tp05 Krishna Technical Writer 


Apache POI 单 元 格 /Cells - POI 教 程 


输入 到 电子 表格 中 的 任何 数据 总 是 存储 在 一 个 单元 中 。 我 们 使 用 的 行 和 列 的 标签 来 
识别 单元 格 。 本 章 介 绍 了 如 何 使 用 Java 编 程 操 纵 单元 电子 表格 的 数据 。 


创建 一 个 单元 格 
需要 创建 一 个 单元 之 前 创建 一 个 行 。 行 是 什么 ? 只 不 过 是 单元 的 集合 。 
下 面 的 代码 片段 用 于 创建 一 个 单元 格 。 


//create new workbook 

XSSFWorkbook workbook = new XSSFWorkbook(); 

//create spreadsheet with a name 

XSSFSheet spreadsheet = workbook.createSheet("new sheet"); 
//create first row on a created spreadsheet 

XSSFRow row = spreadsheet .createRow(0) 

//create first cell on created row 

XSSFCell cell = row.createCell(0); 


单元 格 类 型 


单元 格 类 型 指定 单元 格 是 否 可 以 包含 字符 串 ， 数 值 ， 或 公式 。 字 符 串 单元 不 能 持 有 
数值 和 数值 单元 格 无 法 容纳 字符 串 。 下 面 给 出 是 单元 格 值 和 类 型 的 语法 。 


单元 格 的 值 类 型 类 型 语法 
Blank cell value XSSFCell.CELL_TYPE_BLANK 
Boolean cell value XSSFCell. CELL. TYPE BOOLEAN 
Error cell value XSSFCell.CELL_TYPE_ERROR 
Numeric cell value XSSFCell.CELL_TYPE_NUMERIC 
String cell value XSSFCell.CELL_TYPE_STRING 


以 下 代码 是 用 于 在 电子 表格 创建 不 同类 型 的 单元 格 。 


import java.io.File; 

import java.io.FileOutputStream; 

import java.util.Date; 

import org.apache.poi.xssf.usermodel.XSSFCell; 

import org.apache.poi.xssf.usermodel.XSSFRow; 

import org.apache.poi.xssf.usermodel.XSSFSheet; 

import org.apache.poi.xssf.usermodel.XSSFWorkbook; 

public class TypesofCells 

{ 

public static void main(String[] args)throws Exception 
{ 

XSSFWorkbook workbook = new XSSFWorkbook(); 
XSSFSheet spreadsheet = workbook.createSheet("cell types"); 
XSSFRow row = spreadsheet.createRow((short) 2); 
row.createCell(0).setCellValue("Type of Cell"); 
row.createCell(1).setCellValue("cell value"); 
row = spreadsheet.createRow((short) 3); 
row.createCell(0).setCellValue("set cell type BLANK"); 
row.createCell(1); 
row = spreadsheet.createRow((short) 4); 
row.createCell(0).setCellValue("set cell type BOOLEAN"); 
row.createCell(1).setCellValue(true); 
row = spreadsheet.createRow((short) 5); 
row.createCell(0).setCellValue("set cell type ERROR"); 
row.createCell(1).setCellValue(XSSFCell.CELL TYPE ERROR ); 
row = spreadsheet.createRow((short) 6); 
row.createCell(0O).setCellValue("set cell type date"); 
row.createCell(1).setCellValue(new Date()); 
row = spreadsheet.createRow((short) 7); 
row.createCell(0).setCellValue("set cell type numeric" ); 
row.createCell(1).setCellValue(20 ); 
row = spreadsheet.createRow((short) 8); 
row.createCell(0).setCellValue("set cell type string"); 
row.createCell(1).setCellValue("A String"); 
FileOutputStream out = new FileOutputStream( 
new File("typesofcells.xlsx")); 
workbook.write(out); 
out.close(); 
System.out.println( 
"typesofcells.xlsx written successfully"); 


JEE cer : ur] 
保存 上 面 的 代码 到 一 个 名 为 TypesofCells.java 文 件 ， 编 译 并 从 命令 提示 符 如 下 执行 


€. 


$javac TypesofCells.java 
$java TypesofCells 


如 果 您 的 系统 配置 了 POI 库 ， 那 么 它 会 编译 和 执行 在 当前 目录 中 生成 一 个 名 为 
typesofcells.xlsx 的 Excel 文 件 ， 并 显示 以 下 输出 。 


typesofcells.xlsx written successfully 


typesofcells.xlsx 3c fF BI FATA. 

H9- > typesofcells.xlsx - Excel 7 H- D xX 
FILE HOME INSERT  PAGELAYOUT FORMULAS DATA REVIEW VIEW satish ku... ~ 

Al M fe v 


A B C D E F G H ^ 


1 
2 
3 Type of Cell cell value 
4 |set cell type BLANK 

5 |set cell type BOOLEAN TRUE 

6 

7 

8 

9 





set cell type ERROR 5 

set cell type is date 41871.45 

set cell type is numeric 20 

set cell type is string A String 
10 
Xr - 

types of cells +) 4 > 

READY EH m) -— —34— — — 4 100% 


单元 格 样式 


在 这 里 ， 可 以 学 习 如 何 做 单元 格格 式 ， 并 采用 不 同 的 风格 ， 如 合并 相 邻 的 单元 格 ， 
添加 边框 ， 设 置 单 元 格 对 齐 方式 和 填充 颜色 。 


以 下 代码 是 使 用 Java 编 程 用 于 不 同样 式 应 用 到 单元 格 。 


import java.io.File; 

import java.io.FileOutputStream; 

import org.apache.poi.hssf.util.HSSFColor; 

import org.apache.poi.ss.usermodel.IndexedColors; 
import org.apache.poi.ss.util.CellRangeAddress; 
import org.apache.poi.xssf.usermodel.XSSFCell; 
import org.apache.poi.xssf.usermodel.XSSFCellStyle; 
import org.apache.poi.xssf.usermodel.XSSFRow; 
import org.apache.poi.xssf.usermodel.XSSFSheet; 
import org.apache.poi.xssf.usermodel.XSSFWorkbook; 
public class CellStyle 

{ 


public static void main(String[] args)throws Exception 


XSSFWorkbook workbook = new XSSFWorkbook(); 
XSSFSheet spreadsheet = workbook.createSheet("cellstyle"); 
XSSFRow row = spreadsheet.createRow((short) 1); 
row.setHeight((short) 800); 

XSSFCell cell = (XSSFCell) row.createCell((short) 1); 
cell.setCellValue("test of merging"); 

//MEARGING CELLS 

//this statement for merging cells 

spreadsheet .addMergedRegion(new CellRangeAddress( 
1, //first row (0-based) 

1, //last row (0-based) 

1, //first column (0-based) 

4 //last column (0-based) 

)); 

//CELL Alignment 

row = spreadsheet.createRow(5); 

cell - (XSSFCell) row.createCell(0); 
row.setHeight((short) 800); 

// Top Left alignment 

XSSFCellStyle style1 = workbook.createCellStyle(); 
spreadsheet.setColumnwidth(0, 8000); 
stylei.setAlignment(XSSFCellStyle.ALIGN LEFT); 
stylei.setVerticalAlignment(XSSFCellStyle.VERTICAL TOP); 
cell.setCellValue("Top Left"); 
cell.setCellStyle(style1); 

row = spreadsheet.createRow(6); 

cell - (XSSFCell) row.createCell(1); 
row.setHeight((short) 800); 

// Center Align Cell Contents 

XSSFCellStyle style2 - workbook.createCellStyle(); 
style2.setAlignment(XSSFCellStyle.ALIGN CENTER); 
style2.setVerticalAlignment( 
XSSFCellStyle.VERTICAL CENTER); 
cell.setCellValue("Center Aligned"); 
cell.setCellStyle(style2); 

row = spreadsheet.createRow(7); 

cell - (XSSFCell) row.createCell(2); 
row.setHeight((short) 800); 

// Bottom Right alignment 

XSSFCellStyle style3 = workbook.createCellStyle(); 
style3.setAlignment(XSSFCellStyle.ALIGN RIGHT); 
style3.setVerticalAlignment( 
XSSFCellStyle.VERTICAL BOTTOM); 
cell.setCellValue("Bottom Right"); 
cell.setCellStyle(style3); 

row = spreadsheet.createRow(8); 

cell - (XSSFCell) row.createCell(3); 

// Justified Alignment 

XSSFCellStyle style4 - workbook.createCellStyle(); 
style4.setAlignment(XSSFCellStyle.ALIGN JUSTIFY); 
style4.setVerticalAlignment( 
XSSFCellStyle.VERTICAL JUSTIFY); 


cell.setCellValue("Contents are Justified in Alignment"); 
cell.setCellStyle(style4); 

//CELL BORDER 

row = spreadsheet.createRow((short) 10); 
row.setHeight((short) 800); 

cell = (XSSFCell) row.createCell((short) 1); 
cell.setCellValue("BORDER"); 

XSSFCellStyle style5 = workbook.createCellStyle(); 
style5b.setBorderBottom(XSSFCellStyle.BORDER THICK); 
style5.setBottomBorderColor ( 
IndexedColors.BLUE.getIndex()); 
style5b.setBorderLeft(XSSFCellStyle.BORDER DOUBLE); 
style5.setLeftBorderColor( 
IndexedColors.GREEN.getIndex()); 
style5.setBorderRight(XSSFCellStyle.BORDER_HAIR) ; 
style5.setRightBorderColor ( 
IndexedColors.RED.getIndex()); 
style5.setBorderTop(XSSFCellStyle.BIG_SPOTS) ; 
style5.setTopBorderColor( 
IndexedColors.CORAL.getIndex()); 
cell.setCellStyle(style5); 

//Fill Colors 

//background color 

row = spreadsheet.createRow((short) 10 ); 

cell - (XSSFCell) row.createCell((short) 1); 
XSSFCellStyle style6 - workbook.createCellStyle(); 
style6.setFillBackgroundColor( 

HSSFColor.LEMON CHIFFON.index ); 
style6.setFillPattern(XSSFCellStyle.LESS DOTS); 
style6.setAlignment(XSSFCellStyle.ALIGN FILL); 
spreadsheet.setColumnwidth(1,8000); 
cell.setCellValue("FILL BACKGROUNG/FILL PATTERN"); 
cell.setCellStyle(style6); 

//Foreground color 

row = spreadsheet.createRow((short) 12); 

cell - (XSSFCell) row.createCell((short) 1); 
XSSFCellStyle style7-workbook.createCellStyle(); 
style7.setFillForegroundColor(HSSFColor.BLUE.index); 
style7.setFillPattern( XSSFCellStyle.LESS DOTS); 
style7.setAlignment(XSSFCellStyle.ALIGN FILL); 
cell.setCellValue("FILL FOREGROUND/FILL PATTERN"); 
cell.setCellStyle(style?7); 

FileOutputStream out = new FileOutputStream( 

new File("cellstyle.xlsx")); 

workbook.write(out); 

out.close(); 

System.out.println("cellstyle.xlsx written successfully"); 


保存 上 面 的 代码 在 一 个 名 为 CellStyleJjava 文 件 ， 编 译 并 从 命令 提示 符 如 下 执行 它 。 
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$javac CellStyle.java 
$java CellStyle 


它 会 生成 一 个 名 为 cellstyle.xlsx 在 当前 目录 中 的 Excel 文 件 并 显示 以 下 输出 。 


cellstyle.xlsx written successfully 


cellstyle.xlsx x 440 FATA. 
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本 章 介 绍 如 何 设置 不 同 的 字体 ， 应 用 样式 ， 并 在 Excel 电 子 表格 中 显示 的 方向 不 同 
角度 的 文字 。 


每 个 系统 附带 一 个 很 大 的 字体 如 Arial, Impact, Times New Roman, 等 字体 集合 也 可 
以 用 新 的 字体 更 新 ， 如 果 需 要 的 话 。 同 样 也 有 各 种 风格 ， 其 中 的 字体 可 以 显示 ， 例 
如 ， 粗 体 ， 斜 体 ， 下 划 线 ， 删 除 线 等 。 


字体 和 字体 样式 


下 面 的 代码 用 于 特定 的 字体 和 样式 应 用 于 一 单元 格 的 内 容 。 


import java.io.File; 

import java.io.FileOutputStream; 

import org.apache.poi.hssf.util.HSSFColor; 

import org.apache.poi.xssf.usermodel.XSSFCell; 

import org.apache.poi.xssf.usermodel.XSSFCellStyle; 

import org.apache.poi.xssf.usermodel.XSSFFont; 

import org.apache.poi.xssf.usermodel.XSSFRow; 

import org.apache.poi.xssf.usermodel.XSSFSheet; 

import org.apache.poi.xssf.usermodel.XSSFWorkbook; 

public class FontStyle 

{ 

public static void main(String[] args)throws Exception 
t 

XSSFWorkbook workbook = new XSSFWorkbook(); 
XSSFSheet spreadsheet = workbook.createSheet("Fontstyle"); 
XSSFRow row = spreadsheet.createRow(2); 
//Create a new font and alter it. 
XSSFFont font = workbook.createFont(); 
font.setFontHeightInPoints((short) 30); 
font.setFontName ("IMPACT"); 
font.setItalic(true); 
font.setColor(HSSFColor.BRIGHT GREEN.index); 
//Set font into style 
XSSFCellStyle style = workbook.createCellStyle(); 
style.setFont(font); 
// Create a cell with a value and set style to it. 
XSSFCell cell - row.createCell(1); 
cell.setCellValue("Font Style"); 
cell.setCellStyle(style); 
FileOutputStream out = new FileOutputStream( 
new File("fontstyle.xlsx")); 
workbook.write(out); 
out.close(); 
System.out.println( 
"fontstyle.xlsx written successfully"); 


让 我 们 保存 上 面 的 代码 在 一 个 名 为 FontStyle.java 文 件 。 从 命令 提示 符 编 译 并 执行 它 
如 下 。 


$javac FontStyle.java 
$java FontStyle 


它 生 成 一 个 名 为 fontstyle.xlsx 在 当前 目录 中 的 Excel 文 件 并 显示 在 命 命 提示 符 处 键入 
以 下 输出 。 


fontstyle.xlsx written successfully 


fontstyle.xlsx3c fF 40 FATA. 


= fontstyle.xlsx - Excel 
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Al fe 
A 


q 


F 


Font Style 


Font Format 





X 5€ 73 In] 


在 这 里 ， 可 以 学 习 如 何 设置 不 同 角 度 的 文本 方向 。 通 常 单元 格 的 内 容 以 水 平方 式 显 
示 ， 由 左 到 右 ， 并 在 00 角 ;但 是 可 以 使 用 下 面 的 代码 来 旋转 文本 的 方向 (如 果 需 要 的 
话 )。 


import java.io.File; 

import java.io.FileOutputStream; 

import org.apache.poi.xssf.usermodel.XSSFCell; 

import org.apache.poi.xssf.usermodel.XSSFCellStyle; 

import org.apache.poi.xssf.usermodel.XSSFRow; 

import org.apache.poi.xssf.usermodel.XSSFSheet; 

import org.apache.poi.xssf.usermodel.XSSFWorkbook; 

public class TextDirection 

{ 

public static void main(String[] args)throws Exception 
{ 

XSSFWorkbook workbook 
XSSFSheet spreadsheet 
"Text direction"); 
XSSFRow row = spreadsheet.createRow(2); 
XSSFCellStyle myStyle = workbook.createCellStyle(); 
myStyle.setRotation((short) 0); 
XSSFCell cell - row.createCell(1); 
cell.setCellValue("OD angle"); 
cell.setCellStyle(myStyle); 
//30 degrees 
myStyle-workbook.createCellStyle(); 


new XSSFWorkbook(); 
workbook.createSheet( 


myStyle.setRotation((short) 30); 
cell = row.createCell(3); 
cell.setCellValue("30D angle"); 
cell.setCellStyle(myStyle); 

//90 degrees 
myStyle=workbook.createCellStyle(); 
myStyle.setRotation((short) 90); 
cell = row.createCell(5); 
cell.setCellValue("90D angle"); 
cell.setCellStyle(myStyle); 

//120 degrees 
myStyle=workbook.createCellStyle(); 
myStyle.setRotation((short) 120); 
cell = row.createCell(7); 
cell.setCellValue("120D angle"); 
cell.setCellStyle(myStyle); 

//270 degrees 

myStyle = workbook.createCellStyle(); 
myStyle.setRotation((short) 270); 
cell - row.createCell(9); 
cell.setCellValue("270D angle"); 
cell.setCellStyle(myStyle); 

//360 degrees 
myStyle-workbook.createCellStyle(); 
myStyle.setRotation((short) 360); 
cell - row.createCell(12); 
cell.setCellValue("360D angle"); 
cell.setCellStyle(myStyle); 
FileOutputStream out = new FileOutputStream( 
new File("textdirection.xlsx")); 
workbook.write(out); 

out.close(); 

System.out.println( 
"textdirection.xlsx written successfully"); 


保持 TextDirectin.java 文 件 上 面 的 代码 ， 然 后 编译 并 从 命令 提示 符 如 下 执行 它 。 


$javac TextDirection.java 
$java TextDirection 


这 将 编译 和 执行 ， 以 生成 一 个 名 为 textdirection.xlsx 在 当前 目录 中 的 Excel 文 件 并 显 
示 在 命 命 提示 符 处 键入 以 下 输出 。 


textdirection.xlsx written successfully 


textdirection.xIsx S (fF AI FARA. 


TutorialsPoint Java 技术 教程 





EH S- er-s 


textdirection.xlsx - Excel 


3 D - x 











HOME INSERT PAGELAYOUT FORMULAS DATA REVIEW VIEW satish kumar kallakuri ~ il 
Al -| : f v 
A B c D E F G H J M N = 
H | 
2 
o 
P z 
od = <Q 
E a 3 le 3 
3 OD angle a S ^ 3700 ang 6D 3 ngle 
4 
5 
6 
7 
r. | 








Text direction 中 




















Apache POI 字 体 /Fonts - POI 教 程 


98 


Apache POI xt - POI 教 程 
本 章 将 介 绍 如 何 使 用 Java 编 程 应 用 不 同 单元 公式 的 过 程 。 Excel 应 用 程序 的 基本 目 
的 是 通 过 应 用 公式 就 可 以 保持 数值 数据 。 


在 公式 中 ， 我 们 通过 动态 值 ， 或 在 Excel 工 作 表 中 的 值 的 位 置 。 在 执行 这 个 公式 ， 
就 会 得 到 想 要 的 结果 。 下 表 列 出 了 常用 的 在 Excel 中 的 几 个 基本 公式 。 


操作 语法 
添加 多 个 数值 = SUM(Loc1:Locn) or = SUM(n1,n2,) 
计数 = COUNT(Loc1:Locn) or = COUNT(n1,n2,) 
SAY = POWER(Loc1,Loc2) or = POWER(number, power) 
多 个 数 的 最 大 值 = MAX(Loc1:Locn) or = MAX(n1,n2,) 
乘积 = PRODUCT(Loc1:Locn) or = PRODUCT(n1,n2,) 
阶乘 = FACT(Locn) or = FACT(number) 
绝对 数字 = ABS(Locn) or = ABS(number) 
今天 的 日 期 -TODAY() 
转换 成 小 写 = LOWER(Locn) or = LOWER(text) 
平方 根 = SQRT(locn) or = SQRT(number) 


以 下 代码 用 于 公式 添加 至 单元 格 ， 并 执行 它 


import java.io.File; 

import java.io.FileOutputStream; 

import org.apache.poi.xssf.usermodel.XSSFCell; 
import org.apache.poi.xssf.usermodel.XSSFRow; 
import org.apache.poi.xssf.usermodel.XSSFSheet; 
import org.apache.poi.xssf.usermodel.XSSFWorkbook; 
public class Formula 


public static void main(String[] args)throws Exception 
{ 
XSSFWorkbook workbook = new XSSFWorkbook(); 
XSSFSheet spreadsheet - workbook.createSheet("formula"); 
XSSFROW row - spreadsheet.createRow(1); 
XSSFCell cell - row.createCell(1); 
cell.setCellValue("A =" ); 
cell - row.createCell(2); 
cell.setCellValue(2); 
row = spreadsheet.createRow(2); 
cell - row.createCell(1); 


cell.setCellValue("B ="); 

cell = row.createCell(2); 
cell.setCellValue(4); 

row = spreadsheet.createRow(3); 

cell = row.createCell(1); 
cell.setCellValue("Total ="); 

cell = row.createCell(2); 

// Create SUM formula 
cell.setCellType(XSSFCell.CELL TYPE FORMULA); 
cell.setCellFormula("SUM(C2:C3)" ); 

cell - row.createCell(3); 
cell.setCellValue("SUM(C2:C3)"); 

row = spreadsheet.createRow(4); 

cell - row.createCell(1); 
cell.setCellValue("POWER ="); 
cell-row.createCell(2); 

// Create POWER formula 
cell.setCellType(XSSFCell.CELL TYPE FORMULA); 
cell.setCellFormula("POWER(C2,C3)"); 

cell - row.createCell(3); 
cell.setCellValue("POWER(C2,C3)"); 

row = spreadsheet.createRow(5); 

cell = row.createCell(1); 
cell.setCellValue( "MAX ="); 

cell = row.createCell(2); 

// Create MAX formula 
cell.setCellType(XSSFCell.CELL TYPE FORMULA); 
cell.setCellFormula("MAX(C2,C3)"); 

cell - row.createCell(3); 
cell.setCellValue("MAX(C2,C3)"); 

row = spreadsheet.createRow(6); 

cell - row.createCell(1); 
cell.setCellValue("FACT ="); 

cell - row.createCell(2); 

// Create FACT formula 
cell.setCellType(XSSFCell.CELL TYPE FORMULA); 
cell.setCellFormula("FACT(C3)"); 

cell - row.createCell(3); 
cell.setCellValue("FACT(C3)"); 

row = spreadsheet.createRow(7); 

cell - row.createCell(1); 
cell.setCellValue("SQRT ="); 

cell - row.createCell(2); 

// Create SQRT formula 
cell.setCellType(XSSFCell.CELL TYPE FORMULA); 
cell.setCellFormula("SQRT(C5)"); 

cell = row.createCell(3); 
cell.setCellValue("SQRT(C5)"); 

workbook. getCreationHelper ( ) 
.createFormulaEvaluator() 

.evaluateAll(); 

FileOutputStream out - new FileOutputStream( 
new File("formula.xlsx")); 
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workbook.write(out ) ; 
out.close(); 
System.out.println("fromula.xlsx written successfully"); 


保存 上 面 的 代码 到 文件 Formula.java， 然 后 编译 并 从 命令 提示 符 如 下 执行 它 。 


$javac Formula.java 
$java Formula 


它 会 生成 一 个 名 为 formula.xlsx 在 当前 目录 中 的 Excel 文 件 并 显示 在 命令 提示 符 义 键 
入 以 下 输出 。 


fromula.xlsx written successfully 


formula.xlsx 文 件 如 下 所 示 。 
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本 章 介 绍 


了 如 何 为 超 链接 添加 到 内 容 的 单元 格 。 超 链接 通常 被 用 来 访问 任何 网 站 的 


网 址 ， 电 子 邮 件 或 外 部 文件 。 
下 面 的 代码 演示 如 何 创 建 单 元 格 的 超 链接 。 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
public 
{ 

pub 

{ 


java.io.File; 

java.io.FileOutputStream; 
org.apache.poi.common.usermodel.Hyperlink; 
org.apache.poi.hssf.util.HSSFColor; 
org.apache.poi.ss.usermodel.CreationHelper; 
org.apache.poi.xssf.usermodel.XSSFCell; 
org.apache.poi.xssf.usermodel.XSSFCellStyle; 
org.apache.poi.xssf.usermodel.XSSFFont; 
org.apache.poi.xssf.usermodel.XSSFHyperlink; 
org.apache.poi.xssf.usermodel.XSSFSheet; 
org.apache.poi.xssf.usermodel.XSSFWorkbook; 
class HyperlinkEX 


lic static void main(String[] args) throws Exception 


XSSFWorkbook workbook = new XSSFWorkbook(); 
XSSFSheet spreadsheet = workbook 

.createSheet ("Hyperlinks"); 

XSSFCell cell; 

CreationHelper createHelper = workbook 
.getCreationHelper(); 

XSSFCellStyle hlinkstyle = workbook.createCellStyle(); 
XSSFFont hlinkfont = workbook.createFont(); 
hlinkfont.setUnderline(XSSFFont.U SINGLE); 
hlinkfont.setColor(HSSFColor.BLUE.index); 
hlinkstyle.setFont(hlinkfont); 

//URL Link 

cell - spreadsheet.createRow(1) 
.createCell((short) 1); 

cell.setCellValue("URL Link"); 

XSSFHyperlink link - (XSSFHyperlink)createHelper 
.createHyperlink(Hyperlink.LINK URL); 
link.setAddress("http://www.yiibai.com/" ); 
cell.setHyperlink((XSSFHyperlink) link); 
cell.setCellStyle(hlinkstyle); 

//Hyperlink to a file in the current directory 
cell - spreadsheet.createRow(2) 
.createCell((short) 1); 
cell.setCellValue("File Link"); 

link - (XSSFHyperlink)createHelper 
.createHyperlink(Hyperlink.LINK FILE); 
link.setAddress("cellstyle.xlsx"); 


cell.setHyperlink(link); 
cell.setCellStyle(hlinkstyle); 

//e-mail link 

cell - spreadsheet.createRow(3) 
.createCell((short) 1); 
cell.setCellValue("Email Link"); 

link - (XSSFHyperlink)createHelper 
.createHyperlink(Hyperlink.LINK EMAIL); 
link.setAddress( 
"mailto:contact@yiibai.com?" 
+"subject=Hyperlink"); 
cell.setHyperlink(link); 
cell.setCellStyle(hlinkstyle); 
FileOutputStream out = new FileOutputStream( 
new File("hyperlink.xlsx")); 
workbook.write(out); 

out.close(); 
System.out.println("hyperlink.xlsx written successfully"); 


保存 上 面 的 代码 到 文件 HyperlinkEX.java。 并 从 命令 提示 符 编 译 执行 它 如 下 。 


$javac HyperlinkEX.java 
$java HyperlinkEX 


它 会 生成 一 个 名 为 hyperlink.xlsx 在 当前 目录 中 的 Excel 文 件 并 显示 在 命令 提示 符 处 
输出 : 


hyperlink.xlsx written successfully 


hyperlink.xlsx 文 件 如 下 所 示 。 
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Apache POI 打 印 区 域 - POI 教 程 


本 章 介 绍 


了 如 何在 电子 表格 中 设置 打印 区 域 。 通 常 打 印 区 域 从 左上 角 到 Excel 电 子 


表格 右 下 角 。 打 印 区 域 可 根据 要 求 进行 定制 。 它 意味 着 可 以 从 整个 电子 表格 打印 单 
元 的 特定 范围 ， 自 定义 的 纸张 大 小 ， 用 网 格 线 打印 的 内 容 接 通 等 


以 下 代码 是 用 来 在 电子 表格 中 设置 打印 区 域 。 


import java.io.File; 
import java.io.FileOutputStream; 
import org.apache.poi.xssf.usermodel.XSSFPrintSetup; 


import 
import 


org.apache.poi.xssf.usermodel.XSSFSheet; 
org.apache.poi.xssf.usermodel.XSSFWorkbook; 


public class PrintArea 


( 


public static void main(String[] args)throws Exception 


( 


XSSFWorkbook workbook = new XSSFWorkbook( ); 
XSSFSheet spreadsheet - workbook 
.createSheet("Print Area"); 

//set print area with indexes 
workbook.setPrintArea( 

©, //sheet index 

0, //start column 

5, //end column 

0, //start row 

5 //end row 

); 

//set paper size 
spreadsheet.getPrintSetup().setPaperSize( 
XSSFPrintSetup.A4 PAPERSIZE); 

//set display grid lines or not 
spreadsheet.setDisplayGridlines(true); 


//set print grid lines or not 
spreadsheet.setPrintGridlines(true); 

FileOutputStream out = new FileOutputStream( 

new File("printarea.xlsx")); 

workbook.write(out); 

out.close(); 

System.out.println("printarea.xlsx written successfully"); 


让 我 们 保存 了 上 面 的 代码 为 PrintArea.java。 编 译 并 从 命令 提示 符 执 行 它 如 下 。 


$javac PrintArea.java 
$java PrintArea 


它 会 生成 一 个 名 为 printarea.xlsx 在 当前 目录 下 的 文件 ， 并 显示 在 命令 提示 符 处 输出 
以 下 。 


printarea.xlsx written successfully 
在 上 面 的 代码 中 ， 我 们 还 没有 添加 任何 单元 格 值 。 因 此 printarea.xlsx 是 一 个 空白 文 
件 。 但 是 可 以 在 下 图 的 打印 预览 显示 网 格 线 打 印 区 域 查看 。 
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本 章 介 绍 


并 插入 数 


了 POI 库 与 数据 库 的 交互 方式 。 有 了 JDBC 帮 助 ， 可 以 从 数据 库 中 检索 数据 
据 来 使 用 POI 库 电子 表格 。 让 我 们 考虑 SQL 操作 MySQL 数 据 库 。 


写 入 数据 库 


让 我 们 假设 数据 表 是 emp_tbl 存 有 履 员 信息 是 从 MySQL 数 据 库 test 中 检索 。 
EMP ID EMP NAME DEG SALARY DEPT 
1201 Gopal Technical Manager 45000 IT 
1202 Manisha Proof reader 45000 Testing 
1203 Masthanvali Technical Writer 45000 IT 
1204 Kiran Hr Admin 40000 HR 
1205 Kranthi Op Admin 30000 


使 用 下 面 的 代码 从 数据 库 中 检索 数据 ， 并 插入 到 同一 个 电子 表格 。 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
public 
{ 

pub 

{ 


java.io.File; 

java.io.FileOutputStream; 
java.sql.Connection; 
java.sql.DriverManager; 
java.sql.ResultSet; 

java.sql.Statement; 
org.apache.poi.xssf.usermodel.XSSFCell; 
org.apache.poi.xssf.usermodel.XSSFRow; 
org.apache.poi.xssf.usermodel.XSSFSheet; 
org.apache.poi.xssf.usermodel.XSSFWorkbook; 
class ExcelDatabase 


lic static void main(String[] args) throws Exception 


Class.forName("com.mysql.jdbc.Driver"); 
Connection connect - DriverManager.getConnection( 
"jdbc:mysq1://1localhost:3306/test" , 

oot 


Statement statement = connect.createStatement(); 
ResultSet resultSet = statement 
.executeQuery("select * from emp_tbl"); 
XSSFWorkbook workbook new XSSFWorkbook( ); 
XSSFSheet spreadsheet workbook 


.createSheet ("employe db"); 

XSSFRow row-spreadsheet.createRow(1); 

XSSFCell cell; 

cell-row.createCell(1); 

cell.setCellValue("EMP ID"); 

cell-row.createCell(2); 

cell.setCellValue("EMP NAME"); 

cell-row.createCell(3); 

cell.setCellValue("DEG"); 

cell-row.createCell(4); 

cell.setCellValue(" SALARY"); 

cell-row.createCell(5); 

cell.setCellValue("DEPT"); 

int i-2; 

while(resultSet.next()) 

{ 
row=spreadsheet.createRow(i); 
cell=row.createCell(1); 
cell.setCellValue(resultSet.getInt("eid")); 
cell-row.createCell(2); 
cell.setCellValue(resultSet.getString("ename") ); 
cell-row.createCell(3); 
cell.setCellValue(resultSet.getString("deg")); 
cell-row.createCell(4); 
cell.setCellValue(resultSet.getString("salary")); 
cell-row.createCell(5); 
cell.setCellValue(resultSet.getString("dept")); 
i++: 


, 


} 
FileOutputStream out = new FileOutputStream( 


new File("exceldatabase.xlsx")); 
workbook.write(out); 

out.close(); 

System.out.println( 

"exceldatabase.xlsx written successfully"); 


让 我 们 保存 了 上 面 的 代码 为 ExcelDatabase.java。 编 译 并 从 命令 提示 符 执 行 它 如 
Fo 


$javac ExcelDatabase.java 
$java ExcelDatabase 


它 会 生成 一 个 名 为 exceldatabase.xlsx 在 当前 目录 中 的 Exce| 文 件 并 显示 在 命令 提 : 
符 处 输出 以 下 。 


Pd 


exceldatabase.xlsx written successfully 
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exceldatabase.xlsx X (+40 FAIA. 


H €9- e = exceldatabase.xlsx - Excel 


? 


国 - O x 


FILE HOME INSERT  PAGELAYOUT FORMULAS DATA REVIEW VIEW satish ku... - 踪 





A B C D E 
1 a 
2 EMPID EMP NAME DEG SALARY 
3 1201 gopal technical manager 745000 
4 1202 manisha proof reader 745000 
5 1203 masthanvalli developer 740000 
6 1204 krian HrAdmin 40000 
7 1205 kranthi Op Admin 30000 
8 
9 
10 
11 











DEPT 
IT 
testing 
IT 

HR 


























employe db +) : [«] 
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AWT 教程 


JAVA 提供 了 一 组 丰富 的 平台 无 关 的 方式 来 创建 图 形 用 户 界 面 的 库 。 在 这 篇 文章 中 ， 
我 们 将 看 看 在 AWT (抽象 窗口 工具 包 ) 。 


读者 


本 教程 是 专 为 愿意 学 习 JAVA 的 GUI 编程 软件 专业 人 员 提 供 简单 轻松 的 和 人 门 步骤 。 本 
教程 将 让 你 对 JAVA 的 GUI 编程 有 一 个 概念 的 理解 ， 并 完成 本 教程 后 ， 您 可 以 把 自己 
的 专业 知识 水 平 较 高 的 专业 技术 水 平 。 


必 备 条 件 


继续 本 教程 之 前 ， 你 应 该 有 Java 编 程 语言 的 一 个 基本 的 了 解 ， 文 本 编辑 器 和 执行 程 
序 等 


AWT 概述 介绍 - ANT 


图 形 用 户 界 面 


图 形 用 户 界 面 (GU) 提供 用 户 交 互通 过 一 些 图 形 组 件 。 例 如 ， 我 们 的 基础 操作 系 
统 ， 还 提供 了 GUI， 通 过 窗口 ， 框 架 ， 面 板 ， 按 钮 ， 文 本 区 域 ， 列 表 框 ， 组 合 框 ， 
标签 ， 复 选 框 等 ， 这 些 都 被 称 为 组 件 。 使 用 这 些 组 件 ， 我 们 可 以 创建 一 个 应 用 程序 
交互 的 用 户 界 面 。 


完全 是 基于 GUI 提供 的 结果 为 最 终 用 户 响应 唤起 events.GUI 事 件 。 例 如 点 击 一 个 按 
钮 ， 关 闭 窗 口 ， 打 开 一 个 窗口 ， 输 入 的 东西 在 一 个 textarea 等 ， 这 些 活 动 被 称 为 
events.GUI 使 得 它 更 容易 为 最 终 用 户 使 用 的 应 用 程序 。 这 也 使 得 他 们 有 趣 。 


基本 名 词 术语 


^ 话 Wh 
术语 描述 


组 件 是 一 个 对 象 ， 具 有 可 以 显示 在 屏幕 上 ， 并 且 可 以 和 与 用 户 交 互 
Component ”的 图 形 表示 。 对 于 例子 按钮 ， 复 选 框 ， 列 表 和 滚动 条 的 图 形 用 户 
界面 。 


容器 对 象 中 是 一 个 组 件 ， 它 可 以 含有 其 它 成 分 。 添 加 到 容器 中 的 

Container ，， 组 件 列表 中 的 被 跟踪 。 列 表 中 的 顺序 将 定义 组 件 的 堆 各 顺序 从 前 
到 后 的 容器 内 。 如 果 未 指定 索引 ， 将 一 个 组 件 添加 到 容器 中 时 ， 
它 会 被 添加 到 列表 的 末尾 。 


me 面板 提供 了 空间 ， 在 其 中 一 个 应 用 程序 可 以 连接 任何 其 他 组 件 ， 
包括 其 他 面板 。 


窗口 是 显示 在 屏幕 上 的 一 个 矩形 区 域 。 在 不 同 的 窗口 中 ， 我 们 可 
以 执行 不 同 的 程序 ， 并 显示 不 同 的 数据 。 窗 口 为 我 们 提供 了 多 任 


Wingo 务 环境 。 一 个 窗口 ， 必 须 有 一 个 框 ， 对 话 框 ， 或 定义 为 它 的 主人 
时 ， 它 的 构造 的 另 一 个 窗口 。 
Frame 是 带 有 标题 和 边框 的 顶层 窗口 。 帧 的 大 小 ， 包 括 任何 指定 
Frame 为 边界 的 区 域 。 帧 封装 窗口 。 它 有 标题 栏 ， 菜 单 栏 ， 边 框 和 调整 
大 小 角落 。 
e Canvas 组 件 表 示 空 白 屏幕 上 的 应 用 程序 可 以 绘制 矩形 区 域 。 应 
用 程序 也 可 以 使 用 Canvas 组 件 ， 空 白 区 域 捕获 输入 事件 。 
基于 GUI 的 应 用 实例 


以 下 是 一 些 基于 图 形 用 户 界面 的 应 用 程序 的 例子 。 


自动 取款 机 (ATM) 
航空 票务 系统 

在 火车 站 的 信息 服务 亭 
移动 应 用 程序 

导航 系统 


图 形 用 户 界 面 较 字符 界面 的 优点 


GUI 提 供 图 形 化 的 图 标 进行 互动 ， 而 CUI (字符 用 户 界 面 ) 提供 简单 的 基于 文 
本 的 接口 。 


图 形 用 户 界面 ， 使 应 用 更 多 的 娱乐 性 和 趣味 性 ， 另 一 方面 CUI 没 有 《或 不 


多 ) 。 
GUI 提供 点 击 和 执行 环境 ， 而 在 CUI| 我 们 每 次 都 要 输入 命令 任务 。 


新 的 用 户 可 以 很 容易 地 与 图 形 用 户 界面 交互 的 视觉 指示 器 ， 但 很 难 在 字符 的 用 
户 界面 。 

GUI 提供 了 很 多 的 文件 系统 的 控制 和 操作 系统 ， 而 在 CUI， 必 须 使 用 命令 很 难 
记 住 。 

Windows 概 念 在 GUI 中 人 允许 用 户 查 看 ， 操 纵 和 控制 的 多 个 应 用 程序 一 次 ， 而 在 
CUI 用 户 可 以 在 同一 时 间 控 制 一 个 任务 。 

GUI 提 供 了 多 任务 环境 中 ， 使 CUl 也 没有 ， 但 CUI 不 提供 的 GUI 容 易 操作 。 


使 用 图 形 用 户 界面 ， 它 更 容易 控制 和 有 导航 的 操作 系统 ， 它 在 命令 的 用 户 界 面 变 
得 非常 慢 。 GUI 可 以 轻松 定制 。 


AWT 环境 设置 - AWT 


本 节 将 指导 如 何 下 载 并 设置 Java 在 您 的 机 器 上 。 请 按照 下 列 步骤 来 设置 环境 。 


Java SE 是 免费 提供 下 载 的 链接 Download Java. 所 以 ， 根 据 您 的 操作 系统 下 载 一 个 
版 本 。 


按照 说 明 下 载 java 和 运行 .exe 文 件 在 你 的 机 器 上 安装 Java。 一 旦 在 你 的 机 器 上 安装 
了 Java， 就 需要 设置 环境 变量 指向 正确 的 安装 目录 : 


设置 窗口 XP/WIN7 路 径 : 


假设 您 已 经 安装 了 Java 在 c:Program Filesjavajdk 目录 : 
e 右键 点 击 “ 我 的 电脑 ”， 选 择 “ 属 性 "。 
e 点 击 “ 环 境 变 量 " 按 钮 下 的 “高 级 "选项 卡 。 
e 现在 改变 的 “路 径 ? 变 量 ， 因 此 ， 它 也 包含 Java 可 执行 文件 的 路 径 。 例 如 ， 如 果 


路 径 当 前 设置 为 'C:WINDOWSSYSTEM32', 然 后 可 更 改 您 的 路 
径 'C:WINDOWSSYSTEM32;c:Program Filesjavajdkin'. 


适用 于 Linux，UNIX，Solaris 和 FreeBSD 的 路 径 : 
应 设置 环境 变量 PATH 指向 已 经 安装 Java 二 进 制 文 件 。 如 果 这 样 做 有 困难 ， 请 参 
阅 shell 文 件 。 


例如 ， 如 果 使 用 bash 作 为 shell， 添 加 以 下 行 到 结束 行 '.bashrc: export 
PATH-7/path/to/java:$ PATH' 


流行 的 Java 编 辑 器 : 
编写 Java 程 序 ， 您 将 需要 一 个 文本 编辑 器 。 有 更 复杂 的 IDE， 可 以 在 市 场 上 。 但 现 
在 ， 可 以 考虑 以 下 几 种 : 


e Notepad : 在 Windows 机 器 上 ， 你 可 以 使 用 任何 简单 的 文本 编辑 器 (如 记事 
A) (本 教程 推荐 ) ，TextPad。 


Netbeans : 是 一 个 Java IDE， 是 开源 和 免费 ， 可 以 直接 从 网 上 下 载 
http://www.netbeans.org/index.html. 


Eclipse : 也 是 一 个 Java IDE Eclipse 开源 社区 开发 的 ， 可 以 直接 从 网 上 下 载 
http://www.eclipse.org/. 


AWT#22(4(Controls) - AWT 


每 一 个 用 户 界面 参考 主要 有 以 下 三 个 方面 : 


e Ul TR: 有 核心 可 视 化 元 素 最 终 用 户 看 到 并 与 之 交互。 GWT 提 供 了 一 个 巨大 
的 名 单 变化 复杂 ， 我 们 将 在 本 教程 从 基本 的 广泛 使 用 和 常见 的 元 素 。 

e 布局 : 他 们 定义 的 UI 元 素 如 何 应 安 排 在 屏幕 上 ， 并 提供 一 个 最 终 的 外 观 和 感觉 
的 GUI (图 形 用 户 界 面 ) 。 在 “布局 "一 章 ， 这 部 分 将 被 覆盖 。 


° 行为 ; 这 些 事件 发 生 时 ， 与 用 户 交 互 的 UI 元 素 。 这 部 分 将 被 覆盖 在 "事件 义理 "一 


章 。 





le bai cont 


每 个 AWT 控 件 继承 组 件 类 的 属性 。 


控件 与 描述 
1 Component 组 件 是 一 个 抽象 的 超 类 的 GUI 控件 ， 并 用 图 形 表 示 ， 它 代 
表 了 一 个 对 象 。 
AWT 的 UI 元 素 : 


以 下 是 常用 的 控件 列表 而 设计 的 图 形 用 户 界面 使 用 AWT。 
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控件 与 描述 
Label 标签 对 象 是 在 容器 中 放置 文本 的 一 个 组 成 部 分 。 
Button 该 类 创建 标记 的 按钮 。 


Check Box 复 选 框 是 一 个 图 形 化 的 组 件 ， 它 可 以 在 一 个 ( 真 ) 或 关闭 
( 假 ) 的 状态 。 


Check Box Group CheckboxGroup 类 用 于 分 组 组 复 选 框 。 

List List 组 件 为 用 户 提 供 了 一 个 滚动 的 文本 项 列表 。 

Text Field TextField 对 象 是 一 个 文本 组 件 ， 它 允许 编辑 的 单行 文本 。 
Text Area 一 个 textarea 对 象 是 一 个 文本 组 件 ， 它 允许 编辑 的 多 行文 


o 


Choice 一 个 选择 控制 用 于 显示 弹出 菜单 选择 。 所 选 选 项 将 显示 在 顶部 
的 菜单 。 


Canvas Canvas 控 件 代 表 一 个 矩形 区 域 ， 应 用 程序 可 以 画 的 东西 ， 或 
者 可 以 由 用 户 创建 的 接收 输入 。 


Image 图 像 控 制 是 表示 图 形 图 像 的 所 有 图 像 类 的 超 类 。 
Scroll Bar 代表 一 个 滚动 条 的 滚动 条 控制 组 件 以 让 用 户 选择 的 值 来 自 
范围 。 


Dialog 一 个 对 话 框 控制 是 一 个 顶层 窗口 ， 采 取 某 种 形式 的 用 户 输入 的 
标题 和 边框 。 


File Dialog 一 个 FileDialog 的 控制 代表 一 个 对 话 框 窗口 ， 用 户 可 以 选择 
一 个 文件 。 


AWT Component# - AWT 


介绍 


Component 类 是 一 个 非 菜 单 用 户 界 面 控件 ， 是 AWT 一 个 抽象 基 类 。 组 件 表 示 图 形 
表示 的 对 象 。 


类 的 声明 
以 下 是 声明 的 java.awt.Component 类 : 


public abstract class Component 
extends Object 
implements ImageObserver, MenuContainer, Serializable 


ri ` 
字段 域 
以 下 是 java.awt.Component 类 的 字段 : 
e static float BOTTOM ALIGNMENT -- 易于 使 用 的 常数 getAlignmentY. 


e static float CENTER_ALIGNMENT -- 易于 使 用 的 常数 getAlignmentY 和 
getAlignmentX, 


e static float LEFT ALIGNMENT -- 易于 使 用 常数 getAlignmentX。 
e static float RIGHT ALIGNMENT -- 易于 使 用 常数 getAlignmentX。 
e static float TOP. ALIGNMENT -- 易于 使 用 的 常数 getAlignmentY(). 


X B AE WM 


S.N. 1338 P3 25 53-55 BA 
1 protected Component() 这 将 创建 一 个 新 的 组 件 。 


类 方法 


S.N. 方法 和 说 明 


boolean action(Event evt, Object what) Deprecated. As of JDK 


10 


11 


12 


13 


14 


version 1.1, should register this component as ActionListener on 
component which fires action events. 


void add(PopupMenu popup) Adds the specified popup menu to the 
component. 


void addComponentListener(ComponentListener I) Adds the 
specified component listener to receive component events from this 
component. 


void addFocusListener(FocusListener |) Adds the specified focus 
listener to receive focus events from this component when this 
component gains input focus. 


void addHierarchyBoundsListener(HierarchyBoundsListener l) 
Adds the specified hierarchy bounds listener to receive hierarchy 
bounds events from this component when the hierarchy to which this 
container belongs changes. 


void addHierarchyListener(HierarchyListener I) Adds the specified 
hierarchy listener to receive hierarchy changed events from this 
component when the hierarchy to which this container belongs 
changes. 


void addinputMethodListener(InputMethodListener |) Adds the 
specified input method listener to receive input method events from 
this component. 


void addKeyListener(KeyListener |) Adds the specified key listener 
to receive key events from this component. 


void addMouseListener(MouseListener I) Adds the specified mouse 
listener to receive mouse events from this component. 


void addMouseMotionListener(MouseMotionListener |) Adds the 
specified mouse motion listener to receive mouse motion events from 
this component. 


void addMouseWheelListener(MouseWheelListener I) Adds the 
specified mouse wheel listener to receive mouse wheel events from 
this component. 


void addNotify() Makes this Component displayable by connecting it 
to a native screen resource. 


void addPropertyChangeListener(PropertyChangeListener 
listener) Adds a PropertyChangeListener to the listener list. 


void addPropertyChangeListener(String propertyName, 
PropertyChangeListener listener) Adds a PropertyChangeListener 
to the listener list for a specific property. 


void applyComponentOrientation(ComponentOrientation 
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16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


orientation) Sets the ComponentOrientation property of this 
component and all components contained within it. 


boolean areFocusTraversalKeysSet(int id) Returns whether the Set 
of focus traversal keys for the given focus traversal operation has been 
explicitly defined for this Component. 


int checklmage(Image image, ImageObserver observer) Returns 
the status of the construction of a screen representation of the 
specified image. 


int checklmage(Image image,int width,int height, ImageObserver 
observer) Returns the status of the construction of a screen 
representation of the specified image. 


boolean contains(int x,int y) Checks whether this component 
"contains" the specified point, where x and y are defined to be relative 
to the coordinate system of this component. 


boolean contains(Point p) Checks whether this component 
"contains" the specified point, where the point's x and y coordinates 
are defined to be relative to the coordinate system of this component. 


Image createlmage(ImageProducer producer) Creates an image 
from the specified image producer. 


Image createlmage(int width,int height) Creates an off-screen 
drawable image to be used for double buffering. 


Volatilelmage createVolatilelmage(int width,int height) Creates a 
volatile off-screen drawable image to be used for double buffering. 


Volatilelmage createVolatilelmage(int width,int height, 
ImageCapabilities caps) Creates a volatile off-screen drawable 
image, with the given capabilities. 


void deliverEvent(Event e) Deprecated. As of JDK version 1.1, 
replaced by dispatchEvent(AWTEvent e). 


void disable() Deprecated. As of JDK version 1.1, replaced by 
setEnabled(boolean). 


protected void disableEvents(long eventsToDisable) Disables the 
events defined by the specified event mask parameter from being 
delivered to this component. 


void dispatchEvent(AWTEvent e) Dispatches an event to this 
component or one of its sub components. 


void doLayout() Prompts the layout manager to lay out this 
component. 


void enable() Deprecated. As of JDK version 1.1, replaced by 
setEnabled(boolean). 
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34 


35 


36 


37 


38 


39 


40 


41 


42 


43 
44 
45 
46 


47 
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void enable(boolean b) Deprecated. As of JDK version 1.1, replaced 
by setEnabled(boolean). 


protected void enableEvents(long eventsToEnable) Enables the 
events defined by the specified event mask parameter to be delivered 
to this component. 


void enablelnputMethods(boolean enable) Enables or disables 
input method support for this component. 


protected void firePropertyChange(String propertyName, boolean 
oldValue, boolean newValue) Support for reporting bound property 
changes for boolean properties. 


void firePropertyChange(String propertyName, byte oldValue, 
byte newValue) Reports a bound property change. 


void firePropertyChange(String propertyName, char oldValue, 
char newValue) Reports a bound property change. 


void firePropertyChange(String propertyName, double oldValue, 
double newValue) Reports a bound property change. 


void firePropertyChange(String propertyName, float oldValue, 
float newValue) Reports a bound property change. 


void firePropertyChange(String propertyName, long oldValue, 
long newValue) Reports a bound property change. 


protected void firePropertyChange(String propertyName, Object 
oldValue, Object newValue) Support for reporting bound property 
changes for Object properties. 


void firePropertyChange(String propertyName, short oldValue, 
short newValue) Reports a bound property change. 


AccessibleContext getAccessibleContext() Gets the 
AccessibleContext associated with this Component. 


float getAlignmentX() Returns the alignment along the x axis. 

float getAlignmentY() Returns the alignment along the y axis. 

Color getBackground() Gets the background color of this component. 
int getBaseline(int width,int height) Returns the baseline. 


Component.BaselineResizeBehavior getBaselineResizeBehavior() 
Returns an enum indicating how the baseline of the component 
changes as the size changes. 


Rectangle getBounds() Gets the bounds of this component in the 
form of a Rectangle object. 
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53 


54 


55 


56 


57 


58 


59 


60 


61 


62 


63 


64 


65 


66 


67 


Rectangle getBounds(Rectangle rv) Stores the bounds of this 
component into return value rv and return rv. 


ColorModel getColorModel() Gets the instance of ColorModel used 
to display the component on the output device. 


Component getComponentAt(int x,int y) Determines if this 
component or one of its immediate subcomponents contains the (x, y) 
location, and if so, returns the containing component. 


Component getComponentAt(Point p) Returns the component or 
subcomponent that contains the specified point. 


ComponentListener[] getComponentListeners() Returns an array of 
all the component listeners registered on this component. 


ComponentOrientation getComponentOrientation() Retrieves the 
language-sensitive orientation that is to be used to order the elements 
or text within this component. 


Cursor getCursor() Gets the cursor set in the component. 


DropTarget getDropTarget() Gets the DropTarget associated with this 
Component. 


Container getFocusCycleRootAncestor() Returns the Container 
which is the focus cycle root of this Component's focus traversal cycle. 


FocusListener[] getFocusListeners() Returns an array of all the 
focus listeners registered on this component. 


Set<AWTKeyStroke> getFocusTraversalKeys(int id) Returns the 
Set of focus traversal keys for a given traversal operation for this 
Component. 


boolean getFocusTraversalKeysEnabled() Returns whether focus 
traversal keys are enabled for this Component. 


Font getFont() Gets the font of this component. 


FontMetrics getFontMetrics(Font font) Gets the font metrics for the 
specified font. 


Color getForeground() Gets the foreground color of this component. 


Graphics getGraphics() Creates a graphics context for this 
component. 


GraphicsConfiguration getGraphicsConfiguration() Gets the 
GraphicsConfiguration associated with this Component. 


int getHeight() Returns the current height of this component. 


HierarchyBoundsListener[] getHierarchyBoundsListeners() 
Returns an array of all the hierarchy bounds listeners registered on this 
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component. 


HierarchyListener[] getHierarchyListeners() Returns an array of all 
the hierarchy listeners registered on this component. 


boolean getignoreRepaint() 


InputContext getinputContext() Gets the input context used by this 
component for handling the communication with input methods when 
text is entered in this component. 


InputMethodListener[] getlnputMethodListeners() Returns an array 
of all the input method listeners registered on this component. 


InputMethodRequests getinputMethodRequests() Gets the input 
method request handler which supports requests from input methods 
for this component. 


KeyListener[] getKeyListeners() Returns an array of all the key 
listeners registered on this component. 


«T extends EventListener> T[] getListeners(Class<T> 
listenerType) Returns an array of all the objects currently registered 
as FooListeners upon this Component. 


Locale getLocale() Gets the locale of this component. 


Point getLocation() Gets the location of this component in the form of 
a point specifying the component's top-left corner. 


Point getLocation(Point rv) Stores the x,y origin of this component 
into return value rv and return rv. 


Point getLocationOnScreen() Gets the location of this component in 
the form of a point specifying the component's top-left corner in the 
screen's coordinate space. 


Dimension getMaximumSize() Gets the maximum size of this 
component. 


Dimension getMinimumSize() Gets the mininimum size of this 
component. 


MouseListener[] getMouseListeners() Returns an array of all the 
mouse listeners registered on this component. 


MouseMotionListener[] getMouseMotionListeners() Returns an 
array of all the mouse motion listeners registered on this component. 


Point getMousePosition() Returns the position of the mouse pointer 
in this Component's coordinate space if the Component is directly 
under the mouse pointer, otherwise returns null. 


MouseWheelListener[] getMouseWheelListeners() Returns an array 
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of all the mouse wheel listeners registered on this component. 
String getName() Gets the name of the component. 
Container getParent() Gets the parent of this component. 


java.awt.peer.ComponentPeer getPeer() Deprecated. As of JDK 
version 1.1, programs should not directly manipulate peers; 
replaced by boolean isDisplayable(). 


Dimension getPreferredSize() Gets the preferred size of this 
component. 


PropertyChangeListener[] getPropertyChangeListeners() Returns 
an array of all the property change listeners registered on this 
component. 


PropertyChangeListener[] getPropertyChangeListeners(String 
propertyName) Returns an array of all the listeners which have been 
associated with the named property. 


Dimension getSize() Returns the size of this component in the form of 
a Dimension object. 


Dimension getSize(Dimension rv)Stores the width/height of this 
component into return value rv and return rv. 


Toolkit getToolkit() Gets the toolkit of this component. 


Object getTreeLock() Gets this component's locking object (the object 
that owns the thread sychronization monitor) for AWT component-tree 
and layout operations. 


int getWidth() Returns the current width of this component. 
int getX() Returns the current x coordinate of the components origin. 
int getY() Returns the current y coordinate of the components origin. 


boolean gotFocus(Event evt, Object what) Deprecated. As of JDK 
version 1.1, replaced by processFocusEvent(FocusEvent) . 


boolean handleEvent(Event evt) Deprecated. As of JDK version 1.1 
replaced by processEvent(AWT Event). 


boolean hasFocus() Returns true if this Component is the focus 
owner. 


void hide() Deprecated. As of JDK version 1.1, replaced by 
setVisible(boolean). 


boolean imageUpdate(Image img,int infoflags,int x,int y,int w,int 
h) Repaints the component when the image has changed. 


boolean inside(int x,int y) Deprecated. As of JDK version 1.1, 
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boolean inside(int x,int y) Deprecated. As of JDK version 1.1, 
replaced by contains(int, int). 


void invalidate() Invalidates this component. 


boolean isBackgroundSet() Returns whether the background color 
has been explicitly set for this Component. 


boolean isCursorSet() Returns whether the cursor has been explicitly 
set for this Component. 


boolean isDisplayable() Determines whether this component is 
displayable. 


boolean isDoubleBuffered() Returns true if this component is painted 
to an offscreen image (buffer) that's copied to the screen later. 


boolean isEnabled() Determines whether this component is enabled. 


boolean isFocusable() Returns whether this Component can be 
focused. 


boolean isFocusCycleRoot(Container container) Returns whether 
the specified Container is the focus cycle root of this Component's 
focus traversal cycle. 


boolean isFocusOwner() Returns true if this Component is the focus 
owner. 


boolean isFocusTraversable() Deprecated. As of 1.4, replaced by 
isFocusable(). 


boolean isFontSet() Returns whether the font has been explicitly set 
for this Component. 


boolean isForegroundSet() Returns whether the foreground color 
has been explicitly set for this Component. 


boolean isLightweight() A lightweight component doesn't have a 
native toolkit peer. 


boolean isMaximumSizeSet() Returns true if the maximum size has 
been set to a non-null value otherwise returns false. 


boolean isMinimumSizeSet() Returns whether or not 
setMinimumSize has been invoked with a non-null value. 


boolean isOpaque() Returns true if this component is completely 
opaque, returns false by default. 


boolean isPreferredSizeSet() Returns true if the preferred size has 
been set to a non-null value otherwise returns false. 


boolean isShowing() Determines whether this component is showing 
on screen. 


122 boolean isValid() Determines whether this component is valid. 


boolean isVisible() Determines whether this component should be 


129 visible when its parent is visible. 

124 boolean keyDown(Event evt,int key) Deprecated. As of JDK version 
1.1, replaced by processKeyEvent(KeyEvent). 

125 boolean keyUp(Event evt,int key) Deprecated. As of JDK version 
1.1, replaced by processKeyEvent(KeyE vent). 
void layout() Deprecated. As of JDK version 1.1, replaced by 

126 
doLayout(). 

127 void list() Prints a listing of this component to the standard system 
output stream System.out. 

128 void list(PrintStream out) Prints a listing of this component to the 
specified output stream. 

129 void list(PrintStream out,int indent) Prints out a list, starting at the 


specified indentation, to the specified print stream. 
130 | void list(PrintWriter out) Prints a listing to the specified print writer. 


void list(PrintWriter out,int indent) Prints out a list, starting at the 


191 specified indentation, to the specified print writer. 

132 Component locate(int x,int y) Deprecated. As of JDK version 1.1, 
replaced by getComponentAt(int, int). 

133 Point location() Deprecated. As of JDK version 1.1, replaced by 
getLocation(). 
boolean lostFocus(Event evt, Object what) Deprecated. As of JDK 

134 : 
version 1.1, replaced by processFocusEvent(FocusEvent). 

135 boolean mouseDown(Event evt,int x,int y) Deprecated. As of JDK 
version 1.1, replaced by processMouseEvent(MouseEvent). 

136 boolean mouseDrag(Event evt,int x,int y) Deprecated. As of JDK 
version 1.1, replaced by processMouseMotionEvent(MouseEvent). 

137 boolean mouseEnter(Event evt,int x,int y) Deprecated. As of JDK 
version 1.1, replaced by processMouseEvent(MouseE vent). 

138 boolean mouseExit(Event evt,int x,int y) Deprecated. As of JDK 
version 1.1, replaced by processMouseEvent(MouseEvent).. 

139 boolean mouseMove(Event evt,int x,int y) Deprecated. As of JDK 
version 1.1, replaced by processMouseMotionEvent(MouseEvent).. 

140 boolean mouseUp(Event evt,int x,int y) Deprecated. As of JDK 


version 1.1, replaced by processMouseEvent(MouseEvent). 
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void move(int x,int y) Deprecated. As of JDK version 1.1, replaced by 
setLocation(int, int). 


void nextFocus() Deprecated. As of JDK version 1.1, replaced by 
transferFocus(). 


void paint(Graphics g) Paints this component. 


void paintAll(Graphics g) Paints this component and all of its 
subcomponents. 


boolean postEvent(Event e) Deprecated. As of JDK version 1.1, 
replaced by dispatchEvent(AWT Event). 


boolean preparelmage(Image image,int width,int height, 
ImageObserver observer) Prepares an image for rendering on this 
component at the specified width and height. 


void print(Graphics g) Prints this component. 


void printAll(Graphics g) Prints this component and all of its 
subcomponents. 


protectedvoid processComponentEvent(ComponentEvent e) 
Processes component events occurring on this component by 
dispatching them to any registered ComponentListener objects. 


protected void processEvent(AWTEvent e) Processes events 
occurring on this component. 


protected void processFocusEvent(FocusEvent e) Processes 
focus events occurring on this component by dispatching them to any 
registered FocusListener objects. 


protected void processHierarchyBoundsEvent(HierarchyEvent e) 
Processes hierarchy bounds events occurring on this component by 
dispatching them to any registered HierarchyBoundsListener objects. 


protected void processHierarchyEvent(HierarchyEvent e) 
Processes hierarchy events occurring on this component by 
dispatching them to any registered HierarchyListener objects. 


protectedvoid processinputMethodEvent(InputMethodEvent e) 
Processes input method events occurring on this component by 
dispatching them to any registered InputMethodListener objects. 


protected void processKeyEvent(KeyEvent e) Processes key 
events occurring on this component by dispatching them to any 
registered KeyListener objects. 


protected void processMouseEvent(MouseEvent e) Processes 
mouse events occurring on this component by dispatching them to any 
registered MouseListener objects. 
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protected void processMouseMotionEvent(MouseE vent e) 
Processes mouse motion events occurring on this component by 
dispatching them to any registered MouseMotionListener objects. 


protected void processMouseWheelEvent(MouseWheelEvent e) 
Processes mouse wheel events occurring on this component by 
dispatching them to any registered MouseWheelListener objects. 


void remove(MenuComponent popup) Removes the specified 
popup menu from the component. 


void removeComponentListener(ComponentListener I) Removes 
the specified component listener so that it no longer receives 
component events from this component. 


void removeFocusListener(FocusListener I) Removes the specified 
focus listener so that it no longer receives focus events from this 
component. 


void removeHierarchyBoundsListener(HierarchyBoundsListener 
Il) Removes the specified hierarchy bounds listener so that it no longer 
receives hierarchy bounds events from this component. 


void removeHierarchyListener(HierarchyListener |) Removes the 
specified hierarchy listener so that it no longer receives hierarchy 
changed events from this component. 


void removelnputMethodListener(InputMethodListener |) Removes 
the specified input method listener so that it no longer receives input 
method events from this component. 


void removeKeyListener(KeyListener |) Removes the specified key 
listener so that it no longer receives key events from this component. 


void removeMouseListener(MouseListener I) Removes the 
specified mouse listener so that it no longer receives mouse events 
from this component. 


void removeMouseMotionListener(MouseMotionListener |) 
Removes the specified mouse motion listener so that it no longer 
receives mouse motion events from this component. 


void removeMouseWheelListener(MouseWheelListener l) 
Removes the specified mouse wheel listener so that it no longer 
receives mouse wheel events from this component. 


void removeNotify() Makes this Component undisplayable by 
destroying it native screen resource. 


void removePropertyChangeListener(PropertyChangeListener 
listener) Removes a PropertyChangeListener from the listener list. 


void removePropertyChangeListener(String propertyName, 
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PropertyChangeListener listener) Removes a 
PropertyChangeListener from the listener list for a specific property. 


void repaint() Repaints this component. 


void repaint(int x,int y,int width,int height) Repaints the specified 
rectangle of this component. 


void repaint(long tm) Repaints the component. 


void repaint(long tm, int x,int yint width,int height) Repaints the 
specified rectangle of this component within tm milliseconds. 


void requestFocus() Requests that this Component get the input 
focus, and that this Component's top-level ancestor become the 
focused Window. 


protected boolean requestFocus(boolean temporary) Requests 
that this Component get the input focus, and that this Component's 
top-level ancestor become the focused Window. 


boolean requestFocusInWindow() Requests that this Component 
get the input focus, if this Component's top-level ancestor is already 
the focused Window. 


protected boolean requestFocusInWindow(boolean temporary) 
Requests that this Component get the input focus, if this Component's 
top-level ancestor is already the focused Window. 


void reshape(int x,int y,int width,int height) Deprecated. As of JDK 
version 1.1, replaced by setBounds(int, int, int, int). 


void resize(Dimension d) Deprecated. As of JDK version 1.1, 
replaced by setSize(Dimension). 


void resize(int width,int height) Deprecated. As of JDK version 1.1, 
replaced by setSize(int, int). 


void setBackground(Color c) Sets the background color of this 
component. 


void setBounds(int x,int y,int width,int height) Moves and resizes 
this component. 


void setBounds(Rectangle r) Moves and resizes this component to 
conform to the new bounding rectangle r. 


void setComponentOrientation(ComponentOrientation o) Sets the 
language-sensitive orientation that is to be used to order the elements 
or text within this component. 


void setCursor(Cursor cursor) Sets the cursor image to the specified 
cursor. 
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void setDropTarget(DropTarget dt) Associate a DropTarget with this 
component. 


void setEnabled(boolean b) Enables or disables this component, 
depending on the value of the parameter b. 


void setFocusable(boolean focusable) Sets the focusable state of 
this Component to the specified value. 


void setFocusTraversalKeys(int id, Set<? extends 
AWTKeyStroke> keystrokes) Sets the focus traversal keys for a 
given traversal operation for this Component. 


void setFocusTraversalKeysEnabled(boolean 
focus TraversalKeysEnabled) Sets whether focus traversal keys are 
enabled for this Component. 


void setFont(Font f) Sets the font of this component. 


void setForeground(Color c) Sets the foreground color of this 
component. 


void setlgnoreRepaint(boolean ignoreRepaint) Sets whether or not 
paint messages received from the operating system should be ignored. 


void setLocale(Locale |) Sets the locale of this component. 
void setLocation(int x,int y) Moves this component to a new location. 
void setLocation(Point p) Moves this component to a new location. 


void setMaximumSize(Dimension maximumSize) Sets the 
maximum size of this component to a constant value. 


void setMinimumSize(Dimension minimumSize) Sets the minimum 
size of this component to a constant value. 


void setName(String name) Sets the name of the component to the 
specified string. 


void setPreferredSize(Dimension preferredSize) Sets the preferred 
size of this component to a constant value. 


void setSize(Dimension d) Resizes this component so that it has 
width d.width and height d.height. 


void setSize(int width,int height) Resizes this component so that it 
has width width and height height. 


void setVisible(boolean b) Shows or hides this component 
depending on the value of parameter b. 


void show() Deprecated. As of JDK version 1.1, replaced by 
setVisible(boolean). 


void show(boolean b) Deprecated. As of JDK version 1.1, replaced 


207 by setVisible(boolean). 


208 Dimension size() Deprecated. As of JDK version 1.1, replaced by 
getSize(). 


209 String toString() Returns a string representation of this component 
and its values. 


void transferFocus() Transfers the focus to the next component, as 
210 
though this Component were the focus owner. 


void transferFocusBackward() Transfers the focus to the previous 
211 
component, as though this Component were the focus owner. 


242 void transferFocusUpCycle() Transfers the focus up one focus 
traversal cycle. 


213 . void update(Graphics g) Updates this component. 
214 . void validate() Ensures that this component has a valid layout. 


Rectangle bounds() Deprecated. As of JDK version 1.1, replaced by 


ne getBounds(). 


protected AWTEvent coalesceEvents(AWTEvent existingEvent, 
216 AWTEvent newEvent) Potentially coalesce an event being posted 
with an existing event. 


protected String paramString() Returns a string representing the 


alt state of this component. 


protected void firePropertyChange(String propertyName,int 
218 . oldValue,int newValue) Support for reporting bound property changes 
for integer properties. 


249 Dimension preferredSize() Deprecated. As of JDK version 1.1, 
replaced by getPreferredSize(). 


220 boolean preparelmage(Image image, ImageObserver observer) 
Prepares an image for rendering on this component. 


Dimension minimumSize() Deprecated. As of JDK version 1.1, 
221 gn 
replaced by getMinimumSize(). 


继承 的 方法 


这 个 类 继承 的 方法 从 以 下 类 : 


e java.lang.Object 
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er -种 被 动 的 控制 ， 因为 它 不 会 由 用 户 访问 产生 任何 事件 。 Label 控 件 是 一 个 
对 象 标签 。 一 个 标签 显示 一 行 只 读 文 本 。 然 而 ， 文 本 可 以 由 应 用 程序 改变 ， 但 不 能 
由 最 终 a 户 以 任何 方式 改变 。 

类 的 声明 

以 下 是 声明 的 java.awt.Label 类 : 


public class Label 
extends Component 
implements Accessible 


ron EL 
字段 域 
以 下 是 java.awt.Component 类 的 字段 : 
e static int CENTER -- 表示 标签 应 为 中 心 对 齐 。 
e static int LEFT -- 表示 应 左 对 齐 标签 
e static int RIGHT -- 表示 应 右 对 齐 


KN 44 35s ERI 


S.N. 构造 画 数 与 说 明 
1 Label() Constructs an empty label. 
2 Label(String text) Constructs a new label with the specified string of 


text, left justified. 


3 Label(String text, int alignment) Constructs a new label that 
presents the specified string of text with the specified alignment. 


S.N. 方法 和 说 明 


1 void addNotify() Creates the peer for this label. 

2 AccessibleContext getAccessibleContext() Gets the 
AccessibleContext associated with this Label. 

3 int getAlignment() Gets the current alignment of this label. 

4 String getText() Gets the text of this label. 

5 protected String paramString() Returns a string representing the 
state of this Label. 

6 void setAlignment(int alignment) Sets the alignment for this label to 
the specified alignment. 

7 void setText(String text) Sets the text for this label to the specified 
text. 


继承 的 方法 


这 个 类 继承 的 方法 从 以 下 类 : 
e java.awt.Component 


e java.lang.Object 


标签 示例 
说 在 您 选择 使 用 编辑 器 创建 以 下 java 程 序 D:/ > AWT > com > yiibai.com > gui > 


AwtControlDemo 


package com.yiibai.gui; 


import java.awt.*; 
import java.awt.event.*; 


public class AwtControlDemo { 


private Frame mainFrame; 

private Label headerLabel; 
private Label statusLabel; 
private Panel controlPanel; 


public AwtControlDemo()1 
prepareGUI(); 


public static void main(String[] args){ 
AwtControlDemo awtControlDemo = new AwtControlDemo(); 
awtControlDemo.showLabelDemo(); 


j 


private void prepareGUI(){ 
mainFrame - new Frame("Java AWT Examples"); 
mainFrame.setSize(400,400); 
mainFrame.setLayout(new GridLayout(3, 1)); 
mainFrame.addwindowListener(new WindowAdapter() ( 
public void windowClosing(WindowEvent windowEvent ) { 
System.exit(0); 
j 


tls 
headerLabel - new Label(); 


headerLabel.setAlignment(Label.CENTER); 
statusLabel - new Label(); 
statusLabel.setAlignment(Label.CENTER); 
statusLabel.setSize(350,100); 


controlPanel - new Panel(); 
controlPanel.setLayout(new FlowLayout()); 


mainFrame.add(headerLabel); 
mainFrame.add(controlPanel); 
mainFrame.add(statusLabel); 
mainFrame.setVisible(true); 


j 


private void showLabelDemo(){ 
headerLabel.setText("Control in action: Label"); 


Label label - new Label(); 

label.setText("Welcome to TutorialsPoint AWT Tutorial."); 
label.setAlignment(Label.CENTER); 
label.setBackground(Color.GRAY); 
label.setForeground(Color.WHITE); 
controlPanel.add(label); 


mainFrame.setVisible(true); 


编译 程序 ， 使 用 命令 提示 符 。 到 D:/ > AWT 然后 键入 以 下 命令。 


D:AWT>javac comyiibaiguiAwtControlDemo. java 


如 果 没 有 错误 出 现 ， 这 意味 着 编译 成 功 。 使 用 下 面 的 命令 来 运行 程序 。 


TutorialsPoint Java 技术 教程 


D:AWT>java com. yiibai.gui.AwtControlDemo 


验证 下 面 的 输出 


EJ Java AWT Examples 


Control in action: Label 


Welcome to TutorialsPoint AT Tutorial 
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AWT Button # - AWT 
介绍 


按钮 是 一 个 控制 组 件 ， 按 下 时 有 一 个 标签 ， 并 生成 一 个 事件 。 当 按钮 被 按 下 和 释 
放 ，AWT 发 送 ActionEvent 的 一 个 实例 的 按钮 ， 通 过 调用 按钮 上 的 processEvent。 
按钮 的 processEvent 方 法 接收 所 有 事件 的 按钮 ， 它 通过 一 个 动作 事件 以 及 调用 其 自 
身 的 processActionEvent 方 法 。 后 一 种 方法 通过 操作 事件 的 动作 的 已 注册 侦 听 此 按 
钮 所 产生 的 动作 事件 。 


如 果 一 个 应 用 程序 需要 一 个 按钮 被 按 下 和 释放 的 基础 上 执行 一 些 动作 ， 但 要 实现 
ActionListener 并 注册 新 的 侦 听 器 接收 事件 从 这 个 按钮 ， 调 用 按钮 的 
addActionListener 方 法 。 应 用 程序 可 以 利用 按钮 的 动作 命令 的 消息 传递 协议 。 


Sy + 
类 的 声明 
以 下 是 声明 的 java.awt.Button 类 : 


public class Button 
extends Component 
implements Accessible 


SHE y: 
3 B3 44138 ELA 
S.N. 构造 画 数 与 说 明 
1 Button() Constructs a button with an empty string for its label. 
2 Button(String text) Constructs a new button with specified label. 


S.N. 


10 


11 


12 


13 


方法 和 说 明 
void addActionListener(ActionListener I) Adds the specified action 
listener to receive action events from this button. 


void addNotify() Creates the peer of the button. 


AccessibleContext getAccessibleContext() Gets the 
AccessibleContext associated with this Button. 


String getActionCommand() Returns the command name of the 
action event fired by this button. 


ActionListener[] getActionListeners() Returns an array of all the 
action listeners registered on this button. 


String getLabel() Gets the label of this button. 


<T extends EventListener> T[] getListeners(Class<T> 
listenerType) Returns an array of all the objects currently registered 
as FooListeners upon this Button. 


protected String paramString() Returns a string representing the 
state of this Button. 


protected void processActionEvent(ActionEvent e) Processes 
action events occurring on this button by dispatching them to any 
registered ActionListener objects. 


protected void processEvent(AWTEvent e) Processes events on 
this button. 


void removeActionListener(ActionListener |) Removes the 
specified action listener so that it no longer receives action events from 
this button. 


void setActionCommand(String command) Sets the command 
name for the action event fired by this button. 


void setLabel(String label) Sets the button's label to be the specified 
string. 


继承 的 方法 


这 个 类 继承 的 方法 从 以 下 类 : 


e java.awt.Component 


e java.lang.Object 


按钮 实例 


选择 使 用 编辑 器 创建 以 下 java 程 序 D:/ > AWT > com > yiibai.com > gui > 


AwtControlDemo.java 


package com.yiibai.gui; 


import java.awt.*; 
import java.awt.event.*; 


public class AwtControlDemo { 


private Frame mainFrame; 

private Label headerLabel; 
private Label statusLabel; 
private Panel controlPanel; 


public AwtControlDemo() { 
prepareGUI(); 
j 


public static void main(String[] args){ 
AwtControlDemo  awtControlDemo - new AwtControlDemo(); 
awtControlDemo.showButtonDemo(); 


j 


private void prepareGUI(){ 
mainFrame - new Frame("Java AWT Examples"); 
mainFrame.setSize(400,400); 
mainFrame.setLayout(new GridLayout(3, 1)); 
mainFrame.addwindowListener(new WindowAdapter() { 
public void windowClosing(WindowEvent windowEvent ) { 
System.exit(0); 
j 
3): 


headerLabel - new Label(); 
headerLabel.setAlignment(Label.CENTER); 
statusLabel - new Label(); 
statusLabel.setAlignment(Label.CENTER); 
statusLabel.setSize(350,100); 


controlPanel - new Panel(); 
controlPanel.setLayout(new FlowLayout()); 


mainFrame.add(headerLabel); 
mainFrame.add(controlPanel); 
mainFrame.add(statusLabel); 
mainFrame.setVisible(true); 


j 


private void showButtonDemo(){ 
headerLabel.setText("Control in action: Button"); 


Button okButton = new Button("OK"); 
Button submitButton - new Button("Submit"); 
Button cancelButton - new Button("Cancel"); 


okButton.addActionListener(new ActionListener() ( 
public void actionPerformed(ActionEvent e) { 
statusLabel.setText("Ok Button clicked."); 
j 
3); 


submitButton.addActionListener(new ActionListener() { 
public void actionPerformed(ActionEvent e) { 
statusLabel.setText("Submit Button clicked."); 
j 
3); 


cancelButton.addActionListener(new ActionListener() { 
public void actionPerformed(ActionEvent e) { 
statusLabel.setText("Cancel Button clicked."); 
j 
3); 


controlPanel.add(okButton); 
controlPanel.add(submitButton); 
controlPanel.add(cancelButton); 


mainFrame.setVisible(true); 


编译 程序 ， 使 用 命令 提示 符 。 到 D:/ AWT 然后 键入 以 下 命令 。 


D:AWT>javac comyiibaiguiAwtControlDemo.java 


如 果 没 有 错误 出 现 ， 这 意味 着 编译 成 功 。 使 用 下 面 的 命令 来 运行 程序 。 


D:AWT>java com.yiibai.gui.AwtControlDemo 


验证 下 面 的 输出 


TutorialsPoint Java 技术 教程 


El Java AWT Examples 


Control in action: Button 


Ok Button clicked. 
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AWT CheckBox X: - AWT 


介绍 


CheckBox 控 件 是 用 来 开启 选项 (true) 或 关闭 (false) 。 每 个 复 选 框 标签 代表 的 复 
选 框 做 什么 。 通 过 点 击 它 可 以 改变 一 个 复 选 框 的 状态 。 


类 的 声明 
以 下 是 声明 的 java.awt.Checkbox 类 : 


public class Checkbox 
extends Component 
implements ItemSelectable, Accessible 


S.N. 1335 ES 235-36 HR 

1 Checkbox() Creates a check box with an empty string for its label. 

2 Checkbox(String label) Creates a check box with the specified label. 
3 Checkbox(String label, boolean state) Creates a check box with the 


specified label and sets the specified state. 


Checkbox(String label, boolean state, CheckboxGroup group) 
4 Constructs a Checkbox with the specified label, set to the specified 
state, and in the specified check box group. 


Checkbox(String label, CheckboxGroup group, boolean state) 
5 Creates a check box with the specified label, in the specified check 
box group, and set to the specified state. 


S.N. 


12 


13 


14 


15 


16 


方法 和 说 明 
void addltemListener(ItemListener I) Adds the specified item listener 
to receive item events from this check box. 
void addNotify() Creates the peer of the Checkbox. 


AccessibleContext getAccessibleContext() Gets the 
AccessibleContext associated with this Checkbox. 


CheckboxGroup getCheckboxGroup() Determines this check box's 
group. 


ItemListener[] getltemListeners() Returns an array of all the item 
listeners registered on this checkbox. 


String getLabel() Gets the label of this check box. 


«T extends EventListener>T[] getListeners(Class<T> 
listenerType) Returns an array of all the objects currently registered 
as FooListeners upon this Checkbox. 


Object[] getSelectedObjects() Returns an array (length 1) containing 
the checkbox label or null if the checkbox is not selected. 


boolean getState() Determines whether this check box is in the on or 
off state. 


protected String paramString() Returns a string representing the 
state of this Checkbox. 


protected void processEvent(AWTEvent e) Processes events on 
this check box. 


protected void processltemEvent(ItemEvent e) Processes item 
events occurring on this check box by dispatching them to any 
registered ItemListener objects. 


void removeltemListener(ItemListener |) Removes the specified 
item listener so that the item listener no longer receives item events 
from this check box. 


void setCheckboxGroup(CheckboxGroup g) Sets this check box's 
group to the specified check box group. 


void setLabel(String label) Sets this check box's label to be the string 
argument. 


void setState(boolean state) Sets the state of this check box to the 
specified state. 


继承 的 方法 


这 个 类 继承 的 方法 从 以 下 类 : 
e java.awt.Component 


e java.lang.Object 


CheckBox 的 示例 


说 在 您 选择 使 用 的 编辑 器 创建 以 下 java 程 序 D:/ > AWT > com > yiibai.com > gui > 


AwtControlDemo.java 


package com.yiibai.gui; 


import java.awt.*; 
import java.awt.event.*; 


public class AwtControlDemo { 


private Frame mainFrame; 

private Label headerLabel; 
private Label statusLabel; 
private Panel controlPanel; 


public AwtControlDemo()1 
prepareGUI(); 
} 


public static void main(String[] args){ 
AwtControlDemo awtControlDemo = new AwtControlDemo(); 
awtControlDemo.showCheckBoxDemo( ); 


} 


private void prepareGUI(){ 
mainFrame = new Frame("Java AWT Examples"); 
mainFrame.setSize(400, 400); 
mainFrame.setLayout(new GridLayout(3, 1)); 
mainFrame.addwindowListener(new WindowAdapter() { 
public void windowClosing(WindowEvent windowEvent ) { 
System.exit(0); 
} 


}); 
headerLabel = new Label(); 


headerLabel.setAlignment(Label.CENTER); 
statusLabel - new Label(); 
statusLabel.setAlignment(Label.CENTER); 
statusLabel.setSize(350,100); 


controlPanel - new Panel(); 
controlPanel.setLayout(new FlowLayout()); 


mainFrame.add(headerLabel); 
mainFrame.add(controlPanel); 
mainFrame.add(statusLabel); 
mainFrame.setVisible(true); 


j 

private void showCheckBoxDemo()1 
headerLabel.setText("Control in action: CheckBox"); 
Checkbox chkApple new Checkbox("Apple"); 


Checkbox chkMango - new Checkbox("Mango"); 
Checkbox chkPeer - new Checkbox("Peer"); 


chkApple.addItemListener(new ItemListener() { 
public void itemStateChanged(ItemEvent e) { 
statusLabel.setText("Apple Checkbox: " 
+ (e.getStateChange( )==1?"checked": "unchecked")); 
} 
}); 


chkMango.addItemListener(new ItemListener() { 
public void itemStateChanged(ItemEvent e) { 
statusLabel.setText("Mango Checkbox: " 
+ (e.getStateChange( )==1?"checked": "unchecked")); 
} 
}); 


chkPeer.addItemListener(new ItemListener() { 
public void itemStateChanged(ItemEvent e) { 


statusLabel.setText("Peer Checkbox: " 
+ (e.getStateChange( )==1?"checked": "unchecked")); 


} 
}); 


controlPanel.add(chkApple); 
controlPanel.add(chkMango); 
controlPanel.add(chkPeer); 


mainFrame.setVisible(true); 


LE 到 
编译 程序 ， 使 用 命令 提示 符 。 到 D:/ AWT 然后 键 人 以 下 命令 。 


D:AWT>javac comyiibaiguiAwtControlDemo.java 


如 果 没 有 错误 出 现 ， 这 意味 着 编译 成 功 。 使 用 下 面 的 命令 来 运行 程序 。 


TutorialsPoint Java 技术 教程 


D:AWT>java com. yiibai.gui.AwtControlDemo 


验证 下 面 的 输出 


Java AWT Examples 


Control in action: CheckBox 


Apple Checkbox: checked 
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AWT List - AWT 

介绍 

List 是 一 个 文本 项 列表 。 该 列表 可 以 被 配置 给 该 用 户 可 以 选择 一 个 或 多 个 项 目 。 
类 的 声明 

以 下 是 的 声明 类 java.awt.List : 


public class List 
extends Component 
implements ItemSelectable, Accessible 


S.N. ie AS jt HH 
1 List() Creates a new scrolling list. 
2 List(int rows) Creates a new scrolling list initialized with the specified 


number of visible lines. 


3 List(int rows, boolean multipleMode) Creates a new scrolling list 
initialized to display the specified number of rows. 


类 方法 


T[] getListeners(Class listenerType) 目前 注册 的 所 有 对 象 作 为 FooListeners 名 单 后 
返回 一 个 数组 。 


S.N. Method & Description 

1 void add(String item) Adds the specified item to the end of scrolling 
list. 

2 void add(String item, int index) Adds the specified item to the the 


scrolling list at the position indicated by the index. 


void addActionListener(ActionListener I) Adds the specified action 
listener to receive action events from this list. 


void addltem(String item) Deprecated. replaced by add(String). 


void addltem(String item, int index) Deprecated. replaced by 
add(String, int). 


void addltemListener(ItemListener I) Adds the specified item listener 
to receive item events from this list. 


void addNotify() Creates the peer for the list. 


boolean allowsMultipleSelections() Deprecated. As of JDK version 
1.1, replaced by isMultipleMode(). 


void clear() Deprecated. As of JDK version 1.1, replaced by 
removeAll(). 


int countltems() Deprecated. As of JDK version 1.1, replaced by 
getltemCount(). 


void delltem(int position) Deprecated. replaced by remove(String) 
and remove(int). 


void delltems(int start, int end) Deprecated. As of JDK version 1.1, 
Not for public use in the future. This method is expected to be retained 
only as a package private method. 


void deselect(int index) Deselects the item at the specified index. 


AccessibleContext getAccessibleContext() Gets the 
AccessibleContext associated with this List. 


ActionListener[] getActionListeners() Returns an array of all the 
action listeners registered on this list. 


String getltem(int index) Gets the item associated with the specified 
index. 


int getltemCount() Gets the number of items in the list. 


ItemListener[] getltemListeners() Returns an array of all the item 
listeners registered on this list. 


String[] getltems() Gets the items in the list. 


Dimension getMinimumSize() Determines the minimum size of this 
scrolling list. 


Dimension getMinimumSize(int rows) Gets the minumum 
dimensions for a list with the specified number of rows. 


Dimension getPreferredSize() Gets the preferred size of this scrolling 
list. 


Dimension getPreferredSize(int rows) Gets the preferred 
dimensions for a list with the specified number of rows. 


24 
25 
26 
27 


28 


29 


30 


31 


32 


33 


34 


35 


36 


37 


38 


39 


40 


41 


42 


int getRows() Gets the number of visible lines in this list. 

int getSelectedIndex() Gets the index of the selected item on the list, 
int[] getSelectedIndexes() Gets the selected indexes on the list. 
String getSelectedltem() Gets the selected item on this scrolling list. 


String[] getSelectedltems() Gets the selected items on this scrolling 
list. 


Object[] getSelectedObjects() Gets the selected items on this 
scrolling list in an array of Objects. 


int getVisiblelndex() Gets the index of the item that was last made 
visible by the method makeVisible. 


boolean isIndexSelected(int index) Determines if the specified item 
in this scrolling list is selected. 


boolean isMultipleMode() Determines whether this list allows multiple 
selections. 


boolean isSelected(int index) Deprecated. As of JDK version 1.1, 
replaced by isIndexSelected(int). 


void makeVisible(int index) Makes the item at the specified index 
visible. 


Dimension minimumSize() Deprecated. As of JDK version 1.1, 
replaced by getMinimumSize(). 


Dimension minimumSize(int rows) Deprecated. As of JDK version 
1.1, replaced by getMinimumSize(int). 


protected String paramString() Returns the parameter string 
representing the state of this scrolling list. 


Dimension preferredSize() Deprecated. As of JDK version 1.1, 
replaced by getPreferredSize(). 


Dimension preferredSize(int rows) Deprecated. As of JDK version 
1.1, replaced by getPreferredSize(int). 


protected void processActionEvent(ActionEvent e) Processes 
action events occurring on this component by dispatching them to any 
registered ActionListener objects. 


protected void processEvent(AWTEvent e) Processes events on 
this scrolling list. 


protected void processltemEvent(ItemEvent e) Processes item 
events occurring on this list by dispatching them to any registered 
ItemListener objects. 


43 


44 


45 


46 


47 


48 


49 


50 


51 


52 


void remove(int position) Removes the item at the specified position 
from this scrolling list. 


void remove(String item) Removes the first occurrence of an item 
from the list. 


void removeActionListener(ActionListener |) Removes the 
specified action listener so that it no longer receives action events from 
this list. 


void removeAll() Removes all items from this list. 


void removeltemListener(ItemListener |) Removes the specified 
item listener so that it no longer receives item events from this list. 


void removeNotify() Removes the peer for this list. 


void replaceltem(String newValue, int index) Replaces the item at 
the specified index in the scrolling list with the new string. 


void select(int index) Selects the item at the specified index in the 
scrolling list. 


void setMultipleMode(boolean b) Sets the flag that determines 
whether this list allows multiple selections. 


void setMultipleSelections(boolean b) Deprecated. As of JDK 
version 1.1, replaced by setMultipleMode(boolean). 


继承 的 方法 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.awt.Component 


e java.lang.Object 


List 示例 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 D:/ > AWT > com > yiibai.com > gui > 


AwtControlDemo 


package com.yiibai.gui; 


import java.awt.*; 
import java.awt.event.*; 


public class AwtControlDemo { 


private Frame mainFrame; 

private Label headerLabel; 
private Label statusLabel; 
private Panel controlPanel; 


public AwtControlDemo( ){ 
prepareGUI(); 
j 


public static void main(String[] args){ 
AwtControlDemo  awtControlDemo - new AwtControlDemo(); 
awtControlDemo.showListDemo(); 


j 


private void prepareGUI(){ 
mainFrame = new Frame("Java AWT Examples"); 
mainFrame.setSize(400,400); 
mainFrame.setLayout(new GridLayout(3, 1)); 
mainFrame.addwindowListener(new WindowAdapter() { 
public void windowClosing(WindowEvent windowEvent ) { 
System.exit(0); 
j 
3): 


headerLabel - new Label(); 
headerLabel.setAlignment(Label.CENTER); 
statusLabel - new Label(); 
statusLabel.setAlignment(Label.CENTER); 
statusLabel.setSize(350,100); 


controlPanel - new Panel(); 
controlPanel.setLayout(new FlowLayout()); 


mainFrame.add(headerLabel); 
mainFrame.add(controlPanel); 
mainFrame.add(statusLabel); 
mainFrame.setVisible(true); 


j 


private void showListDemo(){ 


headerLabel.setText("Control in action: List"); 
final List fruitList = new List(4, false); 


fruitList.add("Apple"); 
fruitList.add("Grapes"); 
fruitList.add("Mango"); 
fruitList.add("Peer"); 


final List vegetableList = new List(4,true); 
vegetableList.add("Lady Finger"); 


vegetableList.add("Onion"); 
vegetableList.add("Potato"); 


vegetableList.add("Tomato"); 
Button showButton = new Button("Show"); 
showButton.addActionListener(new ActionListener() { 


public void actionPerformed(ActionEvent e) { 
String data = "Fruits Selected: " 
+ fruitList.getItem(fruitList .getSelectedIndex()); 
data += ", Vegetables selected: "; 
for(String vegetable: vegetableList.getSelectedItems() ): 
data += vegetable + " "; 
} 


statusLabel.setText(data); 
} 
25 


controlPanel.add(fruitList); 
controlPanel.add(vegetableList ); 
controlPanel.add(showButton); 


mainFrame.setVisible(true); 





编译 程序 ， 使 用 命令 提示 符 。 到 DI» AWT 然后 键入 以 下 命令 。 


D:AWT>javac comyiibai.comguiAwtControlDemo. java 
如 果 没 有 错误 出 现 ， 这 意味 着 编译 成 功 。 使 用 下 面 的 命令 来 运行 程序 。 
D:AWT>java com.yiibai.gui.AwtControlDemo 


验证 下 面 的 输出 


TutorialsPoint Java 技术 教程 


El Java AWT Examples 


Control in action: List 


Fruits Selected: Grapes, Vegetables selected: Lady Finger Onion 
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AWT Choice X - AWT 


介绍 


选择 用 于 控制 显示 弹出 菜单 选择 。 所 选 选 项 将 显示 在 顶部 的 菜单 。 


类 的 声明 


以 下 是 声明 的 java.awt.Choice 类 : 


public class Choice 


extends Component 


implements ItemSelectable, Accessible 


X B AE WM 


S.N. 


TIS ES CR 描述 


Choice() () Creates a new choice menu. 


类 方法 


S.N. 


方法 & 描述 
void add(String item) Adds an item to this Choice menu. 
void addltem(String item) Obsolete as of Java 2 platform v1.1. 


void addltemListener(ItemListener |) Adds the specified item listener 
to receive item events from this Choice menu. 


void addNotify() Creates the Choice's peer. 


int countltems() Deprecated. As of JDK version 1.1, replaced by 
getltemCount(). 


AccessibleContext getAccessibleContext() Gets the 
AccessibleContext associated with this Choice. 


String getltem(int index) Gets the string at the specified index in this 
Choice menu. 


int getltemCount() Returns the number of items in this Choice menu. 


10 
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12 
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17 


18 


19 


20 


21 


22 


23 


ItemListener[] getltemListeners() Returns an array of all the item 
listeners registered on this choice. 


«T extends EventListener> T[] getListeners(Class<T> 
listenerType) Returns an array of all the objects currently registered 
as FooListeners upon this Choice. 


int getSelectedIndex() Returns the index of the currently selected 
item. 


String getSelectedltem() Gets a representation of the current choice 
as a string. 


Object[] getSelectedObjects() Returns an array (length 1) containing 
the currently selected item. 


void insert(String item, int index) Inserts the item into this choice at 
the specified position. 


protected String paramString() Returns a string representing the 
state of this Choice menu. 


protected void processEvent(AWTEvent e) Processes events on 
this choice. 


protected void processltemEvent(ItemEvent e) Processes item 
events occurring on this Choice menu by dispatching them to any 
registered ItemListener objects. 


void remove(int position) Removes an item from the choice menu at 
the specified position. 


void remove(String item) Removes the first occurrence of item from 
the Choice menu. 


void removeAIlI() Removes all items from the choice menu. 


void removeltemListener(ItemListener |) Removes the specified 
item listener so that it no longer receives item events from this Choice 
menu. 


void select(int pos) Sets the selected item in this Choice menu to be 
the item at the specified position. 


void select(String str) Sets the selected item in this Choice menu to 
be the item whose name is equal to the specified string. 


继承 的 方法 


这 个 类 继承 的 方法 从 以 下 类 : 


e java.awt.Component 


e java.lang.Object 


Choice 实例 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 D:/ > AWT > com > yiibai > gui > 


AwtControlDemo.java 


package com.yiibai.gui; 


import java.awt.*; 
import java.awt.event.*; 


public class AwtControlDemo { 


private Frame mainFrame; 

private Label headerLabel; 
private Label statusLabel; 
private Panel controlPanel; 


public AwtControlDemo()1 
prepareGUI(); 
j 


public static void main(String[] args){ 
AwtControlDemo  awtControlDemo - new AwtControlDemo(); 
awtControlDemo.showChoiceDemo(); 


j 


private void prepareGUI(){ 
mainFrame - new Frame("Java AWT Examples"); 
mainFrame.setSize(400,400); 
mainFrame.setLayout(new GridLayout(3, 1)); 
mainFrame.addwindowListener(new WindowAdapter() ( 
public void windowClosing(WindowEvent windowEvent ) { 
System.exit(0); 
j 


} 
headerLabel = new Label(); 


headerLabel.setAlignment(Label.CENTER); 
statusLabel - new Label(); 
statusLabel.setAlignment(Label.CENTER); 
statusLabel.setSize(350,100); 


controlPanel - new Panel(); 
controlPanel.setLayout(new FlowLayout()); 


mainFrame.add(headerLabel); 
mainFrame.add(controlPanel); 
mainFrame.add(statusLabel); 
mainFrame.setVisible(true); 


} 


private void showChoiceDemo( ) { 


headerLabel.setText("Control in action: Choice"); 
final Choice fruitChoice = new Choice(); 


fruitChoice.add("Apple"); 
fruitChoice.add("Grapes"); 
fruitChoice.add("Mango"); 
fruitChoice.add("Peer"); 


Button showButton = new Button("Show"); 


showButton.addActionListener(new ActionListener() { 
public void actionPerformed(ActionEvent e) { 
String data - "Fruit Selected: " 
+ fruitChoice.getItem(fruitChoice.getSelectedIndex()); 
statusLabel.setText(data); 
} 
}); 


controlPanel.add(fruitChoice); 
controlPanel.add(showButton); 


mainFrame.setVisible(true); 





编译 程序 ， 使 用 命令 提示 符 。 到 D:/ > AWT 然后 键入 以 下 命 合 。 


D:AWT>javac comyiibaiguiAwtControlDemo.java 


如 果 没 有 错误 出 现 ， 这 意味 着 编译 成 功 。 使 用 下 面 的 命令 来 运行 程序 。 


D:AWT>java com.yiibai.gui.AwtControlDemo 


验证 下 面 的 输出 


TutorialsPoint Java 技术 教程 


E Java AWT Examples 


Control in action: Choice 


Fruit Selected: Grapes 
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AWT 33 TE A38 - AWT 


事件 是 什么 ? 


一 个 对 象 的 状态 变化 被 称 为 事件 ， 即 事件 描述 源 状态 的 变化 。 事 件 产生 的 结果 与 用 
户 交互 的 图 形 用 户 界面 组 件 。 例 如 ， 点 击 一 个 按钮 ， 移 动 鼠 标 ， 通 过 键盘 输入 一 个 
字符 ， 从 列表 中 选择 一 个 项 目 ， 滚 动 页 面 的 活动 ， 使 一 个 事件 的 发 生 。 


事件 的 类 型 


事件 可 以 被 大 致 分 为 两 类 : 


e 前 台 事件 - 这 些 事件 需要 用 户 直 接 互 动 。 在 图 形 用 户 界面 中 的 图 形 组件 交 互 的 
人 产生 的 后 果 。 例 如 ， 点 击 一 个 按钮 ， 移 动 鼠 标 ， 通 过 键盘 输入 一 个 字符 ， 从 
列表 中 选择 一 个 项 目 ， 滚 动 页 面 等 


e 后 台 事 件 - 这 些 事件 ， 需 要 最 终 用 户 的 交互 是 已 知 的 作为 后 台 的 事件 。 操 作 系 
统 的 中 断 ， 硬 件 或 软件 故障 ， 定 时 器 到 期 时 ， 操 作 完 成 的 后 台 事件 的 例子 。 


事件 处 理 是 什么 3 


事件 处 理 机 制 ， 控 制 的 事件 ， 并 决定 如 果 一 个 事件 发 生 时 ， 会 发 生 什 么 。 这 种 机 制 
被 称 为 事件 处 理 程序 ， 在 事件 发 生 时 执行 的 代码 。 Java 使 用 代理 事件 模型 来 处 理事 
件 。 该 模型 定义 了 标准 的 机 制 来 生成 和 处 理事 件 。 让 我 们 简要 介绍 这 种 模式 。 


代理 事件 模型 具有 以 下 的 主要 参与 者 ， 即 : 


。 源 - 源 是 一 个 对 象 ， 在 该 对 象 上 的 事件 发 生 。 它 的 处 理 器 提供 发 生 事 件 的 信息 
来 源 是 可 靠 的 。 JAVA 提供 源 对 象 的 类 。 


e 监听 器 - 它 也 被 称 为 事件 处 理 程序 。 监 听 器 是 负责 生成 响应 事件 。 从 Java 实 现 
的 角度 来 看 ， 监 听 器 也 是 一 个 对 象 。 等 待 ， 直 到 它 接收 到 一 个 事件 监听 器 。 一 
且 收 到 事件 ， 监 听 器 进程 的 事件 然后 返回 。 

这 种 方法 的 好 处 是 ， 用 户 界 面 逻 辑 完全 分 开 ， 生 成 该 事件 的 逻辑 。 用 户 界 面 元 素 是 

能 够 代理 的 事件 义理 单独 的 一 段 代 码 。 在 这 个 模型 中 ， 需 要 与 源 对 象 注册 监听 使 侦 

听 器 能 够 接收 事件 通知 。 这 是 一 个 有 效 的 方式 处 理事 件 ， 因 为 这 些 事件 通知 只 发 送 

给 那些 览 听 器 想 要 它们 接收 。 


参与 事件 处 理 的 步骤 


e 用 户 单 击 该 按钮 时 产生 该 事件 。 


。 现在 有 天 事件 类 的 对 象 是 自动 创建 的 信息 源 和 事件 在 同一 对 象 得 到 填充 。 
。 事件 对 象 被 转发 注册 监听 器 类 的 方法 。 
e. 该 方法 现在 得 到 执行 和 返回 。 


要 记 住 的 有 天 监听 器 要 点 

e 为 了 设计 一 个 监听 类 ， 我 们 必须 制定 一 些 监听 器 接口 。 这 些 监听 器 接口 预测 一 
些 公共 的 抽象 监听 器 类 必须 实现 的 回调 方法 。 

e 如 果 不 实现 任何 预定 义 的 接口 ， 你 的 类 不 能 作为 源 对 象 的 监听 器 类 。 


回调 方法 


这 些 方 法 所 提供 的 API 提 供 者 ， 被 定义 为 应 用 程序 员 和 应 用 程序 开发 者 调用 。 这 里 
的 回调 方法 代表 一 个 事件 的 方法 。 在 响应 一 个 事件 的 Java JRE 将 触发 回调 方法 。 所 
有 这 些 回调 方法 的 监听 器 接口 。 


如 果 一 个 组 件 需要 一 些 监 听 器 将 监听 的 事件 源 必须 注册 自己 的 监听 器 。 


事件 义理 示例 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 D:/ > AWT > com > yiibai > gui > 


AwtControlDemo 


package com.yiibai.gui; 


import java.awt.*; 
import java.awt.event.*; 


public class AwtControlDemo { 


private Frame mainFrame; 
private Label headerLabel; 
private Label statusLabel; 
private Panel controlPanel; 


public AwtControlDemo(){ 
prepareGUI(); 


public static void main(String[] args)(1 
AwtControlDemo  awtControlDemo - new AwtControlDemo(); 
awtControlDemo.showEventDemo(); 


j 


private void prepareGUI()( 


j 


mainFrame = new Frame("Java AWT Examples"); 
mainFrame.setSize(400,400); 
mainFrame.setLayout(new GridLayout(3, 1)); 
mainFrame.addwindowListener(new WindowAdapter() ( 
public void windowClosing(WindowEvent windowEvent ) { 
System.exit(0); 


j 
3); 
headerLabel - new Label(); 
headerLabel.setAlignment(Label.CENTER); 
statusLabel - new Label(); 
statusLabel.setAlignment(Label.CENTER); 
statusLabel.setSize(350,100); 


controlPanel - new Panel(); 
controlPanel.setLayout(new FlowLayout()); 


mainFrame.add(headerLabel); 
mainFrame.add(controlPanel); 
mainFrame.add(statusLabel); 
mainFrame.setVisible(true); 


private void showEventDemo(){ 


j 


headerLabel.setText("Control in action: Button"); 


Button okButton - new Button("OK"); 
Button submitButton - new Button("Submit"); 
Button cancelButton new Button("Cancel"); 


okButton.setActionCommand("OK"); 
submitButton.setActionCommand("Submit"); 
cancelButton.setActionCommand("Cancel"); 


okButton.addActionListener(new ButtonClickListener()); 
submitButton.addActionListener(new ButtonClickListener( 
cancelButton.addActionListener(new ButtonClickListener( 


controlPanel.add(okButton); 
controlPanel.add(submitButton); 
controlPanel.add(cancelButton); 


mainFrame.setVisible(true); 


~ 


e 
De 


private class ButtonClickListener implements ActionListener { 


public void actionPerformed(ActionEvent e) { 
String command = e.getActionCommand(); 
if( command.equals( "OK" )) { 
statusLabel.setText("Ok Button clicked."); 


else if( command.equals( "Submit" ) ) { 


statusLabel.setText("Submit Button clicked."); 


J 
else { 

statusLabel.setText("Cancel Button clicked."); 
} 


编译 程序 ， 使 用 命令 提示 符 。 到 D:/ > AWT 然后 键 和 人 以 下 命令 。 
D:AWT>javac comyiibaiguiAwtControlDemo.java 
如 果 没 有 错误 出 现 ， 这 意味 着 编译 成 功 。 使 用 下 面 的 命令 来 运行 程序 。 


D:AWT>java com.yiibai.gui.AwtControlDemo 


验证 下 面 的 输出 
Java AWT Examples DBR) 


Control in action: Button 


Submit | Cancel | 


Ok Button clicked. 





AWT Event - AWT 


事件 类 代表 了 本 次 活动 。 Java 提 供 了 各 种 事件 类 ， 但 我 们 将 讨论 那些 被 更 频繁 地 使 
用 。 


EventObject 类 


它 是 根 类 ， 应 得 到 所 有 事件 状态 对 象 。 m x m 所 有 事件 的 源 ， 这 是 
Z4 辑 上 被 认为 是 事件 最 初 发 生 时 的 对 象 。 类 定义 在 java.util 包 。 
类 的 声明 


以 下 是 声明 为 java.util.EventObject 类 : 


public class EventObject 
extends Object 
implements Serializable 


ri x 
字段 域 
DAB # java.util.EventObject 的 字段 : 
e protected Object source -- 在 其 最 初 的 事件 发 生 的 对 象 。 


X B3 4435 ELI 
S.N. A38 Eq 23 8 jt, BH 
1 EventObject(Object source) Constructs a prototypical Event. 


类 方法 


S.N. 方法 和 说 明 
1 Object getSource() The object on which the Event initially occurred. 


2 String toString() Returns a String representation of this EventObject. 


继承 的 方法 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


AWT S344 X : 
以 下 是 常用 的 事件 类 的 列表 。 


Sr.No. 


控制 与 说 明 


AWTEvent 它 是 所 有 AWT 事 件 的 根 事件 类 。 这 个 类 及 其 子 类 取代 原来 
的 java.awt.Event 类 。 


ActionEvent 按钮 被 点 击 时 ， 都 会 生成 ActionEvent 双 击 或 列表 中 的 项 


o 


InputEvent InputEvent 类 是 所 有 组 件 级 别 输入 事件 的 根 事件 类 。 
KeyEvent 输入 字符 键 事件 产生 。 

MouseEvent 此 事件 表明 在 一 个 组 件 中 发 生 妃 标 动作 。 
TextEvent 这 个 类 的 对 象 表示 文本 事件 。 

WindowEvent 这 个 类 的 对 象 表示 一 个 窗口 的 状态 的 变化 。 
AdjustmentEvent 这 个 类 的 对 象 代表 可 调 对 象 发 出 的 调整 事件 。 
ComponentEvent 这 个 类 的 对 象 表示 一 个 窗口 的 状态 的 变化 。 
ContainerEvent 这 个 类 的 对 象 表示 一 个 窗口 的 状态 的 变化 。 
MouseMotionEvent 这 个 类 的 对 象 表示 一 个 窗口 的 状态 的 变化 。 
PaintEvent 这 个 类 的 对 象 表示 一 个 窗口 的 状态 的 变化 。 


AWT 事件 监听 器 (Event Listeners) - AWT 


事件 侦 听 器 代表 负责 义理 事件 的 接口 。Java 提 供 了 各 种 事件 监听 器 类 ， 但 我 们 将 讨 
论 那 些 被 更 频繁 地 使 用 。 每 一 个 事件 侦 听 器 方法 具有 方法 的 EventObject 类 的 子 类 
的 对 象 ， 这 是 作为 一 个 单独 的 参数 。 例 如 ， 钼 标 事件 侦 听 器 方法 将 接受 
MouseEvent 的 实例 ， 其 中 派生 的 事件 的 EventObject。 


EventListner 接 口 


它 是 一 个 标记 接口 ， 每 一 个 监听 器 接口 扩展 。 这 个 类 定义 在 java.util 包 。 


MA = 
类 的 声明 
以 下 是 声明 java.util.EventListener 接口 : 


public interface EventListener 


AWT Event Listener 接口 : 
以 下 是 常用 的 事件 侦 听 器 列表 。 


Sr. No. 控制 & 说 明 
ActionListener 该 接口 用 于 接收 动作 事件 。 
ComponentListener 该 接口 用 于 接收 组 件 事件 。 
ItemListener 该 接口 用 于 接收 项 目 事件 。 
KeyListener 该 接口 用 于 接收 键 事件 。 
MouseListener 该 接口 用 于 接收 鼠标 事件 。 
TextListener 该 接口 用 于 接收 文本 事件 。 
WindowListener 该 接口 用 于 接收 窗口 事件 。 
AdjustmentListener 该 接口 用 于 接收 调整 事件 。 
ContainerListener 该 接口 用 于 接收 容器 事件 。 
MouseMotionListener 此 接口 用 于 接收 鼠标 移动 事件 。 
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AWT 适配器 (Adapters) - AWT 


适配器 是 抽象 类 ， 用 于 接收 各 种 事件 。 这 些 类 中 的 方法 是 空 的 。 这 些 类 存在 的 目的 
是 方便 创建 侦 听 器 对 象 。 


AWT 适 配 右 : 
以 下 是 常用 的 适配器 监听 AWT GUI 事件 列表 。 
Sr. No. 适配器 & 说 明 
1 FocusAdapter 接收 焦点 事件 的 抽象 适配器 类 。 
2 KeyAdapter 接收 按键 事件 的 抽象 适配器 类 。 
3 MouseAdapter 接收 鼠标 事件 的 抽象 适配器 类 。 
4 MouseMotionAdapter 接收 鼠标 移动 事件 的 抽象 适配器 类 。 
5 WindowAdapter 接收 窗口 事件 的 抽象 适配器 类 。 


AWT 布局 (Layouts) - AWT 


布局 的 意味 着 ， 在 容器 内 的 配置 的 组 件 。 在 其 他 的 方式 ， 我 们 可 以 说 ， 在 一 个 特定 
的 容器 内 的 位 置 放置 组 件 。 布 局 管理 器 所 控制 布点 的 任务 是 自动 完成 的 。 


布局 管理 器 


布局 管理 器 自动 定位 容器 内 的 所 有 组 件 。 如 果 我 们 不 使 用 布局 管理 器 ， 然 后 定位 组 
件 的 默认 布局 管理 器 。 这 是 可 能 的 手工 布局 的 控制 ， 但 由 于 以 下 两 个 原因 ， 它 变 得 
非常 困难 。 


e 这 是 非常 繁琐 的 容器 内 义理 大 量 的 控制 。 
e 通常 当 我 们 需要 来 排列 它们 没有 给 出 一 个 组 件 的 宽度 和 高 度 信 息 。 


Java 为 我 们 提供 了 各 种 布局 管理 器 来 定位 控制 。 属 性 ， 如 大 小 ， 形 状 和 排列 变化 从 
一 个 布局 管理 器 ， 其 他 的 布局 管理 器 。 的 小 应 用 程序 或 应 用 程序 窗口 的 大 小 改变 
时 ， 即 布局 管理 器 applet 浏 览 器 或 应 用 程序 窗口 的 尺寸 适应 于 响应 的 大 小 ， 形 状 和 
排列 的 组 件 也 随 之 变化 。 


布局 管理 器 关联 的 与 每 个 容器 对 象 。 每 一 个 布局 管理 器 是 实现 布局 管理 接口 的 类 的 
一 个 对 象 。 


以 下 是 接口 定义 布局 管理 器 的 功能 。 


Sr. p 
No. 接口 与 说 明 
1 LayoutManager LayoutManager 接口 声明 了 类 ， 其 对 象 籽 充当 一 个 布局 
管理 器 需要 实现 这 些 方法 。 
2 LayoutManager2 LayoutManager2 中 的 子 接口 布局 管理 。 这 个 接口 是 为 
那些 知道 如 何 布局 容器 的 基础 上 布局 约束 对 象 的 类 。 
AWT 布 局 管理 器 类 : 


以 下 是 常用 的 控件 列表 而 设计 的 图 形 用 户 界面 使 用 AWT。 


lutorialsPoint Java Tx R% E 


布局 管理 说 明 
BorderLayout BorderLayout 排列 组 件 ， 以 适应 在 五 个 区 域 : 东部 ， 西 
部 ， 北 部 ， 南 部 和 中 心 。 


CardLayout CardLayout 对 象 将 卡片 作为 一 个 容器 中 的 每 个 组 件 。 在 一 个 
时 间 只 有 一 个 卡片 是 可 见 的 。 


FlowLayout FlowLayout 将 是 默认 的 布局 。 它 的 布局 有 向 流 中 的 组 件 。 
GridLayout GridLayout 管理 组 件 的 矩形 网 格 的 形式 。 


GridBagLayout 这 是 最 灵活 的 布局 管理 器 类 。 GridBagLayout 中 的 对 象 
对 齐 的 组 件 垂直 方向 ， 水 平方 向 或 治 它 们 的 基线 相同 的 大 小 ， 而 不 需要 
的 组 件 。 


AWT 容器 (Containers) - AWT 
容器 是 AWT GUI 组 件 的 组 成 部 分 。 其 中 一 个 组 件 可 以 位 于 容器 提供 空间 。 AVIS 
器 本 身 是 一 个 组 件 ， 它 增加 了 添加 组 件 本 身 的 能 力 。 以 下 要 考虑 要 点 。 

e Container 的 子 类 被 称 为 容器 。 例 如 面板 ， 框 架 和 窗口 。 

。 容器 只 能 添加 组 件 本 身 。 

e 默认 的 布局 使 用 每 个 容器 的 setLayout 方 法 可 以 覆盖 使 用 。 


Sr. No. 容器 和 说 明 

1 Container 这 是 一 个 通用 的 容器 对 象 中 ， 可 以 包含 其 他 AWT 组 件 。 
AWT 的 UI 元 素 : 
以 下 是 常用 的 容器 而 设计 的 图 形 用 户 界面 使 用 AWT。 

Sr. DR go m 

No. 8T 8A 


Panel 面板 是 最 简单 的 容器 。 它 提供 了 空间 ， 在 其 中 可 以 放置 任何 其 他 
组 件 ， 包 括 其 他 面板 。 


2 Frame Frame 是 一 个 顶层 的 窗口 标题 和 边框 


3 Window Window 对 象 是 一 个 没有 边界 和 菜单 栏 的 顶层 窗口 


1 


AWT 采 单 控制 - AWT 


正如 我 们 所 知道 相关 的 每 一 个 顶层 窗口 有 一 个 菜单 栏 。 此 菜单 栏 包括 提供 给 最 终 用 
户 的 各 种 菜单 的 选择 。 此 外 ， 每 个 选择 包含 这 就 是 所 谓 的 下 拉 菜 单 中 的 选项 列表 。 
菜单 和 菜单 项 的 控件 是 的 MenuComponent 类 的 子 类 。 


菜单 层次 结构 





/liouicornl 
+. 
菜单 控件 
n 控件 与 说 明 
No. 
1 MenuComponent 它 是 顶级 类 的 所 有 菜单 相关 的 控制 。 
2 MenuBar MenuBar 对 象 相 关联 的 顶层 窗口 。 
3 Menultem 菜单 中 的 项 目 必 须 属 于 Menultem 或 任何 其 子 类 。 
4 Menu Menu 对 象 是 从 菜单 栏 中 显示 一 个 下 拉 菜 单 组 件 。 
5 CheckboxMenultem CheckboxMenultem 是 菜单 项 的 子 类 。 


PopupMenu PopupMenu 弹出 式 菜单 ， 可 以 在 一 个 组 件 内 的 指定 位 置 
动态 弹出 。 


AWT 图 形 控 件 - ANT 


图 形 控件 允许 应 用 程序 组 件 或 图 像 上 绘制 。 


形 控件 


Sr. 
No. 


1 


2 


控制 与 说 明 


Graphics 这 是 所 有 图 形 上 下 文 顶层 抽象 类 。 
Graphics2D 这 是 一 个 Graphics 类 的 子 类 ， 并 提供 了 更 复杂 的 几何 坐标 变 
换 ， 色 彩 管理 ， 和 文本 布局 的 控制 权 。 


Arc2D Arc2D 是 抽象 父 类 的 所 有 对 象 存储 框架 矩形 定义 一 个 二 维 弧 ， 开 
始 角度 ， 棱 角 分 明 的 程度 GK) 和 闭合 类 型 (OPEN, CHORDS 
PIE) 。 


CubicCurve2D CubicCurve2D 类 是 抽象 的 超 类 FPR 存 储 2D 三 次 曲线 段 的 
所 有 对 象 ， 它 定义 的 三 次 参数 曲线 段 OX, Y) 坐标 空间 。 

Ellipse2D Ellipse2D 的 是 抽象 超 类 的 所 有 对 象 存储 2D 椭 圆 形 ， 它 描述 了 
一 种 梢 圆 形 ， 是 指 由 一 划分 矩形 。 

Rectangle2D Rectangle2D 类 是 一 个 抽象 父 类 的 所 有 对 象 存 储 2D 和 矩形 所 
定义 的 位 置 OX, Y) 和 尺寸 〈 宽 x 高 ) ， 它 描述 了 一 个 矩形 。 
QuadCurve2D QuadCurve2D 类 是 一 个 抽象 父 类 的 所 有 对 象 存储 2D 二 次 
曲线 段 ， 它 描述 了 一 个 二 次 参数 曲线 段 (X, Y) 坐标 空间 。 

Line2D Line2D 表 示 (的 x，y) 坐标 空间 中 的 线段 。 

Font Font 类 表示 字体 ， 它 是 在 一 个 可 见 的 方式 呈现 文本 。 

Color Color 类 用 于 封装 默认 SRGB 颜 色 空 间或 颜色 的 任意 颜色 空间 中 的 颜 
色 标 识 的 颜色 。 


BasicStroke BasicStroke 的 类 定义 了 一 套 基 本 的 轮廓 基本 图 形 ， 这 是 一 
个 Graphics2D 对 象 有 其 行程 的 属性 设置 与 此 BasicStroke 呈 现 的 泻 染 属 
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EasyMock 教 程 


Mocking 是 什么 ? 


Mocking 是 一 种 在 隔离 测试 一 个 类 的 功能 。 人 例如， 无需 数据 库 连 接 或 属性 文件 中 读 
取 或 文件 服务 器 上 读 取 需 要 测试 的 功能 。 mock 对 象 做 实 服务 的 嘲讽 。 一 个 mock 对 
象 返 回 对 应 于 传递 给 它 一 些 虚 拟 输入 无 效 数 据 。 


EasyMock 


EasyMock 便 于 无 颖 地 创建 模拟 对 象 。 它 使 用 Java 反 射 ， 以 创造 为 给 定 接口 的 模拟 
ee ee E 股票 服务 的 情况 下 ， 
它 返 回 一 个 股票 价格 的 详细 信息 。 在 开发 过 程 中 ， 实 际 的 库存 服务 不 能 被 用 于 获得 
实时 数据 。 因 此 ， 我 们 需要 一 个 虚拟 的 股票 实施 服务 。 简 易 模 拟 可 以 很 容易 理解 顾 
名 思 义 这 样 。 


EasyMock 的 好 处 


。 不 用 手写 - 没有 必要 通过 自己 编写 的 模拟 对 象 。 


uc dE D E 
创建 。 


e 返回 值 支持 - 支持 返回 值 。 

e 异常 支持 - 支持 例外 /异常 

e 命令 检查 支持 - 支持 检查 命令 方法 调用 。 
e 注释 支持 - 支持 使 用 注解 创建 。 
考虑 下 面 的 代码 片段 。 


package com.yiibai.mock; 


import java.util.ArrayList; 
import java.util.List; 


import org.easymock.EasyMock; 


public class PortfolioTester { 
public static void main(String[] args){ 


//Create a portfolio object which is to be tested 
Portfolio portfolio = new Portfolio(); 


//Creates a list of stocks to be added to the portfolio 
List<Stock> stocks = new ArrayList<Stock>(); 

Stock googleStock = new Stock("1","Google", 10); 

Stock microsoftStock = new Stock("2","Microsoft",100); 


stocks.add(googleStock); 
stocks.add(microsoftStock); 


//Create the mock object of stock service 
StockService stockServiceMock = EasyMock.createMock(StockSer\ 


//mock the behavior of stock service to return the value of 
EasyMock.expect(stockServiceMock.getPrice(googleStock) ) .andRe 
EasyMock.expect(stockServiceMock.getPrice(microsoftStock)).ar 


EasyMock.replay(stockServiceMock); 

//add stocks to the portfolio 
portfolio.setStocks(stocks); 

//set the stockService to the portfolio 
portfolio.setStockService(stockServiceMock); 


double marketValue - portfolio.getMarketValue(); 


//verify the market value to be 10*50.00 + 100* 1000.00 = 50( 
System.out.println("Market value of the portfolio: "+ market" 





让 我 们 来 了 解 上 述 程序 的 重要 概念 。 完 整 的 代码 在 第 一 个 应 用 。 


e Portfolio - 进行 股票 名 单 ， 并 获得 用 股票 价格 和 股票 数量 计算 的 市 场 价值 的 对 


象 。 


e Stock - 携带 一 只 股票 的 详细 信息 ， 如 它 的 id， 名 称 ， 数 量 等 的 对 象 


e StockService - 股票 的 服务 接口 ， 其 功能 


个 股票 的 当前 价格 。 


是 返 
e EasyMock.createMock(...) - EasyMock 股 票 创 建 了 服务 的 模拟 


EasyMock.expect(...).andReturn(...) - 模拟 实现 StockService 接 口 用 getPrice 
方法 。 对 于 googleStock， 回 到 50.00 的 价格 。 


EasyMock.replay(...) - EasyMock 准 各 模拟 对 象 ， 以 便 它 可 以 被 用 于 测试 目 


portfolio.setStocks(...) - 现在 的 投资 组 合 包含 了 两 只 股票 列表 。 
portfolio.setStockService(...) - 分 配 的 StockService 模 拟 对 象 来 组 合 。 


portfolio.getMarketValue() - 基于 使 用 的 模拟 股票 服务 公司 的 股票 投资 组 合 回 
报 的 市 场 价 值 。 


EasyMock#ig zx - EasyMock 教 程 


EasyMock 是 Java 框 架 ， 所 以 第 一 个 要 求 是 要 在 机 器 安装 JDK。 


JDK 1.5 或 以 上 . 

内 存 没有 最 低 要 求 
硬盘 空间 没有 最 低 要 求 
操作 系统 没有 最 低 要 求 


第 1 步 - 验证 Java 安 装 在 机 器 


现在 ， 打 开 控 制 台 并 执行 以 下 java 命 倒 。 


OS 任务 命 兮 
Windows 打开 命令 控制 台 c:\> java -version 
Linux 打开 命令 终端 $ java -version 
Mac 打开 终端 machine:~ joseph$ java -version 
让 我 们 来 为 所 有 的 操作 系统 验证 输出 : 
Windows 


Java version "1.6.0 21" 
Java(TM) SE Runtime Environment (build 1.6.0_21-b07) 
Java HotSpot(TM) Client VM (build 17.0-b17, mixed mode, sharing) 


Linux 


java version "1.6.0 21" 
Java(TM) SE Runtime Environment (build 1.6.0 21-b07) 
Java HotSpot(TM) Client VM (build 17.0-b17, mixed mode, sharing) 


Mac 


java version "1.6.0 21" 
Java(TM) SE Runtime Environment (build 1.6.0 21-b07) 
Java HotSpot(TM)64-Bit Server VM (build 17.0-b17, mixed mode, shar: 





si 


如 果 还 没有 安装 Java， 安 装 Java 软 件 开发 工具 包 (SDK) 可 从 
http://www.oracle.com/technetwork/java/javase/downloads/index.htmll 下 载 最 新 版 


本 。 我 们 假设 Java1.6.0_21 作为 本 教程 的 安装 版 本 。 





第 2 步 : 设置 JAVA 环境 


设置 JAVA_HOME 环境 变量 指向 到 安装 在 机 器 上 的 Java 的 基本 目录 的 位 置 。 例 如 


OS 输出 
Windows ， 设 置 环境 变量 JAVA HOME 到 C:\Program Files\Java\jdk1.6.0_21 
Linux export JAVA_HOME=/usr/local/java-current 
Mac export JAVA_HOME=/Library/Java/Home 


添加 Java 编 译 器 位 置 到 系统 路 径 。 


OS 输出 
Append the string ;C:\Program Files\Java\jdk1.6.0_21\bin to the 


Windows end of the system variable, Path. 
Linux export PATH=$PATH:$JAVA_HOME/bin/ 
Mac not required 


FA java -version 命令 验证 如 上 所 述 Java 安 装 。 


第 3 步 : 下 载 EasyMock 


M http://sourceforge.net/projects/easymock/files/EasyMock/3.2/easymock- 
3.2.zip/download 下 载 EasyMock 的 zip 文 件 的 最 新 版 本 。 在 写 这 篇 教程 的 时 候 ， 下 
载 的 是 easymock-3.2.zip 并 将 其 复制 到 C:\>EasyMock 文件 夹 。 
OS Ja FASCE ES 
Windows easymock-3.2.zip 
Linux easymock-3.2.zip 


Mac easymock-3.2.zip 


第 4 步 : 下 载 EasyMock 的 依赖 包 


从 https://github.com/cglib/cglib/releases 下 载 cglib 的 jar 文 件 的 最 新 版 本 。 在 写 这 篇 
教程 的 时 候 ， 我 下 载 的 是 cglib-3.1.jar 并 将 其 复制 到 C : \> EasyMock XR., 


从 http://objenesis.org/download.htmll 下 载 objenesis.zip 文 件 的 最 新 版 本 。 在 写 这 篇 
教程 的 时 候 ， 我 下 载 objenesis-2.1-bin.zip 并 将 其 复制 到 C : v» EasyMock 文 件 夹 。 
提取 objenesis-2.1.jar 到 C : \> EasyMock 文 件 夹 


第 5 步 : 设置 EasyMock 的 环境 


设置 EasyMock_ HOME 环境 变量 指向 的 地 方 EasyMock 的 和 依赖 的 jar 都 存储 在 您 计 
算 机 上 的 基本 目录 的 位 置 。 假 设 ， 我 们 已 经 提取 了 easymock-3.2.jar cglib-3.1.jar 
和 objenesis-2.1.jar 在 各 种 操作 系统 上 EasyMock 的 文件 夹 ， 如 下 所 示 。 


OS 输出 
Windows 设置 环境 变量 EasyMock_HOME to C:\EasyMock 
Linux export EasyMock_HOME=/usr/local/EasyMock 
Mac export EasyMock_HOME=/Library/EasyMock 


第 5 步 : 设置 CLASSPATH 变 量 


设置 CLASSPATH 环 境 变量 指向 了 EasyMock 和 依赖 的 jar 位 置 。 假 设 ， 我 们 已 经 存 
储 了 easymock-3.2.jar cglib-3.1.jar 和 objenesis-2.1.jar i 在 EasyMock 的 文件 夹 ， 在 
各 种 操作 系统 上 ， 如 下 所 示 。 


OS 输出 


设置 环境 变量 CLASSPATH to 
%CLASSPATH%;%EasyMock_HOME%\easymock- 


Windows | 3.2jar%EasyMock HOME%\cglib- 
3.1.jar;%EasyMock_HOME%)\objenesis-2.1 jar;.; 
export 

mate CLASSPATH=$CLASSPATH:$EasyMock_HOME/easymock- 
3.2.jar:$EasyMock_HOME/cglib- 
3.1 .jar:$EasyMock_HOME/objenesis-2.1 .jar:. 
export 

Mac CLASSPATH=$CLASSPATH:$EasyMock_HOME/easymock- 


3.2.jar:$EasyMock_HOME/cglib- 
3.1 .jar:$EasyMock_HOME/objenesis-2.1 .jar:. 


第 6 步 : KAJunithy Js 


从 https://github.com/junit-team/junit/wiki/Download-and-Install 下 载 JUnit 的 jar 文 件 
的 最 新 版 本 。 在 写 这 篇 教程 的 时 候 ， 我 下 载 的 是 Junit-4.11.jar,hamcrest-core- 
1.2.1.jar ， 并 复制 它们 到 C : V» JUnit 文 件 夹 中 。 


OS JE FAN 
Windows junit4.11.jar, hamcrest-core-1.2.1.jar 
Linux junit4.11.jar, hamcrest-core-1.2.1.jar 
Mac junit4.11.jar, hamcrest-core-1.2.1.jar 


第 7 步 : 设置 JUnit 的 环境 


设置 JUNIT_HOME 环 境 变量 指向 JUNIT 的 jar 都 存储 在 您 计算 机 上 的 基本 目录 的 位 
置 。 假 设 ， 我 们 已 经 存储 junit4.11.jar hamcrest-core-1.2.1.jar 在 JUnit 文 件 夹 在 各 
种 操作 系统 上 ， 如 下 所 示 。 


OS 输出 
Windows 设置 环境 变量 JUNIT HOME to C:\JUNIT 
Linux export JUNIT HOME-/usr/local/JUNIT 
Mac export JUNIT HOME-/Library/JUNIT 


第 8 步 : iX IBCLASSPATH £ = 


7 1S CLASSPATH $41 3: BiB f JUnit&Sjarfiri&, Rik, RnB tr junit4.10.jar 
在 JUnit 夹 在 各 种 操作 系统 上 ， 如 下 所 示 。 


OS 输出 


设置 环境 变量 CLASSPATH 为 
Windows %CLASSPATH%;%JUNIT HOME%\junit4.11.jar;%JUNIT HOME%\ 
1.2.1.jar;.; 


export 
Linux CLASSPATH=$CLASSPATH:$JUNIT_HOME/junit4.11 jar:$JUNIT_F 
core-1.2.1.jar:. 


export 
Mac CLASSPATH=$CLASSPATH:$JUNIT_HOME/junit4.11 jar:$JUNIT_F 
core-1.2.1.jar:. 


EasyMock i 4438 - EasyMock 教 程 
EasyMock 提 供 了 一 个 功能 ， 用 以 模拟 抛 出 异常 ， 所 以 异常 处 理 可 以 进行 测试 。 


//add the behavior to throw exception 
EasyMock.expect(calcService.add(10.0,20.0)).andThrow(new RuntimeExc 


‘| — i; 
在 这 里 ， 我 们 添加 了 一 个 异常 子 句 模仿 对 象 。 MathApplication 利 用 使 用 


calcService 其 Add 方 法 和 模型 将 抛 出 RuntimeException 异 常 时 调用 
calcService.add() 方 法 。 








示例 
创建 一 个 接口 CalculatorService， 其 目的 是 提供 各 种 计算 相关 的 功能 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 


j 


创建 一 个 Java 类 用 来 表示 MathApplication。 
MathApplication.java 


public class MathApplication { 
private CalculatorService calcService; 


public void setCalculatorService(CalculatorService calcService): 
this.calcService = calcService; 


} 
public double add(double inputi, double input2){ 
return calcService.add(inputi, input2); 


public double subtract(double inputi, double input2){ 
return calcService.subtract(inputi, input2); 


public double multiply(double inputi, double input2){ 
return calcService.multiply(inputi, input2); 


public double divide(double inputi, double input2){ 
return calcService.divide(inputi, input2); 





让 我 们 来 测试 MathApplication 类 ， 通 过 它 注 入 CalculatorService 作 一 个 模拟 。 Mock 
将 由 EasyMock 创 建 。 


MathApplication Tester.java 


import org.easymock.EasyMock; 
import org.easymock.EasyMockRunner ; 
import org.easymock.Mock; 

import org.easymock.TestSubject; 
import org.junit.Assert; 

import org.junit.Test; 

import org. junit.runner.Runwith; 


//@RunWith attaches a runner with the test class to initialize the 
QRunwith(EasyMockRunner.class) 
public class MathApplicationTester { 


//@TestSubject annotation is used to identify class which is go: 
//mock object 

QTestSubject 

MathApplication mathApplication - new MathApplication(); 


//@Mock annotation is used to create the mock object to be injec 
@Mock 
CalculatorService calcService; 


@Test(expected = RuntimeException.class) 

public void testAdd(){ 
//add the behavior to throw exception 
EasyMock.expect(calcService.add(10.0,20.0)).andThrow(new Runt 
//activate the mock 
EasyMock.replay(calcService); 
//test the add functionality 
Assert.assertEquals(mathApplication.add(10.0, 20.0),30.0,0); 
//verify call to calcService is made or not 
EasyMock.verify(calcService); 





创建 一 个 Java 类 在 文件 夹 CA» EasyMock WORKSPACE 执行 测试 用 例 


TestRunner.java 


import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 


public class TestRunner { 
public static void main(String[] args) { 
Result result = JUnitCore.runClasses(MathApplicationTester .c- 
for (Failure failure : result.getFailures()) { 
System.out.println(failure.toString()); 


j 


System.out.println(result.wasSuccessful()); 





验证 结果 
使 用 javac 编 译 如 下 类 


C:\EasyMock_WORKSPACE>javac MathApplicationTester.java 


现在 运行 测试 运行 看 结果 


C:\EasyMock_WORKSPACE>java TestRunner 


验证 输出 


true 


EasyMock JUnit 集 成 - EasyMock 教 程 


在 本 章 中 ， 我 们 将 集成 JUnit 和 EasyMock 在 一 起 。 对 于 JUnit， 请 参阅 JUnit 教 程 。 
我 们 使 用 计算 器 服务 的 例子 。 目 的 是 创建 一 个 数学 应 用 ， 它 使 用 CalculatorService 
做 加 ， 减 ， 除 运算 操作 。 我 们 将 使 用 EasyMock 来 模拟 虚拟 实现 
CalculatorService。 此 外 ， 使 用 注解 广泛 展示 注解 支持 JUnit 和 EasyMock。 


以 下 是 所 采取 的 步 又。 
创建 一 个 接口 CalculatorService， 其 目的 是 提供 各 种 计算 相关 的 功能 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 


创建 一 个 Java 类 来 表示 MathApplication. 
MathApplication.java 


public class MathApplication { 
private CalculatorService calcService; 


public void setCalculatorService(CalculatorService calcService): 
this.calcService = calcService; 


} 
public double add(double inputi, double input2){ 
return calcService.add(inputi, input2); 


j 
public double subtract(double inputi, double input2){ 
return calcService.subtract(inputi, input2); 


} 
public double multiply(double inputi, double input2){ 
return calcService.multiply(inputi, input2); 


j 

public double divide(double inputi, double input2){ 
return calcService.divide(inputi, input2); 

j 


) 
4 — BM 


让 我 们 来 测试 MathApplication 类 ， 通 过 它 注 入 CalculatorService 作 一 个 模拟 。 Mock 
将 由 EasyMock 创 建 。 








MathApplicationTester.java 


import org.easymock.EasyMock; 
import org.easymock.EasyMockRunner ; 
import org.easymock.Mock; 

import org.easymock.TestSubject; 
import org.junit.Assert; 

import org.junit.Before; 

import org.junit.Test; 

import org.junit.runner.RunWith; 


//@Runwith attaches a runner with the test class to initialize the 
QRunwith(EasyMockRunner.class) 
public class MathApplicationTester { 


//@TestSubject annotation is used to identify class which is go: 
//mock object 

QTestSubject 

MathApplication mathApplication - new MathApplication(); 


//@Mock annotation is used to create the mock object to be injec 
QMock 
CalculatorService calcService; 


QTest 

public void testAdd(){ 
//add the behavior of calc service to add two numbers 
EasyMock.expect(calcService.add(10.0,20.0)).andReturn(30.00), 


//activate the mock 
EasyMock.replay(calcService); 


//test the add functionality 
Assert.assertEquals(mathApplication.add(10.0, 20.0),30.0,0); 





创建 一 个 Java 类 在 文件 夹 CA» EasyMock WORKSPACE 执行 测试 用 例 


TestRunner.java 


import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 


public class TestRunner { 
public static void main(String[] args) { 
Result result = JUnitCore.runClasses(MathApplicationTester .c- 
for (Failure failure : result.getFailures()) { 
System.out.println(failure.toString()); 
} 


System.out.println(result.wasSuccessful()); 





验证 结果 


编译 使 用 javac 编 译 如 下 的 类 


C:\EasyMock_WORKSPACE>javac CalculatorService.java MathApplication 
SS 





现在 运行 测试 运行 看 结果 


C:\EasyMock_WORKSPACE>java TestRunner 


验证 输出 


true 


EasyMock 添 加 行为 - EasyMock 教 程 


EasyMock 使 用 expect() 方 法 或 expectLassCall() 方 法 添加 一 个 功能 ， 一 个 模拟 对 
象 。 请 看 下 面 的 代码 片段 。 


//add the behavior of calc service to add two numbers 
EasyMock.expect(calcService.add(10.0,20.0)).andReturn(30.00); 


这 里 ， 我 们 已 经 指示 EasyMock， 行 为 添加 10 和 20 到 calcService 的 添加 方法 并 作为 
其 结果 ， 到 返回 值 30.00 


在 这 个 时 间 点 上 ， 模 拟 简 单 记 录 的 行为 ， 但 它 本 身 不 作为 一 个 模拟 对 象 。 调 用 回放 
后 ， 按 预期 工作 。 


//add the behavior of calc service to add two numbers 
EasyMock.expect(calcService.add(10.0,20.0)).andReturn(30.00); 


//activate the mock 
//EasyMock.replay(calcService); 
不 需要 EasyMock.Replay() 的 示例 
需要 EasyMock.Replay() 的 示例 


EasyMock 验 证 行为 - EasyMock 教 程 
EasyMock 提 供 了 一 个 检查 被 使 用 或 不 使 用 verify() 方 法 ， 请 看 下 面 的 代码 片段 。 


//activate the mock 
EasyMock.replay(calcService); 


//test the add functionality 
Assert.assertEquals(mathApplication.add(10.0, 20.0),30.0,0); 


//verify call to calcService is made or not 
EasyMock.verify(calcService); 

不 使 用 EasyMock.Verify() 示 例 

使 用 EasyMock.Verify() 示 例 


EasyMock 期 望 调用 - EasyMock 教 程 


EasyMock 提 供 ， 可 以 在 特定 的 方法 来 的 调用 的 数目 的 特别 检查 。 假 设 
MathApplication 使 用 其 的 任意 方法 ， 其 中 CalculatorService.serviceUsed() 方 法 表示 
CalculatorService 的 用 于 获得 所 需要 的 操作 结果 之 前 调用 
CalculatorService.serviceUsed() 方 法 ， 只 有 一 次 。 MathApplication 应 该 不 能 够 调 
用 CalculatorService.serviceUsed() 一 次 以 上 。 


//add the behavior of calc service to add two numbers and serviceU: 
EasyMock.expect(calcService.add(10.0,20.0)).andReturn(30.00); 
calcService.serviceUsed(); 

//limit the method call to 1, no less and no more calls are allowec 
EasyMock.expectLastCall().times(1); 





创建 CalculatorService 的 界面 如 下 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 
public void serviceUsed(); 


calcService.serviceUsed() 被 调用 一 次 例子 
calcService.serviceUsed() 调 用 两 次 例子 


无 需 调 用 calcService.serviceUsed() 示 例 


EasyMock 改 变调 用 - EasyMock 教 程 


EasyMock 提 供 很 多 的 方法 来 改变 预期 的 调用 计数 。 
e times(int min, int max) - 最 小 值 和 最 大 值 之 间 的 预期 调用 。 
e atLeastOnce() - 预期 至 少 有 一 个 调用 。 
e anyTimes() - 预期 调用 的 数量 不 受 限 制 。 
times(min,max) 的 例子 
atLeastOnce 例 子 
anyTimes 例 子 


EasyMock i 4438 - EasyMock 教 程 
EasyMock 提 供 了 一 个 功能 ， 用 以 模拟 抛 出 异常 ， 所 以 异常 处 理 可 以 进行 测试 。 


//add the behavior to throw exception 
EasyMock.expect(calcService.add(10.0,20.0)).andThrow(new RuntimeExc 


‘| — i; 
在 这 里 ， 我 们 添加 了 一 个 异常 子 句 模仿 对 象 。 MathApplication 利 用 使 用 


calcService 其 Add 方 法 和 模型 将 抛 出 RuntimeException 异 常 时 调用 
calcService.add() 方 法 。 








示例 
创建 一 个 接口 CalculatorService， 其 目的 是 提供 各 种 计算 相关 的 功能 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 


j 


创建 一 个 Java 类 用 来 表示 MathApplication。 
MathApplication.java 


public class MathApplication { 
private CalculatorService calcService; 


public void setCalculatorService(CalculatorService calcService): 
this.calcService = calcService; 


} 
public double add(double inputi, double input2){ 
return calcService.add(inputi, input2); 


public double subtract(double inputi, double input2){ 
return calcService.subtract(inputi, input2); 


public double multiply(double inputi, double input2){ 
return calcService.multiply(inputi, input2); 


public double divide(double inputi, double input2){ 
return calcService.divide(inputi, input2); 





让 我 们 来 测试 MathApplication 类 ， 通 过 它 注 入 CalculatorService 作 一 个 模拟 。 Mock 
将 由 EasyMock 创 建 。 


MathApplication Tester.java 


import org.easymock.EasyMock; 
import org.easymock.EasyMockRunner ; 
import org.easymock.Mock; 

import org.easymock.TestSubject; 
import org.junit.Assert; 

import org.junit.Test; 

import org. junit.runner.Runwith; 


//@RunWith attaches a runner with the test class to initialize the 
QRunwith(EasyMockRunner.class) 
public class MathApplicationTester { 


//@TestSubject annotation is used to identify class which is go: 
//mock object 

QTestSubject 

MathApplication mathApplication - new MathApplication(); 


//@Mock annotation is used to create the mock object to be injec 
@Mock 
CalculatorService calcService; 


@Test(expected = RuntimeException.class) 

public void testAdd(){ 
//add the behavior to throw exception 
EasyMock.expect(calcService.add(10.0,20.0)).andThrow(new Runt 
//activate the mock 
EasyMock.replay(calcService); 
//test the add functionality 
Assert.assertEquals(mathApplication.add(10.0, 20.0),30.0,0); 
//verify call to calcService is made or not 
EasyMock.verify(calcService); 





创建 一 个 Java 类 在 文件 夹 CA» EasyMock WORKSPACE 执行 测试 用 例 


TestRunner.java 


import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 


public class TestRunner { 
public static void main(String[] args) { 
Result result = JUnitCore.runClasses(MathApplicationTester .c- 
for (Failure failure : result.getFailures()) { 
System.out.println(failure.toString()); 


j 


System.out.println(result.wasSuccessful()); 





验证 结果 
使 用 javac 编 译 如 下 类 


C:\EasyMock_WORKSPACE>javac MathApplicationTester.java 


现在 运行 测试 运行 看 结果 


C:\EasyMock_WORKSPACE>java TestRunner 


验证 输出 


true 


EasyMock createMock - EasyMock 教 程 


到 目前 为 止 ， 我 们 已 经 使 用 注解 来 创建 Mocks。 EasyMock 提 供 了 各 种 方法 来 创建 
模拟 对 象 。 EasyMock.createMock() 创 建 的 模拟 ， 但 没有 理会 方法 的 顺序 调用 模拟 
会 在 作出 其 行动 的 适当 时 机 。 


语法 


calcService = EasyMock.createMock(CalculatorService.class); 


示例 


创建 一 个 接口 CalculatorService， 其 目的 是 提供 各 种 计算 相关 的 功能 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 

j 


创建 一 个 Java 类 用 来 表示 MathApplication。 
MathApplication.java 


public class MathApplication { 
private CalculatorService calcService; 


public void setCalculatorService(CalculatorService calcService): 
this.calcService = calcService; 


public double add(double inputi, double input2) { 
return calcService.add(inputi, input2); 


public double subtract(double inputi, double input2){ 
return calcService.subtract(inputi, input2); 


public double multiply(double inputi, double input2){ 
return calcService.multiply(inputi, input2); 


public double divide(double inputi, double input2){ 
return calcService.divide(inputi, input2); 





让 我 们 来 测试 MathApplication 类 ， 通 过 它 注 入 CalculatorService 作 一 个 模拟 。 Mock 
将 由 EasyMock 创 建 。 


在 这 里 ， 我 们 已 经 添加 了 两 个 模拟 方法 调用 ，add() 和 subtract() 来 模拟 对 象 ， 通 过 
expect()。 但 在 测试 过 程 中 ， 我 们 调用 Add() 方 法 前 调用 subtract()。 当 我 们 创建 模拟 
对 象 使 用 EasyMock.createMock()， 以 便 执 行 方法 。 


MathApplication Tester. java 


import org.easymock.EasyMock; 
import org.easymock.EasyMockRunner ; 
import org.junit.Assert; 

import org.junit.Before; 

import org.junit.Test; 

import org.junit.runner.Runwith; 


QRunwith(EasyMockRunner.class) 
public class MathApplicationTester { 


private MathApplication mathApplication; 
private CalculatorService calcService; 


QBefore 

public void setUp(){ 
mathApplication - new MathApplication(); 
calcService - EasyMock.createMock(CalculatorService.class); 
mathApplication.setCalculatorService(calcService); 


j 


QTest 

public void testAddAndSubstract(){ 
//add the behavior to add numbers 
EasyMock.expect(calcService.add(20.0,10.0)).andReturn(30.0); 
//subtract the behavior to subtract numbers 
EasyMock.expect(calcService.subtract(20.0,10.0)).andReturn(41( 
//activate the mock 
EasyMock.replay(calcService); 
//test the substract functionality 
Assert.assertEquals(mathApplication.subtract(20.0, 10.0),10.( 
//test the add functionality 
Assert.assertEquals(mathApplication.add(20.0, 10.0),30.0,0); 
//verify call to calcService is made or not 
EasyMock.verify(calcService); 





创建 一 个 Java 类 在 文件 夹 C:\ > EasyMock WORKSPACE 执行 测试 用 例 


TestRunner.java 


import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 


public class TestRunner { 
public static void main(String[] args) { 
Result result = JUnitCore.runClasses(MathApplicationTester .c- 
for (Failure failure : result.getFailures()) { 
System.out.println(failure.toString()); 


j 


System.out.println(result.wasSuccessful()); 





验证 结果 
使 用 javac 编 译 如 下 类 


C:\EasyMock_WORKSPACE>javac MathApplicationTester.java 


现在 运行 测试 运行 看 结果 


C:\EasyMock_WORKSPACE>java TestRunner 


验证 输出 


true 


EasyMock createStrictMock - EasyMock 教 程 


EasyMock.createStrictMock() 创 建 的 模拟 ， 也 需要 关心 的 方法 的 顺序 调用 模拟 会 在 
作出 其 行动 的 适当 时 机 。 


语法 


calcService = EasyMock.createStrictMock(CalculatorService.class); 


加 二 


示例 


创建 一 个 接口 CalculatorService， 其 目的 是 提供 各 种 计算 相关 的 功能 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 

} 


创建 一 个 Java 类 用 来 表示 MathApplication。 
MathApplication.java 


public class MathApplication { 
private CalculatorService calcService; 


public void setCalculatorService(CalculatorService calcService): 
this.calcService = calcService; 


public double add(double inputi, double input2) { 
return calcService.add(inputi, input2); 


public double subtract(double inputi, double input2){ 
return calcService.subtract(inputi, input2); 


public double multiply(double inputi, double input2){ 
return calcService.multiply(inputi, input2); 


public double divide(double inputi, double input2){ 
return calcService.divide(inputi, input2); 





让 我 们 来 测试 MathApplication 类 ， 通 过 它 注 入 CalculatorService 作 一 个 模拟 。 Mock 
将 由 EasyMock 创 建 。 


在 这 里 ， 我 们 已 经 添加 了 两 个 模拟 方法 调用 ，add() 和 subtract() 来 模拟 对 象 ， 通 过 
expect()。 但 在 测试 过 程 中 ， 我 们 调用 Add() 方 法 前 调用 subtract()。 当 我 们 创建 一 个 
使 用 EasyMock.createStrictMock() 的 模拟 对 象 ， 以 便 执行 方法 。 


MathApplication Tester.java 


import 
import 
import 
import 
import 
import 


org.easymock.EasyMock; 
org.easymock.EasyMockRunner ; 
org.junit.Assert; 

org. junit.Before; 
org.junit.Test; 

org. junit.runner.Runwith; 


QRunwith(EasyMockRunner.class) 


public 


class MathApplicationTester { 


private MathApplication mathApplication; 
private CalculatorService calcService; 


@Before 
public void setUp(){ 


} 


mathApplication = new MathApplication(); 
calcService = EasyMock.createStrictMock(CalculatorService.cl: 
mathApplication.setCalculatorService(calcService) ; 


@Test 
public void testAddAndSubstract(){ 


//add the behavior to add numbers 
EasyMock.expect(calcService.add(20.0,10.0)).andReturn(30.0); 
//subtract the behavior to subtract numbers 
EasyMock.expect(calcService.subtract(20.0,10.0)).andReturn(41( 
//activate the mock 

EasyMock.replay(calcService); 

//test the substract functionality 
Assert.assertEquals(mathApplication.subtract(20.0, 10.0),10.( 
//test the add functionality 
Assert.assertEquals(mathApplication.add(20.0, 10.0),30.0,0); 
//verify call to calcService is made or not 
EasyMock.verify(calcService); 





创建 一 个 Java 类 在 文件 夹 C:\ > EasyMock WORKSPACE 执行 测试 用 例 


TestRunner.java 


import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 


public class TestRunner { 
public static void main(String[] args) { 
Result result = JUnitCore.runClasses(MathApplicationTester .c- 
for (Failure failure : result.getFailures()) { 
System.out.println(failure.toString()); 


j 


System.out.println(result.wasSuccessful()); 





验证 结果 
使 用 javac 编 译 如 下 类 


C:\EasyMock_WORKSPACE>javac MathApplicationTester.java 


现在 运行 测试 运行 看 结果 


C:\EasyMock_WORKSPACE>java TestRunner 


验证 输出 


testAddAndSubstract(com.yiibai.mock.MathApplicationTester): 
Unexpected method call CalculatorService.subtract(20.0, 10.0): 
CalculatorService.add(20.0, 10.0): expected: 1, actual: 0 
false 


EasyMock createNiceMock - EasyMock 教 程 


EasyMock.createNiceMock() 创 建 了 模拟 ， 并 设置 模拟 的 每 个 方法 的 默认 实现 。 如 
果 使 用 EasyMock.createMock()， 然 后 模拟 方法 调用 将 抛 出 断言 错误 。 


语法 


calcService = EasyMock.createNiceMock(CalculatorService.class); 


示例 


创建 一 个 接口 CalculatorService， 其 目的 是 提供 各 种 计算 相关 的 功能 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 


j 


创建 一 个 Java 类 用 来 表示 MathApplication。 
MathApplication.java 


public class MathApplication { 
private CalculatorService calcService; 


public void setCalculatorService(CalculatorService calcService): 
this.calcService = calcService; 


} 
public double add(double inputi, double input2){ 
return calcService.add(input1, input2); 


} 
public double subtract(double inputi, double input2){ 
return calcService.subtract(inputi, input2); 


} 
public double multiply(double inputi, double input2){ 
return calcService.multiply(inputi, input2); 


public double divide(double inputi, double input2){ 
return calcService.divide(inputi, input2); 





让 我 们 来 测试 MathApplication 类 ， 通 过 它 注 入 CalculatorService 作 一 个 模拟 。Mock 
将 由 EasyMock 创 建 。 


在 这 里 ， 我 们 已 经 增加 了 一 个 模拟 的 方法 调用 ，add() 通 过 expect()。 但 在 测试 过 程 
中 ， 我 们 称 之 为 substract() 等 方法 。 当 创建 一 个 使 用 EasyMock.createNiceMock() 
模拟 对 象 ， 用 缺 省 值 缺 省 实现 是 可 用 的 。 


MathApplication Tester.java 


import 
import 
import 
import 
import 
import 


org 


org 


.easymock.EasyMock; 
org. 
org. 
.Junit.Before; 
org. 
org. 


easymock.EasyMockRunner ; 
junit.Assert; 


junit.Test; 
junit.runner.RunWith; 


QRunwith(EasyMockRunner.class) 
public class MathApplicationTester { 


private MathApplication mathApplication; 


private CalculatorService calcService; 


QBefore 
public void setUp(){ 

mathApplication - new MathApplication(); 

calcService - EasyMock.createNiceMock(CalculatorService.clas: 
mathApplication.setCalculatorService(calcService); 


j 


QTest 
public void testCalcService()( 

//add the behavior to add numbers 
EasyMock.expect(calcService.add(20.0,10.0)).andReturn(30.0); 
//activate the mock 

EasyMock.replay(calcService); 

//test the add functionality 
Assert.assertEquals(mathApplication.add(20.0, 10.0),30.0,0); 
//test the substract functionality 
Assert.assertEquals(mathApplication.subtract(20.0, 10.0),0.0, 
//test the multiply functionality 
Assert.assertEquals(mathApplication.divide(20.0, 10.0),0.0,0. 
//test the divide functionality 
Assert.assertEquals(mathApplication.multiply(20.0, 10.0),0.0, 


//verify call to calcService is made or not 
EasyMock.verify(calcService); 





创建 一 个 Java 类 在 文件 夹 C:\ > EasyMock WORKSPACE 执行 测试 用 例 


TestRunner.java 


import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 


public class TestRunner { 
public static void main(String[] args) { 
Result result = JUnitCore.runClasses(MathApplicationTester .c- 
for (Failure failure : result.getFailures()) { 
System.out.println(failure.toString()); 


j 


System.out.println(result.wasSuccessful()); 





验证 结果 
使 用 javac 编 译 如 下 类 


C:\EasyMock_WORKSPACE>javac MathApplicationTester.java 


现在 运行 测试 运行 看 结果 


C:\EasyMock_WORKSPACE>java TestRunner 


验证 输出 


true 


EasyMock EasyMockSupport - EasyMock 教 程 


EasyMockSupport 是 Utiliy 或 辅助 类 的 测试 类 。 它 提供 了 以 下 功能 
e replayAll() - 都 记录 在 一 个 批 次 中 创建 模拟 。 
e. verifyAll() - 验证 所 有 模拟 操作 于 一 个 批 次 。 
e resetAll() - 将 所 有 模拟 操作 于 一 个 批 次 。 


示例 
创建 一 个 接口 CalculatorService， 其 目的 是 提供 各 种 计算 相关 的 功能 。 


CalculatorService.java 


public interface CalculatorService { 
public double add(double inputi, double input2); 
public double subtract(double inputi, double input2); 
public double multiply(double inputi, double input2); 
public double divide(double inputi, double input2); 


创建 一 个 Java 类 用 来 表示 MathApplication。 
MathApplication.java 


public class MathApplication { 
private CalculatorService calcService; 


public void setCalculatorService(CalculatorService calcService): 
this.calcService = calcService; 


} 
public double add(double inputi, double input2){ 
return calcService.add(input1, input2); 


} 
public double subtract(double inputi, double input2){ 
return calcService.subtract(inputi, input2); 


} 
public double multiply(double inputi, double input2){ 
return calcService.multiply(inputi, input2); 


public double divide(double inputi, double input2){ 
return calcService.divide(inputi, input2); 





让 我 们 来 测试 MathApplication 类 ， 通 过 它 注 入 CalculatorService 作 一 个 模拟 。Mock 
将 由 EasyMock 创 建 。 


MathApplication Tester.java 


import org.easymock.EasyMockRunner; 
import org.easymock.EasyMockSupport; 
import org.junit.Assert; 

import org.junit.Before; 

import org.junit.Test; 

import org.junit.runner.RunWith; 


QRunwith(EasyMockRunner.class) 
public class MathApplicationTester extends EasyMockSupport { 


private MathApplication mathApplication1; 
private MathApplication mathApplication2; 


private CalculatorService calcService1; 
private CalculatorService calcService2; 


QBefore 

public void setUp(){ 
mathApplicationi - new MathApplication(); 
mathApplication2 - new MathApplication(); 
calcService1 = createNiceMock(CalculatorService.class); 
calcService2 = createNiceMock(CalculatorService.class); 
mathApplicationi.setCalculatorService(calcService1); 
mathApplication2.setCalculatorService(calcService2); 


@Test 

public void testCalcService(){ 
//activate all mocks 
replayAll(); 
//test the add functionality 
Assert.assertEquals(mathApplicationi.add(20.0, 10.0),0.0,0); 
//test the substract functionality 
Assert.assertEquals(mathApplicationi.subtract(20.0, 10.0),0.( 
//test the multiply functionality 
Assert.assertEquals(mathApplicationi.divide(20.0, 10.0),0.0,( 
//test the divide functionality 
Assert.assertEquals(mathApplicationi.multiply(20.0, 10.0),0.t( 


//test the add functionality 
Assert.assertEquals(mathApplication2.add(20.0, 10.0),0.0,0); 
//test the substract functionality 
Assert.assertEquals(mathApplication2.subtract(20.0, 10.0),0.( 
//test the multiply functionality 
Assert.assertEquals(mathApplication2.divide(20.0, 10.0),0.0,( 
//test the divide functionality 
Assert.assertEquals(mathApplication2.multiply(20.0, 10.0),0.t( 


//verify all the mocks 
verifyAll(); 





创建 一 个 Java 类 在 文件 夹 CX» EasyMock WORKSPACE 执行 测试 用 例 


TestRunner.java 


import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 


public class TestRunner { 
public static void main(String[] args) ( 
Result result = JUnitCore.runClasses(MathApplicationTester .c- 
for (Failure failure : result.getFailures()) { 
System.out.println(failure.toString()); 
} 


System.out.println(result.wasSuccessful()); 





验证 结果 


使 用 javac 编 译 如 下 类 

C:\EasyMock_WORKSPACE>javac MathApplicationTester.java 
现在 运行 测试 运行 看 结果 

C:\EasyMock_WORKSPACE>java TestRunner 
验证 输出 


true 


Eclipse 教程 





Eclipse 是 一 个 开放 源 代 码 的 、 基 于 Java 的 可 扩展 开发 平台 。 


Eclipse 是 Java 的 集成 开发 环境 (IDE) ， 当 然 Eclipse 也 可 以 作为 其 他 开发 语言 
的 集成 开发 环境 ， 如 C，C++，PHP， 和 Ruby 等 。 


Eclipse 附带 了 一 个 标准 的 插件 集 ， 包 括 Java 开 发 工具 (Java Development Kit, 
JDK) . 


许可 证 


Eclipse 平台 及 其 插件 基于 Eclipse 公共 许可 证 (EPL : Eclipse Public License) 发 


o 


Eclipse 公共 许可 证 〈 简 称 EPL) 是 一 种 开源 软件 发 布 许可 证 ， 由 Eclipse 基金 会 点 用 
于 名 下 的 集成 开发 环境 Eclipse 上 。 


发 行 版 


从 2006 年 起 ，Eclipse 基 金 会 每 年 都 会 安排 同步 发 布 。 至 今 ， 同 步 发 布 主 要 在 6 月 进 
行 ， 并 且 会 在 接 下 来 的 9 月 及 2 月 释放 出 SR1 及 SR2 版 本 。 


版 本 代号 
Callisto 


Europa 


Ganymede 


Galileo 


Helios 


Indigo 


Juno 


Kepler 


Luna 


Mars 


3.8% 


主要 版 本 发 行 日 
期 
2006 年 6 月 26 日 
2007 年 6 月 27 日 
2008 年 6 月 25 日 
2009*F6 H24H 
2010 年 6 月 23 日 
2011 年 6 月 22 日 
2012 年 6 月 27 日 
2013 年 6 月 26 日 


2014 年 6 月 25 日 


2015 年 6 月 24 日 


SR1 发 行 日 期 


N/A 


2007 年 9 月 28 
日 


2008 年 9 月 24 
日 


2009 年 9 月 25 
日 


2010 年 9 月 24 
日 


2011 年 9 月 23 
日 


2012 年 9 月 28 
日 


2013 年 9 月 27 
日 


2014 年 9 月 25 
日 


N/A 


SR2 发 行 日 期 


N/A 


2008 年 2 月 29 
H 


20094F2A 25 
日 


2010 年 2 月 26 
日 


2011 年 2 月 25 
日 


2012 年 2 月 24 
日 


2013 年 3 月 1 日 


2014 年 2 月 28 


Eclipse 安装 


下 载 Eclipse， 下 载 地 址 为 : http://www.eclipse.org/downloads/, 下 载 页 面 列 出 了 
不 同 语言 的 Eclipse IDE， 你 可 以 根据 自己 需要 下 载 。 


Eclipse 的 每 个 安装 包 都 不 同 ， Java 开发 人 员 通 常 使 用 Eclipse IDE for Java 
Developers 来 开发 Java 应 用 。 


列表 右 侧 提供 了 Windows， 和 Mac 操作 系统 及 对 应 的 32 位 与 64 位 的 安装 包 ， 
你 可 以 根据 自己 的 系统 情 ) 合适 的 包 下 载 。 


Eclipse Luna (4.4.1) Release for 


Eclipse IDE for Java Developers 154 mB 
ve Downloaded 2,581,552 Times * Windows 32 Bit 


Windows 64 Bit 
The essential tools for any Java developer, including a Java IDE, a CVS client =m 


Git client, XML Editor, Mylyn, Maven integration 


Package Solutions 





Eclipse IDE for Java EE Developers. 254 mB 


, —« Downloaded 1,570,255 Times À Windows 32 Bit 
SF a E 


a : : eu Windows 64 Bit 
TNT Tools for Java developers creating Java EE and Web applications, including a 
Java IDE, tools for Java EE, JPA, JSF, Mylyn 


£ * 
JRebel for Eclipse IDE 4 casei 
See Java Code Changes Instantly. Save Time. Reduce Stress. Finish Projects Gu Download 


Faster! 


zz" Eclipse 


Eclipse 是 基于 Java 的 可 扩展 开发 平台 ， 所 以 安装 Eclipse 前 你 需要 确保 你 的 电脑 
已 安装 JDK，JDK 安装 可 以 查看 我 们 的 Java 开 发 环境 配置 。 


Eclipse 的 安装 非常 简单 ， 你 只 需要 下 载 压 缩 包 ， 解 压 完 毕 后 即 可 使 用 ， 进 入 文件 
夹 ， 红 框 如 图 所 示 就 是 eclipse 的 启动 程序 
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(O wma [I] m eJ 
Col p2 eJ plugins eJ readme 


features 


_eclipseproduct @) = artifacts xml 
ECLIPSEPRODUCT 文件 UL X 
1 KB == 112 is 


eclipse. ini "i ] epl-v10. html 
EI 配置 设置 m eclipsec. exe E HTML 次 件 
KB 17 KP 





notice. html 
HTML 文件 
10 KB 





若 你 打开 Eclipse 的 时 候 发 现 如 下 的 对 话 框 ， 则 说 明 你 的 电脑 未 安装 JDK 环境 。 


A Java Runtime Environment (RE) or Java Development Kit (DK) 

must be available in order to run Eclipse, No Java virtual machine 

was found after searching the following locations 

C:\Documents and Bot tines utut i Pri L OE exe 
javer, exe in your current PATH 





A RARER LE, (RSIDUGBIEIFEGG,. MARAMANCE LIFE 
X, mh ok 按钮 。 


> Vorkspace Launcher 


Select a workspace 


Eclipse stores your projects in a folder called a workspace 
Choose a workspace folder to use for this session. 


Yorkspace: TENIYI 


[JUse this as the default and do not ask again 





创建 一 个 项 目 : 选择 file--New--java Project, 204: 
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® Java 一 Eclipse 





File E 
New AlttShift+N — ^| e£ Java Project 
Open File... F5 Project... 
Close Ctrlt¥ ff Package 
Close All Ctrl+Shi £t @ ches 

(B Save Ctrl14S @ Interface 

&g Save Às... G Enum 

办 Save ALL CtrliShi ftfS | @ Annotation 
Revert #9 Source Folder 
Move... 15 Java Forking Set 

ical Rename... F2 C5 Folder 

&) Refresh PS [T File 


p [S Untitled Text File 


Convert Line Delimiters To 
E? JUnit Test Case 


输入 项 目 名 称 ， 上 比如 我 输入 test， 然 后 点 击 finish 


> Hew Java Project 


Create a Java Project 
Create a Java project in the workspace or in an external location, 


alt JRE (currently ’ jre Configure JREs. 


Project layout 
( ) Us 
oF 
Working sets 
Li 





完成 项 目的 创建 ， 点 击 红 框 里 的 小 图 标 ， 如 图 : 
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= Java 一 Eclipse 
File Edit Navigate Search Project Run Window Help 
ah GD) Welcome 23 





Welcome to Eclipse 


— 一 - 


然后 在 左 侧 菜 单 选择 test 项 目 ， 右 键 --new--class 





File Edit Source Refactor Mavigate Segrch Project Bun Window Help 
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E ^: 5... + oj. . 
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Ba Copy Qualified Nane @ Annotation | 
D Beste Ctrl+V EI Source Folder 
X Delete Delete 45 Java Yorking Set | 
Build Path » isa 
Source 人 t+ShiftfS > File 
Refactor Alt+Shift+T > 国 Untitled Text File g 1 
| E? JUnit Test Case t 
Dy Import... | 
2/3 Export... PS Other... Cty ath 


键入 类 名 ， 如 输入 test, UA, AAA dfinish 


H 


E 


对 
Kt 
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& Hew Java Class 


Java Class 
a Type name is discouraged By convention, Java type names usually start 
with an uppercase letter 


PT 
————————— 
pee | (ene. ] 


Browse... 


Das: Clfing — 


(java. lang Object | Browse... | 


| add. |] 

pons 

NENNEN | : | 
J | 
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Eclipse 窗口 说 明 


Eclipse 工作 台 (Workbench) 


首先 ， 让 我 们 来 看 一 下 Eclipse 作 台 用 户 界面 ， 和 它 里 面 的 各 种 组 件 。 


工作 台 是 多 个 窗口 的 集合 。 每 个 窗口 包含 菜单 栏 ， 工 具 栏 ， 快 捷 方 式 栏 ， 以 及 一 
或 者 多 个 透视 图 。 


Workbench window Perspective Editor 
Short cut bar Menu bar Tool bar 


s is ete 
File Edit Source Refactor Navigate 'fearch Project Run Window Help 


S- HLASE- x- ARRAS]: 


i) Welcome [J| MenuTest.java X 
oo SRR 
: * @author jinli 
te MenuTest x | 
=| (default package) * To change this generated comment go to 
* Window>Preferences>Java>Code Generation»Code and Comments 
*/ 
import java.awt.*; 
* MenuTest import java.awt.event.*: 
, MyMenuBar import javax.swing.*; 
È main(String[]) 
à editItems 
A editShortcuts 
A fileItems class MyMenuBar extends JMenuBar { 


A FileShortcuts String ] PXISIC St [ 

@ MyMenuBar() ring ileItems - new ring 
: : String[ ] editItems = 
lj. JRE System Library [jdk1.3.1] char[ ] fileShortcuts 
char[ ] editShortcuts 















































=- [J] MenuTest. java 
4, 
Eimport declarations 
































import javax.swing.border.*; 
import javax.swing.event.*: 














public MyMenuBar( ) { 


JMenu fileMenu = new JMenu("File"): 





q/ Tasks (D Eee) 





Package Explorer [Hierarchy 
MenuTest.java/import declaratic| 


Views 
透视 图 是 一 个 包含 一 系列 视图 和 内 容 编辑 器 的 可 视 容器 。 
视图 完全 存在 于 某 个 透视 图 中 而 且 不 能 被 共享 ， 而 任何 打开 的 内 容 编辑 器 可 以 在 透 
视图 间 共 享 。 


如 果 两 个 或 者 多 个 透视 图 打开 了 同样 的 视图 ， 他 们 共享 这 个 视图 的 同一 个 实例 ， 虽 
然 在 不 同 透视 图 之 间 视 图 的 布局 可 能 不 同 。 





对 于 不 同 的 工作 台 窗 口中 的 透视 图 ， 编 辑 器 和 视图 都 不 能 共享 。 


一 个 透视 图 就 好 像 是 一 本 书 里 面 的 一 页 。 它 存在 在 一 个 窗口 中 ， 并 且 和 其 他 透视 图 
一 起 存在 ， 和 书 中 的 一 页 一 样 ， 每 次 你 只 能 看 到 一 个 透视 图 。 


工作 台 的 主 菜 单 栏 通常 包括 File，Edit，Navigate，Project，Window，Help 这 些 顶 
层 菜 单 。 


其 他 的 顶层 菜单 位 于 Edit 和 Project 菜 单 之 间 ， 往 往 是 和 上 下 文 相关 ， 这 个 上 下 文 包 
括 当前 活动 的 透视 图 ， 最 前 面 的 编辑 器 以 及 活动 视图 。 


在 File 菜 单 中 ， 你 可 以 找到 一 个 New 子 菜单 ， 它 包括 Project，Folder，File 的 创建 菜 
单项 。 


File 菜单 也 包含 Import and Export 菜 单项 ， 用 来 导入 文件 到 Wrokbench 中 ， 以 及 导 
出 它们 。 


在 Edit 菜 单 中 ， 你 可 以 找到 象 Cut，Copy，Paste， 和 Delete 这 些 命令 。 这 些 命令 称 
为 全 局 命 分， 作用 于 活动 部 件 。 


也 就 是 说 ， 如 果 当 Navigator 活 动 时 使 用 Delete 命 令 , 实际 操作 是 由 Navigator 完 成 
的 。 


在 Project 菜 单 中 ， 你 可 以 找到 和 项 目 相关 的 命令 ， 比 如 Open Project, Close 
Project 和 Rebuild Porject 等 。 


在 Run 菜 单 中 ， 你 可 以 看 到 和 和 运行， 调试 应 用 代码 相关 的 命令 ， 以 及 启动 象 Ant 脚 本 
这 样 的 外 部 工具 。 


在 Window 菜 单 中 ， 你 可 以 找到 Open Perspective 子 菜单 ， 根 据 你 开发 任务 的 需要 
打开 不 同 的 透视 图 。 


你 也 能 看 到 透视 图 布局 管理 菜单 栏 。Show View 子 菜单 用 来 在 当前 的 Workbench 窗 
口中 增加 视图 。 


另外 ， 你 可 以 通过 首选 项 菜单 项 来 修改 工作 台 的 功能 首选 项 配置 。 


如 果 你 是 插件 开发 者 ， 你 可 以 为 平台 提供 新 的 视图 ， 编 辑 器 ， 向 导 ， 菜 单 和 工具 
项 。 这 些 东 西 都 是 用 XML 来 定义 的 ， 插 件 一 旦 注册 后 ， 就 可 以 和 平台 中 已 生存 在 的 
组 件 无 缝 地 集成 在 一 起 。 


Eclipse 多 窗口 


Eclipse 可 以 同时 开启 多 个 窗口 ， 在 菜单 栏 选择 : Window -> New Window 来 开启 
多 窗口 。 


多 个 窗口 的 切换 你 可 以 使 用 Alt + Tab 来 回 切 。 
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Eclipse 菜单 


Eclipse 查看 的 菜单 栏 通常 包含 以 下 几 个 菜单 : 


File 菜单 

Edit 菜单 
Navigate 菜单 
Search 菜单 
Project 菜单 
Run 菜单 
Window 菜单 
Help 菜单 





File Edit Navigate Search Project Run [Window] Help - 


[toy is 


larle sl 


New Window 

New Editor 

Open Perspective , 
Show View d 


Customize Perspective... 
Save Perspective As... 
Reset Perspective... 
Close Perspective 

Close All Perspectives 


Navigation d 


Preferences 





通过 Eclipse 插件 你 可 以 添加 新 的 菜单 和 菜单 项 。 


菜单 挡 述 


m 


NO 


菜单 名 
File 
Edit 
Source 


Navigate 
Search 
Project 


Run 


Window 


Help 


描述 


File 菜单 运行 你 打开 文件 ， 关 闭 编辑 器 ， 保 存 编辑 的 内 容 ， 重 命名 
文件 。 此 外 还 可 以 导入 和 导出 工作 区 的 内 容 及 关闭 Eclipse. 


Edit 菜单 有 复制 和 粘贴 等 功能 。 


只 有 在 打开 java 编辑 器 时 Source 菜单 才 可 见 。 Source 菜单 关联 
了 一 些 关 于 编辑 java 源码 的 操作 。 


Navigate 菜单 包含 了 一 些 快速 定位 到 资源 的 操作 。 
Search 菜单 可 以 设置 在 指定 工作 区 对 指定 字符 的 搜索 。 
Project 菜单 关联 了 一 些 创 建 项 目的 操作 。 

Run 菜单 包含 了 一 些 代码 执行 模式 与 调试 模式 的 操作 。 


Window 菜单 允许 你 同时 打开 多 个 窗口 及 关闭 视图 。 Eclipse 的 参 
数 设 置 也 在 该 菜单 下 。 


Help 菜单 用 于 显示 帮助 窗口 ， 包 含 了 Eclipse 描述 信息 ， 你 也 可 以 
在 该 菜单 下 安装 插件 。 


Eclipse 也 可 以 自 定 义 菜 单 ， 自 定义 菜单 的 详细 介绍 可 以 查看 Eclipse 透视 图 。 


Eclipse 视 


天 于 视图 


Eclipse 视图 允许 用 户 以 图 表 形 式 更 直观 的 查看 项 目的 元 数据 。 例如 ， 项 目 导航 视 
图 中 显示 的 文件 夹 和 文件 图 形 表示 在 另外 一 个 编辑 窗口 中 相关 的 项 目 和 属性 视图 。 


Eclipse 透视 图 (perspective) 可 以 显示 任何 的 视图 和 编辑 窗口 。 
所 有 的 编辑 器 实例 出 现在 一 个 编辑 器 区 域内 ， 可 以 通过 文件 夹 视图 查看 。 
一 个 工作 台 窗 口 可 以 显示 任意 数量 的 文件 夹 视 图 。 每 个 文件 夹 视 图 可 以 显示 一 个 或 


多 个 视图 。 


组 织 视图 


下 图 显示 了 文件 夹 视图 的 四 个 视图 。 
BE Problems 9 Javadoc % Declaration © Properties 


0 items 


Description ~- Resource Path 


下 图 在 两 个 文件 夹 视图 中 显示 四 个 视图 。 


EE Problems 2, Declaration 口 | Properties 
O items Property 
Description 


移 除 视图 views 


视图 从 一 个 文件 夹 视 图 移动 到 另外 一 个 文件 夹 视 图 只 需 


工具 区 域 到 另外 一 个 文件 夹 视图 。 


Location 


Va 


要 点 击 视图 标题 并 推动 视图 


(t: Problems :: v "7 ©  q$Javadoc ™ Properties (mpsc--n 
0 items Property Value 
Description 


创建 文件 夹 视图 


文件 夹 视图 可 以 通过 移动 视图 标题 栏 到 编辑 去 外 或 移动 标题 栏 到 另外 一 个 文件 夹 视 
es 下 图 中 如 果 你 拖 动 了 绿色 线 框 内 的 标题 栏 意味 着 一 个 新 的 文件 夹 视 
图 将 被 创建 。 


E Problems 3 ə i = 6 Javadoc & Properties n wem 
D items Property a 
Description 


il $ 





移动 拖 动 图 标 到 窗口 的 底部 ， 您 可 以 创建 一 个 横 跨 窗口 整个 宽度 的 视图 文件 夹 。 移 
动 拖 动 图 标 到 窗口 的 左边 或 右边 ， 您 可 以 创建 一 个 横 跨 窗口 的 整个 高 度 视 图 文件 
夹 。 


操作 视 


你 可 以 在 Window 菜单 中 点 击 "Show View" 选项 打开 其 他 视图 。 
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New Window 















New Editor 
Open Perspective » 
_ Show View d 
z z Console Alt+Shift+Q, C 
Coe Pase Declaration Alt+Shift+Q, D 
ve eia j Error Log Alt+Shift+Q, L 
Reset Perspective... Javadoc Alt+Shift+Q, J 
Close Perspective Navigator 


Close All Perspectives Outline Alt+Shift+Q, O 
Package Explorer Alt+Shift+Q, P 
Palette 

Problems Alt+Shift+Q, X 
Progress 

Project Explorer 

Search Alt+Shift+Q, S 
Structure 

Task List Alt+Shift+Q, K 


Navigation » 


Preferences 








Tasks 
Templates 
Type Hierarchy Alt+Shift+Q, T 


VTE ODAAPAMP CAH HT OCHO * 


Other... Alt+Shift+Q, Q 


mi "Other" 菜单 选项 会 弹出 一 个 "Show View" 对 话 框 ， 对 话 框 中 你 可 以 查找 和 激 
活 视图 。 
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X» Show View 


& Ant 

@ CVS 

Debug 

4 & General 

Gl Bookmarks 
4^ Classic Search 
& Console 
©) Error Log 
@ Internal Web Browser 
[*: Markers 














= Sas 


视图 通过 各 个 分 类 来 组 织 。 你 可 以 通过 搜索 框 快速 查找 视图 。 然后 打开 视图 并 选 
择 ， 点 击 "OK" 按钮 即 可 。 


什么 是 基 视 图 
透视 图 是 一 个 包含 一 系列 视图 和 内 容 编辑 器 的 可 视 容器 。 黑 认 的 透视 图 叫 java, 
Eclipse 窗口 可 以 打开 多 个 透视 图 ， 但 在 同一 时 间 只 能 有 一 个 透视 图 处 于 激活 状 


A 


NO 


用 户 可 以 在 两 个 透视 图 之 间 切 换 。 











操作 透视 图 


通过 "Window" 菜 单 并 选择 "Open Perspective > Other" 来 打开 透视 图 对 话 框 。 


人 Open Persnective ail =) 





BaCVS Repository Exploring 
$ Debug 

fly Git Repcsitory Explorirg 
& Java (de'ault) 

Java Browsing. 

1e? Java Type Hierarchy 

© Planning 

if Resource 

Team Synchronizing 

X XML 














Cancel 





透视 图 对 话 框 中 显示 了 可 用 的 透视 图 列表 。 
该 透视 图 列表 也 可 以 通过 工具 栏 上 的 透视 图 按钮 来 打开 ( )。 


视图 切换 


大 都 数 情况 下 java 开发 者 会 使 用 Java 透视 图 和 Debug 透视 图 。 你 可 以 通过 工具 
条 上 的 透视 图 名 称 来 自由 切换 。 


ty | Java © Planning X XML €» Debug 区 | Resource | 
` * ` 
关闭 透视 图 


工具 条 上 右 击 透 视图 名 及 选择 "Close" 项 即 可 关闭 透视 图 。 


&'Java © Planning X 
Close 
V Show Text | 
mo.) x 
自 定 义 透 视图 
我 们 可 以 通过 自 定 义 透 视图 窗口 来 设置 我 们 想 要 的 透视 图 。 


e 点 击 菜单 栏 上 的 "Windows'" => "Customize Perspective" => 弹出 窗口 ， 可 以 
在 "Submenus" 里 面 选择 你 要 设置 的 内 容 。 


Pad => 设置 你 的 新 建 菜单 ， 可 以 把 你 平时 需要 新 建 的 最 常用 的 文件 类 型 先 


"Show Views" 在 你 自 定义 的 这 个 视图 的 布局 ， 也 就 是 切换 到 你 自己 的 视图 
后 ， 会 出 现 哪些 窗口 。 根 据 自己 习惯 进行 设置 。 


e Open Perspective" => 切换 视图 菜单 中 ， 出 现 哪 些 可 以 选择 的 视图 。 


都 设置 好 以 后 ， 保 存 你 的 自 定义 透视 图 。Windows => Save Perspective as, 
然后 为 你 自 定义 的 透视 图 取 一 个 名 字 ， 保 存 。 
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LL" Auailahi! 
immand Groups Avatlabili 


Choose which too! bar items to display. 


Tool Bar Structure: 
» RJE File 
b VIE Launch 
» MS Debug 
» IEE Java Element Creation 
» [V]ES Search 
b [VE XML Grammar Usage 
» [V]E3 NewFileToolBar 
» (VW) Execute 
» MS Focus Editor on Active Task 
» [VES Navigate 
"区 | 下 help 
b JE Active Tasks 


© Filter by command group 


Too! Bar Visibility | Menu Visibility | Command Groups Availability, Shortcuts 
Select the shortcuts that you want to ascade items to the following submenus. The selections made 
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eclipse 工作 空间 包含 以 下 资源 : 


e 项 目 
e 文件 
e 文件 夹 


项 目 和 启动 时 一 般 可 以 设置 工作 空间 ， 你 可 以 将 其 设置 为 默认 工作 空间 ， 下 次 启动 后 
无 需 再 配置 : 





Š Workspace Launcher — J 0 CE 








are Application (D: » & 








Select a workspace 









TD  $88h5(H) à Q 3 
Eclipse stores your projects in a folder called a workspace. 
新 建文 件 去 Choose a workspace folder to use for this session. 
^ 名 称 


Workspace:[ F:\testWorkspace X 


d| configuration 
J Developer 
d dropins 

Ji features 

Jd p2 

J plugins 

dJ readme 


|_| .eclipseproduct 







(V| Use this as the default and do not ask again 





eclipse 


INDIGO 








|*, artifacts.xml 
S eclipse.exe 


# | eclipse.ini 


m 


m] eclipsec.exe 
ED) epl-v10.html 
|_| notice.html 

BB poi-3.6-20091214 jar 





工作 空间 (Workspace) 有 明显 的 层次 结构 。 项 目 在 最 顶级 ， 项 目 里 头 可 以 有 文件 和 
MIF Ko 


插件 可 以 通过 资源 插件 提供 的 API 来 管理 工作 空间 的 资源 。 


管理 工作 空间 (Workspace) 


用 户 通过 使 用 视图 ， 编 辑 器 和 向 导 功 能 来 创建 和 管理 工作 空间 中 的 资源 。 其 中 ， 显 
示 工 作 区 的 内 容 很 多 意见 中 的 Project Explorer 视 图 。 显 示 项 目 工 作 空间 内 容 的 视图 
是 Project Explorer 视 图 。 
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BSile 7 


I$ Package Explorer :: 
4 i HumanResources 


@ sample 
readme.txt 


文件 创建 向 导 (File > New > File) 。 
| File 
Create a new file resource. 


Enter or select the parent folder: 


HumanResources 


iy © > 
4 2 HumanResources 
& sample 


File name: readme.txt] 





XIF & (Folder) 4!) £m $ (File > New > Folder) 。 
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Create a new folder resource. 





Enter or select the parent folder: 





HumanResources 


fy < 


t3 HumanResources 





Folder name: sample 


Advanced >> — 








工作 空间 (workspace) 设置 


在 菜单 栏 上 选择 "Window" => "preferences..." => "General"=>"VWorkspace"， 设 置 
说 明 如 下 图 : 
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r 





S Preferences 





type filter text | Workspace ov 
4 General 

》 Appearance 
Compare/Patch 
Content Types [|Build automatically 自动 构建 项 目 ( 最 好 关闭 很 影响 速度 ) ， 手 动 构建 好 了 

» Editors [C] Refresh using native hooks or polling — 4& RAH 3-823618] 75 x hls 
Keys 回 Refresh on access ”在 访问 时 刷新 

> Network Connectior Save automatically before build ”在 构建 前 自动 保存 所 有 文件 


oe Always close unrelated projects without prompt 自动 关闭 不 相关 的 项 目 时 不 提示 用 户 
earc 


> Security 
» Startup and Shutdov Workspace save interval (in minutes): 5 ”自动 保存 间隔 
Web Browser Workspace name (shown in window title): — 在 标题 栏 上 显示 的 工作 workspace 名 称 
4| Workspace | 
Build Order 在 打开 一 个 项 目 时 打开 相关 的 其 它 项 目 
i PEN Open referenced projects when a project is opened 
Local History @ Always © Never © Prompt 总 是 自动 打开 ， 从 不 打开 ， 提 示 打 开 
» Android 
oe Text file encoding 文件 编码 New text file line delimiter sae eee 
, Aptana @ Default (GBK) @ Defaut 新 建文 本 文件 的 行 定 界 符 








See ‘Startup and Shutdown’ for workspace startup and shutdown preferences. 











» C/C++ © other |GBK © Other: | - 
> Help 
> Install/Update 


> Java 
aT Restore Defaults Apply 











@ 








Eclipset) +L (FZ ig (workspace) 


Eclipse 切换 工作 空间 可 以 选择 菜单 栏 中 选择 "File" => "switch workspace" : 
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<} 


[File] Edit Navigate Search Project Run Window Help 





New Alt+Shift+N > 


Open Fie- CO | 
Close Ctrl+W 


= 日 GE Outline X 
Close All Ctrl+Shift+W 


Save Ctrl+S An outline is not available. 
Save As... 


Save All Ctrl+Shift+S 
Revert 


Move... 

Rename... 

Refresh 

Convert Line Delimiters To 





G:\eclipse_workspace 


Alt+Enter 


ER Markers X | E Properties 474 Servers |f Data Source Explorer [fS Snippets 


0 items 





23:31 
2014/3/12 星期 





Be wuld) 
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Eclipse 创建 Java 项 目 


打开 新 建 Java 项 目 向 导 


通过 新 建 Java 项 目 向 导 可 以 很 容易 的 创建 Java 项 目 。 打 开 向 导 的 途径 有 : 


e 通过 点 击 "File" 菜单 然后 选择 New > Java Project 

e 在 项 目 浏览 器 (Project Exploren) 窗 口中 鼠标 右 击 任 一 地 方 选择 New > Java 
Project 

e 在 工具 条 上 点 击 新 建 按钮 (上  ) 并 选择 Java Project 


使 用 新 建 Java 项 目 向 导 


新 建 Java 项 目 向 导 有 两 个 页 面 。 
第 一 个 页 面 : 


e 输入 项 目 名 称 (Project Name 栏 中 ) 

e 选择 Java Runtime Environment (JRE) 或 直接 采用 默认 的 

e 选择 项 目 布局 (Project Layout) ， 项 目 布局 决定 了 源 代 码 和 class 文件 是 否 
置 在 独立 的 文件 夹 中 。 推荐 的 选项 是 为 源 代码 和 class 文件 创建 独立 的 文件 
Ko 
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Create a Java Project 


Create a Java project in the workspace or in an external location. 


Project name: HumanResourced 


IVI Use default location 


Location: | C\tutorials-point\java\workspace\HumanResources Browse... 


JRE 


a ener a 


(^) Use a project specific JRE: jre6 
©) Use default JRE (currently ‘jre6’) Configure JREs... 


Project layout 


C) Use project folder as root for sources and class files 


(Q9) Create separate folders for sources and class files 


Working sets 
Add project to working sets 


Working sets | Select... 





(Ra LAR d; "Finish" 按钮 来 创建 项 目 或 点 击 "Next" 按钮 来 修改 java 构建 的 配置 。 


第 二 个 页 面 Java 构建 路 径 设 置 (Java Build Settings ) ， 该 页 面 我 们 可 以 配置 项 
目的 依赖 关系 及 额外 的 jar 包 。 


查看 新 建 项 目 


Package Explorer 显示 了 新 建 的 Java 项 目 。 项 目 图 标 中 的 "J" 字母 表示 Java 项 
E. 文件 夹 图 标 表 示 这 是 一 个 java 资源 文件 夹 。 
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I$ Package Explorer & "ui 
geile > 
4 & HumanResources 
@ src 
b Em JRE System Library (JavaSE-1.6] 


Eclipse 创建 Java 项 目 


Eclipse 创建 Java 包 


打开 新 建 Java 包 向 导 


你 可 以 使 用 新 建 Java 包 向 导 来 创建 Java 包 。Java 包 向 导 打 开 方 式 有 : 


e 通过 点 击 "File" 菜单 并 选择 New > Package 
e {£ Package Explorer 中 通过 右 击 鼠标 选择 > Package 
e 在 工具 条 上 点 击 包 按钮 ( 宇 ) 


如 果 你 要 创建 子 包 ， 在 打开 创建 Java 包 向 导 前 选择 好 父 包 ， 这 样 在 名 称 字段 就 有 
了 父 包 的 值 。 


使 用 创建 Java 包 向 导 


在 向 导弹 出 框 (New Java Package) 中 可 以 执行 以 下 操作 : 


e 输入 资源 文件 夹 名 (Source Folder FFS) 
e 输入 包 名 (Name 字段 ) 
e 点 击 "Finish" 按 钮 


pee 
© New Java Package 


Java Package B 
Create a new Java package. 


Creates folders corresponding to packages. 


Source folder: HumanResources/src | Browse... 


Name: com.tutorialspoint.demo.hr.model 


Create package-info.java 


A =" 


查看 新 建 包 


在 Package Explorer 的 资源 文件 夹 下 我 们 可 以 查看 到 新 建 的 包 。 
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I$ Package Explorer & | 
4 i HumanResources 
4 @ src 
& com.tutorialspoint.demo.hr.model 


b BÀ JRE System Library (JavaSE-1.6] 
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Eclipse 创建 Java X 


打开 新 建 Java 类 向 导 


你 可 以 使 用 新 建 Java 类 向 导 来 创建 Java 类 ， 可 以 通过 以 下 途径 打开 Java 类 向 
导 : 


e mid "File" 菜单 并 选择 New > Class 
e 4 Package Explorer 窗口 中 右 击 电 标 并 选择 New > Class 
e 点 击 类 的 下 拉 按 钮 (如 7) 并 选择 ( 9) 


在 打开 创建 Java 类 向 导 前 ， 最 好 选择 好 Java 类 所 属 的 包 名 ， 这 样 在 创建 Java 类 
时 包 名 字段 就 会 自动 填充 。 


使 用 新 建 Java 类 向 导 


Java 类 向 导 的 弹 窗 中 你 可 以 进行 以 下 操作 : 


e 确认 文件 夹 名 (Source Folder) 和 包 名 (Package) 是 否 正 确 

。 输入 类 名 

。 选取 其 他 修饰 类 

。 输 入 超 类 (Superclass) 的 名 称 或 点 击 Browse( 浏 览 ) 按 钮 选择 已 存在 的 类 
e md Add( 添 加 ) 按钮 选择 类 实现 的 接口 

e 在 复 选 框 中 可 以 选择 方法 创建 方式 及 是 否 自动 生成 注释 
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Create a new Java class. 





Source folder: HumanResources/src 


Package: com,tutorialspoint.demo.hr.model 





E] Enclosing type: | 





Name: Employee 

Modifiers: @public © defaylt  ' private protected 
E] abstract Fl final} |_| static 

Superclass: java.lang.Object 


Which method stubs would you like to create? 
E] public static void main(String[] args) 
E] Constructors from superclass 
\V| Inherited abstract methods 

Do you want to add comments? (Configure templates and default value here) 
F] Generate comments 








e 点 击 Finish( 完 成 ) 按 钮 


查看 新 建 的 Java 类 


在 Package Explorer 视图 中 我 们 可 以 看 到 新 建 的 类 ， 我 们 可 以 通过 右边 的 Java 编 
辑 器 修改 代码 。 
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"B PadageEsploe HW "7b 


4 i&) HumanResources E package com.tutorialspoint.demo.hr.model; + 
4 (P src 
^ ® com.tutorialspoint.demo.hr.model public class Employee ( 
* & Employeejava 


} 


» mh JRE System Library [lavaSE-1.6) 
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Eclipse 创建 Java 接口 


打开 新 建 Java 接口 向 导 


新 建 Java 接口 向 导 可 以 创建 新 的 Java 接口 。 打 开 向 导 的 方式 有 : 


e 点 击 File 菜单 并 选择 New > Interface 
e 在 Package Explorer 窗口 中 右 击 鼠标 并 选择 New > Interface 
e 在 工具 条 上 的 下 拉 框 按钮 中 (OT 选择 ( ) 


在 打开 创建 Java 接口 向 导 前 ， 最 好 选择 好 Java 接 口 所 属 的 包 名 ， 这 样 在 创建 Java 
接口 时 包 名 字段 就 会 自动 填充 。 


使 用 新 建 Java 接口 向 导 


Java 接口 向 导 的 弹 窗 中 你 可 以 进行 以 下 操作 : 


e 确认 文件 夹 名 (Source Folder) 和 包 名 (Package) 是 否 正 确 
。 输入 接口 名 称 

e ma Add( 添 加 ) 按钮 并 选择 要 接口 ， 该 接口 将 被 继承 

。 选择 是 否 自 动 生 成 注释 

e 点 击 Finish( 完 成 ) 按钮 
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查看 新 建 的 java 接口 


在 Package Explorer 视图 中 我 们 可 以 看 到 新 建 的 接口 ， 我 们 可 以 通过 右边 的 Java 
编辑 器 修改 接口 代码 。 


3 Package Explorer a x - D [Table java 
4 i) HumanResources 7 package com.tutorialspoint.demo.hr.view; 
4 (P src 
88i com.tutorialspoint.Gemo.hr.model public interface ITable { 
4 ® com.tutorialspoinLdemo.hr.view ) 
!j [Tablejava 


mà JRE System Library 


e 点 击 Next 按钮 进入 新 建 XML 文件 向 导 


Eclipse 创建 XML 文件 
打开 新 建 XML 文件 向 导 


你 可 以 使 用 新 建 XML 文件 向 导 来 创建 XML 文件 。 打 开 向 导 的 方式 有 : 
e 点 击 File 菜单 并 选择 New > Other 


e 点 击 新 建 下 拉 框 (C v) 选择 Other 
e 快捷 键 组 合 : ctrl + N 


在 向 导 对 话 框 中 可 以 进行 以 下 操作 : 


e 在 输入 框 中 输入 XML， 会 显示 关联 XML 的 向 导 
e 在 展开 的 XML 类 别 中 选择 XML 文件 


r - 一 FF 一 = 
nee mur 
Select a wizard 


Create a new XML file 


Wizards: 
xml 
4 i£» XML 
X! XML File 
5 XML Schema File 
4 & Examples 
i! Editing and validating XML files 


M = 


LEA 


接 下 来 在 向 导 中 我 们 还 可 以 做 以 下 操作 : 


e 点 击 File 菜单 并 选择 New > XML File 
e 在 工具 条 上 点 击 XML File 3242. (* Mlle. ) 


使 用 新 建 的 XML 文件 向 导 


在 新 建 XML 文件 向 导 中 我 们 可 以 进行 如 下 操作 : 


e 输入 或 选择 XML 文件 所 属 的 文件 夹 
e. 输入 xml 文件 名 


^ -— > a mx | 


XML li ; 


Create a new XML file. 





: 
Š New XML File 





| Enter or select the parent folder: 
| HumanResources/src/com/tutorialspoint/demo/hr/model 





a i HumanResources 
5 settings 
& bin 
4 E» src 
4 i com 
4 © tutorialspoint 
4 & demo 
4 (E hr 
i? model E 





| File name: hr dataxml 
| 


| | Advanced >> | 





< Back | 








= 











e At Next 按钮 可 以 配置 DTD, XML Schema 的 XML 模式 描述 语言 ， 或 者 你 
可 以 直接 点 击 Finish 按钮 完成 XML 文件 的 创建 。 


查看 新 建 的 XML 文件 


在 Package Explorer 视图 中 我 们 可 以 看 到 新 建 的 XML 文件 ， 在 右边 的 XML 编辑 
器 中 我 们 可 以 修改 新 建 的 XML 文件 。 
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I8 Package Explorer :: B| 7 " O |R hr dataxmt 22 -n 
4 iz HumanResources DE 
4 sre Node Content 
4 而 com.tutorialspoint.demo.hr.model 2? xmi version="1.0° encoding="UTF-8" 
Ui] Employeejava 
X; hr data.xml 


i8 com.tutorialspoint.demo.hr.view 
mÀ JRE System Library [/svaSE-1.6) 


Design ‘Source . 


XML 编辑 器 可 以 使 用 视图 模式 或 源码 模式 来 设计 XML 文件 。 


Eclipse 创建 XML 文件 
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Eclipse Java 构建 路 径 


设置 Java HERE 


Java 构 建 路 径 用 于 在 编译 Java 项 目 时 找到 依赖 的 类 ， 包 括 以 下 几 项 : 


。 源码 包 
e 项 目 相 关 的 jar 包 及 类 文件 
e 项 目 引 用 的 的 类 库 


我 们 可 以 通过 使 用 Java 项 目 属性 对 话 框 中 的 Java Build Path(Java 构建 路 径 ) 选 项 
来 查看 和 修改 Java 构建 路 径 。 


Java 项 目 属性 对 话 框 可 以 通过 在 Package Explorer 视图 中 鼠标 右 击 指定 的 Java 
项 目 并 选择 Properties( 属 性 ) 菜单 项 来 调用 。 


然后 在 左边 窗口 选择 Java Build Path(Java 构建 路 径 )。 




















— E ceci = 
BD Properties for HumanResources mone 
pe filter tex Java Build Path v zv 
Resource | 
Builders (^ Source | «3 Projects. & Libraries | “> Order and Export 
Java Build Path JARs and class folders on the build path: 
Java Code Style mà JRE System Library [JavaSE-1.6] Add JARS. 
Java Compiler 
Java Editor Add External JARs... 
Jav cat 
aoc tocetion Add Vanable.. 
Project References | 
Run/Debug Settings Add Library.. 
Task Repository 
Ps : Add Class Folder. | | 
Task Tags 
Validation Add External Class Folder... | 
WikiText lU 
i" 
中 | 
i 
| 
| 
u 
? = | 
£ OK | Cancel | 
— 1 
= 一 一 = z+] 





在 Java 构建 路 径 窗口 中 我 们 可 以 已 经 引用 到 的 jar 包 。 


引用 jar 包 可 以 在 Libraries 选项 卡 中 完成 ， 在 Libraries 选项 卡 中 我 们 可 以 通过 点 
击 Add JARs 来 添加 Eclipse 工作 空间 中 存在 的 jar 包 或 点 击 External JARs 来 引入 
其 他 文件 中 的 jar 包 。 


Eclipse iz 47 4c(Run Configuration) 
创建 和 使 用 Eclipse 运行 配置 


在 运行 配置 (Run Configuration) 对 话 框 中 可 以 创建 多 个 运行 配置 。 每 个 配置 可 以 在 
应 用 中 局 用。 








运行 配置 (Run Configuration) 对 话 框 可 以 通 un 菜单 中 选择 Run Configurations 
来 调 用 o 
r m - a | 
© Run Configurations en je 
| 
| Create, manage, and run configurations 四 
Run a Java application 
=F 2s Configure launch settings from this dialog: 
: ir text = - Press the 'New' button to create a configuration of the selected type | 
8j Java Applet - Press the 'Duplicate' button to copy the selected configuration. 1 
MT Java Application : : | 
Jv JUnit - Press the 'Delete' button to remove the selected configuration. | 
ma Maven Build $ - Press the ‘Filter’ button to configure filtering options. | 


Jj Task Context Test - Edit or view an existing configuration by selecting it. | 


Configure launch perspective settings from the ‘Perspectives’ preference page. 


| Filter matched 5 of 5 items M 





Close | 











x 


如 果 要 给 Java 应 用 创建 运行 配置 需要 在 左 侧 列表 中 选择 "Java Application" 3f £x d; 
New 按钮 。 


对 话 框 中 描述 的 项 有 : 


e 运行 配置 名 称 
e RAS 
。 主 类 名 


Arguments( 参 数 ) 项 有 : 


e Program arguments( 程 序 参 数 ) 可 以 0 个 或 多 个 
e VM arguments(Virtual Machine arguments: 虚 拟 机 参数 ) 可 以 0 个 或 多 个 
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i Create, manage, and run configurations 
Run a Java application 


taxes 


ype Tines tet || [@ Maini, o Arguments] mi JRE] 5; Classpath ti- Source] MB Environment] = Common] 
Ei Java Applet | x 
4 [T Java Application EOI 
T HrMain samanose 
Ju JUnit Main class: 
ma Maven Build cun T ERN 
rialspoint.demo.hr HrMai 
Jy Task Context Test memi ieri cel 
1 Inctude system libraries when searching for a main class 
| Include inherited mains when searching for a main class 
F] Stop in main 





























| Fitter matched 6 of 6 items 





© 





定 文件 。 


| Create, manage, and run configurations 
Run a Java application 


| Name HrMain 

| 日 Main **- Arguments mi JRE |^; Classpath | Source [B$ Environment [E] Comman, 

4 [ Java Application Sm 
Py eee © Shred fe: [Viumanfesouces. J| Browse. 
m Maven Build 
Jy Task Context Test 


Display in favorites menu Éncoding 
PB Debug © Default - inherited (Cp1252) 
UO Run © Other | 150-8859-1 





Standard Input and Output 
IV Allocate console (necessary for input) 
Drle | 





[ Workspace. || FileSystem || Variables | 
iV! Launch in background 




















(tun) [tose] 








点 击 Apply( 提 交 ) 按钮 保存 运行 配置 并 点 击 Run( 运 行 ) 按钮 重新 执行 Java 应 用 。 


Eclipse 运行 配置 (Run Configuration) 244 
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Eclipse 运行 程序 


运行 Java 程序 
我 们 可 以 在 Package Explorer 视图 


可 以 在 Package Explorer 视图 中 快速 运行 


Package Explorer 视图 : 


Java 程序 。 


鼠标 右 击 包 好 main KAAI java 类 选择 Run As > Java Application 


同样 你 也 可 以 在 Package Explorer 视图 中 选择 


Alt + Shift + X, J 


以 下 两 种 方式 都 能 创建 一 
动 Java 应 用 程序 。 


个 新 的 Run Configuration( 运 行 


包含 main 方法 的 类 并 按 下 快捷 键 : 


E) 我 们 可 以 使 用 它 来 启 


如 果 


运行 配置 


经 创建 ， 你 可 以 在 Run 2 Run Configurations 来 启动 


Java Fd, E 


支行 配置 的 名 称 ， 然 后 


后 点 击 


运行 按钮 的 Java 应 用 程序 。 





— = Sh 


Fr 
= Run Configurations 








Create, manage, and run configurations 


Run a Java application 


7t, 
v 
Am 





Ei] Java Applet 
4 [3] Java Application 
fF) HelloWorld 
G] New configuration 
Ju JUnit 
m2 Maven Build 
Jv; Task Context Test 








Run 菜单 中 的 Run i 


09= Arguments | BA JRE | “> Classpath | S» Source | P Environment | E] Common 


Browse... 


|| Name: HelloWorld 


© Main 
Project: 
w3cschool.cc 
Main class: 

| Search... | 


cc.w3cschool.main.HelloWorld 


[C] Include system libraries when searching for a main class 
[-]Include inherited mains when searching for a main class 


[E] Stop in main 


选项 可 以 重新 启动 先前 启动 Java 应 用 。 
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9, Run Ctri+F11 
% Debug F11 
i Run History » 
Run As > 
Run Configurations... 


重新 启动 先前 启动 Java 应 用 快捷 键 为 Ctrl + F11。 
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Eclipse 生成 jar 包 


打开 Jar 文件 向 导 


Jar 文件 向 导 可 用 于 将 项 目 导 出 为 可 运行 的 jar 包 。 


打开 向 导 的 步骤 为 : 


e 在 Package Explorer 中 选择 你 要 导出 的 项 目 内 容 。 


的 类 和 资源 ， 只 需 选 择 整个 项 目 即 可 。 
e 点 击 File 菜单 并 选择 Export, 
e 在 输入 框 中 输入 "JAR"。 


如 果 你 要 导出 项 目 中 所 有 








— 


r 
= Export 





Select 


Export resources into a JAR file on the local file system. 


Select an export destination: 
JAR| 
4 @ Java 


JAR file 
<+ Runnable JAR file 


?) | Next > | 


e 在 选项 中 选择 JAR file 选项 开启 向 导 。 
e 点 击 Next 按钮 


使 用 Jar 文件 向 导 


在 JAR File Specification (JAR 文件 描述 ) 
e 输入 JAR 文件 名 及 文件 夹 





Cancel 


页 面 可 进行 以 下 操作 : 


e 默认 只 导出 cass 文件 。 你 也 可 以 通过 勾 选 "Export Java source files and 


resources" 选项 来 导出 源码 的 内 容 。 
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JAR File Specification 
Define which resources should be exported into the JAR. 





Select the resources to export: 


'V Export generated class files and resources 
Export all output folders for checked projects 
F] Export Java source files and resources 


© Export refactorings for checked projects. Select refactorings.. 


Select the export destination: 

JAR file: cAhrjar 
Options: 

V Compress the contents of the JAR file 
F Add directory entries 

F] Overwrite existing files without warning 








md Next 按钮 修改 JAR 包 选 项 
点 击 Next 按钮 修改 JAR Manifest 描述 信息 
点 击 Finish 按钮 完成 操作 
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Eclipse 关闭 项 目 


为 什么 要 关闭 项 目 ? 


Eclipse 工作 空间 包含 了 多 个 项 目 。 一 个 项 目 可 以 是 关闭 或 开启 状态 。 
项 目 打开 过 多 影响 有 : 
e 消耗 内 存 
e 占用 编译 时 间 : 在 删除 项 目 .class X ft (Clean All Projects) 时 并 重新 编译 
(在 菜单 上 选择 Project > Clean > Clean all projects ) 。 


= Clean lak 


Clean will discard all build problems and built states. The projects will be 
rebuilt from scratch. 


@ Clean all projects © Clean projects selected below 





(£3 w3cschool.cc 














如 何 关 闭 项 目 ? 


如 果 项 目 不 处 于 开发 阶段 ， 我 们 就 可 以 先 关闭 项 目 。 


在 Package Explode 视图 上 选择 要 关闭 的 项 目 ， 并 通过 菜单 上 选择 Project > 
Close Project 来 关闭 项 目 。 
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File Edit Source Refactor Navigate Search Run Window Help 
w 4 [m (tj: wd * Oy & Open Project 

Close Project 
I$ Package Explorer 33 = Esl 


Build All Ctrl+B 
Build Project 
Build Working Set 


Clean... 


BSl|e 7 


b |? w3cschoolcc| 


Build Automatically 


Generate Javadoc... 





Properties 


关闭 后 的 项 目 

项 目 关 闭 后 我 们 可 以 在 Package Explorer 视图 看 到 项 目的 图 标 已 经 变 了 。 关 闭 后 
的 项 目 是 不 能 编辑 的 。 

Sve - Eine 0 


File Edit Source Refactor Navigate Sear 
PCY? 0 * lo lg Di Ri*Ry OF] 
I$ Package Explorer 33 x] 


BS|e 7 


IC3 w3cschool.cc| 


重新 开启 项 目 


你 可 以 通过 选择 Project > Open Project。 
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_ Se. 
(— ADR SEA 


| I$ Package Explorer 器 


Eclipse KW El 


File Edit Source Refactor Navigate Search [Project] Run Help - 


imm (Ue Ores 












Open Project 
Close Project 





Build All Ctrl+B 
Build project 
Build Working Set » 
Clean... 

v Build Automatically 

Generate Javadoc... 


Properties 
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Eclipse 编译 项 目 


编译 Java m H 


一 个 项 目 可 以 关联 多 个 编译 器 。 
java 项 目 关联 的 是 java 编译 器 。 可 以 通过 以 下 方式 来 查看 项 目 关联 的 编译 器 : 


e 在 Package Explorer #4 Pasir & x E Hti Properties 
e 在 左 侧 的 树 形 菜单 中 点 击 Builders 


| type filter text Builders 
» Resource 
Builders 


Java Build Path [V ii Java Builder New... 


Configure the builders for the project: 





Java Code Style Import... 
» Java Compiler 
Java Editor Edit.. 
Javadoc Location 
Project References 
Run/Debug Settings 
Task Repository 
Task Tags 
» Validation 
WikiText 


Remove 








®© 








java 编 译 器 用 于 编译 java 项 目 。 通 过 点 New 按钮 我 们 可 以 让 java 项 目 关联 Ant 
builder 编译 器 。 
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b Java Compiler 


b Java Editor 
Javadoc Location 
Project References 
Refactoring History 
Run/Debug Settings 

^ Task Repository 
Task Tags 

b Validation 


WikiText 





java 编译 器 通过 编译 java 项 目 生成 class 文件 。 当 项 目 源 码 发 生变 化 时 会 自动 重新 
编译 java 代码 。 


可 以 通过 去 除 Project 菜单 中 Build Automatically (自动 编译 ) 项 来 禁用 自动 编译 功 


25 
Abo 
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Project] Run Window Help 
| Open Project 
| Close Project 





Build All Ctri+B 
Build Project 
Build Working Set » 
Clean... 

v Build Automatically 


f$: Generate Javadoc... 


Properties 













如 果 你 禁用 了 自动 编译 功能 ， 项 目 需要 通过 Project 菜单 中 的 Build Project 菜单 项 


来 编译 java 项 目 。 如 果 勾 选 了 Build Automatically( 自 动 编译 ) 项 ， 则 Build 
Project( 手 动 编译 ) 菜单 项 是 不 可 用 的 。 





Eclipse 编译 项 目 


O1 


Eclipse Debug 配置 


创建 和 使 用 Debug 配置 


Eclipse Debug 配置 类 似 于 运行 配置 但 它 是 用 于 在 调试 模式 下 开启 应 用 。 
打开 Debug 配置 对 话 框 步骤 为 : Run > Debug Configurations 。 
S Debug Configurations 


Create, manage, and run configurations 


Debug a Java application 








| Configure launch settings from this dialog: 


type filter text || |j - Press the 'New' button to create a configuration of the selected type. 


Java Applet 

31 Java Application | 

. E HelloWorld 
D] Nec =» - Press the 'Filter' button to configure filtering options. 


= - Press the 'Duplicate' button to copy the selected configuration. 





3€ - Press the 'Delete' button to remove the selected configuration. 


Ju JUnit 
m2 Maven Build 


f$ PHP CLI Applicatio || 
B PHP Web Applicat | Configure launch perspective settings from the ‘Perspectives’ preference 


| page. 


- Edit or view an existing configuration by selecting it. 


(31 Remote Java Appli 
Jy Task Context Test | 


J 
| 





4| " 


Filter matched 10 of 10 | 


AN m 
(3) Debug Close 


从 左 侧 列表 中 选择 "Java Application" 选项 来 创建 Java 应 用 的 调试 配置 并 New 按 
钮 。 


e 调试 配置 的 名 称 
e 项 目 名 称 
。 主 类 名 


arguments( 参 数 ) 选 项 卡 的 描述 信息 有 : 


e 需 个 或 多 个 程序 参数 
e 替 个 或 多 个 虚拟 机 参数 (VM arguments) 
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Java Applet 


4 [3] Java Applicatiocl | 一 一 一 一 
w3cschool.cc 


[3j HelloWorld 


D New config Main class: 
Ju JUnit a a CENE UNECOONR YU URL OIN  *#*° °° «# A 
cc.w3cschool.main.HelloWorld 


m2 Maven Build 
Include system libraries when searching for a main class 


Include inherited mains when searching for a main class 


Stop in main 
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Eclipse Debug 调试 


Debug 调试 Java 程序 


我 们 可 以 在 Package Explorer 视图 调试 Java 程序 ， 操 作 步 骤 如 下 : 


e 鼠标 右 击 包 含 main MAH java 类 
e 选择 Debug As > Java Application 


该 操作 也 可 以 通过 快捷 键 来 完成 ， 快 捷 键 组 合 为 Alt + Shift + D, J. 


以 上 操作 会 创建 一 个 新 的 Debug Configuration (调试 配置 ) ， 并 使 用 该 配置 来 启 
动 Java 应 用 。 


如 果 Debug Configuration (调试 配置 ) 已 经 创建 ， 你 可 以 通过 Run 菜单 选择 
Debug Configurations 选取 对 应 的 类 并 点 击 Debug 按钮 来 启动 Java 应 用 。 














a = 

Š Debug Configurations 2 e 

Create, manage, and run configurations S 

Debug a Java application 
xie Name: HrMain 

| | tvne filter tex E 
gu eM un © Main» * Arguments =à JRE | ĉo Classpath & Source | I$ Environment) ": 
" PE Java Applet Project 
E ¢ T Java Application R f 
W "T HrMain HumanResources | Browse. 
" Jv JUnit Main class 
" wa Maven Build com.tutorialspoint.demo hr.HrMain | Search. 
i T. Remote Java Application 

hy Task Context Test | Include system libraries when searching for a main class 
| Include inherited mains when searching for a main class 
| Stop in main 
h 
LI 
Filter matched 7 of 7 items 
D Close 

X 4 





Run 菜单 的 Debug 菜单 项 可 以 重新 加 载 之 前 使 用 了 调试 模式 的 java 应用。 
(Run] Window Help 





| €, Run Ctrl+Fll 
% Debug Fll 
Run History 
Run As n 


Run Configurations... 


重新 加 载 之 前 使 用 了 调试 模式 的 java 应 用 快捷 键 为 F11。 


lutorialsPoint Java #4 


SPA Wives java E, SERA e AAA REAA. AREA A jE 
供 了 其 他 的 视图 用 于 排查 应 用 程序 的 故障 。 

java 编辑 器 可 以 设置 断 点 调试 。 在 编辑 器 中 右 击 标 记 栏 并 选择 Toggle Breakpoint 
来 设置 断 点 调试 。 


- public void addDependent(Person p){ 
if (dependents == null){ 
dependents = new Vector<Pers: 


















} 
dependents.add(p); 
9 Toggle Breakpoint Ctrl * Shift« B 
Disable Breakpoint Shift- Double Click 
Go to Annotation Ctrl+1 [t 


Add Bookmark... 
Add Task... 


v Show Quick Diff Ctrl «Shift«Q 
Show Line Numbers 
Folding d 


Preferences... 





Breakpoint Properties... Ctrl - Double Click 
An ^ = i af 


断 点 可 以 在 标记 栏 中 看 到 。 也 可 以 在 Breakpoints View ( 断 点 视图 ) 中 看 到 。 


当 程序 执行 到 断 点 标记 的 代码 时 JVM 会 挂 起 程序 ， 这 时 你 可 以 查看 内 存 使 用 情况 
及 控制 程序 执行 。 


程序 挂 起 时 ，Debug( 调 试 ) 视 图 可 以 检查 调用 堆栈 。 


$ 
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$ Debug 3: | 日 
4 [3 HrMain [Java Application] 
4 8 com.tutorialspoint.demo.hr.HrMain at localhost:6500 
4 4f? Thread [main] (Suspended (breakpoint at line 10 in HrMain)) 
= HrMainmain(String[]) line: 10) 
ei C:\Program Files\Java\jre6\bin\javaw.exe (Jul 28, 2012 8:38:03 PM) 


variables( 变 量 ) 视 图 可 以 查看 变量 的 值 。 


6 Variables 33 es Breakpoint: t; t B T 


Name Value 
© args String[0] (id=16) 


4 t 


Run 菜单 中 有 继续 执行 (Resume) 菜 单项 ， 跳 过 (Step Over) 一 行 代码 ， 进 入 画 数 
(Step Into) 等 。 


Run| Window Help 











| D> Resume F8 
Suspend 
@ Terminate Ctri+F2 
Disconnect 
5. Step Into F5 
?* Step Over F6 
Step Retum F7 
Run to Line Ctrl «R 
3* Use Step Filters Shift«F5 


以 上 图 片 中 显示 了 Resume, Step Into 和 Step Over 等 关联 的 快捷 键 操作 。 
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Eclipse © it (Preferences) 


设置 首选 项 


该 对 话 框 可 通过 框架 管理 但 是 其 他 插件 可 以 设置 其 他 页 面 来 管理 首选 项 的 配置 
我 们 可 以 通过 Window 菜单 选择 Preferences 菜单 项 来 开启 该 对 话 框 。 

















EL EE ey E 
General EN ON 
General s 
Ant Always ryn in background 
Code Recommender: _ Keep next/previous editor, view and perspectives dialog open 
à Help Show heap status d 
i| > Install/Update Open mode 
" Java @ Double click 
i Maven Single click 
i Mylyn Select on hover 
J Run/Debug Open when using arrow keys 
1 Team Note: This preference may not take effect on all views 
Validation 
WindowBuilder 
XML 
Restore Detautts | | Apply | 
| 
e [ok ]| me = 一 
i = 4 

















首选 项 页 面 有 多 个 分 类 组 成 。 你 可 以 在 左 侧 菜 单 中 展开 各 个 节点 来 查看 首选 项 的 配 
En 


左上 角 的 输入 框 可 以 快速 查找 首选 项 页 面 。 你 只 需 在 输入 框 中 输入 要 查找 的 首选 项 
页 面 的 字母 即 可 快速 找到 对 应 的 首选 项 页 面 。 例如 : 输入 font 即 可 坦 找到 Font( 字 
体 ) 首选 项 页 面 。 


Eclipse 首选 项 (Preferences) 


No 
O» 
ht 
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Colors and Fonts (? = any character, * = any string): 
| type filter text 





einem fon T Em Font | 


Oc Colored labels - write access occurrence: 
O Declaration view background 

W inherited members 

Aa Java Editor Text Font (set to defi 


Aa Javadoc c font (set to default: Dial 
LI 
Descripti 
The background color used to highlight matches when colored labels 
in Java views are enabled. 


Preview: 








在 你 完成 首选 项 页 面 的 配置 后 点 击 OK 按钮 就 可 以 保存 配置 ， 点 击 Cancel 按钮 用 
于 放弃 修改 。 
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Eclipse AA 44 B) 


使 用 内 容 辅 助 


Eclipse 中 我 们 可 以 使 用 代码 提示 来 加 快 开发 速度 ， 默 认 是 输入 "." 后 出 现 自动 提 
示 ， 用 于 类 成 员 的 自动 提示 。 


设置 自动 提示 的 配置 在 : window->Preferences->Java->Editor->Content Assist : 


© Preterences e ae t tm E 














b Install/Update ^ 
4 Java 

b Appearance 

ò Build Path 


b Code Style F 


b Compiler 
b Debug 
a Editor 
b Content Assist 
Folding 


m 


Hovers 
Mark Occurren 
Save Actions 





Syntax Coloring 


Templates 
Typing 
b Installed JREs 
JUnit 
Properties Files Ec 
b JavaScript v 





Content Assist 











-一 一 c — O 4 





@ Insert parameter names 


Sorting and Filtering 


Types along with their members can be filtered using type filters. 


Sort proposals 


[V] Show camel case matches 


| ]Hide deprecated references 


Auto Activation 
[V] Enable auto activation 





Auto activation delay (ms): 


[V] Fill method arguments and show guessed arguments 


© Insert best guessed arguments 


VY) Hide proposals not visible in the invocation context 


200 


Auto activation triggers for Java: A 


Auto activation triggers for Javadoc: @# 


by relevanq— 


m 











4 


m 











如 果 能 在 我 们 输入 类 的 首 字母 按 alt + / 后 就 出 现 自动 提示 ，。 
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$ Package Expl.. ?$ ^ E 四 HelloWorld.java ^ |J] *HelloWorld2.java 32 


as | ev 1 package cc.w3cschool.main; 
= 2 
fod 
4 = w3cschool.cc 3 public class HelloWorld2 { 


4 8 src 
4 [H cc.w3cschool.main 
> |J] HelloWorld.java 
b [J] HelleWorld2.jave 
> mi JRE System Library [ay | 


public static void main(String[] args) { 
// TODO Auto-generated method stub 
System.out.printin("Hello World!"); 


H 





(9 HelloWorld - cc.w3cschool.main 
© HelloWorld2 - cc.w3eschool.main 
© Handler - jsva.util.logging 





ami» 






@ Handler - javax.xml.ws.handler 

(9 HandlerBase - org.xml.sax 

@ HandlerChain - javax.jws 

O HandlerResolver - javax.xml.ws.handler 

© HandshakeCompletedEvent - javax.net.ss| 

@ HandshakeCompletedlistener - javax.net.ss| 

Q HandshakeStatus - javax.net.ssl.SSLEngineResult 
@ HasControls - javax.naming.|dap 

(9 HachAttributeGet - avav nrint attribute 











输入 "." 后 出 现 自动 提示 的 内 容 有 : 


类 方法 
超 类 方法 
其 他 相关 类 


C) >| F 
4 | w3cschool.cc 
4 (8 src 
4 由 ccw3cschool.main 
> [J] HelloWorld.java 
> [N HelloWorld2.jave 
> æ JRE System Library [Jav 


Peter ~ 


public class HelloWorld2 { 


public static void main(String[] args) { 
// TODO Auto-generated method stub 
System.out.println("Hello World!"); 
HelloWorld h - new HelloWorld(); 





Ne cowowuou butt 
I 





h-t 
13 } © test() : String - HelloWorld 
14 } © toString() : String - Object 
15 


[>| tearray - convert collection to array 


(J Not what you’ re looking for? Discover new extensions to C 
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Eclipse 快速 修复 
使 用 快速 修复 


在 Eclipse 编辑 器 中 当 你 输入 字母 时 ， 编 辑 器 会 对 你 输入 的 内 容 进 行 错 误 分 析 。 
Java 编辑 器 中 使 用 Java 语法 来 检测 代码 中 的 错误 。 当 它 发 现 错误 或 警告 时 : 


使 用 线 突 出 错 A 
在 Problem 视图 中 PEN E 
在 垂直 标尺 上 显示 黄色 小 灯泡 及 警告 和 错误 标识 


快速 修复 的 对 话 框 提供 了 解决 的 方案 。 快 速 修复 对 话 框 可 通过 以 下 方式 调用 : 


e. 将 鼠标 指针 放 在 波浪 线 上 

e 点 击 小 灯泡 

e. 将 鼠标 指针 放 在 突出 的 文本 上 并 选择 Edit 菜单 上 的 Quick fix 项 或 者 按 下 快捷 
键 Ctrl + 1 


ij) Employeejava : 四 Persorjava a 0 G Out 
package com.tutorialspoint.demo.hr.model; au * 
4E 


*import java.text.DecimalFormat;| 


public class Employee { 
B private Vector dependents; 


public void metis en pt 





Ez iul 








int personId - Cs a 
} } 9 Create method 'getld() in type ‘Person’ 
(b Add cast to 'p' 
fs Rename in file (Ct 
a. Problems = 
1 error, 2 warnings, 0 others ss 
Description 2 Resource Path 


4 ® Errors (1 item) 
a The method getid0 is undefined for the type Perso! Employeejava — /HumanResources/sr... 


在 上 图 中 ，getld 被 高 亮 显示 ， 因 为 Person 类 中 没有 一 个 名 为 的 getld() 方法 。 在 
弹出 的 修复 方案 中 选择 "Create method 'getld()' in type 'Person" 这 样 就 能 在 
Person 类 中 添加 getld() 方法 。 


也 可 以 通过 右键 点 击 Problems 视图 中 的 错误 项 ， 然 后 选择 快速 修复 菜单 项 显示 的 
快速 修复 对 话 框 ， 如 下 图 所 示 : 


' GA) *HelloWorldjava X 四 Helloworld2java = B 
v 1 package cc.w3cschool.main; am 
3 = 
3 public class HelloWorld { 
4 
E 5c public static void main(S ©] Goto 


E 7 int w3cschool = gutW3 Æ Copy Ctrl+C 
8 } 3€ Delete Delete 













m 






4 Select All Ctrl - A : 
Bi Problems 器 @ Javadoc [®, Declar; Show In > 
Quick Fix Ctrl+1 


1 error, 0 warnings, 0 others 
eae en! RE CY New Task from Marker... 
Description 

4 @ Errors (1 item) Properties 


| Ty The method outW3c() is undefined for elloWorld,... z =. line 7 
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Ws 


Eclipse 县 浮 提示 


使 用 悬浮 提示 


java 编辑 器 中 包含 了 不 同类 型 的 甚 浮 提示 ， 莽 浮 提 示 提 供 了 鼠标 指针 指向 元 素 的 额 
外 信息 。 所 有 java 编 辑 器 中 相关 的 甚 浮 提示 可 以 通过 preference( 首 选项 ) 的 Hovers 


页 面 来 配置 (搜索 框 中 输入 "hover") 。 








Hovers 


4 Editors T] Expand vertical ruler icons upon hovering (does not affect open editors) 
Structured Text Editors ^ Text Hover key modifier preferences: 
Text Edito: D T. comu m TEA) 

z Text Hover Name Pressed Key Modifier While Hovering 


a Java = | 
4 Editor [V] Combined Hover 


Hovers | | Variable Values 








[F] Problem Description 

[J] Externalized String Ctrl - Alt 

VY | Javadoc Ctri «Shift 
|. | Annotation Description 

IV | Source Shift 








Pressed key modifier while hovering: 
Description: 


Tries the hovers in the sequence listed in above table, excluding this hover, and 
uses the one which fits best for the selected element and the current context. 


EEC 


(ox) [cance 








java 编辑 器 中 将 鼠标 指针 移 至 类 上 ， 将 显示 与 该 类 相关 的 java 文 档 信息 。 


D Employeejava =: [Ñ Personjava = A | Outline = = 6 
package com. tutorialspoint.demo.hr.model; ^ Sharer se 
® comtutorialspoint.demo.hr.model 
有 import java.util.Vector; 4 © Employee 
加 java.util.Vector 
public ¢ 


priv The vector class implements a growable array of objects. Like an array, it contains components that can be accessed 
using an integer index. However, the size of a Vector can grow or shrink as needed to accommodate adding and 


pul removing items after the Vector has been created. 


Each vector tries to optimize storage management by maintaining à capacity and a capacityIncrement. The 
capacity is always at least as large as the vector size; it is usually larger because as components are added to the 
vector, the vector's storage increases in chunks the size of capacityInerement. An application can increase the 

) capacity of a vector before inserting a large number of components; this reduces the amount of incremental 
reallocation, 


[am — 2 — A. m ee ala —— "T — — M— 








"T REPRE 
Press F2 for focus 


java 编辑 器 中 将 最 标 指针 移 至 方法 上 ， 将 显示 与 该 方法 相关 的 java 文 档 信息 。 
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e public void addDebendent(Person p){ 
if (dependents -- null)( 
dependents - new Vector«Person»(); 


dependents .add(p) ; 
® boolean java.util.Vector.add(Person e) 


public boolean add(E e) 


Appends the specified element to the end of this Vector. 
Specified by: 


add in interface co11ection«E» 


Specified by: f 


Problems 23 @ Javai 





items 
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Eclipse 查找 


工作 空间 中 查找 


Eclipse 查找 对 话 框 中 可 以 允许 用 户 在 指定 工作 空间 上 使 用 单词 或 字母 模式 来 查找 
或 者 你 可 以 在 指定 项 目 或 在 package explorer 视图 上 选择 好 指定 文件 夹 来 
查找 。 


可 通过 以 下 方式 来 调用 查找 框 : 


e 在 Search 菜单 上 选择 Search 或 File 或 Java 
。 按 下 快捷 键 : Ctrl + H 


* File Search (9? Task Search | ^ Git Search | ^^ Java Search| 


Containing text: 








iuf Case sensitive 


(* = any string, ? = any character, X = escape for literals: * ? \) E] Regular expression 


File name patterns (separated by comma): 

" v | Choose. 
(* = any string, ? = any character, !x = excluding x) 
|| Consider derived resources 

Scope 

(@ Workspace Selected resources ‘_) Enclosing projects 


Working set: 














Q Customize... | 


文件 (File) 查 找 允 许 用 户 查 找 所 有 文件 类 型 ， 而 Java 查找 只 针对 Java 文件 进行 查 
找 。 
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Search string (* = any string, ? = any character): 


Persor| v [F Case sensitive 


Search For Limit To 

© Type © Method ©All occurrences ^ Declarations 
© Package © Constructor @ References (© Implementors 
© Field © Match locations (0 of 15 selected) 
Search In 

IV! Sources [V] Required projects | |JRE libraries V| Application libraries 


Scope 
@ Workspace ^ "Selected resources © Enclosing projects 
© Working set: 





例如 我 们 查找 Person 类 型 使 用 的 情况 ， 可 以 通过 Java 查找 页 面 : 


e 在 查找 框 中 输入 Person 

e 在 search for 的 单 选 按钮 中 选择 Type 

e 在 limitto (IRF) 单 选 按钮 中 选择 References 
e 点 击 Search 


Search 视图 中 显示 结果 如 下 : 


^ Search :: |j Tasks o9|x«WIecjag)uMi Severe Fea 
‘Person’ - 5 references in workspace (no JRE) (0 matches filtered from view) 
4 iB com.tutorialspoint.demo.hr.model - src - HumanResources 
4 © Employee 
è addDependent(Person) (2 matches) 
a dependents 
© printDependents() (2 matches) 
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浏览 Eclipse 工作 空间 
浏览 (Navigate) 菜 单 提供 了 多 个 菜单 可 以 让 你 快速 定位 到 指定 资源 。 


Search Project Run Window Help 


GO Int 
Go To > 


Open from Clipboard 


| & Open Type.. Ctri+Shift+T 
| Open Type in Hierarchy... Ctri+Shift+H 
| Open Resource... Ctril+Shift+R 
@ Open Task... Ctri+F12 
© Activate Task... Ctri+F9 
Deactivate Task Ctri+Shift+F9 
show in Breadcrumb 
Show In Alt+Shift+W > 
Quick Context View Ctri+Alt+Shift+Right 
Next JUI + 
Ctri* 
Last Edit Locatii n Ctr +Q 


© Back Alt+Left> 


上 图 中 Open Type, Open Type in Hierarchy 和 Open Resource 三 个 菜单 项 是 非常 
有 用 的 。 
Open Type 


Open Type 菜单 项 可 以 打开 一 个 对 话 框 ， 对 话 框 中 可 以 查找 Java 类 型 文件 。 


你 可 以 在 输入 框 中 输入 类 名 查找 。 ”号 表示 0 个 或 多 个 字母 ，'? 号 表示 单个 字母 
可 用 于 指定 模式 。 对 话 框 中 将 显示 所 有 匹配 的 模式 。 
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@ Open Type "e. 


Enter type name prefix or pattern (*, ?, or camel case): 
OutputS 
Matching items: 


(9' OutputSettings 


O" OutputStream - java.io - re6] 








Q^ utStream - org.omg.CORBA portable - [jre6] 

- c J 
(9^ OutputStream - org.omg.CORBA 2 3.portable - [jre6] 
Q OutputStream - sun.nethttpserver.SSL Streams - (jre6] 
($* OutputStreamFactory 


CA n 





出 java.io - (jre6] 











你 列表 中 选择 你 查找 的 文件 即 可 。 


Eclipse 将 打开 一 个 编辑 器 ， 显 示 所 选择 的 类 型 。 如 果 所 选 类 型 不 能 显示 源 代 码 ， 
将 使 用 类 文件 编辑 器 显示 所 选 类 型 的 字 节 码 。 


tò OutputStream.class 35 一 四 


Class File Editor 


Source not found 








The JAR file C:\Program Files\Java\jre6\lib\rtjar has no source attachment. 
You can attach the source by clicking Attach Source below: 


// (version 1.5 : 49.0, super bit) 
public abstract class java.io.OutputStream implements java.io.Closeable, java.io.Flushable { 


LI 


// Method descriptor #1 OV 

// Stack 1, Locals: 1 

public OutputStream(); 
0 aload O0 [this] 
1 invokespecial java.lang.Object() [32] 
4 return 


你 可 以 点 击 Attach Source 按钮 来 查看 类 文件 对 应 的 源码 。 
源 代 码 位 于 Java 主 目录 中 的 src.zip 压缩 文件 中 。 
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Open Type in Hierarchy 


次 o 


© Open Type in Hierarchy 


Choose a type (? = any character, * = any string): 
InputStream 

Matching items: 

G" InputStream - java.io - [jre6] | 

©* InputStream - org.omg.CORBA.portable - [jre6] 
©^ InputStream - org.omg. CORBA 2 34 

Q InputStream - sun.net.httpserver.SSLStreams - 
(9 InputStreamAdapter 


GS F nee) een. eel P ETA 


4 








出 java.io - [jre6] 








© 





Open Type in Hierarchy 菜单 允许 用 户 在 Type Hierarchy 视图 中 查看 类 的 继承 层 


Type Hierarchy 视 图 中 选择 指定 的 类 就 可 以 看 到 类 的 定义 信息 ， 包 含 对 应 的 属性 和 





方法 : 
fè Type Hierarchy 3 yra 
InputStream - java.io — — — 
* uE- O^ InputStream w| % 2) aw 
4 ©* InputStream ^ ÊF MAX_SKIP_BUFFER_SIZE 
(à AppinputStream =| e"InputStream() 
; © AudiolnputStream Í e availableQ :int 


(à BlockDatalnputStream 

© ByteArrayInputStream 

(à ByteBufferlnputStream 

Q^ CDRInputStreamBase 

© ChannellnputStream 

© ChunkedInputStream 

Q’ ChunklnputStream 区 

ae Tm + 


9 «close( : void 

9 o mark(int) ; void 

€ markSupported( : boolean 
e ^read() ; int 

© read(byte[]) : int 

© read(bytel], int, int): int 
eofeset0 : void 


Open Resource 


open resource( 打 开 资 源 ) 菜 单 可 用 于 查找 工作 空间 中 的 文件 。 
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“号 表示 0 个 或 多 个 字母 ，'?' 号 表示 单个 字母 可 用 于 指定 模式 。 对话 框 中 将 显示 所 
有 匹配 的 模式 。 





Select an item to open (? = any character, * = any string): 
H* 
Matching items: 

X; hr. data.xml 

(Jj HrMainjava 


i& HumanResources/src/com/tutorialspoint/demo/hr/model 
© [ open jJ 


选择 你 要 打开 的 文件 并 点 击 OK 按钮 。 


Eclipse 浏览 (Navigate) 菜 单 274 


Eclipse 重 构 菜 单 


使 用 Eclipse 重 构 
在 项 目 开 发 中 我 们 经 常 需要 修改 类 名 ， 但 如 果 其 他 类 依赖 该 类 时 ， 我 们 就 需要 花 很 
多 时 间 去 修改 类 名 。 


但 Eclipse 重 构 功能 可 以 自动 检测 类 的 依赖 关系 并 修改 类 名 ， 帮 有 我 们 节省 了 很 多 时 
间 。 


可 用 过 以 下 方式 打开 重 构 菜单 : 
e 在 Package Explorer 视图 中 右 击 Java 元 素 并 选择 Refactor( 重 构 ) 菜 单项 
| 


I$ Package... 8 fg Type Mes E 
Open With > 
4  w3ecschool.cc Open oy áá 
4 GH src Show In Alt+Shift+W > 
4 H cc.w3cschool.m [E Copy Ctrl+C 
P 四 HelloWorld, && Copy Qualified Name 
4 [NN HelloWorld] (f Paste Ctrl+V 
» @ HelloWo 
. 3€ Delete Delete 
> mà JRE System Library 
Remove from Context Ctrl+Alt+Shift+Down 
Build Path > 
Source Alt+Shift+S > | 
Refactor Alt+Shift+T > 
| 
ji»; Import... 
Èg Export... 





e 在 Java #44325 PAH Java 元 素 并 选择 Refactor( 重 构 ) 菜 单项 
e 在 Package Explorer 视图 中 选择 Java 元 素 并 按 下 Shift + Alt + T 
下 图 中 我 们 在 Java 编辑 器 中 选中 了 HelloWorld 类 : 
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package cc.w3cschool.main; 
public class HelloWorld2 { 
public static void main(String[] args) { 


// TODO Auto-generated method stub 
System.out.println("Hello World! 1538 = 





Rename... 


} Move... 


} Change Method Signature... 


Extract Interface... 

Extract Superclass... 

Use Supertype Where Possible... 
4 Pull Up... 


ee o Push Down... 








在 选择 Rename 后 会 提示 输入 新 的 类 名 并 按 回 车 结束 修改 : 


package cc.w3cschool.main; 
public class HelloWorld2 { 


public static void main(String[] args) { 
// TODO Auto-generated method stub 


System.out.println("Hello World!"); 
ESTETSSE h - new Belloworld; 


Enter new name, press Enter to refactor v 


在 修改 完成 按 下 回 车 键 后 ， 会 弹出 将 将 会 修改 的 类 : 














public String test() { 


4| TOW Atta casnsestsd msthnd Rub 











Eclipse 重 构 菜单 


你 只 需 点 击 Continue 按钮 即 可 完成 操作 。 


TutorialsPoint Java 技术 教程 


Eclipse 添加 书签 


关于 书签 


Eclipse 中 可 以 在 编辑 器 的 任意 一 行 添加 书签 。 您 可 以 使 用 书签 作为 提示 信息 ， 或 
者 使 用 书签 快速 定位 到 文件 中 的 指定 的 行 。 


添加 书签 


如 果 你 想 设 置 书签 ， 你 只 需要 在 垂直 标尺 上 右 击 鼠 标 并 选择 能 "Add Bookmark" 即 
可 。 


1 package cc.w3cscnool.main; 

2 

3 public class HelloWorld2 { 

4 

5 public static void main(String[] args) { 


E 6 // TODO Auto-generated method stub 
System.out.println("Hello World!"); 












Toggle Breakpoint Ctrl - Shift- B 
Disable Breakpoint Shift+Double Click 













Go to Annotation Ctrl+1 


ereer B 


Add Bookmark... 
Add Task... 


v Show Quick Diff Ctrl - Shift -Q 
v Show Line Numbers 
Folding » 


0 iti Preferences... 











Breakpoint Properties... Ctrl+Double Click 


在 弹出 的 对 话 框 中 输入 书签 名 。 


舍 Add Bookmark 


Enter Bookmark name: 


全 
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垂直 标尺 上 就 会 出 现 一 个 书签 的 按钮 ， 当 然 你 也 可 以 在 Bookmarks 视图 中 查看 到 
书签 列表 。 








打开 Bookmarks( 书 签 ) 视图 


打开 Bookmarks 视图 的 方法 为 : 


e 点 击 Window 菜单 选择 Show View > Other 
e 在 搜索 输入 框 中 输入 Bookmark 
e 在 General 下 选择 Bookmarks 





e md OK 按钮 
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使 用 Bookmarks( 书 签 ) 视 


Bookmarks 视图 如 下 : 


al Proble i 2, Declarat = e [fl Bookmarks 3: 

1 items 

Description Resource Path Location 
测试 标签 HelloWorld2... /w3cschool.cc/src.. line 8 


你 可 以 在 Bookmarks 视图 中 双击 书签 或 者 鼠标 右 击 书签 选择 "Go to" 菜 单 来 快速 定 
位 书签 所 在 的 位 置 。 


删除 Bookmarks( 书 签 ) 


你 可 以 在 垂直 书签 上 右 击 编辑 并 选择 Remove Bookmark 来 删除 书签 : 
1 package cc.w3cschool.main; 


public class HelloWorld2 { 







// TODO Auto-generated method stub 
.println("Hello World!"); 

= new NewHelloWorld(); 
9 Toggle Breakpoint Ctrl+Shift+B 


Disable Breakpoint Shift+Double Click 


4 
5- public static void main(String[] args) { 
6 
7 
















Go to Annotation Ctrl+1 


Remove Bookmark 


Add Task... 
v Show Quick Diff Ctrl - Shift -Q 
v Show Line Numbers 
1 Folding * [li Bookmarks 3% 
1 Preferences... 


ce Path Location 





Breakpoint Properties... Ctrl+Double Click 





orld2... /w3cschool.cc/src.. line 8 


或 者 在 Bookmarks 视图 视图 中 右 击 书签 并 选择 "Delete" 菜 单项 来 删除 书签 : 
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[= New Task from Marker... 





Properties 
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管理 任务 


在 Eclipse 中 用 TODO 标 签 管 理 任务 ， 利 用 这 个 功能 可 以 方便 地 将 项 目 中 一 些 需 要 处 
理 的 任务 记录 下 来 。 


我 们 可 以 在 Java 代码 中 的 注释 添加 TODO 单词 来 标记 一 个 任务 ， 任 务 可 以 通过 
Tasks( 任 务 ) 视图 查看 。 


(3) NewHelloWorld.java HelloWorld2.java è$ 


1 package cc.w3cschool.main; 
3 public class HelloWorld2 { 


public static void main(String[] args) { 

// TODO Auto-generated method stub 
System.out.println("Hello World!"); 
NewHelloWorld h - new NewHelloWorld(); 
h.test(); 





在 Eclipse 中 我 们 可 以 通过 鼠标 右 击 垂直 标尺 并 选择 Add Task 菜单 来 添加 任务 ， 在 
弹出 的 对 话 框 中 输入 任务 描述 信息 : 
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四 NewHelloWorld.java 因 HelloWorld2java 33 
1 package cc.w3cschool.main; 








2 
3 public class HelloWorld2 { 
4 
| 5- public static void main(String[] args) { 
6 // TODO Auto-generated method stub 
7 System.out.println("Hello World!"); 
| s NewHelloWorld h = new NewHelloWorld(); 
ix o h *act(Y- 
© Toggle Breakpoint Ctrl+Shift+B 
Disable Breakpoint Shift+Double Click 
Go to Annotation Ctrl+1 


Add Bookmark... 
Add Task... 


v | Show Quick Diff Ctrl - Shift-Q 





/ Cha: lina Nil a 





LUE 
Properties — — ——g: -| Sey) 
Description: MitBsetszat 





Priority: Completed 


On element: HelloWorld2.java 








In folder: PE 





Location: line 9 


Q 


C — ——— — 


如 果 需 要 删除 任务 ， 只 需 右 击 任务 图 标 选 择 Remove Task 菜单 项 即 可 : 








[J] NewHelloWorld.java 因 HelloWorld2,java 器 


1 package cc.w3cschool.main; 








2 

3 public class HelloWorld2 { 

4 

== public static void main(String[] args) { 

6 // TODO Auto-generated method stub 

7 System.out.println("Hello World!"); 

8 NewHelloWorld h = new NewHelloWorld(); 

o h_tect(\+ 

® Toggle Breakpoint Ctrl+Shift+B 
Disable Breakpoint Shift+Double Click 
Go to Annotation Ctrl+1 


v Show Quick Diff Ctrl - Shift -Q 
v Show Line Numbers 
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打开 Task( 任 务 ) 视图 


打开 Task( 任 务 ) 视图 的 方法 为 : 


e 在 Window 菜单 中 选择 Show View > Other 
e 在 搜索 框 中 输入 Tasks 
e 在 General 下 选择 Tasks 


SUE 








4 © General 
£j Tasks 








e 最 后 点 击 OK 按钮 


使 用 Task( 任 务 ) 视图 
Task( 任 务 ) 视图 中 显示 了 项 目 中 所 有 待 完成 的 任务 : 


Ee Problems @ Javadoc B Declaration GJ Console $) Tasks 32 











3 items 
uud! | Description | Resource Path Location Type 
[ m] 测试 函数 还 未 完成 HelloWorld2... /w3cschool.cc/src.. line 9 Task 
TODO Auto-generated method stub HelloWorld2... /w3cschool.cc/src.. line 6 Java Task 
TODO Auto-generated method stub NewHelloW... /w3cschool.cc/src.. line 11 Java Task 


Task( 任 务 ) 视图 中 还 能 进行 以 下 操作 : 


e 修改 任务 右 下 角 
e 标记 任务 已 完成 
e 删除 任务 或 删除 所 有 已 完成 任务 
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查找 和 安装 插件 
E E a 为 我 们 的 软件 开发 提供 了 便利 ，eclipse 除 了 
自 带 的 强大 功能 外 ， 还 支持 功能 丰富 的 插件 。 


ade s (http://marketplace.eclipse.org/) 找 到 并 下 载 我 们 需 
要 的 插件 。 


例如 我 们 可 以 查找 支持 Python IDE 的 插件 ， 如 下 图 所 示 : 


marketplace 9 3 S> 


Home My Marketplace Aad Content Login 
kots = 
E 1,399 Solutons and counting 
Sort by python Al Solutions Categones X 
Ite 
Tas Advanced Search + 
Author 
"m Found 17 results matching your query. 
1 net: laste 
Filter by Status 
pidea PyDev - Python IDE for Eclipse 
Pro es r y PyOevisa oe that enadies mx to be used as a Python IDE (supporting also Jhon and 
0 stab (15 
176:2  WonPython) tuses advanced type inference lechniques 12 provide features 
Mate (2) 
| 
P TI Aptana | Quango Edict |Eavcote [EE [IE | Laat Updated om 28 June 2012 by Fabio Zadrozm 
sse Cal Eider [Eco [Pdthon3 | Source Code 
Ee Era) Is i* 
Anat | EN ng Development | Yoots 
LA 
Filter by License Type 
Contarciid EasyEclipse for Python 
? EasyEdipse for Python is an Ectpse dis'isation to develop applications with Python or Jython, CVS and 
wat 2 9 Swdversion 
WE 4 Free I 
amin Languages | Toots Las: Updated on 4 December 2009 by pomoredanoe 


在 Eclipse IDE 中 我 们 也 可 以 通过 点 击 Help 菜单 中 的 Eclipse 
Marketplace (Eclipse 超市 ) 选项 来 查找 插件 : 
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=> = 


a 


Select solutions to install. Press Finish to proceed with installation. 
Press the information button to see a detailed overview and a link to more information. 











PyDev is a plugin that enables Eclipse to be used as a Python IDE (supporting also 
Jython and IronPython), It uses advanced type inference techniques to provide... 


by Appcelerator, EPL 
IDE Python Aptana Pydev Django 


”EasyEclipse for Python Share (D 


EasyEclipse for Python is an Eclipse distribution to develop applications with Python 
or Jython, CVS and Subversion. 


by nexB Inc., Commercial Leam more 


PyDeU* PyDev - Python IDE for Eclipse | 


Enerate Share (D 
JET2 transforms for generating: - Python code - Python code with Traits - Google ~ 























上 图 中 我 们 选择 PyDev 让 Eclipse 支持 Python 开发 ， 我 们 只 需要 点 击 Install 按钮 
即 可 。 以 下 对 话 框 为 选择 安装 的 插件 。 





Confirm Selected Features 
Confirm the features to include in this provisioning operation 








[ 4 vie PyDev - Python IDE for Eclipse http;//pydev.org/updates/ 
[VB PyDev for Eclipse 
Iv Pydev Mylyn Integration 








Einish 
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点 


NN 





ii Help 菜单 上 的 Install New Software 菜单 项 来 安装 插件 : 






你 也 可 以 通过 






Work with” BESESESESERIS . 
Find more software by working with the "Available Software Sites" preferences. 


type filter text 





y Name 
F |© There is no site selected. 








[V Show only the latest versions of available software — | | Hide items that are already installed 
[V Group items by category What is already installed? 

[E] Show only software applicable to target environment 

加 Contact all update sites during install to find required software 


这 种 方式 我 们 需要 知道 插件 远程 的 安装 地 址 ， 你 可 以 通过 点 击 Add 按钮 来 提交 
URL。 





Name: Subclipse 


Location: http;//subclipse.tigris.org/update, 1.61 





安装 的 对 话 框 中 列 出 了 远程 可 安装 的 插件 列表 : 
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Check the items that you wish to install. 





Work with: Subclipse - http;//subclipse.tigrisorg/update 16x -| Addn 


Find more software by working with the “Available Software Sites” prefere 
type filter text 


Name 
b (|W Core SVNKit Library 
» [V]? Optional JNA Library (recommended) 














Show only the Jatest versions of available software — | Hide items that are already installed 
V! Group items by category What is already installed? 

[E] Show only software applicable to target environment 

Contact all update sites during install to find required software 
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使 用 代码 模板 


Eclipse 提供 了 通过 定义 和 使 用 代码 模板 来 提高 工作 效率 与 代码 可 预测 性 的 能 
我 们 在 开发 Java 程序 过 程 中 经 常 需要 编写 main 方法 : 


public static void main(String[]args) { 


} 


如 果 我 们 一 个 字母 一 个 字母 去 编写 ， 闻 是 一 个 重复 而 又 毫 无 意义 的 事情 ， 这 是 我 们 
就 可 以 使 用 Eclipse 代码 模板 来 快速 完成 这 些 工作 。 


我 们 只 需 在 类 体 中 键入 main， 然 后 使 用 Eclipse 的 代码 提示 快捷 键 (默认 为 Alt+/)， 回 
车 后 ， 就 可 以 看 至 JEclipse 自 动 帮 我 们 完成 了 main 画 数 的 完整 定义 : 


四 NewHelloWorld.java D *HelloWorld2.java 3$ 


1 package cc.w3cschool.main; 





= 





3 public class HelloWorld2 { 


"iem 








public static void main(String[] args) - 


} 














2 ame n. fala. M4. Lll... renee Na 


如 果 我 们 要 使 用 System.out.printin(), 我 们 只 需要 输入 syso 然后 按 下 Alt+/ 即 可 : 
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[J) NewHelloWorld,java [J] *HelloWorld2.java 3 
1 package cc.w3cschool.main; 


2 
3 public class HelloWorld2 { 
4 
E 5- public static void main(String[] args) { 










System.out.println(); 





El syserr - print to standard error 





[=| sysout - print to standard out | 
E] systrace - print current method to standard out 

© System - java.lang 

© SysexMessage - javax.sound.midi 

@ SYSTEM EXCEPTION - org.omg.PortableInterceptor 
© SystemColor - java.awt 

© SystemException - org.omg.CORBA 

© SystemFlavorMap - java.awt.datatransfer 













m 


















© SystemMenuBar - javax.swing.plaf.basic.BasicinternalFram 


目 定义 代码 模板 


Eclipse 还 提供 了 非常 多 的 代码 模板 ， 我 们 可 以 通过 Windows->Preferences- 
>Java->Editor->Templates (你 可 以 在 搜索 框 中 输入 Templates 查 找 ) 看 到 所 有 已 定义 
的 代码 模板 列表 。 


wo - = = : 
wow CERES xX | 


Templates 





| = Preferences 








type filter text 








> Appearance 


人 Create, edit or remove templates: 
» Build Path 


> Code Style 

» Compiler 

» Debug 

Editor 
b Content Assist 

Folding 
Hovers 
Mark Occurren 
Save Actions 
Syntax Colorinc 





Templates 
Typing 
» Installed JREs 
JUnit 
Properties Files Ec 二 


«| m ' 





Context 
. Java type memb... 
SWT statements 


z 
a 
3 
m 


; 


ISS [S] [s] [s] Is) 








[Si [S] [S] 


PLE 


Description Auto Ins... 
static final fie... 
new StyledTe... 
new StyleRan... 
switch case s... 
synchronized... 
print to stan... 


€————— 


new Tabltem... 





Preview: 





|System.out.println(S(word selection)$([]);$[cursor] 


^ 


New... 


Edit... 
Remove 


| Restore Removed 


| Revert to Default 


Import... 








zal 








© 


B 


我 们 在 弹 窗口 选中 sysout 模板 并 点 击 右 侧 Edit， 显 示 如 下 : 
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4 & Edit Template OC on xX | 





Name: sysout Context: | Java statements -| [V] Automatically insert 





Description: print to standard out 


Pattern: System.out.println($(word selection}${});${cursor} 





Insert Variable... 








编辑 面板 是 核心 关注 对 象 ， 因 为 一 切 东 西 都 在 这 里 面 配 置 。 先 来 熟悉 下 这 个 面板 中 
天 键 的 五 项 分 别 是 什么 。 


e Name: 名 称 ， 其 实 就 是 以 后 可 以 用 到 的 代码 缩写 
e Context : 模板 上 下 文 ， 指 定 该 代码 模板 在 什么 地 方才 能 生效 ， 对 于 Java 至 少 


包含 这 么 四 个 : 
1. Java type members， 模 板 对 应 的 代码 是 类 成 员 ，psvm 模 板 严格 来 说 应 该 
选择 这 个 


2. Java statements， 模 板 对 应 的 代码 是 语句 块 
3. Java， 最 通用 的 ， 只 要 是 Java 代 码 就 行 
4. Java doc, iE ET 
e 模板 变量 : eclipse 已 经 预 置 了 一 些 模板 变量 (Alnsert Varibles 可 以 看 到 所 有 
预 置 变量 ) ， 如 : 
${cursor} 是 表示 光标 
${date} 表 示 当 前 日 期 字符 串 
${time} 表 示 当 前 时 间 字 符 串 
. $fline_selection} 让 当前 行 被 选中 
. ${word_selectiom} 让 当前 单词 被 选中 当然 我 们 也 可 以 定义 自己 的 模板 变 
量 ， 比 如 我 定义 一 个 $fmyTemplateVarible}， 那 么 对 应 代码 显示 的 就 是 
myTemplateVarible。 
e Pattern : 代码 模板 对 应 的 模式 ， 按 照 你 希望 代码 的 格式 逐个 输入 即 可 


更 多 自 定义 代码 模板 的 内 容 你 可 以 通过 点 击 Help 菜单 中 的 Help Contents 选项 ， 
在 弹出 的 对 话 框 的 搜索 栏 上 输入 "Java Editor Template Variables" 选择 Java Editor 
Template Variables 查看 具体 的 文档 描述 : 


een 
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Eclipse 快捷 键 
关于 快捷 键 


Eclipse 的 很 多 操作 都 提供 了 快捷 键 功 能 ， 我 们 可 以 通过 键 意 就 能 很 好 的 控制 
Eclipse 各 个 功能 : 

e 使 用 快捷 键 关联 菜单 或 菜单 项 

e 使 用 快捷 键 关 联 对 话 窗 口 或 视图 或 编辑 器 

。 使 用 快捷 键 关联 工具 条 上 的 功能 按钮 


| 图 Welcome 

@ Help Contents 

9? Search 
Dynamic Help 


Key Assist... Ctri+Shift+L 
Tips and Tricks... 

Report Bug or Enhancement... 

Cheat Sheets... 


£5. 


Eclipse Marketplace... 
Check for Updates 
Install New Software... 


About Eclipse 








Eclipse 快捷 键 列 表 可 通过 快捷 键 Ctrl + Shift + L FTF 。 
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| Activate Editor 
Activate Task 
Add Javadoc Comment 
All Instances 
Backward History 
Build All 
Change Method Signature 
Close 
Close All 
Collapse All 
Commit... 
Content Assist 
Context Information 
Copy 
Cut 
Deactivate Task 
Debug 
Debug Ant Build 
Debug JUnit Test 
Debug Java Applet 
_Debua Java Aoolication 


Ctrl «F9 
Alt+Shift+J 
Ctri+Shift+N 
Alt+Left 

Ctri+B 
Alt+Shift+C 
Ctri+F4 
Ctri+Shift+F4 
Ctri+Shift+Numpad_Divide 
Ctri+# 
Ctri+Space 
Ctri+Shift+Space 
Ctri+Insert 
Shift+Delete 
Ctri+Shift+F9 
F11 

Alt+Shift+D, Q 
Alt+Shift+D, T 
Alt«Shift«D, A 
Alt«Shift-D.J 


Press “Ctri+Shift+L" to open the preference 


设置 快捷 键 





Eclipse 系统 提供 的 快捷 键 有 时 比较 难 记 住 ， 甚 至 根本 没有 提供 快捷 键 时 ， 就 需要 
自己 手动 设置 快捷 键 。 


我 们 可 以 通过 点 击 window->preferences->general->keys (或 直接 搜索 keys) ， 进 
入 快捷 键 管理 界面 : 
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Content Types ^ 


Globalization 











Keys 3 type filter text 
bani — | Command e | Binding When Category User 
Perspectives i z | 
&Rename XSD element Edit 
Search : 
s E Abort Rebase Git 
> Security d Hel 
> Startup and Shutd 会 n a 
Activate Editor F12 In Windows Window 
Web Browser a 
Activate Selected Task Navigate 
> Workspace E : 
Android Activate Task Ctrl F9 In Windows Navigate 
i Ant E Add a Git Repository Git 
K C/C++ Add Block Comment Script Source 
Add Block Comment Ctrl+Shift+/ C/C++ Editor C/C++ Source 
b Code Recommenders - — - 
i Add Block Comment Ctrl+Shift+/ Editing in Structure... Edit L 
b Dynamic Languages |= a 7 
E Add Block Comment Ctrl+Shift+/ Editing Java Source Source 


b Help 
b Install/Update 


"- à Copy Command | | Unbind Command | | Restore Command Filters... Export CSV... 
b JavaScript 


T 


Add Block Comment Ctrl+Shift+/ Fditina JavaScrint S.. Source 























b Maven 
b Mylyn Name: 
p PHP Description: .. Conflicts: 
b Run/Debug Command When 
b Team 
Validation Binding: 4 
» Web When: [ - 
b WindowBuilder 











» XML z E 
«| im ] Restore Defaults Apply = 











在 这 里 可 以 查找 所 有 功能 的 快捷 键 ， 需 要 修改 或 新 增 时 ， 点 击 需要 修改 或 新 增 的 命 
4, binding 里 设置 快捷 键 : 

Name: Add Block Comment 

Description: Add Block Comment © Conflicts: 


Command 










Binding: Ctri+Shitt+/ 
When: Editing in Structured Text Editors X 








设置 完 快 捷 键 后 ， 还 需要 设置 在 什么 时 候 可 以 使 用 该 快捷 键 ，eclipse 提 供 各 种 场景 
供 选择 ， 一 般 选 择 In Windows( 即 在 eclipse 窗 口 激 活 状 态 ) 即 可 。 
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Add Block Comment 


dd Block Comment — ——  (trl+Shift+/ 

In Git Repositories View ^ 
used In I/O Console 
Add EIn Macro Expansion Hover 
Add FIn Memory View 
In Table Memory Rendering 


Copy Comm In Tasks Editor 


In Tasks View 


Script Source 
C/C++ Editor C/C++ Source 
Editing in Structure... Edit 
Editing Java Source Source 


Fditina JavaScrint S... Source 


[her J Le 




















Name: JavaScript View 
Description: Makefile Editor _ | Conflicts: 
Source Comments in Structured Text Editc | 
Task Markup Editor Source Context Command When 
ot mas WikiText Markup Source Context - 
Binding: «| = | : 
When: 
Restore Defaults m 
完成 以 上 操作 ， 点 击 OK 按钮 即 完成 设置 。 
Eclipse 常用 快捷 键 
快捷 键 描述 
编辑 
no 快速 修复 〈 最 经 典 的 快捷 刍 BUNS LT, TAR 
决 很 多 问题 ， 比 如 import 类 、try catch 包 围 等 ) 
Ctrl+Shift+F 格式 化 当前 代码 
Ctrl+Shift+M 添加 类 的 import 导 入 
| 组 织 类 的 import 导 和 人 《 既 有 Ctrl+Shift+M 的 作用 ， 又 
le 可 以 帮 你 去 除 没 用 的 导入 ， 很 有 用 ) 
Ctrl+V 重 做 (与 撤销 CtrltZ 相 反 ) 
Alt+/ 内 容 辅助 ( 帮 你 省 了 多 少 次 键盘 敲打 ， 太 常用 了 ) 
Ctrl+D 删除 当前 行 或 者 多 行 
"m 当前 行 和 下 面 一 行 交互 位 置 (特别 实用 ,可 以 省 去 先 
剪 切 , 再 粘贴 了 ) 
Alt+t 当前 行 和 和 上面 一 行 交互 位 置 (同上 ) 
Ctri+Alt+ | 复制 当前 行 到 下 一 行 (复制 增加 ) 
Ctrl+Alt+1 复制 当前 行 到 上 一 行 (复制 增 加 ) 
"mem 在 当前 行 的 下 一 行 插入 空 行 ( 这 时 鼠标 可 以 在 当前 
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行 的 任 一 位 置 ,不 一 定 是 最 后 ) 


Ctrl+/ 

选择 
Alt+Shift+ 个 
Alt+Shift+— 
Alt-Shift-— 
Shift-— 
Shift-— 
Ctrl+Shift+<— 
Ctrl+Shiftt— 
移动 
Ctrl+— 
Ctrl+ 一 


搜索 
Ctrl+K 


Ctrl+Shift+K 


Ctrl+J 


Ctrl+Shift+J 
Ctrl+Shift+U 
Ctrl+H 
Ctrl+G 
Ctrl+Shift+G 
导航 
Ctrl+Shift+T 
Ctrl+Shift+R 


Ctrl+E 


F4 


注释 当前 行 ,再 按 则 取消 注释 


选择 封装 元 素 
选择 上 一 个 元 素 

wie R—T27538 

从 光标 处 开始 往 左 选择 字符 
从 光标 处 开始 往 右 选择 字符 
选中 光标 左边 的 单词 
选中 光标 又 边 的 单词 


光标 移 到 左边 单词 的 开头 ， 相 当 于 vim 的 b 
光标 移 到 右边 单词 的 末尾 ， 相 当 于 vim 的 e 


参照 选中 的 Word 快 速 定 位 到 下 一 个 (如果 没 有 选中 
word， 则 搜索 上 一 次 使 用 搜索 的 word) 


参照 选中 的 Word 快 速 定位 到 上 一 个 

正 向 增 量 查找 ( 按 下 Ctrl+J 后 ,你 所 输入 的 每 个 字母 
编辑 器 都 提供 快速 匹配 定位 到 某 个 单词 ,如 果 没 有 ， 
则 在 状态 栏 中 显示 没有 找到 了 , 查 一 个 单词 时 ,特别 
实用 ,要 退出 这 个 模式 ， 按 escape 建 ) 

反 向 增 量 查找 (和 上 条 相同 ,只 不 过 是 从 后 往 前 查 ) 
列 出 所 有 包含 字符 串 的 行 

打开 搜索 对 话 框 

工作 区 中 的 声明 

工作 区 中 的 引用 


搜索 类 (包括 工程 和 关联 的 第 三 jar 包 ) 
搜索 工程 中 的 文件 


快速 显示 当前 Editer 的 下 拉 列 表 (如 果 当 前 页 面 没 
有 显示 的 用 黑体 表示 ) 


打开 类 型 层次 结构 


F3 

Alt+<— 

Alt+ 一 
CtrltPageUp/PageDown 
调试 

FS 

F6 

F7 

F8 
Ctrl+Shift+D 
Ctrl+Shift+B 
Ctrl+R 


BY 〈 一 般 重 构 的 快捷 
键 都 是 Alt+Shift 开 头 的 
i) 


Alt-Shift-R 


Alt+Shift+M 


Alt+Shift+C 


Alt+Shift+L 


Alt+Shift+F 


Alt-Shift*l 
Alt+Shift+V 
Alt+Shift+Z 
其 他 


Alt+Enter 


Ctrl+ 个 


跳 转 到 声明 处 
前 一 个 编辑 的 页 面 

下 一 个 编辑 的 页 面 (当然 是 针对 上 面 那 条 来 说 了 ) 
在 编辑 器 中 ， 切 换 已 经 打开 的 文件 


和 行 设置 或 者 去 掉 断 点 
行 ( 超 好 用 ， 可 以 节省 好 多 的 断 点 ) 


重 命名 方法 名 、 属 性 或 者 变量 名 (是 我 自己 最 爱 用 
的 一 个 了 ,尤其 是 变量 和 类 的 Rename, 比 手工 方法 能 
节省 很 多 劳动 力 ) 


把 一 段 函 数 内 的 代码 抽取 成 方法 (这 是 重 构 里 面 最 
常用 的 方法 之 一 了 ,尤其 是 对 一 大 堆 泥 团 代 码 有 用 ) 


修改 函数 结构 〈 比 较 实用 ,有 N 个 函数 调用 了 这 个 方 
法 ， 修改 一 次 搞定 ) 


抽取 本 地 变量 ( 可 以 直接 把 一 些 魔法 数字 和 字符 串 
抽取 成 一 个 变量 ,尤其 是 多 处 调用 的 时 候 ) 


把 Class 中 的 local 变 量变 为 field 变 量 (比较 实用 的 


合并 变量 (可 能 这 样 说 有 点 不 妥 Inline) 
移动 男 数 和 变量 (不 怎么 常用 ) 
重 构 的 后 悔 药 (Undo) 


显示 当前 选择 资源 的 属性 ，windows 下 的 查看 文件 
的 属性 就 是 这 个 快捷 键 ， 通 常用 来 查看 文件 在 
windows 中 的 实际 路 径 


文本 编辑 器 上 滚 行 


Ctrl | 
Ctrl+M 


Ctrl+O 
Ctrl+T 
Ctrl+W 


Ctrl+L 
F2 


文本 编辑 器 下 滚 行 
最 大 化 当前 的 Edit 或 View (再 按 则 反之 ) 


快速 显示 OutLine (不 开 Outline 窗 口 的 同学 ， 这 个 
快捷 键 是 必 不 可 少 的 ) 


快速 显示 当前 类 的 继承 结构 


关闭 当前 Editer (windows 下 关闭 打开 的 对 话 框 也 
是 这 个 ， 还 有 qq、 旺 旺 、 浏 览 器 等 都 是 ) 


文本 编辑 器 转 至 行 


显示 工具 提示 描述 
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Eclipse & 2 it 


L 


= & Eclipse 


重启 选项 允许 用 户 重 启 Eclipse。 
我 们 可 以 通过 点 击 File 菜单 选择 Restart 菜单 项 来 重启 Eclipse. 


[Eile] Edit Sou 





项 


rce Refactor Navigate Search 





pı 
New Alt+Shift+N > 
Open File... 
Close Ctri+W 
Close All Ctrl+Shift+W 
Save Ctri+S 
Save As. 
Save All Ctri+Shift+S 
Revert 
Move... 
Rename F2 
Refresh F5 
Convert Line Delimiters To » 
Print... Ctri+P 
Switch Workspace M 
Restart 
Import... 
Export... 
Properties Alt+Enter 


Exit 











在 安装 插件 后 ， 用 户 一 般 都 会 被 提醒 要 重启 Eclipse. WRA PAN RABE 


Eclipse， 可 以 通过 该 选项 来 重启 。 


Eclipse 重启 选项 
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Eclipse 内 置 浏览 器 
Web | i 4 


Eclipse 系统 内 部 自 带 了 浏览 器 ， 该 浏览 器 可 以 通过 点 击 Window 菜单 并 选择 Show 
View > Other, ue de ni. "browser", 


4 & General 
@ Internal Web Browser 





在 树 形 菜单 中 选择 "Internal Web Browser" 并 点 击 OK, 


在 内 置 浏览 器 中 我 们 在 地 址 栏 中 输入 网 址 ， 如 : http://www.w3cschool.cce， 即 可 打 
开 网 页 。 


Él Problems @ Javadoc [Ò Declaration © Console A Tasks @ Internal Web Browser 12 


a o Er 


学 的 不 仅 是 技术 ,更 是 梦想 E 
W3CSCHOOL.CC mmm 


HTML / CSS 











` 
3: HTML W3CSCHOOL 5: 9, A f£; 
学 习 HTMLS 
+5 CSS * HTML4 * CSS123 
学 习 css3 w3cschool 葡 驴 教 程 是 一 个 寓 供 最 新 的 web 技 术 站 点 ,本 站 免费 提供 了 建 * HTML5 + does 
学 习 Bootstrap 站 相关 的 技术 文档 , 帮 动 广 大 web 技 术 艾 好 者 快速 入 门 并 建立 自己 的 网 * HTML XAR + HTML ERE 
w, SR KRAG SS TAXUBBSCK ， 更 是 参 想 ， * Javascript * XMLDOM 

Sporyn 让 我 们 一 起 开始 我 们 的 建站 之 旅 吧 > d 
P JavaScript gi * PHP * XPath 
#5 HTML DOM * jQ Mobile . XSLT 
学 习 jQuery » » * MongoDB * IOS 
学 习 AngularlS FFI GH wats 
F jQuery Ul 
F5 jQuery EasyUl 

习 Nodejs 
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EJB 教 程 - EJB 


企业 Java Beans (EJB) 是 一 个 集 开 发 构建 高 度 可 扩展 性 和 强大 的 企业 级 应 用 程序 
的 架构 上 部 署 符合 J2EE 规 范 的 应 用 服务 器 ， 如 JBOSS， 网 站 逻辑 等 。 EJB3.0 从 

EJB2.0 是 一 个 伟大 的 转变 ， 使 得 基于 EJB 应 用 的 开发 变 得 更 容易 。 本 教程 讲述 EJB 
概念 和 理解 ， 在 这 一 个 过 程 中 需要 创建 和 部 署 企业 级 应 用 程序 启动 和 运行 。 读者 对 
R: 本 教程 是 专 为 软件 专业 人 员 学 习 EJB 编 程 简单 人 门 。 本 教程 将 介绍 EJB 编 程 概 
念 和 理解 ， 在 完成 本 教程 后 ， 希 望 你 能 够 对 EJB 有 一 个 初级 的 认识 和 应 用 。 


前 置 技 术 知 识 要 求 : 在 继续 本 教程 之 前 ， 您 应 该 对 Java 编 程 语 言 有 一 定 的 了 解 ， 文 
本 编辑 器 和 执行 程序 这 些 也 必 不 可 少 ， 因 为 我 们 要 开发 企业 应 用 程序 使 用 EJB， 如 
果 你 已 经 了 解 其 他 技术 ， 如 数据 库 服务 器 ， 应 用 服务 器 ， 那 么 你 可 以 跳 过 上 面 技术 
知识 的 学 习 ， 直 接 进 入 下 一 章节 。 


EJB 概 述 - EJB 


EJB 其 实 就 是 企业 Java Beans。 EJB 是 J2EE 平 台 的 重要 组 成 部 分 。 J2EE 平 台 基 于 
组 件 的 企业 级 应 用 架构 ， 提 供 多 层次 ， 分 布 式 和 高 事务 的 功能 特点 。 EJB 提 供 了 一 
个 架构 ， 充 分 考虑 健壮 性 ， 高 可 扩展 性 和 高 性 能 的 基于 组 件 的 企业 应 用 程序 开发 和 
部 署 。 一 个 EJB 应 用 程序 可 以 部 署 在 任何 符合 J2EE1.3 标 准 规范 的 应 用 程序 服务 器 
上 。 我 们 将 在 本 教程 中 讨论 EJB3.0。 
优点 
e. 简化 开发 大 型 企业 级 应 用 。 
e 应 用 服务 器 / EJB 容 器 提供 了 系统 级 服务 ， 如 事务 处 理 ， 上 日志， 负载 均衡 ， 持 久 
性 机 制 ， 异 常 处 理 等 。 开 发 者 只 专注 于 业务 逻辑 的 上 应 用 程序 。 
e REL UR CIS 因此 ， 开 发 人 员 并 不 需要 担心 何 时 创建 / 删 
除 EJB 对 象 。 


类 型 EJB 主 要 有 三 种 类 型 ， 下 面 简要 介绍 : 


类 型 描述 
Session 会话 bean 将 特定 用 户 的 数据 存储 为 一 个 单一 的 会 话 。 它 可 以 是 状态 


或 无 状态 。 它 占用 更 少 资源 ， 相 比 于 实体 Bean。 只 要 终止 用 户 会 
话 ， 会 话 bean 被 销毁 。 


Entity 实体 bean 代 表 持 久 性 数据 存储 。 可 将 用 户 数据 保存 到 数据 库 中 ， 通 
Bean 过 实体 bean， 后 来 就 可 以 检索 从 数据 库 中 的 实体 bean。 


Bean 


Message ， 使 用 消息 驱动 bean 上 下 文中 的 JMS (Java 消 息 服 务 ) 。 消 息 驱动 


Diven ， Bean 可 以 从 外 部 实体 消耗 JMS 消 息 ， 并 采取 相应 的 动作 。 


EJB 6!) @ © FH - EJB 


要 创建 一 个 简单 的 EJB 模 块 ， 我 们 这 里 使 用 NetBeans“New project" 向 导 。 在 下 面 的 
例子 中 ， 我 们 将 创建 一 个 名 为 “Component" 的 EJB 模 块 项 目 。 


创建 项 目 


在 NetBeans IDE 中 ， 选 择 File > New Project >. 可 以 看 到 如 下 图 . 





r 
© New Project 





Steps Choose Project 


1. Choose Project Categories: Projects: 

2 m CM e —— (A Enterpise Appian —— 
D JavaFx |A Enterprise Application with Existing Sources 
D. Java Vieb $ 
D mwa 
DO HML/avaSoipt 


W EJ8 Module with Existing Sources 
(SS Enterpise Application Clent 
WB Enterprise Application Clent with Existing Sources 











Creates a new Enterprise JavaBean (EJB) module in à standard IDE project. Standard 
projects use an IDE-generated Ant build script to buid and run your project. 
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在 类 别 中 选择 项 目 类 型 ，Java EE 的 EJB 模 块 项 目 类 型 。 点 击 Next> 按 和 钮 ， 你 会 看 到 
以 下 的 画面 。 


TutorialsPoint Java 技术 教程 


Steps Name and Location 
1 Choose Project Project :  [EjComponent 
2. Name and Location em hole — - 
p meus Project Location: C:\Users\Acer Documents WetBeansProjects 

Project Eolder: C:Wsers\Acer Documents WetBeansProjects'EjbComponent 














[E] Use Dedicated Folder for Storing Libraries 








Libraries Folder: | Browse.. 





Different users and projects can shere the same coenpiiation libraries 
(see Help for details). 





Add to Enterprise Aapkcation: | «hone > 
Server: “JBoss Appication Server 





[V] Set Source Level to 1.5 
Recommendation: Source Level 1.5 should be used in Java EE 5 projects. 





选择 服务 器 为 JBoss 应 用 服务 器 。 单 击 “Finish” 按 钮 。 你 会 看 到 以 下 由 NetBeans 创 
建 的 项 目 。 


EJB 创 建 应 用 - EJB 305 





| Projects 3€ |Files | Services [zl 
E INS] EjbComponent 
由 a Source Packages 
sB 
H- IDK 1.6 
H-E JBoss Application Server 
Gj Enterprise Beans 
由 -网 Configuration Files 
出 te Server Resources 








DEDE € M S.C QM 





创建 一 个 简单 的 EJB 
要 创建 一 个 简单 的 EJB， 我 们 将 使 用 NetBeans“New” 向 导 。 在 下 面 的 例子 中 ， 我 们 
将 在 EjbComponent 项 目下 创建 一 个 无 状态 EJB 类 名 为 librarySessionBean。 


在 项 目 资源 管理 器 窗口 中 选择 项 目 EjbComponent， 右 键 单 击 它 。 选 择 New > 
Session Bean, 您 将 看 到 新 的 会 话 Bean 向 导 。 





| 
© New Session Bean 





Steps Name and Location 


1, Choose File Type EJB Name: NewSessionBean 
2. Name and Location 
Project: | EjbComponent 
Location: | Source Packages 
Package: |com.tutonaispoint.stateless 
Session Type: 
5 Stateless 
Stateful 
Create Interface: 
[V] Local 


| | Remote 








grece ; A5 DI Zr p UR 5 
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输入 会 话 bean 的 名 称 和 包 名 。 单 击 “Finish ”按钮 。 你 会 看 到 以 下 由 NetBeans 创 建 
的 EJB 类 。 


e LibrarySessionBean - 无 状态 会 话 bean 


e LibrarySessionBeanLocal - 本 地 接口 的 会 话 bean 


要 改变 本 地 接口 ， 我 们 要 一 个 基于 控制 台 的 应 用 程序 访问 我 们 的 EJB 远 程 接口 。 远 
程 /本 地 接口 用 于 公开 一 个 EJB 的 业务 方法 实现 。 


LibrarySessionBeanLocal 更 名 为 LibrarySessionBeanRemote 和 
LibrarySessionBean 实 现 LibrarySessionBeanRemote 接 口 。 


LibrarySessionBeanRemote 


package com.tutorialspoint.stateless; 


import java.util.List; 
import javax.ejb.Remote; 


@Remote 
public interface LibrarySessionBeanRemote { 


void addBook(String bookName) ; 


List getBooks(); 


LibrarySessionBean 


package com.tutorialspoint.stateless; 


import java.util.ArrayList; 
import java.util.List; 
import javax.ejb.Stateless; 


@Stateless 
public class LibrarySessionBean implements LibrarySessionBeanRemote 


List<String> bookShelf; 


public LibrarySessionBean( ){ 
bookShelf = new ArrayList<String>(); 
j 


public void addBook(String bookName) { 
bookShelf.add(bookName); 


} 


public List<String> getBooks() { 
return bookShelf; 


j 











构建 项 目 
e 在 Project Explorer 窗 口中 选择 EjbComponent 项 目 。 
e 右键 点 击 它 来 打开 上 下 文 菜单 。 
e 选择 clean and build. 


在 NetBeans 控 制 台 输出 ， 你 会 看 到 以 下 的 输出 。 


ant -f C:\EJB\EjbComponent clean dist 

init: 

undeploy-clean: 

deps-clean: 

Deleting directory C:EJBEjbComponentuild 

Deleting directory C:EJBEjbComponentdist 

clean: 

init: 

deps-jar: 

Created dir: C:EJBEjbComponentuildclasses 

Copying 3 files to C:EJBEjbComponentuildclassesMETA-INF 
Created dir: C:EJBEjbComponentuildempty 

Created dir: C:EJBEjbComponentuildgenerated-sourcesap-source-output 
Compiling 2 source files to C:EJBEjbComponentuildclasses 
warning: [options] bootstrap class path not set in conjunction witt 
Note: C:EJBEjbComponentsrcjavacom utorialspointstateless 
LibraryPersistentBean.java uses unchecked or unsafe operations. 
Note: Recompile with -Xlint:unchecked for details. 

1 warning 

compile: 

library-inclusion-in-archive: 

Created dir: C:EJBEjbComponentdist 

Building jar: C:EJBEjbComponentdistEjbComponent.jar 

dist: 

BUILD SUCCESSFUL (total time: 3 seconds) 





启动 应 用 程序 服务 器 


e 服务 器 在 服务 窗口 下 选择 JBoss 应 用 服务 器 。 
e 右键 点 击 它 来 打开 上 下 文 菜单 。 
e 选择 Start。 


你 会 看 到 下 面 的 输出 在 NetBeans 中 JBoss 应 用 服务 器 下 的 输出 。 


Calling C:jboss-5.1.0.GAin 
un.conf.bat 


JBoss Bootstrap Environment 

JBOSS HOME: C:jboss-5.1.0.GA 

JAVA: C:Program Files (x86)Javajdk1.6.0 21injava 

JAVA OPTS: -Dprogram.name-run.bat -Xms128m -Xmx512m -server 


CLASSPATH: C:jboss-5.1.0.GAin 
un.jar 


16:25:50,062 INFO [ServerImpl] Starting JBoss (Microcontainer)... 
16:25:50,062 INFO [ServerImpl] Release ID: JBoss [The Oracle] 5.1 


16:26:40,420 INFO [TomcatDeployment] deploy, ctxPath=/admin-conso- 
16:26:40,485 INFO [config] Initializing Mojarra (1.2 12-b01-FCS) ! 
16:26:42,362 INFO [TomcatDeployment] deploy, ctxPath-/ 

16:26:42,406 INFO [TomcatDeployment] deploy, ctxPath-/jmx-console 
16:26:42,471 INFO [HttpiiProtocol] Starting Coyote HTTP/1.1 on htt 
16:26:42,487 INFO [AjpProtocol] Starting Coyote AJP/1.3 on ajp-127 
16:26:42,493 INFO [ServerImpl] JBoss (Microcontainer) [5.1.0.GA (| 


|I MESSI es 


部 署 项 目 
。 在 Project Explorer 窗 口中 选择 EjbComponent 项 目 。 
e 右 击 它 ， 打 开 上 下 文 菜单 。 
e 选择 Deploy. 

在 NetBeans 控 制 台 输 出 ， 你 会 看 到 下 面 的 输出 。 





OSes 


ant -f C:\EJB\EjbComponent -DforceRedeploy=true -Ddirectory.deployr 
init: 

deps-jar: 

compile: 

library-inclusion-in-archive: 

Building jar: C:EJBEjbComponentdistEjbComponent.jar 
dist-directory-deploy: 

pre-run-deploy: 

Checking data source definitions for missing JDBC drivers... 
Distributing C:EJBEjbComponentdistEjbComponent.jar to [org.jboss.de 
Deploying C:EJBEjbComponentdistEjbComponent. jar 

Applicaton Deployed 

Operation start started 

Operation start completed 

post-run-deploy: 

run-deploy: 

run: 

BUILD SUCCESSFUL (total time: 2 seconds) 





JBoss 应 用 服务 器 的 日 志 输 出 


16:30:00,963 INFO [DeployHandler] Begin start, [EjbComponent. jar] 
16:30:01,233 INFO [Ejb3DependenciesDeployer] Encountered deploymer 


16:30:01,281 INFO [JBossASKernel ] jndi:LibrarySessionBean/remot 
16:30:01,281 INFO [JBossASKernel] Class:com.tutorialspoint.sta! 
16:30:01,281 INFO [JBossASKernel] jndi:LibrarySessionBean/remot 
16:30:01,281 INFO [JBossASKernel] Added bean(jboss.j2ee: jar=EjbC« 
LibrarySessionBean,service-EJB3) to KernelDeployment of: EjbCompone 
16:30:01,282 INFO [JBossASKernel] installing bean: jboss.j2ee:jar: 
16:30:01,282 INFO [JBossASKernel] with dependencies: 
16:30:01,282 INFO [JBossASKernel] and demands: 

16:30:01,282 INFO [JBossASKernel] jboss.ejb:service-EJBTimerSe! 


16:30:01,283 INFO [EJB3EndpointDeployer] Deploy AbstractBeanMetaD: 


16:30:01,394 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
16:30:01,395 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
16:30:01,401 INFO [JndiSessionRegistrarBase] Binding the followint 

LibrarySessionBean/remote - EJB3.x Default Remote Business Intei 

LibrarySessionBean/remote-com.tutorialspoint.stateless.LibrarySt 
16:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
16:30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibrarySessionBean/remote - EJB3.x Default Remote Business Intei 
LibrarySessionBean/remote-com.tutorialspoint.stateless.LibrarySt 











创建 客户 端 访问 EJB 
。 在 NetBeans IDE 中 选择 File > New Project >. 


e 类 别 下 选择 项 目 类 型 为 Java， 项 目 类 型 为 Java 应 用 程序 的 Java。 点 击 Next> 按 
£o 


e 输入 项 目的 名 称 和 位 置 。 单 击 “Finish >" 按 钮 。 我 们 选择 名 为 EjbTester。 
e 右键 点 击 项 目 名 称 (在 Project explore 窗 口中 )。 选 择 属性 properties。 
e 添加 EJB 组 件 项 目的 库 使 用 “Add Project "按钮 ， 在 compile 选 项 卡 下 创建 的 。 


e 添加 JBoss 库 使 用 添加 Add jarfolder 按 钮 ， 在 compile 选 项 卡 。 Jboss 的 库 可 
以 位 于 <JBOSS 安 装 文件 夹 > 客户 端 文件 夹 。 


在 工程 中 创建 jndi.properties 说 一 个 句 话 EjbTester. 
jndi.properties 
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 


java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url=localhost 





创建 包 com.tutorialspoint.test 和 EJBTesterjava 类 在 下 面 。 
EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateless.LibrarySessionBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 
1 
props - new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
) catch (IOException ex) { 


ex.printStackTrace(); 


j 


try { 
ctx = new InitialContext(props); 


) catch (NamingException ex) { 
ex.printStackTrace(); 


j 


brConsoleReader - 
new BufferedReader(new InputStreamReader(System.in)); 


j 


public static void main(String[] args) { 


EJBTester ejbTester - new EJBTester(); 


ejbTester.testStatelessEjb(); 


j 


private void showGUI(){ 
SvSEtensoute DL bL eese RUNG UE aS MEE 
System.out.println("Welcome to Book Store"); 
SVS GCM sod Eb ESTE 0 t s Mya 
System.out.print("Options 
1\. Add Book 


2AF “EXE 


Enter Choice: "); 


j 


private void testStatelessEjb()( 
try { 


int choice - 1; 
LibrarySessionBeanRemote libraryBean - 
(LibrarySessionBeanRemote)ctx.lookup("LibrarySessionBean/i 
while (choice != 2) { 
String bookName; 
ShowGUI(); 
String strChoice - brConsoleReader.readLine(); 
choice = Integer.parseInt(strChoice); 
if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
libraryBean.addBook(bookName); 
jelse if (choice == 2) { 


break; 

} 
} 
List<String> booksList = libraryBean.getBooks(); 
System.out.println("Book(s) entered so far: " + booksList 
for (int i = 0; i < booksList.size(); ++i) { 
System.out.printin((iti)+". " + booksList.get(i)); 
} 


LibrarySessionBeanRemote libraryBeani = 
(LibrarySessionBeanRemote)ctx.lookup("LibrarySessionBean/i 
List«String» booksListi - libraryBeani.getBooks(); 
System.out.println( 

"***Using second lookup to get library stateless object**’ 


System.out.println( 

"Book(s) entered so far: " + booksListi.size()); 

Tor (int i = 0; i < booksList1.size(); ++i) { 
System.out.println((i+1)+". " + booksList1.get(i)); 


} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


) catch (IOException ex) { 
System.out.println(ex.getMessage()); 





运行 客户 端 访 问 EJB 


在 project explorer 中 找到 EJBTesterjava。 右键 点 击 上 EJBTester 类 ， 并 选择 "run 
file”, 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
ockckckckckckckckckokckckckck kckck ck ko k 


Welcome to Book Store 


*ockckckck kck k ok ko ck ko k kk kk kk*k*k* 


Options 
1N. Add Book 
2 Exit 


Enter Choice: 1 
Enter book name: Learn Java 


*ockckckck kck k ok ck ck ko k kkkk ke k*kk* 


Welcome to Book Store 


*okckckck kck k ok k ck ck k kk kk ke k*kk* 


Options 
1N. Add Book 
2\. Exit 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. Learn Java 

***Using second lookup to get library stateless object*** 
Book(s) entered so far: 0 

BUILD SUCCESSFUL (total time: 13 seconds) 


在 下 面 的 章节 中 ， 我 们 将 讨论 这 个 完整 的 EJB 的 多 个 层面 应 用 程序 。 


EJB 无 状态 Bean - EJB 


无 状态 会 话 bean 是 一 种 企业 bean， 通 常 是 用 于 执行 独立 操作 。 正 如 它 的 名 字 一 
样 ， 无 状态 会 话 bean 不 具有 任何 关联 的 客户 端的 状态 ， 但 它 可 能 会 保持 其 实例 的 状 
态 。 EJB 容 器 通常 创建 一 个 容器 池 和 几 无 状态 的 bean 的 对 象 ， 并 使 用 这 些 对 象 来 处 
理 客 户 端的 请 求 。 由 于 有 容器 池 ， 实 例 变量 的 值 不 能 保证 跨 查 找 /方法 调用 同一 个 。 
下 面 是 创建 一 个 无 状态 的 EJB 所 需 的 步骤 。 

e 创建 一 个 远程 /本 地 接口 暴露 的 业务 方法 。 

e 此 接口 将 用 于 EJB 客 户 端 应 用 程序 。 

e 使 用 @ Local 注 释 如 果 EJB 客 户 端 是 在 相同 的 环境 中 部 署 EJB 会 话 Bean。 

e 使 用 @ Remote 批注 如 果 EJB 客 户 端 是 在 不 同 的 环境 中 部 署 EJB 会 话 Bean。 

e 创建 一 个 无 状态 会 话 bean 实 现 上 述 接口 。 


e 使 用 @ Stateless 注 释 ， 以 表示 它 一 个 无 状态 的 bean。 EJB 容 器 会 自动 创建 通 
过 读 取 这 个 注解 ， 在 部 署 过 程 中 的 相关 配置 或 接口 。 


Remote Interface 


import javax.ejb.Remote; 


@Remote 
public interface LibrarySessionBeanRemote { 
//add business method declarations 


} 


Stateless EJB 


@Stateless 
public class LibrarySessionBean implements LibrarySessionBeanRemote 
//implement business method 





示例 应 用 程序 


让 我 们 创建 一 个 测试 测试 无 状态 EJB 的 EJB 应 用 程序 。 


描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.stateless as explained in the EJB - Create Application 
chapter. You can also use the project created in EJB - Create Application 
chapter as such for this chapter to understand stateless ejb concepts. 


Create LibrarySessionBean.java and LibrarySessionBeanRemote as 
2 explained in the EJB - Create Application chapter. Keep rest of the files 
unchanged. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss Application 
4 Server. JBoss Application server will get started automatically if it is not 
started yet. 


Now create the ejb client, a console based application in the same way 
5 as explained in theEJB - Create Application chapter under topic Create 
Client to access EJB. 


EJBComponent (EJB Module) 


LibrarySessionBeanRemote.java 


package com.tutorialspoint.stateless; 


import java.util.List; 
import javax.ejb.Remote; 


@Remote 

public interface LibrarySessionBeanRemote { 
void addBook(String bookName); 
List getBooks(); 

} 


LibrarySessionBean.java 


package com.tutorialspoint.stateless; 


import java.util.ArrayList; 
import java.util.List; 
import javax.ejb.Stateless; 


@Stateless 
public class LibrarySessionBean implements LibrarySessionBeanRemote 


List<String> bookShelf; 


public LibrarySessionBean(){ 
bookShelf = new ArrayList<String>(); 
j 


public void addBook(String bookName) { 
bookShelf.add(bookName); 
} 


public List<String> getBooks() { 
return bookShelf; 





e As soon as you deploy the EjbBComponent project on JBOSS, notice the jboss 
log. 


e JBoss has automatically created a JNDI entry for our session bean - 
LibrarySessionBean/remote. 


e We'll using this lookup string to get remote business object of type - 
com.tutorialspoint.stateless.LibrarySessionBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


16:30:01,401 INFO [JndiSessionRegistrarBase] Binding the followint 
LibrarySessionBean/remote - EJB3.x Default Remote Business Intei 
LibrarySessionBean/remote-com.tutorialspoint.stateless.LibrarySe 
16:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee: jar=t 
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
16:30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibrarySessionBean/remote - EJB3.x Default Remote Business Inte) 
LibrarySessionBean/remote-com.tutorialspoint.stateless.LibrarySe 


«| = 








EJBTester (EJB Client) 


jndi.properties 


java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 


一 = n LLL LLL LLL exi] 


e These properties are used to initialize the InitialContext object of java naming 
service 





e InitialContext object will be used to lookup stateless session bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.LibrarySessionBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 


InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
j 


try { 
ctx - new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 
brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testStatelessEjb(); 
j 


private void showGUI(){ 

Syetomsobte Prine me meee en ake d Dr 
System.out.println("Welcome to Book Store"); 
Sy S bensou t» DE PEU d dem Pe t UMS 
System.out.print("Options 

1\. Add Book 

2 Noe Exact 

Enter Choice: "); 


} 


private void testStatelessEjb(){ 


try { 
int choice = 1; 


LibrarySessionBeanRemote libraryBean = 
LibrarySessionBeanRemote)ctx.lookup("LibrarySessionBean/re 


while (choice != 2) { 

String bookName; 

ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
Book book = new Book(); 
book.setName(bookName) ; 
libraryBean.addBook(book); 


} else if (choice == 2) { 
break; 
} 
} 


List<Book> booksList = libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " + booksList 
int i - 0; 
for (Book book:booksList) ( 
System.out.println((i-1)-". " + book.getName( )); 
i++; 
} 
LibrarySessionBeanRemote libraryBeani = 
(LibrarySessionBeanRemote)ctx.lookup("LibrarySessionBe: 
List«String» booksListi = libraryBeani.getBooks(); 
System.out.println( 
"***Using second lookup to get library stateless object 
System.out.println( 


"Book(s) entered so far: " + booksListi.size()); 
for (int i = 0; i < booksListi.size(); ++i) { 
System.out.println((it+1)+". " + booksListi.get(1i)); 


} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


) catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester 在 执行 以 下 任务 。 


e Load properties from jndi.properties and initialize the InitialContext object. 


e In testStatelessEjb() method, jndi lookup is done with name - 
"LibrarySessionBean/remote" to obtain the remote business object (stateless 
ejb). 


e Then user is shown a library store User Interface and he/she is asked to enter 
choice. 


e |f user enters 1, system asks for book name and saves the book using 
stateless session bean addBook() method. Session Bean is storing the book 
in its instance variable. 


e |f user enters 2, system retrieves books using stateless session bean 
getBooks() method and exits. 


e Then another jndi lookup is done with name - "LibrarySessionBean/remote" to 
obtain the remote business object (stateless ejb) again and listing of books is 
done. 


{TE P limi ij] EJB 


Locate EJBTester.java in project explorer. Right click on EJBTester class and 
select run file. 


Verify the following output in Netbeans console. 


run: 
okckckckckckckck kckckckckck kck ck ko ko ko 


Welcome to Book Store 
*Wockckckockokockock kockock ko ck ko ck ck KEKE 


Options 
1\. Add Book 
2 EXIT 


Enter Choice: 1 
Enter book name: Learn Java 
bp ko ckock ko ck ko ck ck kk kkk 


Welcome to Book Store 

*ockckck kock ck ck ko k ck ck k kk kk kkkk* 

Options 

1\. Add Book 

2N. EXCIE 

Enter Choice: 2 

Book(s) entered so far: 1 

1\. Learn Java 

***Using second lookup to get library stateless object*** 
Book(s) entered so far: 0 

BUILD SUCCESSFUL (total time: 13 seconds) 


再 次 运行 客户 端 访 问 EJB 


在 项 目 资源 管理 器 中 找到 EJBTesterjava。 右键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
KKEKKKKKKEKKKEKKKKKKKKKKE 


Welcome to Book Store 


和 和 


Options 
1\. Add Book 
2N TESI 


Enter Choice: 2 

Book(s) entered so far: 0 

***Using second lookup to get library stateless object*** 
Book(s) entered so far: 1 

1\. Learn Java 

BUILD SUCCESSFUL (total time: 12 seconds) 


e 如 上 图 所 示 的 输出 可 能 会 有 所 不 同 ， 这 取决 于 许多 无 状态 JBoss 的 EJB 对 象 保 
持 。 


e 万 一 单一 的 无 状态 EJB 对 象 得 以 维持 ， 每 次 查找 后 ， 你 可 能 会 看 到 相同 书籍 列 


o 


e EJB 容 器 可 以 为 每 个 查询 返回 相同 的 无 状态 EJB 对 象 。 
无 状态 EJB 的 bean 实 例 变量 的 值 是 直到 重新 启动 服务 器 才 失 效 的 。 


EJB 有 状态 Bean - EJB 


有 状态 会 话 Bean 是 一 种 企业 bean 保 存 客 户 端 的 会 话 状态 类 型 。 有 状态 会 话 bean 作 
为 每 它 的 名 字 相 关 的 客户 站 HARE CHOSE, EJB 容 器 创建 一 个 单独 的 有 
状态 会 话 bean 来 处 理 客户 端的 每 个 请 求 。 只 要 请 求 范 围 过 ， 有 状态 会 话 bean 被 销 


毁 。 

以 下 是 创建 一 个 有 状态 的 EJB 所 需 的 步 又 : 
e Create a remote/local interface exposing the business methods. 
e This interface will be used by the ejb client application. 


e Use @Local annotation if ejb client is in same environment where ejb session 
bean is to be deployed. 


e Use @Remote annotation if ejb client is in different environment where ejb 
session bean is to be deployed. 


e Create a stateful session bean implementing the above interface. 


e Use @Stateful annotation to signify it a stateful bean. EJB Container 
automatically creates the relevant configurations or interfaces required by 
reading this annotation during deployment. 


远程 接口 
import javax.ejb.Remote; 
@Remote 
public interface LibraryStatefulSessionBeanRemote { 
//add business method declarations 
} 


Stateful EJB 


@Stateful 

public class LibraryStatefulSessionBean implements LibraryStatefuls 
//implement business method 

} 


于 = 


示例 应 用 程序 


让 我 们 创建 一 个 测 试 测 斌 状态 EJB 的 EJB 应 用 程序 。 


| 





Step 描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.stateful as explained in the EJB - Create Application 

1 chapter. You can also use the project created in EJB - Create 
Application chapter as such for this chapter to understand stateful ejb 
concepts. 


Create LibraryStatefulSessionBean.java and 
2 LibraryStatefulSessionBeanRemote as explained in the EJB - Create 
Application chapter. Keep rest of the files unchanged. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
4 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
5 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. 


EJBComponent (EJB Module) 


LibraryStatefulSessionBeanRemote.java 


package com.tutorialspoint.stateful; 


import java.util.List; 
import javax.ejb.Remote; 


@Remote 

public interface LibraryStatefulSessionBeanRemote { 
void addBook(String bookName) ; 
List getBooks(); 

} 


LibraryStatefulSessionBean.java 


package com.tutorialspoint.stateful; 


im 
im 
im 


QS 
pu 


port java.util.ArrayList; 
port java.util.List; 
port javax.ejb.Stateful; 


tateful 
blic class LibraryStatefulSessionBean implements LibraryStateful: 


List<String> bookShelf; 

public LibraryStatefulSessionBean(){ 
bookShelf = new ArrayList<String>(); 

j 


public void addBook(String bookName) { 
bookShelf.add(bookName); 
} 


public List<String> getBooks() { 
return bookShelf; 





只 要 你 部 署 在 JBoss EjbComponent 项 目 发 现 jboss 的 日 志 。 


JBoss 已 经 自动 创建 一 个 JNDI 条 目 会 话 bean- 
LibraryStatefulSessionBean/remote, 

我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


16: 


16 


16: 
16: 


30:01,401 INFO [JndiSessionRegistrarBase] Binding the followin, 
LibraryStatefulSessionBean/remote - EJB3.x Default Remote Busine 
LibraryStatefulSessionBean/remote-com.tutorialspoint.stateful.L: 
:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryStatefulSessionBean/remote - EJB3.x Default Remote Busine 
LibraryStatefulSessionBean/remote-com.tutorialspoint.stateful.L: 


— |] 








EJBTester (EJB Client) 


jndi.properties 


java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 


«| -— 











e These properties are used to initialize the InitialContext object of java naming 
service 


e InitialContext object will be used to lookup stateful session bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemot: 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties") ); 
) catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 


EJBTester ejbTester = new EJBTester(); 


ejbTester.testStatelessEjb(); 


j 


private void showGUI(){ 
System rout Pram mM (a e ver E Pen aah eae 
System.out.println("Welcome to Book Store"); 
System out DIS EN ce. perce SEIL antag pee Sen cns 
System.out.print("Options 
1\. Add Book 


2\. Exit 


Enter Choice: "); 


} 


private void testStatelessEjb(){ 


try { 


int choice = 1; 


LibraryStatefulSessionBeanRemote libraryBean = 
LibraryStatefulSessionBeanRemote)ctx.lookup("LibraryState! 


while (choice != 2) { 
String bookName; 
ShowGUI(); 
String strChoice - brConsoleReader.readLine(); 
choice = Integer.parselInt(strChoice); 
if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
Book book = new Book(); 
book. setName(bookName) ; 
libraryBean.addBook(book); 
} else if (choice == 2) ( 
break; 
j 
j 


List<Book> booksList = libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " + booksList 
int i = 0; 
for (Book book:booksList) ( 
System.out.println((i-1)-*". " + book.getName( )); 
i++; 
} 
LibraryStatefulSessionBeanRemote libraryBeani = 
(LibraryStatefulSessionBeanRemote)ctx.lookup("LibraryS! 


List<String> booksListi = libraryBean1.getBooks(); 
System.out.println( 

"***Using second lookup to get library stateful object’ 
System.out.println( 


"Book(s) entered so far: " + booksListi.size()); 
for (int i = 0; i < booksListi.size(); ++i) { 
System.out.println((i-1)-". " + booksList1.get(i)); 


} 

} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


} 
} catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester is doing the following tasks. 


e Load properties from jndi.properties and initialize the InitialContext object. 


e In testStatefulEjb() method, jndi lookup is done with name - 
"LibraryStatefulSessionBean/remote" to obtain the remote business object 
(stateful ejb). 


e Then user is shown a library store User Interface and he/she is asked to enter 
choice. 


If user enters 1, system asks for book name and saves the book using 
stateful session bean addBook() method. Session Bean is storing the book in 
its instance variable. 


If user enters 2, system retrieves books using stateful session bean 
getBooks() method and exits. 


Then another jndi lookup is done with name - 
"LibraryStatefulSessionBean/remote" to obtain the remote business object 
(stateful ejb) again and listing of books is done. 


运行 客户 端 访 问 EJB 
在 项 目 资源 管理 器 中 找到 EJBTester.java。 右 键 单 击 类 EJBTester 并 选择 run file. 
在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
KKEKKKKKKEKKKEKKKKKKKKKKE 


Welcome to Book Store 


和 和 


Options 
1\. Add Book 
2N EXI 


Enter Choice: 1 
Enter book name: Learn Java 
kkkk kkk KEK KEKE ko ck k ck ck kk kkk 


Welcome to Book Store 
*ockckckockockockock ko ckock ko ck ko ck ck kk kk ke 


Options 
1\. Add Book 
2N c WE SGI 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. Learn Java 

***Using second lookup to get library stateful object*** 
Book(s) entered so far: 0 

BUILD SUCCESSFUL (total time: 13 seconds) 


再 次 运行 客户 端 访 问 EJB 
在 项 目 资 源 管 理 器 中 找到 EJBTester.java。 右键 单 击 类 EJBTester 选 择 run file. 
在 NetBeans 控 制 台 验证 以 下 输出 . 


run: 
okckckckckckck ck kckckckckck kck ck ko ko ko 


Welcome to Book Store 


*ockckck ck kck k k ck ck kk kkkkkk*k*k* 


Options 
1\. Add Book 
2A SE: XS 


Enter Choice: 2 

Book(s) entered so far: 0 

***Using second lookup to get library stateful object*** 
Book(s) entered so far: 0 

BUILD SUCCESSFUL (total time: 12 seconds) 


e 输出 上 面 显示 的 状态 ， 对 于 每 个 查询 不 同 状态 的 EJB 实 例 将 被 返 
e 只 适用 于 单个 会 话 状态 EJB 对 象 值 。 在 第 二 次 运行 时 ， 我 们 没有 得 到 任何 值 . 


EJB 持 久 性 - EJB 

EJB2.0 中 使 用 的 实体 bean 持 久 化 机 制 在 很 大 程度 上 被 EJB3.0 取 代 。 现 在 实体 bean 
是 一 个 简单 的 POJO 了 映射 表 。 

以 下 是 持久 性 API 的 关键 角色 
e Entity - 持久 对 象 代表 数据 存储 记录 。 这 也 是 可 序列 化 的 。 


。 EntityManager - 持久 性 接口 做 数据 操作 ， 如 添加 /删除 /更 新 /找到 持久 化 对 象 
(实体 ) 。 它 还 有 助 于 执行 查询 使 用 query 接 口 


e Persistence unit (persistence.xml) - 持久 性 单元 介绍 了 持久 性 机 制 的 属性 。 


。 Data Source (*ds.xml) - 数据 源 描述 了 数据 存储 相关 的 属性 ， 如 连接 URL。 用 
户 名 ， 密 码 等 。 


为 了 证 明 EJB 的 持久 化 机 制 ， 我 们 要 做 好 以 下 几 项 工作 。 
e Step 1. 在 数据 库 中 创建 表 . 
e Step 2. 创建 实体 类 对 应 的 表 . 
e Step 3. 创建 数据 源 和 持久 性 单元 
e Step 4. 创建 一 个 无 状态 EJB ai KEEA 


e Step 5. 更 新 无 状态 EJB。 添 加 添加 记录 并 获得 通过 实体 管理 器 从 数据 库 中 记录 
的 方法 。 


e Step 6. 一 个 基于 控制 台 应 用 程序 客户 端 料 访问 无 状态 EJB 的 持久 化 数据 库 中 的 
数据 。 


创建 表 
创建 一 个 表 books 在 默认 的 数据 库 postgres. 


CREATE TABLE books ( 
id integer PRIMARY KEY, 
name  varchar(50) 


): 


创建 实体 类 


//mark it entity using Entity annotation 
//map table name using Table annoation 
@Entity 

@Table(name="books" ) 

public class Book implements Serializable{ 


private int id; 
private String name; 


public Book(){ 
} 


//mark id as primary key with autogenerated value 
//map database column id with id field 
@Id 
QGeneratedValue(strategy- GenerationType. IDENTITY) 
@Column( name="id" ) 
public int getId() { 

return id; 


} 


创建 数据 源 和 持久 性 单元 
DataSource (jboss-ds.xml) 


<?xml version="1.0" encoding="UTF-8"?> 
<datasources> 
<local-tx-datasource> 
<jndi-name>PostgresDS</jndi-name> 
«connection-url»jdbc:postgresq1://localhost:5432/postgres«/c« 
<driver-class>org.postgresql.driver</driver-class> 
<user -name>sa</user -name> 
<password>sa</password> 
<min-pool-size>5</min-pool-size> 
<max-pool-size>20</max-pool-size> 
<idle-timeout -minutes>5</idle-timeout -minutes> 
</local-tx-datasource> 
</datasources> 


Ki = : 


Persistence Unit (persistence.xml) 





«persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persi: 
«persistence-unit name="EjbComponentPU" transaction-type="JTA"> 
<jta-data-source>java: /PostgresDS</jta-data-source> 
<exclude-unlisted-classes>false</exclude-unlisted-classes> 
<properties/> 
</persistence-unit> 
«persistence-unit name="EjbComponentPU2" transaction-type="JTA": 
<provider>org.hibernate.ejb.HibernatePersistence</provider> 
<jta-data-source>java: /PostgresDS</jta-data-source> 
<exclude-unlisted-classes>false</exclude-unlisted-classes> 
<properties> 
«property name-"hibernate.hbm2ddl.auto" value="update"/> 
</properties> 
</persistence-unit> 
</persistence> 


Fa 入 





Create Stateless EJB having EntityManager 
instance 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


//pass persistence unit to entityManager. 
QPersistenceContext(unitName-"EjbComponentPU") 
private EntityManager entityManager; 


public void addBook(Book book) { 


entityManager.persist(book); 
} 


public List<Book> getBooks() { 
return entityManager.createQuery("From Books").getResultListi 





构建 EJB 模 块 后 ， 我 们 需要 一 个 无 状态 的 bean， 我 们 将 在 下 一 节 要 创建 客户 端 来 访 
问 。 


示例 应 用 程序 


让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 EJB 的 持久 化 机 制 。 


Step 描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.entity as explained in the EJB - Create Application 

1 chapter. You can also use the project created in EJB - Create 
Application chapter as such for this chapter to understand ejb 
persistence concepts. 


2 Create Book.java under package com.tutorialspoint.entity and modify 
it as shown below. 


Create LibraryPersistentBean.java and LibraryPersistentBeanRemote 
3 as explained in the EJB - Create Application chapter and modify them 
as shown below. 


Create jboss-ds.xml in EjbComponent > setup folder and 

4 persistence.xml in EjbComponent > src > conf folder. These folder 
can be seen in files tab in Netbeans. Modify these files as shown 
above. 


5 清理 并 生成 应 用 程序 以 确保 业务 逻辑 是 按 要 求 工 作 。 


6 最 后 ， 将 应 用 程序 部 署 在 JBoss 应 用 服务 器 上 的 jar 文 件 的 形式 。 JBoss 
应 用 服务 器 将 自动 开始 浏览 网 页 ， 如 果 它 尚未 启动 。 


Now create the ejb client, a console based application in the same 
7 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. Modify it as shown below. 


EJBComponent (EJB Module) 


Book.java 


package com.tutorialspoint.entity; 


import java.io.Serializable; 

import javax.persistence.Column; 

import javax.persistence.Entity; 

import javax.persistence.EntityListeners; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Table; 


QEntity 
@Table(name="books") 
public class Book implements Serializable{ 


private int id; 
private String name; 


public Book(){ 
} 


@Id 
QGeneratedValue(strategy- GenerationType. IDENTITY) 
@Column( name="id" ) 
public int getId() { 
return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 


} 


LibraryPersistentBeanRemote.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 
import javax.ejb.Remote; 


@Remote 
public interface LibraryPersistentBeanRemote { 


void addBook(Book bookName) ; 


List<Book> getBooks(); 


LibraryPersistentBean.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Stateless; 

import javax.persistence.EntityManager; 
import javax.persistence.PersistenceContext; 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


public LibraryPersistentBean(){ 


} 


QPersistenceContext(unitName-"EjbComponentPU") 
private EntityManager entityManager; 


public void addBook(Book book) { 
entityManager.persist(book); 


j 


public List«Book» getBooks() ( 
return entityManager.createQuery("From Book").getResultList(: 


} 
} 


E O 


e As soon as you deploy the EjbComponent project on JBOSS, notice the jboss 
log. 





e JBoss has automatically created a JNDI entry for our session bean - 


LibraryPersistentBean/remote. 


e We'll using this lookup string to get remote business object of type - 


com.tutorialspoint.stateless.LibraryPersistentBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


16: 


16: 
16: 
16: 


30:01,401 INFO [JndiSessionRegistrarBase] Binding the followint 
LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Librai 
30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Librai 





EJBTester (EJB Client) 


jndi.properties 


java.naming.factory.initial-org.jnp.interfaces.NamingContextFactor 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 


| 


These properties are used to initialize the InitialContext object of java naming 
service 


InitialContext object will be used to lookup stateless session bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateless.LibraryPersistentBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 


import java.io.InputStreamReader ; 
import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 
import javax.naming.NamingException; 


public class EJBTester { 


BufferedReader brConsoleReader = null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testEntityEjb(); 
j 


private void showGUI(){ 

SVS Gel mollis: DIPL ESI SE c c E D 
System.out.println("Welcome to Book Store"); 
Sy StOnson PEE EXPL Seen te i E a ae 
System.out.print("Options 

1\. Add Book 

2N ECL: 

Enter Choice: "); 


} 


private void testEntityEjb(){ 


try { 
int choice = 1; 


LibraryPersistentBeanRemote libraryBean = 
LibraryPersistentBeanRemote)ctx.lookup("LibraryPersistentt 


while (choice != 2) { 


String bookName; 

ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName - brConsoleReader.readLine(); 
Book book - new Book(); 
book.setName(bookName) ; 
libraryBean.addBook(book); 

} else if (choice == 2) ( 


break; 

j 
j 
List«Book» booksList - libraryBean.getBooks(); 
System.out.println("Book(s) entered so far: " + booksList 
int i - 0; 
for (Book book:booksList) { 

System.out.println((i-1)-". " + book.getName( )); 

i++; 


} 

} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


} 
} catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester is doing the following tasks. 


e Load properties from jndi.properties and initialize the InitialContext object. 


e In testStatefulEjb() method, jndi lookup is done with name - 
"LibraryStatefulSessionBean/remote" to obtain the remote business object 
(stateful ejb). 


e Then user is shown a library store User Interface and he/she is asked to enter 
choice. 


e |f user enters 1, system asks for book name and saves the book using 
stateless session bean addBook() method. Session Bean is persisting the 
book in database via EntityManager call. 


e |f user enters 2, system retrieves books using stateful session bean 
getBooks() method and exits. 


e Then another jndi lookup is done with name - 
"LibraryStatelessSessionBean/remote" to obtain the remote business object 
(stateless ejb) again and listing of books is done. 


{TE P imiy |] EJB 


在 项 目 资源 管理 器 中 找到 EJBTester.java。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
炎炎 火炎 炎炎 火炎 炎炎 炎炎 类 火炎 炎炎 炎炎 火炎 大 


Welcome to Book Store 
*Wockckckockokockock kockock ko ck ko ck ck kk kkk 


Options 
1\. Add Book 
2 EXIT 


Enter Choice: 1 
Enter book name: Learn Java 
bp ko ckock ko ck ko ck ck kk kkk 


Welcome to Book Store 
*Wokckckockokockock kockock ck ck kock ko kk kkk 


Options 
1\. Add Book 
AN EXIT 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. learn java 

BUILD SUCCESSFUL (total time: 15 seconds) 


再 次 运行 客户 端 来 访问 EJB。 
访问 EJB 之 前 重新 启动 JBoss。 


在 项 目 资源 管理 器 中 找到 EJBTesterjava。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
KKEKKKKKKEKKKEKKKKKKKKKKE 


Welcome to Book Store 


和 和 


Options 
1\. Add Book 
2N EXI 


Enter Choice: 1 
Enter book name: Learn Spring 


*okckckck kck ko k ck k k kkkk kk k*k*k* 


Welcome to Book Store 


大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


Options 
1\. Add Book 
2N REGIE 


Enter Choice: 2 

Book(s) entered so far: 2 

1\. learn java 

2\. Learn Spring 

BUILD SUCCESSFUL (total time: 15 seconds) 


e 上 面 显 示 的 输出 状态 书 存 储 在 持久 性 存储 ， 并 从 数据 库 中 检索 。 


EJB 消 息 驱 动 Bean - EJB 
一 个 消息 驱动 bean 是 一 种 类 型 的 企业 Bean， 这 是 由 EJB 容 器 调用 ， 当 它 接 收 到 一 个 
消息 队列 或 主题 。 消息 驱动 bean 是 一 个 无 状态 的 bean 是 用 来 做 异步 任务 。 


为 了 演示 如 何 使 用 消息 驱动 bean， 我 们 将 利用 EJB 持 久 章 节 的 内 容 ， 我 们 要 做 好 以 
下 几 项 工作 。 


e Step 1. 在 数据 库 中 创建 表 ( 请 参阅 EJB 持 久 章节 )。 

e Step 2. 创建 实体 类 对 应 的 表 (请 参阅 EJB 持 久 章节 ). 

e Step 3. 创建 数据 源 和 持久 性 单元 (请 参阅 EJB 持 久 章节 ). 

e Step 4. 创建 一 个 无 状态 EJB EntityManager 实 例 (请 参阅 EJB 持 久 章 节 ). 


e Step 5. 更 新 无 状态 EJB。 添加 添加 记录 的 方法 ， 并 通 过 实体 管理 器 ， 从 数据 库 
中 获取 记录 (请 参阅 EJB 持 久 章 节 ). 


e Step 6. 创建 队列 名 为 BookQueue 在 JBoss default 应 用 目录 . 
e Step 7. 一 个 基于 控制 台 点 用 程序 客户 端 发 送 消息 到 这 个 队列 
e Step 8. 创建 消息 驱动 bean 将 使 用 无 状态 的 bean 持 久 化 客户 数据 。 


e Step 9. JBoss 的 EJB 容 器 将 调用 上 面 的 消息 驱动 bean， 并 把 它 传 递 的 消息 将 要 
发 送 给 客户 端 。 


创建 队列 


创建 一 个 文件 名 为 jbossmq 目 的 地 service.xml 中 ， 如 果 不 存 在 «JBoss Installation 
Folder> > server > default > deploy 目录 . 


在 这 里 ， 我 们 创建 名 为 BookQueue 一 个 队列 


jbossmq-destinations-service.xml 


«mbean code="org. jboss.mq.server.jmx.Queue" 
name="jboss.mq.destination: service=Queue, name=BookQueue"> 
«depends optional-attribute-name="DestinationManager'"> 

jboss.mq:service=DestinationManager 
</depends> 

</mbean> 


当 你 启动 JBoss， 你 会 看 到 类 似 的 内 容 在 JBoss 日 志 


10:37:06,167 INFO [QueueService] Queue[/queue/BookQueue] started, 


‘| LÁ 








创建 消息 驱动 bean 


@MessageDriven( 
name = "BookMessageHandler", 
activationConfig = { 
@ActivationConfigProperty( propertyName = "destinationType", 
propertyValue = "javax.jms.Queue" ` 
@ActivationConfigProperty( propertyName = "destination", 
propertyValue ="/queue/BookQueue" | 


} 


public class LibraryMessageBean implements MessageListener { 


@Resource 
private MessageDrivenContext mdctx; 


@EJB 
LibraryPersistentBeanRemote libraryBean; 


public LibraryMessageBean( ) { 
} 


public void onMessage(Message message) { 





e LibraryMessageBean annoatated@MessageDriven 注 解 ， 把 它 标记 为 消息 驱 
动 bean。 


e Its properties are defined as destinationType - Queue and destination - 
/queue/BookQueue. 


e It implements MessageListener interface which exposes onMessage method. 
e |t has MessgeDrivenContext as resource. 


e LibraryPersistentBeanRemote stateless bean is injected in this bean for 
persistence purpose. 


构建 EibComponent 项 目 ， 并 将 其 部 署 在 JBoss 上 。 构建 和 部 署 EJB 模 块 后 ， 我 们 需 
要 一 个 客户 端 发 送 一 个 消息 到 JBoss 队列 。 


示例 应 用 程序 
让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 消息 驱动 bean。 


Step Description 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.entity as explained in the EJB - Create Application 

1 chapter. You can also use the project created in EJB - Create 
Application chapter as such for this chapter to understand ejb 
persistence concepts. 


Create Book.java under package com.tutorialspoint.entity as created 


< in EJB-Persistence chapter 

3 Create LibraryPersistentBean.java and LibraryPersistentBeanRemote 
as created in EJB-Persistence chapter 
Create jboss-ds.xml in EjbComponent > setup folder and 

4 persistence.xml in EjbComponent > src > conf folder. These folder 
can be seen in files tab in Netbeans as created in EJB-Persistence 
chapter 

5 Create LibraryMessageBean.java under a package 
com.tutorialspoint. messagebean and modify it as shown below. 

6 Create BookQueue queue in Jboss as described above. 

7 Clean and Build the application to make sure business logic is working 


as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
8 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
9 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. Modify it as shown below. 


EJBComponent (EJB Module) 


LibraryMessageBean.java 


package com.tuturialspoint.messagebean; 


import com.tutorialspoint.entity.Book; 
import com.tutorialspoint.stateless.LibraryPersistentBeanRemote; 
import javax.annotation.Resource; 

import javax.ejb.ActivationConfigProperty; 
import javax.ejb.EJB; 

import javax.ejb.MessageDriven; 

import javax.ejb.MessageDrivenContext; 
import javax.jms.JMSException; 

import javax.jms.Message; 

import javax.jms.MessageListener; 

import javax.jms.ObjectMessage; 


@MessageDriven( 
name = "BookMessageHandler", 
activationConfig = { 
@ActivationConfigProperty( propertyName = "destinationType", 
propertyValue = "javax.jms.Queue" 
@ActivationConfigProperty( propertyName = "destination", 
propertyValue ="/queue/BookQueue" | 
} 


public class LibraryMessageBean implements MessageListener { 


@Resource 
private MessageDrivenContext mdctx; 


QEJB 
LibraryPersistentBeanRemote libraryBean; 


public LibraryMessageBean(){ 
} 


public void onMessage(Message message) { 
ObjectMessage objectMessage = null; 


try { 
objectMessage = (ObjectMessage) message; 
Book book = (Book) objectMessage.getObject(); 
libraryBean.addBook(book); 


) catch (JMSException ex) ( 
mdctx.setRollbackOnly(); 
j 


j 
Aoo t 


EJBTester (EJB Client) 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.entity.Book; 
import com.tutorialspoint.stateless.LibraryPersistentBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.jms.ObjectMessage; 

import javax.jms.Queue; 

import javax.jms.QueueConnection; 

import javax.jms.QueueConnectionFactory; 
import javax.jms.QueueSender; 

import javax.jms.QueueSession; 

import javax.naming.InitialContext; 
import javax.naming.NamingException; 


public class EJBTester { 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 
public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester .testMessageBeanEjb(); 
} 


private void showGUI(){ 
Sy SEen sou te nt 


System.out.println("Welcome to Book Store"); 
SyStensouts DII EL UE E LR EPI. 
System.out.print("Options 

1\. Add Book 

2NF REXI 

Enter Choice: "); 


} 


private void testMessageBeanEjb(){ 


try { 
int choice = 1; 
Queue queue = (Queue) ctx.lookup("/queue/BookQueue"); 
QueueConnectionFactory factory = 
(QueueConnectionFactory) ctx.lookup("ConnectionFactory"); 
QueueConnection connection = factory.createQueueConnectic 
QueueSession session = 
connection.createQueueSession(false, QueueSession.AUTO_ACH 
QueueSender sender = session.createSender (queue); 


while (choice != 2) { 
String bookName; 
ShowGUI(); 
String strChoice - brConsoleReader.readLine(); 
choice = Integer.parseInt(strChoice); 
if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
Book book = new Book(); 
book.setName(bookName) ; 
ObjectMessage objectMessage = 
session.createObjectMessage(book); 
sender.send(objectMessage); 
} else if (choice == 2) ( 
break; 
j 
j 


LibraryPersistentBeanRemote libraryBean - 
(LibraryPersistentBeanRemote) 
ctx.lookup("LibraryPersistentBean/remote"); 


List«Book» booksList = libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " + booksList 
int i = 0; 
for (Book book:booksList) { 

System.out.println((i-1)-*". " + book.getName()); 

i++; 


} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 


}finally { 
try { 
if(brConsoleReader !-null)( 
brConsoleReader.close(); 


} 
} catch (IOException ex) { 
System.out.println(ex.getMessage()); 








EJBTester 做 以 下 任务 。 
e。jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


e In testStatefulEjb() method, jndi lookup is done with name - 
"/queue/BookQueue" to obtain treference of queue available in Jboss. Then 
sender is created using queue session. 


e Then user is shown a library store User Interface and he/she is asked to enter 
choice. 


e |f user enters 1, system asks for book name and sender sends the book 
name to queue. When JBoss container receives this message in queue, it 
calls our message driven bean's onMessage method. Our message driven 
bean then saves book using stateful session bean addBook() method. 
Session Bean is persisting the book in database via EntityManager call. 


e |f user enters 2, then another jndi lookup is done with name - 
"LibraryStatefulSessionBean/remote" to obtain the remote business object 
(stateful ejb) again and listing of books is done. 


运行 客户 端 访 问 EJB 


Locate EJBTester.java in project explorer. Right click on EJBTester class and 
select run file. 


Verify the following output in Netbeans console. 


run: 
Wkckckckckckck ck kckckckckck ck kc ko ko ko ko 


Welcome to Book Store 


*ockckckck kck k ck k k k k kkkkkk*k*k* 


Options 
1\. Add Book 
2N RESI 


Enter Choice: 1 
Enter book name: Learn EJB 


*okckck ck kck k ck k k kk kkkkkk*k*k* 


Welcome to Book Store 


大 大 大 类 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


Options 
1\. Add Book 
2 Nie MENGE 


Enter Choice: 2 

Book(s) entered so far: 2 

1N. learn java 

1N. learn EJB 

BUILD SUCCESSFUL (total time: 15 seconds) 


上 面 显 示 的 输出 状态 ， 我 们 的 消息 驱动 bean 接 收 消息 和 存储 在 持久 性 存储 的 书 和 书 
籍 通过 数据 库 检 索 。 


EJB 注 解 /注释 - EJB 


在 Java 5.0 中 引入 的 注解 。 注 释 的 目的 是 要 重视 在 类 中 更 多 的 信息 或 元 数据 在 其 源 
代码 内 类 。 在 EJB 3.0 中 ， 注 释 是 用 来 描述 配置 元 数据 在 ejb 类 。 通 过 这 种 方式 ， 
EJB3.0 消 除了 需要 描述 在 XML 配 置 文件 中 的 配置 数据 。 


EJB 容 器 使 用 的 编译 器 工具 来 生成 所 需 的 工件 ， 如 接口 ， 部 署 描述 符 ， 通 过 阅读 


些 注释 。 下 面 列 出 的 常用 的 注解 。 


Sr. 

No. 名 称 

1 javax.ejb.Stateless 

2 javax.ejb.Stateful 

3 javax.ejb.MessageDrivenBean 


4 javax.ejb.EJB 


Ts 


描 


学 


指定 一 个 给 定 的 EJB 类 是 一 个 无 状 
态 会 话 bean. 属性 name - 用 于 指 
定 会 话 bean 的 名 称 。 
mappedName - 用 于 指定 的 会 话 
bean 的 JNDI 名 称 。 description - 
用 于 提供 会 话 bean 的 描述 。 


指定 一 个 给 定 的 EJB 类 是 有 状态 会 
话 bean。 属 性 name - 用 于 指定 会 
话 bean 的 名 称 。 mappedName - 
用 于 指定 的 会 话 bean 的 JNDI 名 
称 。 description - 用 于 提供 会 话 
bean 的 描述 。 


指定 一 个 给 定 的 EJB 类 是 消息 驱动 
的 Bean。 属 性 name - 用 于 指定 
消息 驱动 bean 的 名 称 。 
messageListenerlnterface - 消 
息 驱 动 bean 用 于 指定 消息 监听 器 
#20. activationConfig - 用 于 指 
定 的 配置 细节 ， 消 息 驱 动 Bean 消 
息 驱 动 bean 的 经 营 环 境 。 
mappedName - 用 于 指定 的 会 话 
bean 的 JNDI 名 称 。 description - 
用 于 提供 会 话 bean 的 描述 。 


用 于 指定 或 注入 到 另 一 个 EJB 的 
EJB 实 例 的 依赖 。 属 性 name - 用 
来 指定 将 被 使 用 的 环境 中 找到 引用 
的 bean 的 名 称 。 beanlnterface - 
用 于 指定 的 接口 类 型 引用 的 

bean。 beanName - 用 来 提供 引 
用 的 bean 的 名 称 。 

mappedName - 用 于 引用 bean 指 
定 的 JNDI 名 称 。 description - 用 


javax.ejb.Local 


javax.ejb.Remote 


javax.ejb.ActivationConfigProperty 


javax.ejb.PostActivate 


来 提供 引用 的 bean 的 描述 。 


用 于 指定 一 个 会 话 bean 的 本 地 接 
O CR) 。 这 个 本 地 接口 状态 会 话 
bean 的 业务 方法 (可 以 是 无 状态 
或 有 状态 ) 。 这 个 接口 是 用 来 以 暴 
露 本 地 客户 端 都 运行 在 相同 的 部 
署 /应 用 EJB 的 业务 方法 。 属性 
value - 用 于 指定 的 本 地 接口 列表 
接口 数组 。 


用 于 指定 一 个 会 话 bean 的 远程 接 
O CAR) 。 这 个 远程 接口 状态 会 话 
bean 的 业务 方法 (可 以 是 无 状态 
或 有 状态 ) 。 这 个 接口 是 用 来 揭露 
远程 客户 端 运 行 在 不 同 的 部 署 /应 
用 EJB 的 业务 方法 。 属 性 value - 
用 于 指定 远程 接口 接口 数组 列表 。 


用 于 指定 需要 消息 驱动 的 Bean 的 
属性 。 例 如 终止 点 ， 目 的 地 ， 消 息 
选择 等 。 这 个 注解 通过 作为 参数 ， 
activationConfig 属 性 
javax.ejb.MessageDrivenBean 注 
释 。 属 性 propertyName - 属性 名 
称 . propertyValue - 属性 值 . 


用 于 指定 EJB 的 生命 周期 的 回调 方 
法 。 这 种 方法 时 ， 将 调用 EJB 容 器 
刚刚 激活 /激活 bean 实 例 。 这 个 接 
口 是 用 来 以 暴露 本 地 客 户 端 都 运行 
在 相同 的 部 署 /应 用 EJB 的 业务 方 


e. 


EJB 回 调 - EJB 


回调 是 一 种 机 制 ， 可 以 截获 企业 Bean 的 生命 周期 。 EJB 3.0 规 范 指定 的 回调 ， 回 调 
处 理 方法 是 要 创建 。 EJB 容 器 调用 这 些 回 调 。 EJB 类 本 身 或 在 一 个 单独 的 类 ， 我 们 
可 以 定义 回调 方法 。 EJB3.0 提 供 了 许多 回调 的 注解 


以 下 是 无 状态 的 bean 回 调 的 注解 。 


Annotation 


@PostConstruct 


@PreDestroy 


method is invoked when a bean is created for the first time 


method is invoked when a bean is removed from the bean 
pool or is destroyed. 


Following is the list of callback annotations for stateful bean. 


Annotation 


@PostConstruct 


@PreDestroy 


@PostActivate 


@PrePassivate 


method is invoked when a bean is created for the first time 


method is invoked when a bean is removed from the bean 
pool or is destroyed. 


method is invoked when a bean is loaded to be used. 


method is invoked when a bean is put back to bean pool. 


Following is the list of callback annotations for message driven bean. 


Annotation 


@PostConstruct 


@PreDestroy 


描述 
method is invoked when a bean is created for the first time 


method is invoked when a bean is removed from the bean 
pool or is destroyed. 


Following is the list of callback annotations for entity bean. 


Annotation 


@PrePersist 


@PostPersist 


@PreRemove 


@PostRemove 


@PreUpdate 


@PostLoad 


示例 应 用 程序 


Description 


method is invoked when an entity is created in database. 


method is invoked after an entity is created in database. 


method is invoked when an entity is deleted from the 
database. 


method is invoked after an entity is deleted from the 
database. 


method is invoked before an entity is to be updated in the 
database. 


method is invoked when a record is fetched from database 
and loaded into the entity. 


让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 各 种 回调 EJB。 


Step 


描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.stateless as explained in the EJB - Create 
Application chapter. You can also use the project created in EJB - 
Persistence chapter as such for this chapter to add various callbacks 
to ejbs. 


Create LibrarySessionBean.java and LibrarySessionBeanRemote as 
explained in the EJB - Create Application chapter. Keep rest of the 
files unchanged. 


Use Beans created in the EJB - Persistence chapter. Add callback 
methods as shown below. Keep rest of the files unchanged. 


Create a java class BookCallbackListener under package 
com.tutorialspoint.callback. This class will demonstrates the 
seperation of callback methods. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. 


EJBComponent (EJB Module) 


BookCallbackListener.java 


package com.tutorialspoint.callback; 


import 
import 
import 
import 
import 
import 
import 
import 


public 


javax.persistence.PrePersist; 
javax.persistence.PostLoad; 
javax.persistence.PostPersist; 
javax.persistence.PostRemove; 
javax.persistence.PostUpdate; 
javax.persistence.PreRemove; 
javax.persistence.PreUpdate; 
com.tutorialspoint.entity.Book; 


class BookCallbackListener { 


@PrePersist 


public void prePersist(Book book) { 
System.out.println("BookCallbackListener.prePersist:" 
+ "Book to be created with book id: "+book.getId()); 


j 


@PostPersist 
public void postPersist(Object book){ 
System.out.println("BookCallbackListener.postPersist::" 
+ "Book created with book id: "+((Book)book).getId()); 


} 
@PreRemove 
public void preRemove(Book book) 
{ 
System.out.println("BookCallbackListener.preRemove:" 
+ " About to delete Book: " + book.getId()); 
j 
@PostRemove 
public void postRemove(Book book) 
{ 
System.out.println("BookCallbackListener.postRemove::" 
+ " Deleted Book: " + book.getId()); 
} 
@PreUpdate 
public void preUpdate(Book book) 
f 
System.out.println("BookCallbackListener.preUpdate::" 
+ " About to update Book: " + book.getId()); 
} 
@PostUpdate 
public void postUpdate(Book book) 
{ 
System.out.println("BookCallbackListener .postUpdate::" 
+ " Updated Book: " + book.getId()); 
j 
@PostLoad 
public void postLoad(Book book) 
{ 
System.out.println("BookCallbackListener.postLoad::" 
+ " Loaded Book: " + book.getId()); 
} 


Book.java 


package com.tutorialspoint.entity; 


import java.io.Serializable; 

import javax.persistence.Column; 

import javax.persistence.Entity; 

import javax.persistence.EntityListeners; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Table; 


QEntity 
@Table(name="books") 
public class Book implements Serializable{ 


private int id; 
private String name; 


public Book(){ 
} 


@Id 
QGeneratedValue(strategy- GenerationType. IDENTITY) 
@Column( name="id" ) 
public int getId() { 
return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 


} 


LibraryStatefulSessionBean.java 


package com.tutorialspoint.stateful; 


import java.util.ArrayList; 

import java.util.List; 

import javax.annotation.PostConstruct; 
import javax.annotation.PreDestroy; 


import javax.ejb.PostActivate; 
import javax.ejb.PrePassivate; 
import javax.ejb.Stateful; 


@Stateful 

public class LibraryStatefulSessionBean 
implements LibraryStatefulSessionBeanRemote { 
List<String> bookShelf; 


public LibraryStatefulSessionBean()( 
bookShelf = new ArrayList<String>(); 
} 


public void addBook(String bookName) { 
bookShelf.add(bookName); 
} 


public List<String> getBooks() { 
return bookShelf; 
} 


@PostConstruct 
public void postConstruct(){ 
System.out.println("LibraryStatefulSessionBean.postConstruct 
* " bean created."); 


j 


QPreDestroy 
public void preDestroy()( 
System.out.println("LibraryStatefulSessionBean.preDestroy:" 
* " bean removed."); 


j 


@PostActivate 
public void postActivate(){ 
System.out.println("LibraryStatefulSessionBean.postActivate:' 
* " bean activated."); 


} 


@PrePassivate 
public void prePassivate(){ 
System.out.println("LibraryStatefulSessionBean.prePassivate:' 
* " bean passivated."); 





LibraryStatefulSessionBeanRempote.java 


package com.tutorialspoint.stateful; 


import java.util.List; 
import javax.ejb.Remote; 


@Remote 

public interface LibraryStatefulSessionBeanRemote { 
void addBook(String bookName) ; 
List getBooks(); 


LibraryPersistentBean.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.annotation.PostConstruct; 
import javax.annotation.PreDestroy; 

import javax.ejb.Stateless; 

import javax.persistence.EntityManager ; 
import javax.persistence.PersistenceContext; 


@Stateless 
public class LibraryPersistentBean 
implements LibraryPersistentBeanRemote { 


public LibraryPersistentBean(){} 


QPersistenceContext(unitName-"EntityEjbPU") 
private EntityManager entityManager; 


public void addBook(Book book) { 
entityManager.persist(book); 
} 


public List<Book> getBooks() { 
return entityManager.createQuery("From Book") 
.getResultList(); 


j 


QPostConstruct 
public void postConstruct(){ 
System.out.println("postConstruct:: LibraryPersistentBean se: 
* " created with entity Manager object: "); 


j 


QPreDestroy 

public void preDestroy()( 
System.out.println("preDestroy: LibraryPersistentBean sessior 
* " bean is removed "); 





LibraryPersistentBeanRemote.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 
import javax.ejb.Remote; 


@Remote 
public interface LibraryPersistentBeanRemote { 


void addBook(Book bookName) ; 


List<Book> getBooks(); 


e 只 要 你 部 署 在 JBoss EjbComponent 项 目 ， 就 会 发 现 jboss 的 日 志 。 


e JBoss 已 经 自动 为 我 们 的 会 话 bean 创 建 一 个 JNDI 条 目 - 
LibraryPersistentBean/remote. 


e. 我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.stateless.LibraryPersistentBeanRemote 


JBoss 应 用 服务 器 的 日 志 $ tH 


16:30:01,401 INFO [JndiSessionRegistrarBase] Binding the followint 
LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Librai 
16:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 





<] _ Em 


EJBTester (EJB Client) 


jndi.properties 


java.naming.factory.initial-org.jnp.interfaces.NamingContextFactor 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 


El = BR | 
这 些 属性 是 用 来 初始 化 InitialContext 对 象 的 Java 命 名 服务 








e InitialContext 的 对 象 籽 被 用 于 查找 无 状态 会 话 bean 
EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.LibrarySessionBeanRemote; 
import java.io.BufferedReader ; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester { 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testEntityEjb(); 
j 


private void showGUI(){ 
Sy SEO OLE DE dE Ds ser sonst noc AMD E 
System.out.println("Welcome to Book Store"); 
Systemsotbsprdht bn d tesis ea t no tenete 
System.out.print("Options 
1\. Add Book 
2N. Exit 


Enter Choice: "); 


} 
private void testEntityEjb(){ 

try { 

int choice = 1; 

LibraryPersistentBeanRemote libraryBean = 

(LibraryPersistentBeanRemote) 

ctx.lookup("LibraryPersistentBean/remote"); 

while (choice != 2) { 

String bookName; 

ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice -- 1) ( 
System.out.print("Enter book name: "); 
bookName - brConsoleReader.readLine(); 
Book book - new Book(); 
book.setName (bookName) ; 
libraryBean.addBook(book); 

) else if (choice -- 2) ( 
break; 

} 

} 

List<Book> booksList = libraryBean.getBooks(); 

System.out.println("Book(s) entered so far: " + booksList.si: 

int i = 0; 

for (Book book:booksList) { 
System.out.printin((it+i)+". " + book.getName()); 
i++; 

} 

} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try ( 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 
) catch (IOException ex) { 
System.out.println(ex.getMessage()); 
} 
} 
} 








EJBTester is doing the following tasks. 


Load properties from jndi.properties and initialize the InitialContext object. 


In testStatelessEjb() method, jndi lookup is done with name - 
"LibrarySessionBean/remote" to obtain the remote business object (stateless 
ejb). 


Then user is shown a library store User Interface and he/she is asked to enter 
choice. 


If user enters 1, system asks for book name and saves the book using 
stateless session bean addBook() method. Session Bean is storing the book 
in the database. 


If user enters 2, system retrieves books using stateless session bean 
getBooks() method and exits. 


运行 客户 新 访问 EJB 


在 项 目 资源 管理 器 中 找到 EJBTester.java。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 


file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
okckckckckckckck kckckckckck kckc ko ko ko k 


Welcome to Book Store 


大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


Options 
1\. Add Book 
2\. Exit 


Enter Choice: 1 


Enter book name: Learn Java 
大 类 炎炎 炎炎 炎炎 炎炎 炎炎 炎炎 火炎 火炎 火 火 类 类 


Welcome to Book Store 
Wockckockockockockock KKK ko ck ck ck ck kk kkk 


Options 
1\. Add Book 
2N REXI 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. Learn Java 

BUILD SUCCESSFUL (total time: 13 seconds) 


JBoss 应 用 服务 器 的 日 志 输 


你 可 以 找到 以 下 的 回调 在 JBoss 日 志 项 


14:08:34,293 INFO 


16:39:09,484 INFO 
16:39:09,531 INFO 
16:39:09,900 INFO 


[STDOUT] postConstruct:: LibraryPersistentBean : 


[STDOUT] BookCallbackListener.prePersist:: Book 
[STDOUT] BookCallbackListener.postPersist:: Bool 
[STDOUT] BookCallbackListener.postLoad:: Loaded 


Se | 








EJB 定 时 器 服务 - EJB 


定时 器 服务 使 用 计划 应 用 程序 可 以 建立 一 个 机 制 。 例 如 ， 每 月 1 日 的 工资 单 生 成 。 
EJB3.0 规 范 指定 超时 注释 ， 这 有 助 于 编程 一 个 无 状态 或 消息 驱动 Bean 的 EJB 服 务 。 
EJB 容 器 调用 的 方法 ， 这 是 注释 @Timeout. 

EJB 计 时 器 服务 是 有 助 于 创造 的 定时 器 ， 并 安排 回调 计时 器 到 期 时 由 EJB 容 器 提供 
的 服务 。 


创建 定时 器 的 步骤 
使 用 @ Resource 注 解 注 入 SessionContext 的 bean 


@Stateless 
public class TimerSessionBean { 


@Resource 
private SessionContext context; 


使 用 SessionContext 对 象 TimerService 创 造 定 时 器 的 。 传 递 时 间 (以 毫秒 为 单位 ) 
和 消息 。 


public void createTimer(long duration) { 
context.getTimerService().createTimer(duration, "Hello World!"), 


} 
Aoo: AER 


使 用 定时 器 的 步 又 


使 用 @Timeout 批 注 的 方法 。 返 回 类 型 必须 为 void， 并 传递 一 个 参数 类 型 的 定时 
器 。 我 们 取消 计时 器 后 第 一 次 执行 ， 否 则 将 继续 运行 ， 修 正 后 的 时 间 间 隔 。 


@Timeout 

public void timeOutHandler(Timer timer) { 
System.out.println("timeoutHandler : " + timer.getInfo()); 
timer .cancel(); 


} 
n = 











示例 应 用 程序 


让 我 们 创建 一 个 测试 测试 计时 器 服务 在 EJB 的 EJB 应 用 程序 中 。 


Step 描述 
Create a project with a name EjbComponent under a package 

1 com.tutorialspoint.timer as explained in the EJB - Create Application 
chapter. 


Create TimerSessionBean.java and TimerSessionBeanRemote as 
2 explained in the EJB - Create Application chapter. Keep rest of the 
files unchanged. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
4 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
5 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. 


EJBComponent (EJB Module) 


TimerSessionBean.java 


package com.tutorialspoint.timer; 


import javax.annotation.Resource; 
import javax.ejb.SessionContext; 
import javax.ejb.Timer; 

import javax.ejb.Stateless; 
import javax.ejb.Timeout; 


@Stateless 
public class TimerSessionBean implements TimerSessionBeanRemote { 


@Resource 
private SessionContext context; 


public void createTimer(long duration) { 
context.getTimerService().createTimer(duration, "Hello World 


} 


@Timeout 

public void timeOutHandler(Timer timer) { 
System.out.println("timeoutHandler : " + timer.getInfo()); 
timer .cancel(); 





TimerSessionBeanRemote.java 


package com.tutorialspoint.timer; 
import javax.ejb.Remote; 
@Remote 


public interface TimerSessionBeanRemote { 
public void createTimer(long milliseconds); 


} 


e 一 旦 你 在 Jboss 应 用 服务 器 部 署 EjbComponent 项 目 ， 发 现 jboss 日 志 。 


e JBoss 已 经 自动 为 我 们 的 会 话 bean 创 建 一 个 JNDI 条 目 - 
TimerSessionBean/remote. 


。 我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.timer. TimerSessionBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


16:30:01,401 INFO [JndiSessionRegistrarBase] Binding the followint 
TimerSessionBean/remote - EJB3.x Default Remote Business Interf: 
TimerSessionBean/remote-com.tutorialspoint.timer.TimerSessionBe: 
16:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint. | 


«| Te 








EJBTester (EJB Client) 
jndi.properties 


java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 


-| E 
e 这 些 属 性 是 用 来 初始 化 InitialContext 对 象 的 Java 命 名 服务 
e |nitialContext 对 象 业 被 用 于 查找 无 状态 会 话 bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.TimerSessionBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 


try { 
props.load(new FileInputStream("jndi.properties")); 


) catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testTimerService(); 


j 


private void showGUI(){ 
Svstemnzoucc prime TMOA ee a ee MN c stmt ue 
System.out.println("Welcome to Book Store"); 
System out Print Ima 3 
System.out.print("Options 
1N. Add Book 


2\. Exit 
Enter Choice: "); 
} 
private void testTimerService(){ 
try { 


TimerSessionBeanRemote timerServiceBean = (TimerSessionBe: 


System.out.println("["-(new Date()).toString()+ "]" + "tir 
timerServiceBean.createTimer (2000); 


) catch (NamingException ex) { 
ex.printStackTrace(); 





EJBTester 做 以 下 任务 。 


e。jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


e 在 testTimerService () 方法 ， 名 字 完 成 JNDI 查 找 - 
“TimerSessionBean/remote”， 以 获得 远程 业务 对 象 (定时 器 无 状态 EJB) 。 


e 然后 的 调用 createTimer 通 过 预定 时 间 为 2000 毫 秒 。 


e 2 秒 后 EJB 容 器 调用 timeoutHandler， 方法。 


i5 (128 P imig i] EJB 
在 项 目 资源 管理 器 中 找到 EJBTester.java。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验 证 以 下 输出 。 


run: 
[Wed Jun 19 11:35:47 IST 2013]timer created. 
BUILD SUCCESSFUL (total time: 0 seconds) 


JBoss 应 用 服务 器 的 日 志 AE 


你 可 以 找到 以 下 的 回调 在 JBoss 日 志 项 


11:35:49,555 INFO [STDOUT] timeoutHandler : Hello World! 


EJB 依 赖 注入 - EJB 
EJB 3.0 规 范 提供 了 注释 字段 或 setter 方 法 注入 依赖 可 以 应 用 。 EJB 容器 使 用 的 全 局 
JNDI 注 册 表 定位 的 依赖 。 以 下 注解 在 EJB 3.0 中 使 用 依赖 注入 。 

e (QEJB - 用 来 注入 其 他 EJB 引 用 。 


e @Resource - 用 于 注入 数据 源 或 单 例 服务 ， 如 sessionContext，timerService 
等 


@EJB 使 用 步骤 
@EJB 可 以 使 用 栏 位 或 以 下 方式 的 方法 。 


public class LibraryMessageBean implements MessageListener { 
//dependency injection on field. 
@EJB 
LibraryPersistentBeanRemote libraryBean; 


public class LibraryMessageBean implements MessageListener { 
LibraryPersistentBeanRemote libraryBean; 
//dependency injection on method. 
QEJB(beanName-"com.tutorialspoint.stateless.LibraryPersistentBe: 
public void setLibraryPersistentBean( 
LibraryPersistentBeanRemote libraryBean) 


this.libraryBean - libraryBean; 





@Resource 使 用 步 又 


@Resource 通常 用 于 注入 EJB 容 器 提供 单 例 。 


public class LibraryMessageBean implements MessageListener { 
@Resource 
private MessageDrivenContext mdctx; 


示例 应 用 程序 


让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 EJB 服 务 的 依赖 注入 。 


Step Description 
Create a project with a name EjbComponent under a package 

1 com.tutorialspoint.timer as explained in the EJB - Create Application 
chapter. 


Use Beans created in the EJB - Message Driven Bean chapter. Keep 
rest of the files unchanged. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
6 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
yh way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. 


EJBComponent (EJB Module) 


LibraryMessageBean.java 


package com.tuturialspoint.messagebean; 


import com.tutorialspoint.entity.Book; 
import com.tutorialspoint.stateless.LibraryPersistentBeanRemote; 
import javax.annotation.Resource; 

import javax.ejb.ActivationConfigProperty; 
import javax.ejb.EJB; 

import javax.ejb.MessageDriven; 

import javax.ejb.MessageDrivenContext; 
import javax.jms.JMSException; 

import javax.jms.Message; 

import javax.jms.MessageListener; 

import javax.jms.ObjectMessage; 


@MessageDriven( 
name = "BookMessageHandler", 
activationConfig = { 
@ActivationConfigProperty( propertyName = "destinationType", 
propertyValue = "javax.jms.Queue" 
@ActivationConfigProperty( propertyName = "destination", 
propertyValue ="/queue/BookQueue" | 
} 


public class LibraryMessageBean implements MessageListener { 


@Resource 
private MessageDrivenContext mdctx; 


QEJB 
LibraryPersistentBeanRemote libraryBean; 


public LibraryMessageBean(){ 
} 


public void onMessage(Message message) { 
ObjectMessage objectMessage = null; 


try { 
objectMessage = (ObjectMessage) message; 
Book book = (Book) objectMessage.getObject(); 
libraryBean.addBook(book); 


) catch (JMSException ex) ( 
mdctx.setRollbackOnly(); 
j 


j 
Rb | 


EJBTester (EJB Client) 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.entity.Book; 
import com.tutorialspoint.stateless.LibraryPersistentBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.jms.ObjectMessage; 

import javax.jms.Queue; 

import javax.jms.QueueConnection; 

import javax.jms.QueueConnectionFactory; 
import javax.jms.QueueSender; 

import javax.jms.QueueSession; 

import javax.naming.InitialContext; 
import javax.naming.NamingException; 


public class EJBTester { 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 
public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester .testMessageBeanEjb(); 
} 


private void showGUI(){ 
Sy SEen sou te nt 


System.out.println("Welcome to Book Store"); 
SyStensouts DII EL UE E LR EPI. 
System.out.print("Options 

1\. Add Book 

2NF REXI 

Enter Choice: "); 


} 


private void testMessageBeanEjb(){ 


try { 
int choice = 1; 
Queue queue = (Queue) ctx.lookup("/queue/BookQueue"); 
QueueConnectionFactory factory = 
(QueueConnectionFactory) ctx.lookup("ConnectionFactory"); 
QueueConnection connection = factory.createQueueConnectic 
QueueSession session = connection.createQueueSession( 
false, QueueSession.AUTO_ACKNOWLEDGE ) ; 
QueueSender sender = session.createSender (queue); 


while (choice != 2) { 

String bookName; 

ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
Book book = new Book(); 
book.setName(bookName) ; 
ObjectMessage objectMessage - 
session.createObjectMessage(book); 
sender.send(objectMessage); 

} else if (choice == 2) ( 
break; 

j 


j 


LibraryPersistentBeanRemote libraryBean - 
(LibraryPersistentBeanRemote) 
ctx.lookup("LibraryPersistentBean/remote"); 


List«Book» booksList - libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " 

* booksList.size()); 

int i - 0; 

for (Book book:booksList) ( 
System.out.println((i-1)-*". " + book.getName( )); 
i++; 


} catch (Exception e) { 
System.out.println(e.getMessage()); 


e.printStackTrace(); 
}finally { 
try { 
if(brConsoleReader !-null)( 
brConsoleReader.close(); 


} 
} catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester 做 以 下 任务 。 


e。jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


e JNDI 查 找 testStatefulEjb () 方法 ， 完 成 了 名 字 - /queue/BookQueue" 在 
JBoss 获得 参考 。 发 件 人 使 用 队列 会 话 创建 。 


e 然后 用 户 显示 一 个 库存 储 的 用 户 界面 和 他 /她 被 要 求 输 入 选择 。 


e 如 果 用 户 输 入 1， 系 统 要 求 输 入 书籍 名 称 和 发 件 人 发 送 本 书 的 名 字 来 排队 。 当 
JBoss 容器 接收 到 这 个 消息 队列 ， 它 会 调用 我 们 的 消息 驱动 bean 的 onMessage 
方法 。 消 息 驱 动 bean 保 存 使 用 状态 会 话 bean addBook () 方法 的 书 。 会 话 
Bean 持 久 化 这 本 书 中 通过 EntityManager 调 用 数据 库 。 


e 如 果 用 户 输 入 2， 然 后 是 另 一 个 JNDI 查 找 名 字 - 
“LibraryStatefulSessionBean/remote" 获 取 远 程 业 务 对 象 (状态 EJB) 再 次 上 市 
的 书籍 完成 。 


iE 1729 P limi EJB 


在 项 目 资 源 管理 器 中 找到 EJBTester.java。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
KKEKKKKKKEKKKEKKKKKKKKKKE 


Welcome to Book Store 


和 和 


Options 
1\. Add Book 
2N EXI 


Enter Choice: 1 
Enter book name: Learn EJB 


*okckckck ck ck k k ck k kk kkkkkk*k*k* 


Welcome to Book Store 
*ockckckockockockock ko ckock ko ck ko ck ck kk kk ke 


Options 
1\. Add Book 
2N REGIE 


Enter Choice: 2 

Book(s) entered so far: 2 

1\. learn java 

1N. learn EJB 

BUILD SUCCESSFUL (total time: 15 seconds) 


。 输出 上 面 显 示 说 我 们 的 消息 驱动 bean 接 收 消息 和 持久 性 存储 和 书籍 从 数据 库 中 
检索 存储 本 书 。 


e 我 们 的 消息 驱动 bean 被 使 用 LibraryPersistentBean 使 用 @ EJB 注 释 注 入 的 情 ; 
下 例外 MessageDrivenContext 对 象 用 于 回 滚 事务 。 


EJB} & - EJB 


EJB3.0 提 供 了 拦截 业务 方法 的 规范 使 用 @ Aroundlnvoke 注 释 注释 的 方法 调用 。 一 
个 拦截 器 方法 被 称 为 包含 EJBContainer 的 业务 方法 调用 前 拦截 。 下 面 的 例子 是 一 个 
拦截 器 方法 签名 


QAroundInvoke 
public Object methodInterceptor(InvocationContext ctx) throws Exce[ 
{ 
System.out.println("*** Intercepting call to LibraryBean method 
+ ctx.getMethod().getName()); 
return ctx.proceed(); 





拦截 器 方法 可 以 应 用 在 三 个 层面 上 的 约束 


e Default - 默认 的 拦截 器 被 调用 内 deployment.Default 拦 截 每 个 bean 只 能 应 用 于 
通过 XML (ejb-jar.xml) 。 


e Class - 类 级 别 拦截 所 有 的 bean 的 方法 被 调用 。 类 级 别 拦截 器 可 以 应 用 通过 
XML 注释 (ejb-jar.xml) 。 


e Method - 方法 级 别 的 拦截 器 是 一 个 特定 的 bean 的 方法 调用 。 方 法 级 的 拦截 器 
可 以 应 用 通过 XML 注释 (ejb-jarxml) 。 


我 们 在 这 里 讨论 类 级 别 拦截 。 


Interceptor class 


package com.tutorialspoint.interceptor; 


import javax.interceptor.AroundInvoke; 
import javax.interceptor.InvocationContext; 


public class BusinessInterceptor { 
QAroundInvoke 
public Object methodInterceptor(InvocationContext ctx) throws E» 
1 
System.out.println("*** Intercepting call to LibraryBean mett 
+ ctx.getMethod().getName()); 
return ctx.proceed(); 
} 
} 








al 





Remote Interface 


import javax.ejb.Remote; 


@Remote 

public interface LibraryBeanRemote { 
//add business method declarations 

} 


Intercepted Stateless EJB 


@Interceptors ({BusinessInterceptor.class}) 

@Stateless 

public class LibraryBean implements LibraryBeanRemote { 
//implement business method 

} 


示例 应 用 程序 
让 我 们 创建 一 个 测试 测试 截获 的 无 状态 EJB 的 EJB 应 用 程序 。 


Step 描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.interceptor_as explained in the _EJB - Create 

1 Application chapter. You can also use the project created inEJB - 
Create Application chapter as such for this chapter to understand 
intercepted ejb concepts. 


Create LibraryBean.java and LibraryBeanRemote under 
2 packagecom.tutorialspoint.interceptor as explained in the EJB - 
Create Application chapter. Keep rest of the files unchanged. 


3 Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
4 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
5 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. 


EJBComponent (EJB Module) 


LibraryBeanRemote.java 


package com.tutorialspoint.interceptor; 


import java.util.List; 
import javax.ejb.Remote; 


@Remote 

public interface LibraryBeanRemote { 
void addBook(String bookName) ; 
List getBooks(); 


LibraryBean.java 


package com.tutorialspoint.interceptor; 


import java.util.ArrayList; 

import java.util.List; 

import javax.ejb.Stateless; 

import javax.interceptor.Interceptors; 


@Interceptors ({BusinessInterceptor.class}) 
@Stateless 
public class LibraryBean implements LibraryBeanRemote { 


List<String> bookShelf; 


public LibraryBean(){ 
bookShelf = new ArrayList<String>(); 


} 


public void addBook(String bookName) { 
bookShelf .add(bookName) ; 


} 


public List<String> getBooks() { 
return bookShelf; 


} 


e 只 要 你 部 署 在 JBoss EjbComponent 项 目 ， 会 注意 到 jboss 的 日 志 。 
e JBoss 已 经 自动 为 我 们 的 会 话 bean 创 建 一 个 JNDI 条 目 - LibraryBean/remote. 


e. 我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.interceptor.LibraryBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


‘| 


16: 
16: 


16: 
16: 


30:01,401 INFO [JndiSessionRegistrarBase] Binding the followin 
LibraryBean/remote - EJB3.x Default Remote Business Interface 

LibraryBean/remote-com.tutorialspoint.interceptor.LibraryBeanRer 
30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
30:02,731 INFO [JndiSessionRegistrarBase] Binding the followin 


LibraryBean/remote - EJB3.x Default Remote Business Interface 
LibraryBean/remote-com.tutorialspoint.interceptor.LibraryBeanRer 


EET ^] 








EJBTester (EJB Client) 


jndi.properties 


一 了 了 了 
文 些 属性 是 用 来 初始 化 InitialContext 对 象 的 Java 命 名 服务 


e 这 


java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 





elnitialContext 的 对 象 将 被 用 于 查找 无 状态 会 话 bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.LibraryBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 


props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
j 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testInterceptedEjb(); 
j 


private void showGUI(){ 

SV SCCM out rt oak us Ra E qat 
System.out.println("Welcome to Book Store"); 
System out DIE rt. purée Si e UP Su re 
System.out.print("Options 

1\. Add Book 

2\. Exit 

Enter Choice: "); 


} 


private void testInterceptedEjb(){ 


try ( 
int choice = 1; 


LibraryBeanRemote libraryBean = 
LibraryBeanRemote)ctx.lookup("LibraryBean/remote"); 


while (choice != 2) { 

String bookName; 

ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parselInt(strChoice); 

if (choice -- 1) ( 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
Book book - new Book(); 
book.setName(bookName) ; 
libraryBean.addBook(book); 

} else if (choice == 2) { 


break; 


} 
} 
List<Book> booksList = libraryBean.getBooks(); 
System.out.println("Book(s) entered so far: " + booksList 
int i = 0; 
for (Book book:booksList) { 

System.out.println((i-1)-*". " + book.getName()); 

i++; 


} 

} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


} 
} catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester 做 以 下 任务 。 


e。jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


e JNDI 查 找 testlnterceptedEjb () 方法 ， 完 成 了 名 称 - "LibraryBean/remote"3& 
得 远程 业务 对 象 无 状态 EJB) 。 


e 如 果 用 户 输入 1， 系 统 要 求 输 入 书籍 名 称 和 节约 使 用 无 状态 的 会 话 bean 
addBook () 方法 的 书 。 会 话 Bean 存 储 在 它 的 实例 变量 的 书 。 


e 如 果 用 户 输 入 2， 系 统 检 索 书 使 用 状态 会 话 Bean getBooks () 方法 和 退出 。 


Run Client to access EJB 


在 项 目 资源 管理 器 中 找到 EJBTester.java。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
okckckckckckck ck kckckckckck kc kck ko ko k 


Welcome to Book Store 


*okckckck kck k ck k ck kk kk kk ke k*kk* 


Options 
1\. Add Book 
2 EXE 


Enter Choice: 1 
Enter book name: Learn Java 
Wok kockc ck kok Rock ck AXok k k k kk kkokXk 


Welcome to Book Store 


*ockckckck kck k ck k ck kk kkk kk k*kk* 


Options 
1\. Add Book 
2 EX 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. Learn Java 

BUILD SUCCESSFUL (total time: 13 seconds) 


JBoss 应 用 服务 器 的 日 志 输 
验证 下 面 的 输出 在 JBoss 应 用 服务 器 的 日 志 输 出 。 


09:55:40,741 INFO [STDOUT] *** Intercepting call to LibraryBean me 
09:55:43,661 INFO [STDOUT] *** Intercepting call to LibraryBean me 





EJBERA 128 -EJB 


EJB 3.0 中 提供 了 选项 人 散人 入 到 实体 bean 的 Java POJO (普通 Java 对 象 ) MRAR 
POJO 类 的 方法 允许 列 名 映射 。 骨 入 一 个 java 的 POJO 必 须 定 义 了 @ Embeddable 注 
解 。 


@Embeddable 

public class Publisher implements Serializable{ 
private String name; 
private String address; 


上 面 的 类 可 以 使 用 @ Embedded 批注 嵌入 


@Entity 

public class Book implements Serializable( 
private int id; 
private String name; 
private Publisher publisher; 


@Embedded 
@AttributeOverrides({ 
@AttributeOverride(name = "name", 
column = @Column(name = "PUBLISHER")), 
@AttributeOverride(name = "address", 


column = @Column(name = "PUBLISHER ADDRESS"): 


}) 
public Publisher getPublisher() { 
return publisher; 





示例 应 用 程序 


让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 EJB 3.0 中 的 族人 对 象 。 


Step 描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.entity as explained in the EJB - Create Application 

1 chapter. Please use the project created in EJB - Persistence chapter 
as such for this chapter to understand embedded objects in ejb 
concepts. 


Create Publisher.java under package com.tutorialspoint.entity as 
2 explained in the EJB - Create Application chapter. Keep rest of the 
files unchanged. 


Create Book.java under package com.tutorialspoint.entity. Use EJB - 
Persistence chapter as reference. Keep rest of the files unchanged. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
5 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
6 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. 


Create/Alter book table 


CREATE TABLE book ( 
id integer PRIMARY KEY, 
name varchar (50) 
); 
Alter table book add publisher varchar(100); 
Alter table book add publisher address varchar(200); 


EJBComponent (EJB Module) 


Publisher.java 


package com.tutorialspoint.entity; 


import java.io.Serializable; 
import javax.persistence.Embeddable; 


@Embeddable 
public class Publisher implements Serializable{ 


private String name; 
private String address; 


public Publisher() {} 


public Publisher(String name, String address) { 
this.name = name; 
this.address = address; 


} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 
j 


public String getAddress() ( 
return address; 
} 


public void setAddress(String address) { 
this.address = address; 
} 


public String toString(){ 
return name + "," + address; 
} 


Book.java 


package com.tutorialspoint.entity; 


import com.tutorialspoint.callback.BookCallbackListener; 
import java.io.Serializable; 

import javax.persistence.AttributeOverride; 

import javax.persistence.AttributeOverrides; 

import javax.persistence.Column; 


import javax.persistence.Embedded; 

import javax.persistence.Entity; 

import javax.persistence.EntityListeners; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Table; 


QEntity 
@Table(name="book" ) 
public class Book implements Serializable{ 


private int id; 
private String name; 
private Publisher publisher; 


public Book(){ 
} 


@Id 
QGeneratedValue(strategy- GenerationType.IDENTITY) 
@Column( name="id" ) 
public int getId() { 
return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 


} 
@Embedded 
@AttributeOverrides({ 
@AttributeOverride(name = "name", 
column = @Column(name = "PUBLISHER")), 
@AttributeOverride(name = "address", 
column = @Column(name = "PUBLISHER ADDRESS")) 
3) 


public Publisher getPublisher() { 
return publisher; 


j 


public void setPublisher(Publisher publisher) { 
this.publisher - publisher; 
j 


上 


L 


ibraryPersistentBeanRemote.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 
import javax.ejb.Remote; 


@Remote 
public interface LibraryPersistentBeanRemote { 


void addBook(Book bookName) ; 


List<Book> getBooks(); 


ibraryPersistentBean.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Stateless; 

import javax.persistence.EntityManager ; 
import javax.persistence.PersistenceContext; 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


public LibraryPersistentBean(){ 


} 


QPersistenceContext(unitName-"EjbComponentPU") 
private EntityManager entityManager; 


public void addBook(Book book) { 
entityManager.persist(book); 


j 


public List«Book» getBooks() ( 
return entityManager.createQuery("From Book").getResultList(: 


j 











e 一 旦 你 部 署 EjbComponent 项 目 在 Jboss 应 用 服务 器 ， 发 现 jboss 的 日 志 。 


e JBoss 已 经 自动 为 我 们 的 会 话 bean 创 建 一 个 JNDI 和 人 口 - 
LibraryPersistentBean/remote. 


e. 我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.interceptor.LibraryPersistentBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


16:30:01,401 INFO [JndiSessionRegistrarBase] Binding the followint 
LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.interceptor.Libi 
16:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
16:30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.interceptor.Libi 





El — B 
EJBTester (EJB Client) 
jndi.properties 


java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 


do RI 
e 这 些 属 性 是 用 来 初始 化 InitialContext 对 象 的 Java 命 名 服务 
elnitialContext 的 对 象 将 被 用 于 查找 无 状态 会 话 bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.LibraryBeanRemote; 
import java.io.BufferedReader ; 
import java.io.FileInputStream; 


import java.io.IOException; 

import java.io.InputStreamReader; 
import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 
import javax.naming.NamingException; 


public class EJBTester { 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties") ); 
) catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testEmbeddedObjects(); 
j 


private void showGUI(){ 

System ouit PRIMEN S sept rue entes ICN: 
System.out.println("Welcome to Book Store"); 
System out rn et ee tcr sis i eR RON yrs 
System.out.print("Options 

1\. Add Book 

2A Ex 

Enter Choice: "); 


j 


private void testEmbeddedObjects(){ 


try { 
int choice = 1; 


LibraryPersistentBeanRemote libraryBean = 
(LibraryPersistentBeanRemote) 
ctx.lookup("LibraryPersistentBean/remote"); 


while (choice != 2) { 

String bookName; 

String publisherName; 

String publisherAddress; 

showGUI(); 

String strChoice = brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
System.out.print("Enter publisher name: "); 
publisherName = brConsoleReader.readLine(); 
System.out.print("Enter publisher address: "); 
publisherAddress = brConsoleReader.readLine(); 
Book book = new Book(); 
book.setName(bookName) ; 
book.setPublisher 
(new Publisher (publisherName, publisherAddress) ); 


libraryBean.addBook(book); 


) else if (choice == 2) { 
break; 
} 


} 
List<Book> booksList = libraryBean.getBooks(); 
System.out.println("Book(s) entered so far: " + booksList 


int i - 0; 
for (Book book:booksList) ( 


System.out.println((i-1)-*". " + book.getName( )); 
System.out.println("Publication: "-«book.getPublisher(): 
i++; 


} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


) catch (IOException ex) ( 
System.out.println(ex.getMessage()); 
} 


E 
«| = 











EJBTester 做 以 下 任务 。 


jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


In testInterceptedEjb() method, jndi lookup is done with name - 
"LibraryPersistenceBean/remote" to obtain the remote business object 
(stateless ejb). 


e Then user is shown a library store User Interface and he/she is asked to enter 
choice. 


If user enters 1, system asks for book name and saves the book using 
stateless session bean addBook() method. Session Bean is storing the book 
in database. 


If user enters 2, system retrives books using stateless session bean 
getBooks() method and exits. 


ITE P imig jp) EJB 
在 项 目 资源 管理 器 中 找到 EJBTesterjava。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 


*ockckckck kck k k k k kk kkkk ke k*k*k* 


Welcome to Book Store 


*okckck ck kck k k ck ck kk kkkkkk*k*k* 


Options 
1\. Add Book 
2 aE ae 


Enter Choice: 1 

Enter book name: learn html5 
Enter publisher name: SAMS 
Enter publisher address: DELHI 


*ockckck ck kk k k kk kk kkkkkk*k*k* 


Welcome to Book Store 


大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 


Options 
1\. Add Book 
2 Noe PE XG 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. learn htm15 

Publication: SAMS, DELHI 

BUILD SUCCESSFUL (total time: 21 seconds) 


EJB - Blobs/Clobs - EJB 
EJB3.0 提 供 支 持 BLOB 和 CLOB 类型， 使 用 @Lob 注 解 。 下 面 的 Java 类 型 可 以 映射 
使 用 @Lob 注 解 。 

e java.sql.Blob 

e java.sql.Clob 

e byte[] 

e String 


e Serializable Object 


QEntity 

@Table(name="books") 
QEntityListeners(BookCallbackListener.class) 
public class Book implements Serializable{ 


private byte[] image; 
QLob @Basic(fetch= FetchType. EAGER) 
public byte[] getImage() { 


return image; 


} 


示例 应 用 程序 


让 我 们 创建 一 个 测试 EJB 在 EJB3.0 应 用 程序 来 测试 BLOB / CLOB 支 持 。 


Step 描述 


创建 一 个 项 目 与 一 个 名 字 EjbComponent 包 com.youcompany.entity 下 
1 EJB 中 的 解释 - 创建 应 用 程序 的 章节 。 请 作为 的 项 目 中 创建 EJB -阅读 
持久 性 本 章 可 了 解 CLOB/ BLOB 对 象 EJB 概 念 。 


创建 Book.java 包 com.youcompany.entity 下 。 使 用 EJB - 持久 性 章 作 为 
参考 。 其 余 文 件 保持 不 变 。 


3 清理 并 生成 应 用 程序 以 确保 业务 逻辑 是 按 要 求 工 作 。 
最 后 ， 将 应 用 程序 部 署 在 JBoss 应 用 服务 器 上 的 jar 文 件 的 形式 。 JBoss 


应 用 服务 器 将 自动 开始 浏览 网 页 ， 如 果 它 尚未 启动 。 
: 现在 创建 EJB 客 户 端 ， 基 于 控制 台 的 点 用 程序 以 同样 的 方式 在 EJB 解 释 


- 下 创建 应 用 程序 本 章 主 题 Create Client to access EJB. 


Create/Alter book table 


CREATE TABLE book ( 
id integer PRIMARY KEY, 
name varchar (50) 


); 
Alter table book add image bytea; 
Alter table book add xml text; 


EJBComponent (EJB Module) 


Book.java 


package com.tutorialspoint.entity; 


import com.tutorialspoint.callback.BookCallbackListener; 
import java.io.Serializable; 

import javax.persistence.Basic; 

import javax.persistence.Column; 

import javax.persistence.Entity; 

import javax.persistence.EntityListeners; 
import javax.persistence.FetchType; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Lob; 

import javax.persistence.Table; 


@Entity 
@Table(name="book") 
public class Book implements Serializable{ 


private int id; 
private String name; 
private byte[] image; 
private String xml; 


public Book(){ 
j 


@Id 
QGeneratedValue(strategy- GenerationType. IDENTITY) 
@Column( name="id" ) 
public int getId() { 
return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 
j 


QLob @Basic(fetch= FetchType.EAGER) 
public byte[] getimage() (1 

return image; 
j 


public void setImage(byte[] image) { 
this.image - image; 
j 


QLob @Basic(fetch= FetchType.EAGER) 
public String getXml() { 

return xml; 
} 


public void setXml(String xml) { 
this.xml = xml; 
} 


LibraryPersistentBeanRemote.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 
import javax.ejb.Remote; 


@Remote 
public interface LibraryPersistentBeanRemote { 


void addBook(Book bookName) ; 


List<Book> getBooks(); 


LibraryPersistentBean.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Stateless; 

import javax.persistence.EntityManager; 
import javax.persistence.PersistenceContext; 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


public LibraryPersistentBean(){ 


} 


QPersistenceContext(unitName-"EjbComponentPU") 
private EntityManager entityManager; 


public void addBook(Book book) { 
entityManager.persist(book); 


j 


public List«Book» getBooks() ( 
return entityManager.createQuery("From Book").getResultList(: 


} 
} 


E O 


e As soon as you deploy the EjbComponent project on JBOSS, notice the jboss 
log. 





e JBoss has automatically created a JNDI entry for our session bean - 


LibraryPersistentBean/remote. 


e We'll using this lookup string to get remote business object of type - 


com.tutorialspoint.interceptor.LibraryPersistentBeanRemote 


JBoss Application server log output 


16: 


16: 
16: 
16: 


EA 网 


30:01, 401 INFO [JndiSessionRegistrarBase] Binding the followin 
LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.interceptor.Libi 
30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.interceptor.Libi 





EJBTester (EJB Client) 


jndi.properties 


java.naming.factory.initial-org.jnp.interfaces.NamingContextFactor 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 


| 


These properties are used to initialize the InitialContext object of java naming 
service 


InitialContext object will be used to lookup stateless session bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.LibraryBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 


import java.io.InputStreamReader ; 
import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 
import javax.naming.NamingException; 


public class EJBTester { 


BufferedReader brConsoleReader = null; 
Properties props; 
InitialContext ctx; 
{ 
props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
} 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testBlobClob(); 
j 


private void showGUI(){ 

SVS Gel mollis: DIPL ESI SE c c E D 
System.out.println("Welcome to Book Store"); 
Sy StOnson PEE EXPL Seen te i E a ae 
System.out.print("Options 

1\. Add Book 

2N ECL: 

Enter Choice: "); 


} 


private void testBlobClob(){ 


try { 
int choice = 1; 


LibraryPersistentBeanRemote libraryBean = 
(LibraryPersistentBeanRemote ) 
ctx. lookup("LibraryPersistentBean/remote") ; 


while (choice != 2) { 
String bookName; 
String publisherName; 
String publisherAddress; 
ShowGUI(); 
String strChoice - brConsoleReader.readLine(); 
choice = Integer.parseInt(strChoice); 
if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName - brConsoleReader.readLine(); 
String xml = "<book><name>"+bookName+"</name></book: 
Book book - new Book(); 
book.setName(bookName) ; 
byte[] imageBytes = (0x32, 0x32,0x32, 0x32,0x32, 
0x32,0x32, 0x32, 
0x32, 0x32,0x32, 0x32,0x32, 0x32,0x32, 0x32, 
0x32, 0x32,0x32, 0x32,0x32, 0x32,0x32, 0x32 
3 
book.setImage(imageBytes) ; 
book.setXm1l(xm1); 


libraryBean.addBook(book); 
) else if (choice == 2) ( 
break; 
j 


j 


List«Book» booksList = libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " + booksList 
int i - 0; 
for (Book book:booksList) ( 
System.out.println((i-1)-*". " + book.getName( )); 
byte[] imageByts = book.getImage(); 
if(imageByts != null){ 
System.out.print("image bytes: ["); 
for(int j = 0; j < imageByts.length ; j++){ 
System.out.print("0x" 
+ String.format("%x", imageByts[j]) +" "); 


} 

System.out.println("]"); 
j 
System.out.println(book.getXml()); 
i++; 


} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !-null)( 
brConsoleReader.close(); 
j 


} catch (IOException ex) { 
System.out.println(ex.getMessage()); 








EJBTester is doing the following tasks. 
e Load properties from jndi.properties and initialize the InitialContext object. 


e In testinterceptedEjb() method, jndi lookup is done with name - 
"LibraryPersistenceBean/remote" to obtain the remote business object 
(stateless ejb). 


e Then user is shown a library store User Interface and he/she is asked to enter 
choice. 


e |f user enters 1, system asks for book name and saves the book using 
stateless session bean addBook() method. Session Bean is storing the book 
in database. 


If user enters 2, system retrieves books using stateless session bean 
getBooks() method and exits. 


Run Client to access EJB 


Locate EJBTester.java in project explorer. Right click on EJBTester class and 
select run file. 


Verify the following output in Netbeans console. 


run: 
okckckckckckck ck kckckckckck kc kck ko ko k 


Welcome to Book Store 


*okckckck kck k ck k ck kk kk kk ke k*kk* 


Options 
1\. Add Book 
2 EXE 


Enter Choice: 1 
Enter book name: learn testing 


*okckckck kck k ck kk kk kkkkkk*k*k* 


Welcome to Book Store 


*okckckck kck k k k ck kk kk kk ke k*k*k* 


Options 
1\. Add Book 
2: EX 


Enter Choice: 2 

Book(s) entered so far: 1 

1N. learn testing 

image bytes: [ 

0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32 0) 
<book><name>learn testing</name></book> 

BUILD SUCCESSFUL (total time: 20 seconds) 





EJB 事 务 -EJB 
A AD eee 


。 原子 -如 果 有 任何 的 工作 项 失败 ， 完 整 的 单元 被 认为 是 失败 。 成 功 意味 着 所 有 
项 目的 成 功 执 行 。 


e 一 致 性 - 事务 必须 保持 系统 处 于 一 致 状态 。 
。 独立 性 - 每 个 事务 执行 独立 的 任何 其 他 的 事务 。 
。 持久 性 - 事务 应 该 生存 系统 故障 ， 如 果 已 经 执行 或 提交 。 


EJB 容 器 /服务 器 ， 的 事务 服务 器 和 义理 事务 上 下 文 的 传递 和 分 布 式 事务 。 事 务 可 以 
由 容器 管理 或 bean 的 代码 自 定义 代码 义理 。 


e Container Managed Transactions - 在 这 种 类 型 中 ， 容 器 管理 的 事务 状态 。 
e Bean Managed Transactions - 在 这 种 类 型 中 ， 开 发 者 管理 事务 状态 的 生命 周 
期 。 


容器 管理 的 事务 


指定 EJB3.0，EJB 容 器 实现 的 事务 特性 。 


e REQUIRED - 表示 业务 方法 已 被 执行 的 范围 内 的 事务 ， 否 则 将 开始 一 个 新 的 事 
务 方 法 。 


e REQUIRES NEW - 表示 要 开始 一 个 新 的 事务 ， 业 务 方法 。 

e SUPPORTS - 表示 业务 方法 将 执行 作为 的 事务 的 一 部 分 。 

e NOT SUPPORTED - 表示 业务 方法 不 应 该 被 执行 作为 的 事务 的 一 部 分 。 

e MANDATORY - 表示 业务 方法 将 执行 作为 的 事务 的 一 部 分 ， 否 则 将 引发 异常 。 
e NEVER - 表示 如 果 业 务 方法 执行 作为 的 事务 的 一 部 分 ， 那 么 会 抛 出 一 个 异常 。 


例子 


package com.tutorialspoint.txn. required; 

import javax.ejb.* 

@Stateless 

@TransactionManagement (TransactionManagementType. CONTAINER) 

public class UserDetailBean implements UserDetailRemote { 
private UserDetail; 
@TransactionAttribute(TransactionAttributeType. REQUIRED ) 


public void createUserDetail() { 
//create user details object 


} 
} 


createUserDetail () 业务 方法 时 ， 需 要 使 用 Required 注 解 。 


package com.tutorialspoint.txn.required; 
import javax.ejb.* 


@Stateless 
public class UserSessionBean implements UserRemote { 


private User; 


@EJB 
private UserDetailRemote userDetail; 


public void createUser() { 
//create user 
Laie 
//create user details 
userDetail.createUserDetail(); 


为 createUser () 业务 方法 的 使 用 createUserDetail () 。 如 果 为 createUser (期 间 
发 生 的 异常 ) 调用 和 用 户 对 象 不 会 创建 那么 UserDetail 对 象 也 不 会 被 创建 。 


Bean 管 理 的 事务 


Bean 管 理 的 事务 ， 事 务 处 理应 用 水 平 的 异常 ， 可 以 管理 。 以 下 是 要 考虑 的 关键 点 
e Start - 当 启 动 一 个 事务 中 的 业务 方法 。 
e Sucess - 确定 成 功 的 情况 下 ， 当 一 个 事务 被 提交 。 


e Failed - 确定 失败 的 情况 下 ， 事 务 回 滚 。 


实例 


packag 


import 
import 
import 
import 
import 


e com.tutorialspoint.txn.bmt; 


javax.annotation.Resource; 
javax.ejb.Stateless; 
javax.ejb.TransactionManagement; 
javax.ejb.TransactionManagementType; 
javax.transaction.UserTransaction; 


@Stateless 


@Trans 
public 


act ionManagement (value=TransactionManagementType. BEAN ) 
class AccountBean implements AccountBeanLocal { 


@Resource 
private UserTransaction userTransaction; 


public void transferFund(Account fromAccount, double fund , 


} 


Account toAccount) throws Exception{ 


try{ 
userTransaction.begin(); 


confirmAccountDetail(fromAccount); 
withdrawAmount(fromAccount, fund); 


confirmAccountDetail(toAccount); 
depositAmount(toAccount, fund); 


userTransaction.commit(); 

jcatch (InvalidAccountException exception)( 
userTransaction.rollback(); 

jcatch (InsufficientFundException exception) { 
userTransaction.rollback(); 

jcatch (PaymentException exception) { 
userTransaction.rollback(); 

j 


private void confirmAccountDetail(Account account) 


j 


throws InvalidAccountException ( 


private void withdrawAmount() throws InsufficientFundException -+ 


j 


private void depositAmount() throws PaymentException{ 


j 











在 这 个 例子 中 ， 我 们 使 用 UserTransaction 接 口 标记 开始 使 用 
userTransaction.begin () 方法 调用 事务 处 理 。 我 们 标记 事务 完成 使 用 
userTransaction.commit () 方法 ， 如 果 期 间 发 生 任何 异常 ， 那 么 我 们 完整 的 事务 
回 滚 使 用 userTransaction.rollback () 方法 调用 。 


EJB 安 全 - EJB 


安全 性 是 任何 企业 级 应 用 关注 的 重大 问题 。 它 包括 用 户 身份 识别 (S) 或 系统 访问 
的 应 用 程序 ， 并 人 允许 或 拒绝 的 访问 应 用 程序 内 的 资源 。 在 EJB 中 ， 安 全 性 可 以 声明 
的 方式 称 为 声明 性 安全 EJB 容 器 管理 的 安全 问题 ， 或 者 自 定 义 代码 可 以 在 EJB 人 处 理 
安全 问题 的 关注 ， 通 过 自己 声明 。 


安全 的 重要 术语 

。 认证 - 这 是 确保 用 户 访问 系统 或 应 用 程序 被 验证 为 是 正品 的 方法 。 
e 授权 - 这 是 过 程 ， 确 保 用 户 有 权 访 问 系统 资源 的 权限 级 别 。 

e. 用户 - 用 户 表示 访问 该 应 用 程序 的 客户 端 或 系统 。 

e 用户 组 - 用户 可 能 具有 一 定 部 门 例如 管理 员 组 的 一 部 分 。 

e 用 户 角 色 - 角色 定义 授权 用 户 有 权限 访问 系统 资源 的 水 平 。 


容器 管理 安全 
EJB3.0 指 定 下 列 属 性 /安全 EJB 容 器 实现 的 注解 。 
e DeclareRoles - 指示 类 将 接受 这 些 声 明 的 的 角色 。 注 释 在 类 级 别 应 用 。 


e RolesAllowed -指示 指定 的 角色 的 用 户 可 以 访问 的 方法 。 可 以 应 用 在 一 流水 
平 ， 导 致 指定 角色 的 用 户 可 以 访问 的 所 有 类 方法 。 


e PermitAll - 表示 该 业务 的 方法 是 访问 。 可 以 应 用 在 类 以 及 方法 级 别 。 
e DenyAll - 表明 业务 方法 不 能 访问 任何 用 户 指定 的 类 或 方法 级 别 。 


实例 


package com.tutorialspoint.security.required; 
import javax.ejb.* 


@Stateless 
@DeclareRoles({"student" "librarian"}) 
public class LibraryBean implements LibraryRemote { 


@RolesAllowed({"librarian"}) 

public void delete(Book book) { 
//delete book 

} 


QPermitAll 

public void viewBook(Book book) { 
//view book 

} 


QDenyAll 

public void deleteAll()( 
//delete all books 

} 


安全 配置 
在 配置 文件 中 的 的 映射 角色 和 用 户 组 。 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE sun-ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD Applic 
<ejb-jar> 
<security-role-mapping> 
<role-name>student</role-name> 
<group-name>student -group</group-name> 
</security-role-mapping> 
<security-role-mapping> 
<role-name>librarian</role-name> 
<group-name>librarian-group</group -name> 
</security-role-mapping> 
<enterprise-beans/> 
</ejb-jar> 


BM] 





EJBJNDIZ; 5E - EJB 
JNDI 代 表 Java 命 名 和 目录 接口 。 它 是 一 组 API 和 服务 接口 。 基 于 Java 的 应 用 程序 使 
用 JNDI 命 名 和 目录 服务 。 在 EJB 的 背景 下 ， 有 两 个 方面 。 
e Binding - 这 指 的 是 以 后 可 以 使 用 一 个 EJB 对 象 分 配 一 个 名 称 。 
e Lookup - 这 指 的 是 寻找 并 获得 EJB 对 象 。 
在 JBoss 中 ， 会 话 bean 绑 定 到 JNDI， 默 认 情况 下 有 以 下 格式 。 
e local - ejb-name/local 
e remote - ejb-name/remote 
情况 下 ，EJB 捆 绑 在 一 起 <application-name> ear 文 件 默认 格式 如 下 。 
e local - application-name/ejb-name/local 


e remote - application-name/ejb-name/remote 


默认 绑 定 的 例子 


请 参阅 EJB - 创建 应 用 本 章 的 JBoss 的 控制 台 输 出 。 
JBoss 应 用 服务 器 的 日 志 输 出 


16:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee: jar=t 
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
16:30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibrarySessionBean/remote - EJB3.x Default Remote Business Inte) 
LibrarySessionBean/remote-com.tutorialspoint.stateless.LibrarySe 
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以 下 注释 可 以 用 来 定制 默认 JNDI 绑 定 。 
e local - org.jboss.ejb3.LocalBinding 
e remote - org.jboss.ejb3.RemoteBindings 


更 新 LibrarySessionBean.java。 请 参阅 EJB - 创建 应 用 程序 一 章 


LibrarySessionBean 


package com.tutorialspoint.stateless; 


import java.util.ArrayList; 
import java.util.List; 
import javax.ejb.Stateless; 


@Stateless 
QLocalBinding(jndiBinding-"tutorialsPoint/librarySession") 
public class LibrarySessionBean implements LibrarySessionBeanLocal 


List<String> bookShelf; 


public LibrarySessionBean(){ 
bookShelf = new ArrayList<String>(); 


} 


public void addBook(String bookName) { 
bookShelf .add(bookName) ; 


} 


public List<String> getBooks() { 
return bookShelf; 





LibrarySessionBeanLocal 


package com.tutorialspoint.stateless; 


import java.util.List; 
import javax.ejb.Local; 


@Local 
public interface LibrarySessionBeanLocal { 


void addBook(String bookName) ; 


List getBooks(); 


构建 项 目 。 将 应 用 程序 部 署 在 JBoss 在 JBoss 控制 台 验 证 下 面 的 输出 。 


16:30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee: jar=t 
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
16:30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


tutorialsPoint/librarySession - EJB3.x Default Local Business Ir 
tutorialsPoint/librarySession-com.tutorialspoint.stateless.Libr: 


«| = 








重复 上 述 步 又， 为 远程 和 检查 结果 。 


EJB3: (AK - EJB 
EJB 3.0 中 提供 的 选项 来 定义 像 一 对 一 的 数据 库 实 体 关 系 / 映 射 ， 一 对 多 ， 多 对 一 和 
多 对 多 关系 。 以 下 是 相关 的 注释 。 

e OneToOne - 对 象 都 具有 一 对 一 的 关系 。 例 如 ， 乘 客 可 以 在 时 间 旅 行使 用 一 张 


e OneToMany - 对 象 是 具有 一 对 多 的 关系 。 例 如 ， 一 个 父亲 可 以 有 多 个 孩子 。 
e ManyToOne - 对 象 有 多 对 一 的 关系 。 举 例 来 说 ， 多 个 孩子 对 一 个 母亲 。 


e ManyToMany - 对 象 是 多 对 多 的 关系 。 举 例 来 说 ， 一 本 书 可 以 多 发 作者 ， 一 个 
作者 可 以 写 多 本 书 。 


在 这 里 ， 我 们 将 演示 如 何 使 用 多 对 多 的 映射 。 要 代表 多 对 多 的 关系 ， 三 表 是 必需 
的 。 


e Book - 书籍 记录 表 
e Author - 作者 Author 表 记录 
e Book Author - BOOK_AUTHOR 上 述 Book 和 Author 表 的 表 具 有 关联 。 


创建 表 
创建 表 book author, book_author 在 默认 数据 库 postgres. 


CREATE TABLE book ( 
book_id integer, 
name varchar (50) 


); 


CREATE TABLE author ( 
author_id integer, 
name varchar (50) 


); 


CREATE TABLE book_author ( 
book_id integer, 
author_id integer 


); 


创建 实体 类 


@Entity 

@Table(name="author" ) 

public class Author implements Serializable{ 
private int id; 
private String name; 


@Entity 

@Table(name="book" ) 

public class Book implements Serializable( 
private int id; 
private String title; 
private Set<Author> authors; 


Use ManyToMany annotation in Book Entity 


@Entity 
public class Book implements Serializable( 


@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE) 
, fetch = FetchType.EAGER) 
@JoinTable(table = @Table(name = "book author"), 


joinColumns = {@JoinColumn(name = "book_id")}, 
inverseJoinColumns = {@JoinColumn(name = "author_id")}) 
public Set<Author> getAuthors() 
{ 
return authors; 


} 


ES 


实例 应 用 


让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 EJB3.0 实 体 关 系 对 象 。 


Step 描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.entity as explained in the EJB - Create Application 

1 chapter. Please use the project created in EJB - Persistence chapter 
as such for this chapter to understand embedded objects in ejb 
concepts. 


Create Author.java under package com.tutorialspoint.entity as 
2 explained in the EJB - Create Application chapter. Keep rest of the 
files unchanged. 


Create Book.java under package com.tutorialspoint.entity. Use EJB - 
Persistence chapter as reference. Keep rest of the files unchanged. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
5 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
6 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. 


EJBComponent (EJB Module) 


Author.java 


package com.tutorialspoint.entity; 


import java.io.Serializable; 

import javax.persistence.Column; 

import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Table; 


QEntity 
@Table(name="author" ) 
public class Author implements Serializable{ 


private int id; 
private String name; 


public Author(){} 


public Author(int id, String name) { 
this.id = id; 
this.name = name; 


} 


@Id 
QGeneratedValue(strategy- GenerationType. IDENTITY) 
@Column(name="author_id") 
public int getId() { 
return id; 


} 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 


} 


public void setName(String name) { 
this.name = name; 


} 


public String toString(){ 
return id + "," + name; 


} 


Book.java 


package com.tutorialspoint.entity; 
import java.io.Serializable; 


import javax.persistence.Column; 
import javax.persistence.Entity; 
import javax.persistence.Table; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 


QEntity 
QTable(namez"book") 
public class Book implements Serializable{ 


private int id; 
private String name; 
private Set«Author» authors; 


public Book(){ 
j 


QId 
QGeneratedValue(strategy- GenerationType.IDENTITY) 
QColumn(name-"book id") 
public int getId() { 
return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 
j 


public void setName(String name) { 
this.name - name; 
} 


public void setAuthors(Set<Author> authors) { 
this.authors = authors; 
} 


@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE) 
, fetch = FetchType. EAGER) 

@JoinTable(table = @Table(name = "book_author"), 
joinColumns = {@JoinColumn(name = "book_id")}, 
inverseJoinColumns = {@JoinColumn(name = "author_id")}) 

public Set<Author> getAuthors() 


( 


return authors; 








LibraryPersistentBeanRemote.java 


package com.tutorialspoint.stateless; 
import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Remote; 


@Remote 
public interface LibraryPersistentBeanRemote { 


void addBook(Book bookName) ; 


List<Book> getBooks(); 


LibraryPersistentBean.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Stateless; 

import javax.persistence.EntityManager; 
import javax.persistence.PersistenceContext; 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


public LibraryPersistentBean() { 


} 


QPersistenceContext(unitName-"EjbComponentPU") 
private EntityManager entityManager; 


public void addBook(Book book) { 
entityManager.persist(book); 


j 


public List«Book» getBooks() ( 
return entityManager.createQuery("From Book").getResultList(: 





e 只 要 你 在 JBoss 部 署 EjbComponent 项 目 ， 会 注意 到 jboss 的 日 志 。 


e JBoss 已 经 自动 为 我 们 的 会 话 bean 创 建 一 个 JNDI 条 目 - 
LibraryPersistentBean/remote. 


e. 我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.interceptor.LibraryPersistentBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


«] 


16: 
16: 


16: 
16: 


30:01,401 INFO [JndiSessionRegistrarBase] Binding the followint 
LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.interceptor.Libi 
30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.interceptor.Libi 


sr] ^] 








EJBTester (EJB Client) 


jndi.properties 


一 = n LLL LLL LLL exi] 


java.naming.factory.initial-org.jnp.interfaces.NamingContextFactor 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 





These properties are used to initialize the InitialContext object of java naming 
service 


InitialContext object will be used to lookup stateless session bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateful.LibraryBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.*; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 


props = new Properties(); 
try { 
props.load(new FileInputStream("jndi.properties")); 
} catch (IOException ex) { 
ex.printStackTrace(); 
j 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 


brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testEmbeddedObjects(); 
B 


private void showGUI(){ 

SV SCCM out rt oak us Ra E qat 
System.out.println("Welcome to Book Store"); 
System out DIE rt. purée Si e UP Su re 
System.out.print("Options 

1\. Add Book 

2\. Exit 

Enter Choice: "); 


} 


private void testEmbeddedObjects(){ 


try ( 
int choice = 1; 


LibraryPersistentBeanRemote libraryBean = 
(LibraryPersistentBeanRemote ) 
ctx. lookup("LibraryPersistentBean/remote") ; 


while (choice != 2) { 
String bookName; 
String authorName; 


ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
System.out.print("Enter author name: "); 


authorName = brConsoleReader.readLine(); 
Book book = new Book(); 

book. setName(bookName) ; 

Author author = new Author(); 
author.setName(authorName) ; 

Set<Author> authors = new HashSet«Author»(); 
authors.add(author); 
book.setAuthors(authors); 


libraryBean.addBook(book); 
} else if (choice == 2) ( 
break; 
} 


} 


List<Book> booksList = libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " + booksList 
int i - 0; 
for (Book book:booksList) { 
System.out.println((i-1)-". " + book.getName()); 
System.out.print("Author: "); 
Author[] authors = (Author[])books.getAuthors().toArra 
for(int j=0;j<authors. length; j++) { 
System.out.println(authors[j]); 
} 


i++; 


} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


) catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester 做 以 下 任务 。 


e。jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


e 在 testlnterceptedEjb () 方法 ，JNDI 查 找 名称 - 的 “LibraryPersistenceBean/ 远 
时 "获得 远程 业务 对 象 (无 状态 的 EJB) 。 


e 然后 用 户 显示 一 个 库存 储 的 用 户 界面 和 他 /她 被 要 求 输 入 选择 。 


e. 如果 用 户 输入 1， 系 统 要 求 输入 书籍 名 称 和 节约 使 用 无 状态 的 会 话 bean 
addBook () 方法 的 书 。 会 话 Bean 在 数据 库 中 存储 的 书 。 


e 如果 用 户 输入 2， 系 统 检 索 书 使 用 状态 会 话 Bean getBooks () 方法 和 退出 。 


i5 1128 P imig i] EJB 
在 项 目 资源 管理 器 中 找到 EJBTesterjava。 右键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
ockckckckckckckck kckckckckck kc kc k ko ko k 


Welcome to Book Store 
Wockckckockokockock ko ckock ko ck ko ck ko kk kkk 


Options 
1\. Add Book 
2A EX 


Enter Choice: 1 
Enter book name: learn html5 
Enter Author name: Robert 


*okckck ck kck k k kk kk kkkkkk*k*k* 


Welcome to Book Store 


*okckckck kck ko k ko ck k k kkkk ke k*k*k* 


Options 
1N. Add Book 
2N SEXE 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. learn html5 

Author: Robert 

BUILD SUCCESSFUL (total time: 21 seconds) 


EJB 访 问 数 据 库 - EJB 
EJB 3.0 持 久 性 机 制 来 访问 容器 管理 的 数据 库 中 的 数据 库 相 关 的 操作 。 开 发 人 员 访 
问 数 据 库 可 以 直接 使 用 JDBC API 调 用 EJB 的 业务 方法 。 
为 了 证 明 在 ejb 的 数据 库 访问 ， 我 们 要 做 好 以 下 几 项 工作 。 
e 步骤 1. 在 数据 库 中 创建 表 . 
e. H3 2. 创建 一 个 无 状态 EJB. 


e 步骤 3. 更 新 无 状态 的 EJB。 添 加 添加 记录 并 获得 通过 实体 管理 器 从 数据 库 中 记 
录 的 方法 。 

。 步 骤 4. 一 个 基于 控制 台 应 用 程序 客户 端 将 访问 无 状态 EJB 的 持久 化 数据 库 中 的 
数据 。 


创建 表 
创建 一 张 表 books 在 默认 的 数据 库 postgres. 


CREATE TABLE books ( 
id integer PRIMARY KEY, 
name varchar (50) 


): 


创建 模型 类 


public class Book implements Serializable{ 


private int id; 
private String name; 


public Book(){ 
j 


public int getId() { 
return id; 


创建 无 状态 EJB 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


public void addBook(Book book) { 
//persist book using jdbc calls - by yiibai.com 


} 


public List<Book> getBooks() { 
//get books using jdbc calls 





构建 EJB 模 块 后 ， 我 们 需要 一 个 无 状态 的 bean， 我 们 将 在 下 一 节 要 创建 客户 端 来 访 
问 。 


实例 应 用 
让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 EJB 的 数据 库 访问 机 制 。 


Step 描述 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.entity as explained in the EJB - Create Application 

1 chapter. You can also use the project created in EJB - Create 
Application chapter as such for this chapter to understand ejb data 
access concepts. 


2 Create Book.java under package com.tutorialspoint.entity and modify 
it as shown below. 


Create LibraryPersistentBean.java and LibraryPersistentBeanRemote 
3 as explained in the EJB - Create Application chapter and modify them 
as shown below. 


4 Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
5 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
6 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. Modify it as shown below. 


EJBComponent (EJB Module) 


Book.java 


package com.tutorialspoint.entity; 
import java.io.Serializable; 
public class Book implements Serializable{ 


private int id; 
private String name; 


public Book(){ 
j 


public int getId() { 
return id; 
j 


public void setId(int id) ( 
this.id = id; 
} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 


} 


LibraryPersistentBeanRemote.java 


package com.tutorialspoint.stateless; 
import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Remote; 


@Remote 
public interface LibraryPersistentBeanRemote { 


void addBook(Book bookName) ; 


List<Book> getBooks(); 


LibraryPersistentBean.java 


packag 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


e com.tutorialspoint.stateless; 


com.tutorialspoint.entity.Book; 
java.sql.Connection; 
java.sql.DriverManager; 
java.sql.PreparedStatement; 
java.sql.ResultSet; 
java.sql.SQLException; 
java.sql.Statement; 
java.util.ArrayList; 
java.util.List; 
javax.ejb.Stateless; 


@Stateless 


public 


class LibraryPersistentBean implements LibraryPersistentBear 


public LibraryPersistentBean(){ 


} 


public void addBook(Book book) { 


Connection con = null; 
String url = "jdbc:postgresql://localhost :5432/postgres"; 


String driver = "org.postgresql.driver"; 
String userName = "sa"; 
String password = "sa"; 


List«Book» books = new ArrayList<Book>(); 
try { 


Class. forName(driver ).newInstance(); 
con = DriverManager.getConnection(url , userName, passwort 


PreparedStatement st = 
con.prepareStatement("insert into book(name) values(?)"); 
st.setString(1,book.getName()); 


int result = st.executeUpdate( ); 


catch (SQLException ex) { 
ex.printStackTrace(); 

catch (InstantiationException ex) { 
ex.printStackTrace(); 

catch (IllegalAccessException ex) { 
ex.printStackTrace(); 

catch (ClassNotFoundException ex) { 
ex.printStackTrace(); 


tM uw YY vu uu 


public List<Book> getBooks() { 
Connection con = null; 
String url = "jdbc:postgresql://localhost :5432/postgres"; 


String driver = "org.postgresql.driver"; 
String userName = "sa"; 
String password = "sa"; 


List«Book» books = new ArrayList<Book>(); 
try { 


Class.forName(driver).newInstance(); 
con - DriverManager.getConnection(url , userName, passwort 


Statement st 
ResultSet rs 


- con.createStatement(); 
- st.executeQuery("select * from book"); 
Book book; 
while (rs.next()) { 
book = new Book(); 
book.setId(rs.getiInt(1)); 
book.setName(rs.getString(2)); 
books.add(book); 


catch (SQLException ex) { 
ex.printStackTrace(); 

catch (InstantiationException ex) { 
ex.printStackTrace(); 

catch (IllegalAccessException ex) { 
ex.printStackTrace(); 

catch (ClassNotFoundException ex) { 
ex.printStackTrace(); 


Sw rc € YH € 


eturn books; 





e 只 要 你 在 JBoss 部 署 EjbComponent 项 目 ， 注 意 到 jboss 的 日 志 。 


e JBoss 已 经 自动 为 我 们 的 会 话 bean 创 建 一 个 JNDI 条 目 - 
LibraryPersistentBean/remote. 


。 我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.stateless.LibraryPersistentBeanRemote 


JBoss 应 用 服务 器 的 日 志 输 


q 


16: 
16: 


16: 
16: 


30:01,401 INFO [JndiSessionRegistrarBase] Binding the followin 
LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Librai 
30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Librai 








EJBTester (EJB Client) 


jndi.properties 


[Egger nne eec one eee eL Sn IL LL LLL Lies] 


e 这 些 属性 是 用 来 初始 化 InitialContext 对 象 的 Java 命 名 服务 


java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 





elnitialContext 的 对 象 将 被 用 于 查找 无 状态 会 话 bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateless.LibraryPersistentBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 


props = new Properties(); 
try { 

props.load(new FileInputStream("jndi.properties")); 
) catch (IOException ex) { 

ex.printStackTrace(); 


j 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 
brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testEntityEjb(); 
j 


private void showGUI(){ 

SV SCCM out rt oak us Ra E qat 
System.out.println("Welcome to Book Store"); 
System out DIE rt. purée Si e UP Su re 
System.out.print("Options 

1\. Add Book 

2\. Exit 

Enter Choice: "); 


} 


private void testEntityEjb(){ 


try ( 
int choice = 1; 


LibraryPersistentBeanRemote libraryBean = 
LibraryPersistentBeanRemote ) 
ctx. lookup("LibraryPersistentBean/remote") ; 


while (choice != 2) { 

String bookName; 

ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
Book book = new Book(); 
book.setName(bookName) ; 
libraryBean.addBook(book); 


} else if (choice == 2) { 
break; 
} 


} 
List<Book> booksList = libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " + booksList 
int i - 0; 
for (Book book:booksList) ( 

System.out.println((i-1)-". " + book.getName( )); 

i++; 


} 

} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


} catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester 做 以 下 任务 。 


e。jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


e 在 testStatefulEjb () 方法 ，JNDI 名 称 进 行 查找 - 
"LibraryStatelessSessionBean/remote" 以 获得 远程 业务 对 象 (状态 EJB) 。 


e 然后 用 户 显示 一 个 库存 储 的 用 户 界面 和 他 /她 被 要 求 输 入 选择 。 


e 如 果 用 户 输入 1， 系 统 要 求 输入 书籍 名 称 和 可 以 节省 使 用 无 状态 的 会 话 bean 
addBook () 方法 。 会 话 Bean 坚 持 这 本 书 中 通过 EntityManager 的 调用 数据 
库 。 


e 如 果 用 户 输 入 2， 系 统 检 索 书 使 用 状态 会 话 Bean getBooks () 方法 和 退出 。 


e 然后 另 一 个 JNDI 名 称 进 行 查找 - "LibraryStatelessSessionBean/remote" 获得 
远程 业务 对 象 (状态 EJB) 再 次 列 出 书籍 。 


{TE P limi |] EJB 


在 项 目 资源 管理 器 中 找到 EJBTesterjava。 右键 点 击 上 EJBTester 类 ， 并 选择 run 
file. 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
ockckckckckckck ck kckck kckckckck ck ko ko ko 


Welcome to Book Store 
*Wockckckockokockock ko ckock ko ck ck ck ck kk kkk 


Options 
1N. Add Book 
2N EXIIT 


Enter Choice: 1 
Enter book name: Learn Java 


*ockckckck kck k ck kk kk kkkk*kk*k*k* 


Welcome to Book Store 
*ockckckocko ko ckock kockock ko ck ko ck ck kk kkk 


Options 
1\. Add Book 
2\ IE 


Enter Choice: 2 

Book(s) entered so far: 1 

1\. learn java 

BUILD SUCCESSFUL (total time: 15 seconds) 


EJB 4 i i2 5 - EJB 
EJB3.0，EJB 查 询 语言 编写 自 定义 的 查询 非常 方便 ， 不 用 担心 底层 数据 库 的 详细 信 
息 。 这 是 很 相似 的 HQL(Hibernate 查 询 语言 )， 通 常 被 称 为 按 名 称 EJBQL。 
要 理解 熟悉 ejb 的 EJBQL， 要 做 好 以 下 几 项 工作 。 
e 步骤 1. 在 数据 库 中 创建 表 . 
e 步骤 2. 创建 一 个 无 状态 EJB. 


@ 步骤 3. 更 新 无 状态 的 EJB。 添加 添加 记录 并 获得 实体 管理 器 从 数据 库 中 记 
录 的 方法 。 


e Tb yk 4. 一 个 基于 控制 台 应 用 程序 客户 端 笃 访 问 无 状态 EJB 的 持久 化 数据 库 中 的 
数据 。 
创建 数据 库 表 
创建 表 books 在 默认 数据 库 postgres. 


CREATE TABLE books ( 
id integer PRIMARY KEY, 
name varchar (50) 


): 


创建 模型 类 


public class Book implements Serializable{ 


private int id; 
private String name; 


public Book(){ 
j 


public int getId() { 
return id; 


创建 无 状态 EJB 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


public void addBook(Book book) { 
//persist book using entity manager 


} 


public List<Book> getBooks() { 
//get books using entity manager 





构建 EJB 模 块 后 ， 我 们 需要 一 个 无 状态 的 bean， 我 们 将 在 下 一 节 要 创建 客户 端 来 访 
问 。 


示例 应 用 程序 
让 我 们 创建 一 个 测试 EJB 应 用 程序 来 测试 EJB 的 数据 库 访问 机 制 。 


Step Description 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.entity as explained in the EJB - Create Application 

1 chapter. You can also use the project created in EJB - Create 
Application chapter as such for this chapter to understand ejb data 
access concepts. 


2 Create Book.java under package com.tutorialspoint.entity and modify 
it as shown below. 


Create LibraryPersistentBean.java and LibraryPersistentBeanRemote 
3 as explained in the EJB - Create Application chapter and modify them 
as shown below. 


4 Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
5 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


Now create the ejb client, a console based application in the same 
6 way as explained in theEJB - Create Application chapter under topic 
Create Client to access EJB. Modify it as shown below. 


EJBComponent (EJB Module) 


Book.java 


package com.tutorialspoint.entity; 
import java.io.Serializable; 
public class Book implements Serializable{ 


private int id; 
private String name; 


public Book(){ 
j 


public int getId() { 
return id; 
j 


public void setId(int id) ( 
this.id = id; 
} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 


} 


LibraryPersistentBeanRemote.java 


package com.tutorialspoint.stateless; 
import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Remote; 


@Remote 
public interface LibraryPersistentBeanRemote { 


void addBook(Book bookName) ; 


List<Book> getBooks(); 


LibraryPersistentBean.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Stateless; 

import javax.persistence.EntityManager ; 
import javax.persistence.PersistenceContext; 
import javax.persistence.Query; 


@Stateless 
public class LibraryPersistentBean implements LibraryPersistentBear 


public LibraryPersistentBean(){ 


} 


@PersistenceContext (unitName="EntityEjbPU" ) 
private EntityManager entityManager; 


public void addBook(Book book) { 
entityManager.persist(book); 
j 


public List«Book» getBooks() ( 
//create an ejbql expression 
String ejbQL - "From Book b where b.name like ?1"; 
//create query 
Query query = entityManager.createQuery(ejbQL); 
//substitute parameter. 
query.setParameter(1, "%test%"); 
//execute the query 
return query.getResultList(); 





e 只 要 在 JBoss 部 署 EjbComponent 项 目 ， 会 注意 到 jboss 的 日 志 。 


e JBoss 已 经 自动 为 我 们 的 会 话 bean 创 建 一 个 JNDI 条 目 - 
LibraryPersistentBean/remote. 


e. 我 们 将 使 用 这 个 查询 字符 串 来 获得 远程 类 型 的 业务 对 象 - 
com.tutorialspoint.stateless.LibraryPersistentBeanRemote 


JBoss 应 用 服务 器 的 日 志 $ tH 


q 


16: 
16: 


16: 
16: 


30:01,401 INFO [JndiSessionRegistrarBase] Binding the followin 
LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Librai 
30:02,723 INFO [SessionSpecContainer] Starting jboss.j2ee:jar-t 
30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
30:02,731 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryPersistentBean/remote - EJB3.x Default Remote Business Ir 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Librai 








EJBTester (EJB Client) 


jndi.properties 


[Egger nne eec one eee eL Sn IL LL LLL Lies] 


e 这 些 属性 是 用 来 初始 化 InitialContext 对 象 的 Java 命 名 服务 


java.naming.factory.initial=org.jnp.interfaces.NamingContextFactor\ 
java.naming.factory.url.pkgs-org.jboss.naming:org.jnp.interfaces 
java.naming.provider.url-localhost 





elnitialContext 的 对 象 将 被 用 于 查找 无 状态 会 话 bean 


EJBTester.java 


package com.tutorialspoint.test; 


import com.tutorialspoint.stateless.LibraryPersistentBeanRemote; 
import java.io.BufferedReader; 

import java.io.FileInputStream; 

import java.io.IOException; 

import java.io.InputStreamReader; 

import java.util.List; 

import java.util.Properties; 

import javax.naming.InitialContext; 

import javax.naming.NamingException; 


public class EJBTester ( 


BufferedReader brConsoleReader - null; 
Properties props; 
InitialContext ctx; 


props = new Properties(); 
try { 

props.load(new FileInputStream("jndi.properties")); 
) catch (IOException ex) { 

ex.printStackTrace(); 


j 


try { 
ctx = new InitialContext(props); 


} catch (NamingException ex) { 
ex.printStackTrace(); 
} 
brConsoleReader = 
new BufferedReader (new InputStreamReader(System.in)); 


} 


public static void main(String[] args) { 
EJBTester ejbTester = new EJBTester(); 


ejbTester.testEntityEjb(); 
j 


private void showGUI(){ 

SV SCCM out rt oak us Ra E qat 
System.out.println("Welcome to Book Store"); 
System out DIE rt. purée Si e UP Su re 
System.out.print("Options 

1\. Add Book 

2\. Exit 

Enter Choice: "); 


} 


private void testEntityEjb(){ 


try ( 
int choice = 1; 


LibraryPersistentBeanRemote libraryBean = 
LibraryPersistentBeanRemote ) 
ctx. lookup("LibraryPersistentBean/remote") ; 


while (choice != 2) { 

String bookName; 

ShowGUI(); 

String strChoice - brConsoleReader.readLine(); 

choice = Integer.parseInt(strChoice); 

if (choice == 1) { 
System.out.print("Enter book name: "); 
bookName = brConsoleReader.readLine(); 
Book book = new Book(); 
book.setName(bookName) ; 
libraryBean.addBook(book); 


} else if (choice == 2) { 
break; 
} 
} 


List<Book> booksList = libraryBean.getBooks(); 


System.out.println("Book(s) entered so far: " + booksList 
int i - 0; 
for (Book book:booksList) ( 

System.out.println((i-1)-". " + book.getName( )); 

i++; 


} 

} catch (Exception e) { 
System.out.println(e.getMessage()); 
e.printStackTrace(); 

}finally { 
try { 

if(brConsoleReader !=null){ 
brConsoleReader.close(); 


} catch (IOException ex) { 
System.out.println(ex.getMessage()); 





EJBTester 做 以 下 任务 。 


e。jndi.properties 中 加 载 和 初始 化 的 InitialContext 对 象 。 


e 在 testStatefulEjb () 方法 ，JNDI 名 称 进行 查找 - 
"LibraryStatelessSessionBean/remote" 以 获得 远程 业务 对 象 (状态 EJB) 。 


e 然后 用 户 显示 一 个 库存 储 的 用 户 界面 和 他 /她 被 要 求 输 入 选择 。 


。 如 果 用 户 输入 1， 系 统 要 求 输 入 书籍 名 称 和 节省 了 使 用 无 状态 的 会 话 bean 
addBook () 方法 。 会 话 Bean 坚 持 这 本 书 中 通过 EntityManager 的 调用 数据 
库 。 


e 如 果 用 户 输 入 2， 系 统 检 索 书 使 用 状态 会 话 Bean getBooks () 方法 和 退出 。 


e 然后 另 一 个 JNDI 名 称 进行 查找 - "LibraryStatelessSessionBean/remote" 获 得 远 
程 业务 对 象 (状态 EJB) 再 次 列 出 书籍 。 


ik (T8 P Wiz ip] EJB 
在 项 目 资源 管 


file. 


eG 
资源 


理 器 中 找到 EJBTesterjava。 右 键 点 击 上 EJBTester 类 ， 并 选择 run 


在 Netbeans 控 制 台 验证 以 下 输出 。 


run: 
ockckckckckckck ck kckck kckckckck ck ko ko ko 


Welcome to Book Store 
*Wockckckockokockock ko ckock ko ck ck ck ck kk kkk 


Options 
1N. Add Book 
2N EXIIT 


Enter Choice: 1 
Enter book name: Learn Testing 


*ockckck ck kock k ck ko k kk kkkk*k*k*k*k* 


Welcome to Book Store 
*ockckckocko ko ckock kockock ko ck ko ck ck kk kkk 


Options 
1\. Add Book 
2\ IE 


Enter Choice: 2 

Book(s) entered so far: 1 

1N. learn Testing 

BUILD SUCCESSFUL (total time: 15 seconds) 


EJB Web Services - EJB 


EJB3.0 暴 露 会 话 EJB 作 为 Web 服 务 提供 选项 。 @WebService 注 释 是 用 来 标记 一 
作为 一 个 Web 服 务 端 点 ， 并 使 用 @WebMethod 是 用 来 作为 客户 ME 
FA. 


@Stateless 
@WebService(serviceName="LibraryService" ) 
public class LibraryPersistentBean implements LibraryPersistentBear 


@WebMethod(operationName="getBooks" ) 
public List<Book> getBooks() { 
return entityManager.createQuery("From Books").getResultListi 





示例 应 用 程序 


让 我 们 创建 一 个 测试 EJB 在 EJB3.0 应 用 程序 来 测试 BLOB/CLOB 支 持 。 


Step Description 


Create a project with a name EjbComponent under a package 
com.tutorialspoint.entity as explained in the EJB - Create Application 

1 chapter. Please use the project created in EJB - Persistence chapter 
as such for this chapter to understand clob/blob objects in ejb 
concepts. 


Create LibraryPersistentBean.java under package 
2 com.tutorialspoint.stateless. Use EJB - Persistence chapter as 
reference. Keep rest of the files unchanged. 


Clean and Build the application to make sure business logic is working 
as per the requirements. 


Finally, deploy the application in the form of jar file on JBoss 
4 Application Server. JBoss Application server will get started 
automatically if it is not started yet. 


LibraryPersistentBean.java 


package com.tutorialspoint.stateless; 


import com.tutorialspoint.entity.Book; 
import java.util.List; 

import javax.ejb.Stateless; 

import javax.jws.WebMethod; 

import javax.jws.WebService; 

import javax.persistence.EntityManager ; 
import javax.persistence.PersistenceContext; 


@Stateless 
@WebService(serviceName="LibraryService" ) 
public class LibraryPersistentBean implements LibraryPersistentBear 


public LibraryPersistentBean(){ 


} 


@PersistenceContext(unitName="EjbComponentPU") 
private EntityManager entityManager; 


public void addBook(Book book) { 
entityManager.persist(book); 
j 


QwebMethod(operationName-"getBooks") 
public List<Book> getBooks() { 
return entityManager.createQuery("From Book").getResultList(: 





JBoss 应 用 服务 器 的 日 志 输 出 


10:51:37,271 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.: 
10:51:37,287 INFO [JndiSessionRegistrarBase] Binding the followint 


LibraryPersistentBean/remote - EJB3.x Default Remote Business : 
LibraryPersistentBean/remote-com.tutorialspoint.stateless.Libr: 


10:51:37,349 INFO [EJBContainer] STARTED EJB: com.tuturialspoint.r 
10:51:37,443 INFO [DefaultEndpointRegistry] register: jboss.ws:cor 
10:51:38,191 INFO [WSDLFilePublisher] WSDL published to: file:/D:, 
LibraryService3853081455302946642.wsdl 


= 一 





创建 客户 端 访问 EJB 作 为 Web 服 务 


Nees 选择 File>NewProject> 类 别 下 选择 项 目 类 型 ，Java 项 目 类 型 
为 Java 应 用 。 点 击 Next> 按 钮 。 输 入 项 目 的 名 称 和 位 置 。 单 击 “Next>" 按 钮 。 Su 
14 3; EJBWebServiceClient, 


右键 点 击 项 目 名 称 在 项 目 exporer 窗 口中 。 选 择 New > WebService Client . 


® New Web Service Client 


Steps WSDL and Client Location 


|, Choose Fle Type Speofy the WSOL He of the Web Service. 
2. WSDL and Client Location : 


($) Project: 
© Local nile: | rose 
Ow pt ] 


© IDE Registered: 








Speofy a package name where the clent java art acts will be generated: 
Project: FXiWebserviceClen: 
Package: 





[C] Generate Dispatch code 


(9 Enter the URL of the service you wish to use. 





sas RA 
F | Ck E * 
8W- EMERAOM 





添加 EJB 组 件 项 目的 LibraryPersistentBean 早 下 创建 WSDL 和 客户 端 位 置 使 用 在 " 编 
译 " 选 项 卡 中 添加 mA “按钮 。 


E Browse Web Services 
Web Services: 


日 g EjbComponent 
ES B ibraryPersistentBean 
6 getBooks: List 








ok SAS eae 


DEDE. GMS EOM 





单 击 “ 完 成 按钮。 在 项 目 资源 管理 器 验证 以 下 结构 。 





asame R - " P^ 
Projects x Files | Services =] | 





t] g EjbComponent 
c» SERES 
= SgEJBWebserviceClient 
(=) (Source Packages 
由 - 国 aMETA-INF 
由 - 国 sMETA-INF,wsdllocalhost_8080,EibComponent 
H- Egeibwebserviceclient 





2 ca Generated Sources (jax-ws) 
i-i H com. tutoriaispaint stateless 








[8 Ee Ee Be 





info, java 


H- Web Service References 
Libraries 


织 梦 内 容 管 理 条 统 


DEDE € M S.C ON 








Create EJBWebServiceClient.java 


package ejbwebserviceclient; 


public class EJBWebServiceClient { 
public static void main(String[] args) { 


j 


如 下 图 所 示 ， 选 择 Web 服 务 getBooks Web 方 法 ， 将 其 拖 动 到 代码 窗口 
EJBWebServiceClient, 


TutorialsPoint Java 技术 教程 


$ EJBWebServiceClient - NetBeans IDE 7.2 
‘file Edt view Navigate Source Refactor Run Debug Profile Team Tools Window Help Qy 0o 


HASIE c VT BDH O- 
35? EmWebservicech gga 
[Source | History (I. [i 上 分 BS 


package ejbuebserviceclient; 








H- Elbcompenent 
P-E EXTeser | 
2 SpgkBWebservicechent public class BdBWebServiceClient | 
$- Eja Source Packages 
v Generated Sources (jax) 
aB Web Service References 
5 [S] UbroryPersistentBean 
G & UbxaryService : public static void mein(String[] args) { 
i BB LibraryPersistent&eanPort 
| ^w getfooks 
由 Lg Lbraries 











[SessionFactoryÜbjectFactory] Faca 
10:51:37,209 INFO (NamingHelper] INDI InitialConta» 
10:51:37,209 INFO [SessionFactoryÜbjectFactory] Boi 

lal 10:51:37,209 VAIN  [SazzionFactoryÜbjectFactory] Ini 
ge 10:51:37,256 INFO (NamingHelper} JNDI InitisiConte: 
51:37,271 INFO [(SessionSpecContainer) Startin 





会 看 到 类 似 的 输出 如 下 所 示 。 


EJB Web Services - EJB 444 


TutorialsPoint Java 技术 教程 


$ EJBWebServiceClient - NetBeans IDE 7.2 
Ble Edt View Navigate Source Refactor Run Debug Profile Team Tods Window Help Qr Sori 0 =!) 


EGS OE eme VT Bd ERO 





(Projects x Files | 





B- Elbcompenent 
P-E EXTeser 
=) SpgEBWebServiceclient 
由 - 国 g5ource Packages 
2B Generated Sources (faxes) 
=) GQ Web Service References ji 
i [S] UbroryPersistentBean 
G & LibearyServicé : public static void mein(String[] args) { 
fs) B. LibraryPersistent&eanPort 
© getfooks 
® Lg Lbraries } 


package ejbuebserviceclient; 


public class EJBWebServiceClient | 


€90 «3 Ov ne ON be 





private static java.util. List<com. tutorials 
com, tutorialspoint. stateless. Libraryser 
com. tutorialspoint. stateless, Libraryler 


ort.getBooks() 











Output x 国 | 
D | JBoss Application Server. x Retriever Output x | EDBWeb5er' «du 
=p 10:51:37,209 INFO {SessionFactory0bjectFactory} FacA| 
» 10:51:37,209 INFO  [NamingHelpor] JNDI InitiaiConte 
10:51:37,209 INFO [SessionFactoryÜbjectFactory] Boi 
lal 10:51:37,209 VAIN  [SazzionFactoryÜbjectFactory] Ini 


和 INFO (NamingHelper} JNDI InitisiConte: 
10:51:37,271 INFO ([(SessionSpecContainer] Starcin 
3 v ies = 








更 新 EJBWebServiceClient 的 代码 使 用 此 方法 。 


EJB Web Services - EJB 445 


package ejbwebserviceclient; 
public class EJBWebServiceClient { 


public static void main(String[] args) { 
for(com.tutorialspoint.stateless.Book book: getBooks()){ 


System.out.println(book.getName()); 


} 
} 


private static java.util.List 
<com.tutorialspoint.stateless.Book> getBooks() { 


com.tutorialspoint.stateless.LibraryService service = 
new com.tutorialspoint.stateless.LibraryService(); 

com.tutorialspoint.stateless.LibraryPersistentBean port 
service.getLibraryPersistentBeanPort(); 


return port.getBooks(); 


} 
} 
.— UV 一 PR thu 
i5 fT $£& P Wm 
点 击 项 目 名 称 ， 项 目 资 源 管理 器 窗口 。 选 择 "Run”。 NetBeans 将 生成 客户 端 并 


它 。 验 证 下 面 的 输出 。 


ant -f D:\SVN\EJBWebServiceClient run 

init: 

Deleting: D:SVNEJBWebServiceClientuilduilt-jar.properties 
deps-jar: 

Updating property file: D:SVNEJBWebServiceClientuilduilt-jar.prope! 
wsimport-init: 

wsimport-client-LibraryPersistentBean: 

files are up to date 

classLoader = java.net.URLClassLoader@4ce46c 
SharedSecrets.getJavaNetAccess()-java.net.URLClassLoader$70182cdac 
wsimport-client-generate: 

Compiling 1 source file to D:SVNEJBWebServiceClientuildclasses 
compile: 

run: 

learn java 

Learn Spring 

learn JSF 

Learn HTML 

Learn JBoss 

Learn EJB 

Learn Hibernate 

Learn IBatis 

Times Now 

learn html5 

Learn images 

Learn Testing 

Forbes 

testi 

BUILD SUCCESSFUL (total time: 1 second) 


| 


EJB 封 效应 用 - EJB 


封装 要 求 应 用 程序 使 用 EJB 3.0 是 类 似 于 J2EE 平 台 。 EJB 组 件 打包 成 jar 文 件 的 模块 
被 打包 成 ear 文 件 的 应 用 企业 为 档 。 主要 的 企业 应 用 程序 有 三 个 组 成 部 分 。 


e jar - Javan AR jai, GSES, EBS 户 端 模块 和 实用 模块 。 
e war - Web 应 用 程序 为 档 ， 包 含 Web 模 块 。 
e ear - 企业 应 用 程序 为 档 包 括 jars 和 war 模块 . 


m «default package 7 
3 a EnterpriseApplication-ejb.jar 
S- F «default package 
[S] Test.class 
cH META-INF 
[e] MANIFEST.MF 
图 jboss.xml 
=| EnterpriseApplication-war.war 
ES «default package 
GP] index.jsp 
= EE META-INF 
[e] MANIFEST.MF 
S- [F wEB-INF 
… 国 jboss-web,xml 
Du web.xml 
EE] WEB-INF.classes 
e META-INF 
i- [S] MANIFEST.MF 
i 图 jboss-app.xml 


在 NetBeans 它 是 很 容易 的 创建 ， 开 发 ， 打 包 和 部 署 J2EE 应 用 程序 。 


在 NetBeans IDE 中 ， 选 择 File>New Project> 选 择 项 目 类 型 为 企业 应 用 程序 的 
JavaEE 项 目 类 型 。 Fave Ciara 输入 项 目的 名 称 和 位 置 。 单 击 “Finish >“ 按 
钮 。 我 们 选 T 3; EnterpriseApplicaton, 


选择 服务 器 和 设置 。 保 持 创 建 EJB 模 块 “ 和 "创建 Web 应 用 程序 模块 检查 提供 的 默认 
名 称 。 单 击 “ 完 成 按钮 。 NetBeans 将 创建 下 列 结构 在 项 目 窗口 。 


ED 


zi &\gEnterpriseApplication 
B-A Java EE Modules 
i @ EnterpriseApplication-war.war 
g EnterpriseApplication-ejb.jar 
HCA Configuration Files 
由 (aggserver Resources 
局 Qj EnterpriseApplication-ejb 
trjg Source Packages 
H- Libraries 
H-È Enterprise Beans 
&- Gg Configuration Files 
E: [号 65erver Resources 
()gEnterpriseApplication-war 
iH Gg Web Pages 
(HG gSource Packages 
H- Libraries 
H-E Configuration Files 
由 (Gg gServer Resources 


项 目 企 业 在 项 目 资源 管理 器 中 的 应 用 上 点 击 右键 并 选择 “生成 ”。 


ant -f D:\SVN\EnterpriseApplication dist 
pre-init: 

init-private: 

init-userdir: 

init-user: 

init-project: 

do-init: 

post-init: 

init-check: 

init: 

deps-jar: 

deps-j2ee-archive: 
EnterpriseApplication-ejb.init: 
EnterpriseApplication-ejb.deps-jar: 
EnterpriseApplication-ejb.compile: 
EnterpriseApplication-ejb.library-inclusion-in-manifest: 


Building jar: D:SVNEnterpriseApplicationEnterpriseApplication-ejbd: 


EnterpriseApplication-ejb.dist-ear: 
EnterpriseApplication-war.init: 
EnterpriseApplication-war.deps-module-jar: 
EnterpriseApplication-war.deps-ear-jar: 
EnterpriseApplication-ejb.init: 
EnterpriseApplication-ejb.deps-jar: 
EnterpriseApplication-ejb.compile: 
EnterpriseApplication-ejb.library-inclusion-in-manifest: 
EnterpriseApplication-ejb.dist-ear: 
EnterpriseApplication-war.deps-jar: 
EnterpriseApplication-war.library-inclusion-in-archive: 
EnterpriseApplication-war.library-inclusion-in-manifest: 
EnterpriseApplication-war.compile: 


EnterpriseApplication-war.compile-jsps: 
EnterpriseApplication-war.do-ear-dist: 


Building jar: D:SVNEnterpriseApplicationEnterpriseApplication-ward: 


EnterpriseApplication-war.dist-ear: 
pre-pre-compile: 

pre-compile: 

Copying 1 file to D:SVNEnterpriseApplicationuild 
Copying 1 file to D:SVNEnterpriseApplicationuild 
do-compile: 

post-compile: 

compile: 

pre-dist: 

do-dist-without-manifest: 

do-dist-with-manifest: 


Building jar: D:SVNEnterpriseApplicationdistEnterpriseApplication.: 
post-dist: 


dist: 
BUILD SUCCESSFUL (total time: 1 second) 


[下 


在 这 里 ， 你 可 以 看 到 每 个 jar，war 和 和 ear 文件 带 有 一 个 META-INF 文 件 夹 ， 按 照 J2EE 
规范 的 元 数据 。 





Guava 教 程 


Guava 是 什么 ? 


Guava 是 一 种 基于 开源 的 Java 库 ， 其 中 包含 谷歌 正在 由 他 们 很 多 项 目 使 用 的 很 多 核 
心 库 。 这 个 库 是 为 了 方便 编码 ， 并 减少 编码 错误 。 这 个 库 提供 用 于 集合 ， 缓 存 ， 支 
持原 语 ， 并 发 性 ， 常 见 注解 ， 字 符 串 处 理 ，|/O 和 验证 的 实用 方法 。 


Guava 的 好 你 


标准 化 - Guava 库 是 由 谷歌 托管 。 

e 高 效 - 可 靠 ， 快 速 和 有 效 的 扩展 JAVA 标 准 库 

e 优化 -Guava 库 经 过 高 度 的 优化 。 

e EZ se -增加 JAVA 功 能 和 处 理 能 

e 实用 程序 - 提供 了 经 常 需要 在 应 用 程序 开发 的 许多 实用 程序 类 。 
e 验证 -提供 标准 的 故障 安全 验证 机 制 。 

e 最 佳 实践 - 强调 最 佳 的 做 法 。 

考虑 下 面 的 代码 片段 。 


public class GuavaTester { 
public static void main(String args[]){ 
GuavaTester guavaTester = new GuavaTester(); 
Integer a = null; 
Integer b = new Integer(10); 
System.out.println(guavaTester.sum(a,b)); 


} 


public Integer sum(Integer a, Integer b){ 
return a + b; 
} 
} 


运行 程序 ， 看 到 如 下 结果 。 


Exception in thread "main" java.lang.NullPointerException 
at GuavaTester.sum(GuavaTester.java:13) 
at GuavaTester.main(GuavaTester.java:9) 


以 下 是 该 代码 的 问题 。 

e sum() 不 采取 任何 的 保护 传递 的 参数 为 null。 

。 调用 函数 也 并 不 担心 传递 一 个 null 到 sum () 方法 而 产生 意外 。 

e 当 程 序 运 行 时 ，NullPointerException 异 常 发 生 。 

e 为 了 避免 上 述 问题 ，null 检 查 要 在 每 个 这 样 存 在 问题 地 方 。 

让 我 们 来 看 看 使 用 Optional，Guava 提供 实用 工具 类 来 标准 化 方式 解决 上 述 问题 。 


import com.google.common.base.Optional; 


public class GuavaTester ( 
public static void main(String args[]){ 
GuavaTester guavaTester = new GuavaTester(); 


Integer invalidInput = null; 

Optional<Integer> a = Optional.of(invalidInput); 
Optional<Integer> b = Optional.of(new Integer(10)); 
System.out.println(guavaTester.sum(a,b)); 


j 


public Integer sum(Optional<Integer> a, Optional<Integer> b){ 
return a.get() * b.get(); 


} 
} 


运行 程序 ， 看 到 结果 如 下 。 


Exception in thread "main" java.lang.NullPointerException 
at com.google.common.base.Preconditions.checkNotNull(Precondit: 
at com.google.common.base.Optional.of (Optional. java:85) 
at GuavaTester.main(GuavaTester.java:8) 


二 
让 我 们 来 了 解 上 述 程序 的 一 些 重 要 概念 。 
e Optional - 实用 类 ， 使 代码 使 用 null 能 够 正常 。 
e Optional.of - 返回 要 用 作 参 数 Optional 类 的 实例 。 检 查 传递 的 值 是 否 为 null。 
e Optional.get - 获取 输入 存储 在 Optional 类 的 值 。 
使 用 Optional 类 ， 可 以 方便 地 查看 调用 者 方法 来 传递 参数 正确 与 否 。 





Guava 环 境 设 置 - Guava 教 程 


Guava 本 地 环境 设置 


这 部 分 指导 如 何 下 载 和 设置 Java 在 机 器 上 。 请 按照 以 下 步骤 来 设置 环境 。 
Java SE 人 免费 提供 链接 : 下 载 Java。 所 以 ， 根 据 操作 系统 下 载 对 应 版 本 。 


按照 说 明 下 载 java 和 运行 .exe 在 机 器 上 ， 并 按说 明 安 装 Java。 一 旦 机 器 上 安装 了 
Java， 还 需要 设置 环境 变量 指向 正确 的 JAVA 安装 目录 : 


Windows 2000/XP 设 置 的 路 径 : 


假设 你 已 经 安装 JAVA 在 c:Program Filesjavajdk 目 录 下 : 
。 在 “我 的 电脑 "右键 单 击 并 选择 "属性 "。 
e 在 "高 级 "选项 卡 下 单 击 “ 环 境 变 量 " 按 钮 。 


e 现在 ， 改 变 “Path" 变 量 ， 因 此 ， 它 也 包含 了 路 径 Java 可 执行 文件 。 例 如 ， 路 径 
当前 默认 设置 为 'C:WINDOWSSYSTEM32', 然 后 改变 路 径 修 改 后 就 是 这 
样 : 'C:WINDOWSSYSTEM32;c:Program Filesjavajdkin'. 


Windows95/98/ME3& E 43 : 


假设 你 已 经 安装 JAVA 在 c:Program FilesjavajdkEl # F : 


e 编辑 文件 'C:autoexec.bat' 并 添加 以 下 行 到 文件 的 结尾 : 'SET 
PATH=%PATH%;C:Program Filesjavajdkin' 


Linux, UNIX, Solaris#]FreeBSDi# BEE : 


环境 变量 PATH 应 设置 为 指向 已 安装 的 Java 二 进 制 文件 的 位 置 。 请 参考 您 的 shell 文 
件 ， 如 果 有 麻烦 可 以 这 样 做 。 


例如 ， 如 果 使 用 的 是 bash shell， 那 么 将 下 面 的 行 添加 到 未 尾 '.bashrc: export 
PATH=/path/to/java:$PATH' 


流行 的 Java 编 辑 器 : 


写 Java 程 序 ， 需 要 一 个 文本 编辑 器 。 在 市 场 上 有 很 多 可 用 的 更 复杂 的 IDE。 可 以 考 
虑 下 列 之 一 : 


e Notepad: 在 Windows 机 器 上 ， 可 以 使 用 像 记 事 本 的 简单 的 文本 编辑 器 (本 教程 
推荐 ) ，TextPad。 


e Netbeans: 是 一 个 Java IDE， 它 是 开源 和 免费 的 ， 可 从 以 下 地 址 下 载 
http://www.netbeans.org/index.html. 


e Eclipse: 也 是 一 个 Java IDE 由 Eclipse 开源 社区 开发 ， 可 以 下 载 
http://www.eclipse.org/. 


下 载 Guava 存 档 


从 guava-18.0.jar 下 载 Guava jar 文 件 的 最 新 版 本 。 在 写 这 篇 教程 的 时 候 ， 下 载 最 新 
的 版 本 是 guava-18.0.jar 并 拷贝 到 C:>Guava 目录 。 


OS BRAM 
Windows guava-18.0.jar 
Linux guava-18.0.jar 
Mac guava-18.0.jar 
设置 Guava 环 境 


设置 Guava_HOME 环 境 变量 指向 Guava jar 存储 在 计算 机 上 的 目录 位 置 。 假 设 ， 我 
们 已 经 提取 guava-18.0.jar 在 各 种 操作 系统 的 Guava 文 件 夹 ， 如 下 所 示 。 


OS 输出 
Windows 设置 环境 变量 Guava_HOME 到 C:Guava 
Linux export Guava HOME=/usr/local/Guava 
Mac export Guava HOME=/Library/Guava 

ix i& CLASSPATH & © 


设置 CLASSPATH 环 境 变 量 指向 Guava jar 位 置 。 假 设 ， 我 们 已 经 存储 guava- 
18.0.jar 的 Guava 文 件 夹 在 不 同 的 操作 系统 如 下 。 


os 输出 
设置 环境 变量 CLASSPATH 到 


Windows | %CLASSPATH%:%Guava_HOME%guava-18.0 jar: 
Y export CLASSPATH=$CLASSPATH:$Guava_HOME/guava- 
inux CK 
18.0 jar:. 
oe export CLASSPATH=$CLASSPATH:$Guava_HOME/guava- 


18.0 jar:. 


Guava Optional - Guava 教 程 


Optional 用 于 包含 非 空 对 象 的 不 可 变 对 象 。 Optional 对 象 ， 用 于 不 存在 值 表 示 null。 
这 个 类 有 各 种 实用 的 方法 ， 以 方便 代码 来 处 理 为 可 用 或 不 可 用 ， 而 不 是 检查 null 
{Bo 


44 ok 
X Fa HH 
以 下 是 com.google.common.base.Optional<T> 类 的 声明 : 


@GwtCompatible(serializable=true) 
public abstract class Optional<T> 
extends Object 
implements Serializable 


S.N. 方法 及 说 明 


static <T> Optional<T> absent() 返回 没有 包含 的 参考 Optional 的 实 
例 。 


2 abstract Set<T> asSet() 返回 一 个 不 可 变 的 单 集 的 唯一 元 素 所 包含 的 实 
例 (如 果 存 在 ); 否 则 为 一 个 空 的 不 可 变 的 集合 。 


3 abstract ou equals(Object object) 返回 true 如 果 对 象 是 一 个 
Optional 实 例 ， 无 论 是 包含 引用 彼此 相等 或 两 者 都 不 存在 。 


static <T> Optional<T> fromNullable(T nullableReference) 如 果 
4 nullableReference 非 空 ， 返 回 一 个 包含 引用 Optional 实 例 ;否则 返回 
absent()。 


5 abstract T get() 返回 所 包含 的 实例 ， 它 必须 存在 。 
6 abstract int hashCode() 返回 此 实例 的 哈 希 码 。 
abstract boolean isPresent() 返回 true， 如 果 这 支架 包含 一 个 ( 非 空 ) 的 


实例 。 

8 static <T> Optional<T> of(T reference) 返回 包含 给 定 的 非 空 引用 
Optional 实 例 。 

9 abstract Optional<T> One phenets T extends T» secondChoice) 3x 


回 此 Optional， 如 果 它 有 一 个 值 存 在 ; 否则 返回 secondChoice。 


10 abstract T or(Supplier«? extends T» supplier) 返回 所 包含 的 实例 (如 
果 存 在 ); 否则 supplier.get()。 


abstract T or(T defaultValue) 返回 所 包含 的 实例 (如 果 存 在 ); 否 则 为 默 
认 值 。 


12 abstract T orNull() 返回 所 包含 的 实例 (如 果 存 在 ); 否 则 返回 null。 


static <T> lterable<T> presentlnstances(lterable<? extends 
13 Optional<? extends T>> optionals) 从 提供 的 optionals 返 回 每 个 实例 
的 存在 的 值 ， 从 而 跳 过 absent()。 


14 abstract String toString() 返回 此 实例 的 字符 串 表 示 。 


abstract <V> Optional<V> transform(Function<? super TV> 
15 function) 如 果实 例 存在 ， 则 它 被 转换 给 定 的 功能 ;否则 absent() 被 返 


o 


继承 的 方法 


这 个 类 继承 了 以 下 类 的 方法 : 


e java.lang.Object 


Optional 示 例 : 


使 用 所 选择 的 编辑 器 ， 创 建 下 面 的 java 程 序 ， 比 如 C:/> Guava 


GuavaTester.java 


import com.google.common.base.Optional; 


public class GuavaTester ( 
public static void main(String args[]){ 
GuavaTester guavaTester = new GuavaTester(); 


Integer Valuel null; 

Integer value2 new Integer(10); 

//Optional.fromNullable - allows passed parameter to be null 
Optional«Integer» a = Optional.fromNullable(value1); 
//Optional.of - throws NullPointerException if passed paramet 
Optional«Integer» b - Optional.of(value2); 


System.out.println(guavaTester.sum(a,b)); 


j 

public Integer sum(Optional<Integer> a, Optional<Integer> b){ 
//Optional.isPresent - checks the value is present or not 
System.out.println("First parameter is present: " + a.isPrese 
System.out.println("Second parameter is present: " + b.isPre: 
//Optional.or - returns the value if present otherwise returr 
//the default value passed. 
Integer valuei = a.or(new Integer(0)); 


//Optional.get - gets the value, value should be present 
Integer value2 - b.get(); 


return value1 + value2; 





验证 结果 


使 用 javac 编 译 器 编译 如 下 类 


C:\Guava>javac GuavaTester.java 


现在 运行 GuavaTester 看 到 的 结果 


C:\Guava>java GuavaTester 


到 结果 。 


First parameter is present: false 
Second parameter is present: true 
10 


Guava Preconditions 类 - Guava 教 程 


Preconditions 提 供 静 态 方法 来 检查 方法 或 构造 画 数 ， 被 调用 是 否 给 


它 检查 的 先决 条 件 。 其 方法 失败 抛 出 llegalArgumentException。 


MA = 
A FAR 
以 下 是 com.google.common.base.Preconditions 类 的 声明 : 


@GwtCompatible 
public final class Preconditions 
extends Object 


定 适 当 的 参数 。 


S.N. 
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方法 及 说 明 


static void checkArgument(boolean expression) 确保 涉及 的 一 个 或 
多 个 参数 来 调用 方法 表达 式 的 真相 。 


static void checkArgument(boolean expression, Object 
errorMessage) 确保 涉及 的 一 个 或 多 个 参数 来 调用 方法 表达 式 的 真相 。 


static void checkArgument(boolean expression, String 
errorMessageTemplate, Object... errorMessageArgs) 确保 涉及 的 一 
个 或 多 个 参数 来 调用 方法 表达 式 的 真相 。 


static int checkElementIndex(int index, int size) 确保 索引 指定 一 个 


数组 ， 列 表 或 尺寸 大 小 的 字符 串 有 效 的 元 素 。 


static int checkElementindex(int index, int size, String desc) 确保 


索引 指定 一 个 数组 ， 列 表 或 尺寸 大 小 的 字符 串 有 效 的 元 素 。 


static «T» T checkNotNull(T reference) 确保 对 象 引用 作为 参数 传递 
给 调用 方法 不 为 空 。 


static <T> T checkNotNull(T reference, Object errorMessage) 确保 
对 象 引 用 作为 参数 传递 给 调用 方法 不 为 空 。 


static <T> T checkNotNull(T reference, String 
errorMessageTemplate, Object... errorMessageArgs) 确保 对 象 引用 
作为 参数 传递 给 调用 方法 不 为 空 。 


static int checkPositionIndex(int index, int size) 确保 索引 指定 一 个 


数组 ， 列 表 或 尺寸 大 小 的 字符 串 的 有 效 位 置 。 


static int checkPositionIndex(int index, int size, String desc) 确保 


索引 指定 一 个 数组 ， 列 表 或 尺寸 大 小 的 字符 串 的 有 效 位 置 。 


static void checkPositionlndexes(int start, int end, int size) 确保 开 


始 和 结束 指定 数组 ， 列 表 或 字符 串 大 小 有 效 的 位 置 ， 并 按照 顺序 。 


static void checkState(boolean expression) 确保 涉及 调用 实例 的 状 
态 ， 但 不 涉及 任何 参数 来 调用 方法 表达 式 的 真相 。 


static void checkState(boolean expression, Object errorMessage) 
确保 涉及 调用 实例 的 状态 ， 但 不 涉及 任何 参数 来 调用 方法 表达 式 的 真 
相 。 

static void checkState(boolean expression, String 


errorMessageTemplate, Object... errorMessageArgs) 确保 涉及 调用 
实例 的 状态 ， 但 不 涉及 任何 参数 来 调用 方法 表达 式 的 真相 。 


继承 的 方法 


这 个 类 继承 了 以 下 类 方法 : 


e java.lang.Object 


Preconditions 示例 


使 用 所 选择 的 编辑 器 ， 创 建 下 面 的 java 程 序 比如 C:/> Guava 


GuavarTester.java 


import com.google.common.base.Preconditions; 
public class GuavaTester { 


public static void main(String args[]){ 
GuavaTester guavaTester = new GuavaTester(); 
try { 
System.out.println(guavaTester.sqrt(-3.0)); 
}catch(IllegalArgumentException e){ 
System.out.println(e.getMessage()); 
} 


try { 
System.out.println(guavaTester.sum(null,3)); 


jcatch(NullPointerException e){ 
System.out.println(e.getMessage()); 
} 


try { 
System.out.println(guavaTester.getValue(6)); 


}catch(IndexOutOfBoundsException e){ 
System.out.println(e.getMessage()); 
} 


} 


public double sqrt(double input) throws IllegalArgumentExceptior 
Preconditions.checkArgument(input > 0.0, 
"Illegal Argument passed: Negative value %s.", input); 
return Math.sqrt(input); 


} 


public int sum(Integer a, Integer b){ 
a = Preconditions.checkNotNull(a, 
"Illegal Argument passed: First parameter is Null."); 
b = Preconditions.checkNotNull(b, 
"Illegal Argument passed: Second parameter is Null."); 
return a+b; 


} 


public int getValue(int input){ 
int[] data = {1,2,3,4,5}; 
Preconditions.checkElementIndex(input,data.length, 
"Illegal Argument passed: Invalid index."); 
return 0; 





验证 结果 


使 用 javac 编 译 器 编译 如 下 类 


C:\Guava>javac GuavaTester.java 


现在 运行 GuavaTester 看 到 的 结果 


C:\Guava>java GuavaTester 


Illegal Argument passed: Negative value -3.0. 
Illegal Argument passed: First parameter is Null. 
Illegal Argument passed: Invalid index. (6) must be less than size 


EN) 





Guava Ordering X - Guava 教 程 


Ordering( 排 序 ) 可 以 被 看 作 是 一 个 丰富 的 比较 具有 增强 功能 的 链接 ， 多 个 实用 方 
法 ， 多 类 型 排序 功能 


we = 
类 两 明 
以 下 是 com.google.common.collect.Ordering<T> 类 的 声明 : 


@GwtCompatible 
public abstract class Ordering<T> 
extends Object 
implements Comparator<T> 


类 方法 


S.N. 方法 及 说 明 


static Ordering<Object> allEqual() 返回 一 个 排序 ， 它 把 所 有 的 值 相 
1 等 ， 说 明 “ 没 有 顺序 。" 通 过 这 个 顺序 以 任何 稳定 的 排序 算法 的 结果 ， 在 
改变 没有 顺序 元 素 。 


static Ordering<Object> arbitrary() 返回 一 个 任意 顺序 对 所 有 对 象 ， 


: 其 中 compare(a, b) == 0 意味 着 a == b (身份 平等 ) 。 

3 int binarySearch(List<? extends T> sortedList, T key) 搜索 排序 列 
表 使 用 键 的 二 进 制 搜索 算法 。 

4 abstract int compare(T left, T right) 比较 两 个 参数 的 顺序 。 


<U extends T> Ordering<U> compound(Comparator<? super U> 
5 secondaryComparator) 返回 首先 使 用 排序 这 一 点 ， 但 它 排序 中 
的 “tie”， 然 后 委托 给 secondaryComparator 事 件 。 


static <T> Ordering<T> compound(Iterable<? extends 


6 Comparator<? super T>> comparators) 返回 一 个 排序 它 党 试 每 个 给 
定 的 比较 器 ， 以 便 直 到 一 个 非 需 结果 找到 ， 返 回 该 结果 ， 并 返回 需 仅 当 
所 有 上 比较 器 返回 需 。 


static <T> Ordering<T> explicit(List<T> valuesInOrder) 返回 根据 它 
‘ 们 出 现 的 定 列表 中 的 顺序 比较 对 象 进行 排序 。 


static <T> Ordering<T> explicit(T leastValue, T... 
8 remainingValuesInOrder) 返回 根据 它们 所 赋予 本 方法 的 顺序 进行 比较 
的 对 象 进 行 排序 。 


10 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


static <T> Ordering<T> from(Comparator<T> comparator) 返回 基 
于 现 有 的 比较 实例 进行 排序 。 


«E extends T» List<E> greatestOf(Iterable«E» iterable, int k) 返回 
根据 这 个 顺序 给 出 迭代 ， 为 了 从 最 大 到 最 小 的 k 个 最 大 的 元 素 。 
«E extends T» List<E> greatestOf(Iterator<E> iterator, int k) 返回 
从 给 定 的 迭代 器 按照 这 个 顺序 ， 从 最 大 到 最 小 k 个 最 大 的 元 素 。 


<E extends T> ImmutableList<E> 
immutableSortedCopy(Iterable<E> elements) 返回 包含 的 元 素 排 序 
这 种 排序 的 不 可 变 列 表 。 


boolean isOrdered(Iterable«? extends T» iterable) 返回 true 如 果 在 
迭代 后 的 第 一 个 的 每 个 元 素 是 大 于 或 等 于 在 它 之 前 ， 根 据 该 排序 的 元 
素 。 


boolean isStrictlyOrdered(Iterable«? extends T» iterable) 返回 true 
well M dL D 根据 该 排序 的 元 
素 更 大 。 


«E extends T» List<E> leastOf(Iterable<E> iterable, int k) 返回 根据 
这 个 顺序 给 出 和 迭代， 从 而 从 低 到 最 大 的 k 个 最 低 的 元 素 。 


«E extends T» List<E> leastOf(Iterator<E> elements, int k) 返回 第 k 
从 给 定 的 迭代 器 ， 按 照 这 个 顺序 从 最 低 到 最 大 至 少 元 素 。 


<S extends T> Ordering<lterable<S>> lexicographical() 返回 一 个 新 
的 排序 它 通过 上 比较 对 应 元 素 两 两 直到 非 需 结果 发 现 排 序 迭 代 ; 规 定 “ 字 典 
顺序 ”。 


<E extends T> E max(E a, E b) 返回 两 个 值 按照 这 个 顺序 的 较 大 值 。 


<E extends T> E max(E a, E b, E c, E... rest) 返回 指定 的 值 ， 根 据 这 
个 顺序 是 最 大 的 。 


«E extends T» E max(Iterable<E> iterable) 返回 指定 的 值 ， 根 据 这 个 
顺序 是 最 大 的 。 


«E extends T» E max(Iterator<E> iterator) 返回 指定 的 值 ， 根 据 这 个 
顺序 是 最 大 的 。 


«E extends T» E min(E a, E b) 返回 两 个 值 按照 这 个 顺序 的 较 小 者 。 


«E extends T» E min(E a, E b, E c, E... rest) 返回 最 少 指定 的 值 ， 根 
据 这 个 顺序 。 


«E extends T» E min(Iterable<E> iterable) 返回 最 少 指定 的 值 ， 根 据 


这 个 顺序 。 
«E extends T» E min(Iterator<E> iterator) 返回 最 少 指定 的 值 ， 根 据 
这 个 顺序 。 


static «C extends Comparable> Ordering<C> natural() 返回 使 用 值 
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32 


的 自然 顺序 排序 序列 化 。 


<S extends T> Ordering<S> nullsFirst() 返回 对 待 null 小 于 所 有 其 他 
值 ， 并 使 用 此 来 比较 非 空 值 排序 。 


«S extends T» Ordering<S> nullsLast() 返回 对 待 null 作 为 大 于 所 有 其 
他 值 ， 并 使 用 这 个 顺序 来 比较 非 空 值 排序 。 


<F> Ordering<F> onResultOf(Function<F,? extends T> function) 
返回 一 个 新 的 排序 在 FE 上 ， 首 先 应 用 功能 给 它们 ， 然 后 比较 使 用 此 这 些 
结果 的 顺序 元 素 。 


<S extends T> Ordering<S> reverse() 返回 相反 顺序 ; 顺序 相当 于 
Collections.reverseOrder (Comparator) 。 


«E extends T» List<E> sortedCopy(Iterable<E> elements) 返回 包 
含 的 元 素 排序 此 排序 可 变 列表 ;使 用 这 个 只 有 在 结果 列表 可 能 需要 进一步 
修改 ， 或 可 能 包含 null。 


static Ordering<Object> usingToString() 返回 由 它们 的 字符 串 表 示 的 
自然 顺序 ，toString() 比 较 对 象 进行 排序 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


Order 


ing 示例 


使 用 所 选择 的 编辑 器 ， 创 建 下 面 的 java 程 序 比如 C:/> Guava 


Guavatester.java 


import 
import 
import 
import 


public 
pub 


java.util.ArrayList; 
java.util.Collections; 
java.util.List; 
com.google.common.collect.Ordering; 


class GuavaTester { 

lic static void main(String args[]){ 
List<Integer> numbers = new ArrayList<Integer>(); 
numbers.add(new Integer(5)); 

numbers.add(new Integer(2)); 

numbers.add(new Integer(15)); 

numbers.add(new Integer(51)); 

numbers.add(new Integer(53)); 

numbers.add(new Integer(35)); 


numbers.add(new Integer(32)); 
numbers.add(new Integer(43)); 
numbers.add(new Integer(16)); 


Ordering ordering - Ordering.natural(); 
System.out.println("Input List: "); 
System.out.println(numbers); 


Collections.sort(numbers,ordering ); 
System.out.println("Sorted List: "); 
System.out.println(numbers); 


System.out.println("zzzzzzzzzzzz------z----z"); 
System.out.println("List is sorted: " + ordering.isOrdered(nt 
System.out.println("Minimum: " + ordering.min(numbers)); 
System.out.println( "Maximum: " + ordering.max(numbers)); 


Collections.sort(numbers, ordering.reverse()); 
System.out.println("Reverse: " + numbers); 


numbers.add(null); 
System.out.println("Null added to Sorted List: "); 
System.out.println(numbers); 


Collections.sort(numbers,ordering.nullsFirst()); 
System.out.println("Null first Sorted List: "); 
System.out.println(numbers); 
System.out.println("zzzzzzzzzzzz---------zz"); 


List«String» names = new ArrayList<String>(); 
names .add("Ram"); 
names . add ("Shyam"); 
names .add("Mohan"); 
names.add("Sohan"); 
names.add("Ramesh"); 
names.add("Suresh"); 
names.add("Naresh"); 
names.add("Mahesh"); 
names.add(null); 
names.add("Vikas"); 
names.add("Deepak"); 


System.out.println("Another List: "); 
System.out.println(names); 


Collections.sort(names,ordering.nullsFirst().reverse()); 
System.out.println("Null first then reverse sorted list: "); 
System.out.println(names); 








验证 结果 
使 用 javac 编 译 器 编译 如 下 类 


C:\Guava>javac GuavaTester.java 


现在 运行 GuavaTester 看 到 的 结果 


C:\Guava>java GuavaTester 


看 到 结果 。 


Input List: 

(5,2; 15, 51, 53, 35, 45, 32° 43 16] 
Sorted List: 

[2 5,15, T6. 32. 35, 49,045 Si, 53] 


List is sorted: true 

Minimum: 2 

Maximum: 53 

Reverse: [53, 51, 45, 43, 35, 32, 16, 15, 5, 2] 
Null added to Sorted List: 

[53, 51, 45, 43, 35, 32, 16, 15, 5, 2, null] 
Null first Sorted List: 

[null, 2, 5, 15, 16, 32, 35, 43, 45, 51, 53] 


Another List: 
[Ram, Shyam, Mohan, Sohan, Ramesh, Suresh, Naresh, Mahesh, null, V: 


Null first then reverse sorted list: 
[Vikas, Suresh, Sohan, Shyam, Ramesh, Ram, Naresh, Mohan, Mahesh, I 


[i eee LLL 





Guava Objects 类 - Guava 教 程 

Objects # #24455 AF PAA st, equals, hashCode 44 BER EX 
类 声明 

以 下 是 com.google.common.base.Objects 类 的 声明 : 


@GwtCompatible 
public final class Objects 
extends Object 


类 方法 

S.N. 方法 及 说 明 

1 static boolean equal(Object a, Object b) 确定 两 个 可 能 是 空 的 对 象 是 
否 相等 。 
static <T> T firstNonNull(T first, T second) 不 推荐 使 用 。 使 用 

2 MoreObjects.firstNonNull (T, T) 来 代替 。 定 于 2016 年 6 月 去 除 该 方 
2 

3 static int hashCode(Object... objects) 生成 多 个 值 的 哈 希 码 。 


static Objects.ToStringHelper toStringHelper(Class<?> clazz) 不 推 
4 荐 使 用 。 使 用 MoreObjects.toStringHelper (Class) 来 代替 。 定 于 2016 
年 6 月 去 除 该 方法 。 


static Objects.ToStringHelper toStringHelper(Object self) 不 推荐 使 
5 用 。 使 用 MoreObjects.toStringHelper (Object) 来 代替 。 定 于 2016 年 6 
月 去 除 该 方法 。 


static Objects.ToStringHelper toStringHelper(String className) 
6 不 推荐 使 用 。 使 用 MoreObjects.toStringHelper (String) 来 代替 。 定 于 
2016 年 6 月 去 除 该 方法 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


Objects 示例 


使 用 所 选择 的 编辑 器 ， 创 建 下面 的 java 程 序 比如 C:/> Guava 


GuavaTester.java 


import com.google.common.base.Objects; 


public class GuavaTester { 


} 


public static void main(String args[]){ 
Student s1 = new Student("Mahesh", "Parashar", 1, "VI"); 
Student s2 = new Student("Suresh", null, 3, null); 


System.out.println(si.equals(s2)); 

System.out.println(si.hashCode()); 

System.out.println( 

Objects.toStringHelper(s1) 
.add("Name",si.getFirstName()+" " + s1.getLastName( )) 
.add("Class", si.getClassName() ) 

.add("Roll No", si.getRollNo()) 
.toString()); 


class Student ( 


private String firstName; 
private String lastName; 
private int rollNo; 

private String className; 


public Student(String firstName, String lastName, int rollNo, Si 


this.firstName - firstName; 
this.lastName - lastName; 
this.rollNo - rollNo; 
this.className - className; 


j 


QOverride 
public boolean equals(Object object){ 
if(!(object instanceof Student) || object == null){ 
return false; 


Student student - (Student)object; 

// no need to handle null here 

// Objects.equal("test", "test") -- true 
// Objects.equal("test", null) -- false 
// Objects.equal(null, "test") -- false 
// Objects.equal(null, null) -- true 


return Objects.equal(firstName, student.firstName) // first 1 
&& Objects.equal(lastName, student.lastName) // last name 
&& Objects.equal(rollNo, student.rollNo) 

&& Objects.equal(className, student.className);// class n: 


} 


@Override 

public int hashCode()( 
//no need to compute hashCode by self 
return Objects.hashCode(className, rollNo); 


public String getFirstName() ( 
return firstName; 


public void setFirstName(String firstName) { 
this.firstName - firstName; 
} 


public String getLastName() { 
return lastName; 


public void setLastName(String lastName) { 
this.lastName = lastName; 
} 


public int getRollNo() { 
return rollNo; 


public void setRollNo(int rollNo) { 
this.rollNo - rollNo; 
} 


public String getClassName() { 
return className; 


public void setClassName(String className) { 
this.className = className; 





验证 结果 


使 用 javac 编 译 器 编译 如 下 类 


C:\Guava>javac GuavaTester.java 


现在 运行 GuavaTester 看 到 的 结果 


C:\Guava>java GuavaTester 


看 到 结果 。 


false 
85871 
Student{Name=Mahesh Parashar, Class=VI, Roll No=1} 


Guava Range X - Guava 教 程 


Range 表示 一 个 间隔 或 一 个 序列 。 它 被 用 于 获取 一 组 数字 / 串 在 一 个 特定 范围 之 
JA —- 

类 两 明 

以 下 是 com.google.common.collect.Range<C> 类 的 声明 : 


@GwtCompatible 
public final class Range<C extends Comparable> 
extends Object 
implements Predicate<C>, Serializable 


方法 


S.N. 方法 及 说 明 


static <C extends Comparable<?>> Range<C> all() 返回 包含 C 型 的 
每 一 个 值 范 转 


2 boolean apply(C input)Deprecated. 只 有 提供 满足 谓词 接口 ;使 用 包含 
(CHEK ES. 

3 static <C extends Comparable<?>> Range<C> atLeast(C 
endpoint) 返回 包含 大 于 或 等 于 终点 (endpoint) 的 所 有 值 的 范围 内 。 

4 static <C extends Comparable<?>> Range<C> atMost(C endpoint) 
返回 包含 的 所 有 值 小 于 或 等 于 终点 的 范围 内 。 

5 Range<C> canonical(DiscreteDomain<C> domain) 返回 此 范围 内 ， 
在 给 定 域 中 的 规范 形式 。 

6 static <C extends Comparable<?>> Range<C> closed(C lower, C 


upper) 返回 包含 大 于 所 有 值 或 等 于 降低 且 小 于 或 等 于 上 限 的 范围 内 。 


static <C extends Comparable<?>> Range<C> closedOpen(C 
7 lower, C upper) 返回 包含 大 于 或 等 于 下 限 和 所 有 值 严格 大 于 上 限 以 下 


的 范围 内 。 
8 boolean contains(C value) 返回 true， 如 果 值 是 这 个 范围 的 范围 之 
内 。 
9 boolean containsAll(Iterable«? extends C» values) 如 果 值 每 一 个 元 


素 都 包含 在 这 个 范围 内 ， 则 返回 true。 


10 


11 


12 


13 


14 


15 
16 
17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


static <C extends Comparable<?>> Range<C> downTo(C 
endpoint, BoundType boundType) 返回 的 范围 内 的 给 定 的 端点 ， 它 可 
以 是 包容 性 〈 闭 合 ) 或 专用 ( 开 ) ， 没 有 上 限 。 


static <C extends Comparable<?>> Range<C> 
encloseAll(Iterable<C> values) 返回 包含 所 有 给 定 值 的 最 小 范围 内 。 


boolean encloses(Range<C> other) 返回 true， 如 果 其 他 的 边界 不 在 
该 范围 的 边界 之 外 延伸 。 


boolean equals(Object object) 返回 true， 如 果 对 象 是 具有 相同 端 
绑 定 类 型 ， 这 个 范围 内 的 范围 。 


static <C extends Comparable<?>> Range<C> greaterThan(C 
endpoint) 返回 一 个 包含 所 有 值 严 格 大 于 端点 的 范围 内 。 


int hashCode() 返回 此 范围 内 的 哈 希 码 。 
boolean hasLowerBound() 如 果 此 范围 内 具有 更 低 的 终点 返回 true。 
boolean hasUpperBound() 如 果 此 范围 内 有 上 端点 返回 true。 


Range<C> intersection(Range<C> connectedRange) 返回 由 两 者 范 
围 和 connectedRange 封 闭 ， 如 果 这 样 的 范围 存在 的 最 大 范围 。 


boolean isConnected(Range<C> other) 如 果 存 在 这 是 由 两 者 此 范围 
和 其 他 封闭 (可 能 为 空 ) 的 范围 ， 则 返回 true。 

boolean isEmpty() 返回 true， 如 果 这 个 范围 是 形式 [v..v) & (v..v]. 
static <C extends Comparable<?>> Range<C> lessThan(C 
endpoint) 返回 一 个 包含 所 有 值 严格 小 于 端点 的 范围 内 。 

BoundType lowerBoundType() 返回 类 型 这 个 范围 的 下 限 : 如 果 范 围 
包括 它 的 下 端点 BoundType.CLOSED， 如 果 没 有 BoundType.OPEN。 
C lowerEndpoint() 返回 该 范围 的 较 低 端点 。 


static <C extends Comparable<?>> Range<C> open(C lower, C 
upper) 返回 一 个 包含 所 有 值 严 格 大 于 下 限 和 严格 比 上 端 更 小 一 个 范围 。 


static <C extends Comparable<?>> Range<C> openClosed(C 
lower, C upper) 返回 包含 所 有 值 严格 低 于 更 大 且 小 于 或 等 于 上 限 的 范 
内 。 


static <C extends Comparable<?>> Range<C> range(C lower, 
BoundType lowerType, C upper, BoundType upperType) 返回 包含 
任何 值 由 下 到 上 ， 每 个 端点 可 以 是 包容 性 (KA) REA OT) 的 范 
围 。 


static «C extends Comparable<?>> Range<C> singleton(C value) 
返回 包含 只 在 给 定 范围 内 的 值 。 


Range<C> span(Range<C> other) 返回 最 小 的 范围 包围 两 者 这 个 范围 
和 other 等 。 


29 


30 


31 


32 


String toString() 返回 该 范围 内 的 字符 串 表 示 ， 如 "[3..5) ”( 其 他 实例 
列 在 类 文档 ) 。 


BoundType upperBoundType() 返回 类 型 此 范围 的 上 限 : 如 果 范 围 包 
括 其 上 的 端点 返回 BoundType.CLOSED， 如 果 没 有 返回 
BoundType.OPEN。 


C upperEndpoint() 返回 此 范围 的 上 限 端点 。 


static <C extends Comparable<?>> Range<C> upTo(C endpoint, 
BoundType boundType) 返回 一 个 范围 ， 没 有 下 限 到 给 定 的 端点 ， 它 
可 以 是 包容 性 (闭合 ) 或 专用 ( 开 ) 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java. 


lang.Object 


Range 例子 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> Guava 


GuavaTester.java 


import 
import 
import 
import 
public 


pub 


} 


pri 


com.google.common.collect.ContiguousSet; 
com.google.common.collect.DiscreteDomain; 
com.google.common.collect.Range; 
com.google.common.primitives.Ints; 


class GuavaTester { 

lic static void main(String args[]){ 
GuavaTester tester = new GuavaTester(); 
tester.testRange(); 


vate void testRange(){ 


//create a range [a,b] (x | a <= x <= b) 
Range<Integer> range1 = Range.closed(0, 9); 


System.out.print("[0,9] : "); 

printRange(range1); 

System.out.println("5 is present: " + rangei.contains(5)); 
System.out.println("(1,2,3) is present: " + range1.containsA- 
System.out.println("Lower Bound: " + rangei.lowerEndpoint()), 


System.out.println("Upper Bound: " + rangei.upperEndpoint()), 


//create a range (a,b) = (x | a < x < b) 


si 


j 


j 


Range<Integer> range2 = Range.open(0, 9); 
System.out.print("(0,9) : "); 
printRange(range2); 


//create a range (a,b] = (x | a«x <= b} 
Range<Integer> range3 = Range.openClosed(0, 9); 
System.out.print("(0,9] : "); 
printRange(range3); 


//create a range [a,b) = { x | a <= x « bj 
Range<Integer> range4 = Range.closedOpen(0, 9); 
System.out.print("[0,9) : "); 
printRange(range4); 


//create an open ended range (9, infinity 
Range<Integer> range5 = Range.greaterThan(9); 


System.out.println("(9,infinity) : "); 
System.out.println("Lower Bound: " + range5.lowerEndpoint()), 
System.out.println("Upper Bound present: " + range5.hasUppert 


Range<Integer> range6 = Range.closed(3, 5); 
printRange(range6); 


//check a subrange [3,5] in [0,9] 
System.out.println("[0,9] encloses [3,5]:" + rangei.encloses! 


Range<Integer> range7 = Range.closed(9, 20); 
printRange(range7); 

//check ranges to be connected 

System.out.println("[0,9] is connected [9,20]:" + rangei.isC 


Range<Integer> range8 = Range.closed(5, 15); 


//intersection 
printRange(rangei.intersection(range8)); 


//span 
printRange(rangei1.span(range8)); 


private void printRange(Range<Integer> range){ 


System.out.print("[ "); 
for(int grade : ContiguousSet.create(range, DiscreteDomain.ir 
System.out.print(grade +" "); 


} 
System.out.println("]"); 








验证 结果 


使 用 javac 编 译 器 编译 如 下 类 


C:NGuava»javac GuavaTester.java 


现在 运行 GuavaTester 看 到 的 结果 


C:\Guava>java GuavaTester 


看 到 结果 。 


[9,9] : [0123456789] 
5 is present: true 

(1,2,3) is present: true 

Lower Bound: 0 

Upper Bound: 9 


(0,9) : [12345678] 
(009]: [123456789] 
[0,9) : [012345678] 
(9, infinity) 


Lower Bound: 9 

Upper Bound present: false 

[345] 

[0,9] encloses [3,5]:true 

[ 9 10 11 12 13 14 15 16 17 18 19 20 ] 
[0,9] is connected [9,20]:true 

ES GTB ou] 
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Guava Throwables 类 - Guava 教 程 
Throwable 类 提供 了 相关 的 Throwable 接 口 的 实用 方法 。 

类 声明 

以 下 是 com.google.common.base.Throwables 类 的 声明 : 


public final class Throwables 
extends Object 


S.N. 


方法 及 说 明 


static List<Throwable> getCausalChain(Throwable throwable) 获 
取 一 个 Throwable 的 原因 链 的 列表 。 


static Throwable getRootCause(Throwable throwable) 返回 抛 出 的 
最 里 面 的 原因 。 


static String getStackTraceAsString(Throwable throwable) 返回 包 
合 toString() 的 结果 字符 串 ， 随 后 完整 抛 出 ， 递 当 的 堆栈 跟踪 。 


static RuntimeException propagate(Throwable throwable) 传播 抛 
出 原 祥 如 果 RuntimeException 或 Error 是 一 个 实例 ， 否 则 作为 最 后 的 报 
告 ， 把 它 包 装 在 一 个 RuntimeException， 然 后 传播 。 


static <X extends Throwable> void 
propagatelflnstanceOf(Throwable throwable, Class<X> 
declaredType) 传播 抛 出 对 象 完 全 按 原 样 ， 当 且 仅 当 它 是 declaredType 
的 一 个 实例 。 


static void propagatelfPossible(Throwable throwable) 传播 抛 出 对 
象 完 全 按 原 样 ， 当 且 仅 当 它 是 RuntimeException 或 Error 的 一 个 实例 。 


static <X extends Throwable> void 
propagatelfPossible(Throwable throwable, Class<X> 
declaredType) 传播 抛 出 对 象 完全 按 原样 ， 当 且 仅 当 它 是 
RuntimeException， 错 误 或 的 declaredType 的 一 个 实例 。 


static <X1 extends Throwable,X2 extends Throwable>void 
propagatelfPossible(Throwable throwable, Class<X1> 
declaredType1, Class<X2> declaredType2) 传播 抛 出 对 象 完全 按 原 
样 ， 当 且 仅 当 它 是 RuntimeException，Error，declaredType1 或 
declaredType2 的 一 个 实例 。 


继承 的 方法 


这 个 类 继承 了 以 下 类 方法 : 


e java.lang.Object 


Throwables 示 例 


创建 使 用 所 选择 的 任何 编辑 器 下 面 的 java 程 序 ， 比 如 C:/> Guava 


GuavaTester.java 


import java.io.IOException; 


import com.google.common.base.Objects; 


import com.google.common.base.Throwables; 


public class GuavaTester { 
public static void main(String args[]){ 

GuavaTester tester = new GuavaTester(); 

try { 
tester .showcaseThrowables(); 

} catch (InvalidInputException e) { 
//get the root cause 
System.out.println(Throwables.getRootCause(e)); 

}catch (Exception e) { 
//get the stack trace in string format 
System.out.println(Throwables.getStackTraceAsString(e)); 


j 


try { 
tester.showcaseThrowables1(); 


jcatch (Exception e) { 
System.out.println(Throwables.getStackTraceAsString(e)); 


j 
j 
public void showcaseThrowables() throws InvalidInputException{ 
try { 
sqrt(-3.0); 
) catch (Throwable e) { 
//check the type of exception and throw it 
Throwables.propagateIflInstanceOf(e, InvalidInputException 
Throwables.propagate(e); 
j 
j 
public void showcaseThrowables1(){ 
try { 
int[] data = {1,2,3}; 
getValue(data, 4); 
) catch (Throwable e) { 
Throwables.propagateIflInstanceOf(e, IndexOutOfBoundsExcept 
Throwables.propagate(e); 
j 
j 


public double sqrt(double input) throws InvalidInputException{ 
if(input « 0) throw new InvalidInputException(); 
return Math.sqrt(input); 


j 


public double getValue(int[] list, int index) throws IndexOutOft 
return list[index]; 
j 


public void dummyIO() throws IOException { 
throw new IOException(); 








j 

class InvalidInputException extends Exception { 
j 

‘ a 
验证 结果 


使 用 javac 编 译 器 编译 如 下 类 


C:\Guava>javac GuavaTester.java 


现在 运行 GuavaTester 看 到 的 结果 


C:\Guava>java GuavaTester 


看 到 结果 。 


InvalidInputException 
java. lang.ArrayIndexOutOfBoundsException: 4 

at GuavaTester.getValue(GuavaTester.java:52) 

at GuavaTester.showcaseThrowablesi(GuavaTester.java:38) 


at GuavaTester.main(GuavaTester.java:19) 


Guava LS - Guava 教 程 


Guava 介 绍 了 基于 开发 者 的 应 用 开发 经 验 ， 许 多 先进 的 集合 。 以 下 是 有 用 的 集合 列 
k: 


S.N. 


1 
2 


集合 名 称 和 说 明 
Multiset 一 个 扩展 来 设置 界面 ， 人 允许 重复 的 元 素 。 
Multimap 一 个 扩展 来 映射 接口 ， 以 便 其 键 可 一 次 被 映射 到 多 个 值 
BiMap 一 个 扩展 来 映射 接口 ， 支 持 反 向 操作 。 


Table 表 代 表 一 个 特殊 的 图 ， 其 中 两 个 键 可 以 在 组 合 的 方式 被 指定 为 单 
个 值 。 


Guava/£ zT - Guava 教 程 


Guava 通 过 接口 LoadingCache 提 供 了 一 个 非常 强大 的 基于 内 存 的 
LoadingCache<K，V>。 在 缓存 中 自动 加 载 值 ， 它 提供 了 许多 实用 的 方法 ， 在 有 缓 
存 需 求 时 非常 有 用 。 


接口 声明 
以 下 是 forcom.google.common.cache.LoadingCache<K，V> 接 口 的 声明 : 


@Beta 

@GwtCompatible 

public interface LoadingCache<k, V> 
extends Cache«K,V», Function<K, V> 


接口 方法 

S.N. 方法 及 说 明 

1 V apply(K key) 不 推荐 使 用 。 提 供 满足 功能 接口 ;使 用 get(K) 或 
getUnchecked(K)(t &, 

2 ConcurrentMap<K,V> asMap() 返回 存储 在 该 缓存 作为 一 个 线程 安全 
的 映射 条 目的 视图 。 

3 V get(K key) 返回 一 个 键 在 这 个 高 速 缓存 中 ， 首 先 装 载 如 果 需 要 该 值 相 
关联 的 值 。 

4 ImmutableMap<K,V> getAll(Iterable<? extends K> keys) ix[n] — ^ 


键 相 关联 的 值 的 上 映射， 创建 或 必要 时 检索 这 些 值 。 


5 V getUnchecked(K key) 返回 一 个 键 在 这 个 高 速 缓存 中 ， 首 先 装 载 如 果 
需要 该 值 相关 联 的 值 。 


6 void refresh(K key) 加 载 键 key， 可 能 是 异步 的 一 个 新 值 。 


LoadingCache 示例 


使 用 所 选择 的 编辑 器 创建 下 面 的 java 程 序 C:/> Guava 


GuavaTester.java 


import java.util.HashMap; 


import java.util.Map; 
import java.util.concurrent.ExecutionException; 
import java.util.concurrent.TimeUnit; 


import com.google.common.base.MoreObjects; 

import com.google.common.cache.CacheBuilder ; 
import com.google.common.cache.CacheLoader ; 
import com.google.common.cache.LoadingCache; 


public class GuavaTester { 
public static void main(String args[]){ 
//create a cache for employees based on their employee id 
LoadingCache «string, employee=""" style="box-sizing: border-t 
CacheBuilder .newBuilder ( ) 
.maximumSize(100) // maximum 100 records can be cached 
.expireAfterAccess(30, TimeUnit.MINUTES) // cache will 
.build(new CacheLoader<string, employee-"" style-z"box-: 
@Override 
public Employee load(String empId) throws Exception 
//make the expensive call 
return getFromDatabase(empId); 
j 
3); 


try { 
//on first invocation, cache will be populated with corre: 


//employee record 

System.out.println("Invocation #1"); 
System.out.println(employeeCache.get("100")); 
System.out.println(employeeCache.get("103")); 
System.out.println(employeeCache.get("110")); 
//second invocation, data will be returned from cache 
System.out.println("Invocation #2"); 
System.out.println(employeeCache.get("100")); 
System.out.println(employeeCache.get("103")); 
System.out.println(employeeCache.get("110")); 


) catch (ExecutionException e) { 
e.printStackTrace(); 


} 
} 


private static Employee getFromDatabase(String empId){ 
Employee e1 = new Employee("Mahesh", "Finance", "100"); 
Employee e2 = new Employee("Rohan", "IT", "103"); 
Employee e3 = new Employee("Sohan", "Admin", "110"); 


Map «string, employee-"" style="box-sizing: border-box;"»dat: 
database.put("100", e1); 

database.put("103", e2); 

database.put("110", e3); 

System.out.println("Database hit for" + empId); 

return database.get(empId); 


} 


class Employee { 
String name; 
String dept; 
String emplD; 


public Employee(String name, String dept, String empID){ 
this.name - name; 
this.dept - dept; 
this.emplD - empID; 
} 
public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 


public String getDept() { 
return dept; 


public void setDept(String dept) { 
this.dept = dept; 

} 

public String getEmplD() { 
return emplD; 


public void setEmplD(String emplD) { 
this.emplD = emplD; 
j 


QOverride 
public String toString() (1 
return MoreObjects.toStringHelper(Employee.class) 
.add("Name", name) 
.add("Department", dept) 
.add("Emp Id", emplD).toString(); 


)«/string,»«/string,»«/string,»«/string,» 


Ha ——— Xi 





验证 结果 
使 用 javac 编 译 器 如 下 编译 类 


C:\Guava>javac GuavaTester.java 


现在 运行 GuavaTester 看 到 的 结果 


C:\Guava>java GuavaTester 


Invocation #1 

Database hit for100 

Employee{Name=Mahesh, Department=Finance, Emp Id=100} 
Database hit for103 

Employee{Name=Rohan, Department=IT, Emp Id=103} 
Database hit for110 

Employee{Name=Sohan, Department=Admin, Emp Id=110} 
Invocation #2 

Employee{Name=Mahesh, Department=Finance, Emp Id=100} 
Employee{Name=Rohan, Department-IT, Emp Id=103} 
Employee{Name=Sohan, Department=Admin, Emp Id=110} 


Guava} 15 - Guava 教 程 


Guava 介 绍 基于 开发 者 的 应 用 开发 经 验 ， 许 多 先进 的 字符 串 工 具 。 以 下 是 有 用 的 基 
于 字符 串 的 实用 程序 列表 : 
S.N. 程序 名 称 和 说 明 
1 Joiner 实用 加 入 对 象 ， 字 符 串 等 。 
Spilter 实用 程序 用 来 分 割 字符 串 。 
CharMatcher 实用 的 字符 操作 。 
CaseFormat 实用 程序 ， 用 于 改变 字符 串 格 式 。 
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Guava 原 语 工 具 - Guava 教 程 


作为 Java 的 原 语 类 型 ， 不 能 用 来 传递 在 泛 型 或 于 类 别 作 为 输入 。Guava 提 供 大 量 包 
装 工 具 类 来 处 理 原 始 类 型 的 对 象 。 以 下 是 有 用 的 原始 处 理工 具 的 列表 : 
S.N. 程序 名 称 和 说 明 
1 Bytes 实用 程序 的 原始 字 节 。 
Shorts 实用 的 原始 short。 
Ints 实用 为 基本 整 型 。 
Longs 实用 的 原始 长 整 型 。 
Floats 实用 为 基本 float。 
Doubles 实用 为 基本 的 double。 
Chars 实用 的 原始 字符 。 
Booleans 实用 为 基本 布尔 。 


co N O C A C N 


Guava 数 学 工具 - Guava 教 程 


提供 Guava 数 学 相关 的 实用 工具 类 来 处理 int，long 及 Biglnteger。 以 下 是 有 用 的 工 
具 列 表 : 


S.N. 程序 名 称 和 说 明 
1 IntMath 数学 工具 为 int 类 型 。 
2 LongMath 数学 工具 为 long 类 型 。 


3 BiglntegerMath A+ sz FAS 4^ T BigInteger. 


Hibernate 教程 
Hibernate 是 一 个 高 性 能 的 对 象 /关系 持久 性 和 其 基于 开源 GNU 宽 通用 公共 许可 证 


(LGPL) 授权 ， 可 以 免费 下 载 查询 服务 。 Hibernate 不 仅仅 关心 从 Java 类 映射 到 数 
据 库 表 (包括 Java 数 据 类 型 到 SQL 数据 类 型 ) ， 还 提供 数据 查询 和 获取 。 


本 教程 将 教 你 如 何 使 用 Hibernate 来 开发 简单 基于 数据 库 的 Web 点 用 程序 。 


读者 


本 教程 是 为 Java 程 序 员 设 计 了 一 个 需要 了 解 Hibernate 框 架 和 APlI。 完 成 本 教程 后 ， 
你 会 发 现 自己 在 专业 知识 的 中 等 水 平 。 


必 备 条 件 


我 们 假设 你 有 Java 编 程 语言 的 很 好 的 理解 。 关 系数 据 库 的 一 个 基本 的 了 解 ，JDBC 
和 SQL 是 非常 有 帮助 的 。 


ORM 是 什么 ?ORM 介绍 - hibernate 


JDBC 是 什么 ? 


JDBC 代 表 Java 数 据 库 连接 ， 并 提供 一 组 Java API， 用 于 Java 程 序 访问 关系 数据 
库 。 这 些 Java 的 API 人 允许 Java 程 序 执 行 SQL 语句 ， 并 与 任何 SQL 兼容 的 数据 库 进 行 


交互 。 


JDBC 提 供 了 一 个 灵活 的 架构 来 编写 一 个 独立 于 数据 库 应 用 程序 ， 它 可 以 在 不 同 的 
平台 上 运行 ， 并 与 不 同 的 数据 库 管 理 系统 交互 ， 而 无 需 任何 修改 。 


JDBC 的 优点 和 缺点 


JDBC 的 优点 JDBC 的 缺点 


干净 和 简单 的 SQL 你 理 良好 的 性 ”复杂 ， 如 果 它 被 用 在 大 型 工程 项 目 大 的 编 
能 与 大 数据 用 于 小 型 应 用 很 不 错 ERA 无 封装 难以 实现 MVC 的 概念 查询 
简单 ， 语 法 很 容易 学 习 是 具体 的 数据 库 管 理 系统 


为 什么 用 对 象 关系 映射 (ORM) ? 


当 我 们 与 一 个 面向 对 象 的 系统 工作 ， 还 有 的 对 象 模型 和 关系 数据 库 之 间 的 不 匹配 。 
RDBMS 代 表 以 表格 格式 数据 ， 而 面向 对 象 的 语言 ， 如 Java 或 C# 将 其 表示 为 对 象 
的 互 连 图 。 考 虑 下 面 的 Java 类 与 适当 的 构造 图 数 和 相关 的 公共 功能 : 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


public Employee() {} 

public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


public int getId() ( 
return id; 
} 


public String getFirstName() { 
return first_name; 
} 


public String getLastName() { 
return last_name; 
} 


public int getSalary() { 
return salary; 
} 


考虑 上 述 目的 需要 存储 和 检索 到 下 面 的 RDBMS 表 : 


create table EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


): 


第 一 个 问题 ， 如 果 我 们 需要 开发 有 几 页 或 我 们 的 应 用 程序 后 ， 修 改 数据 库 的 设计 ? 
其 次 ， 加 载 并 存储 对 象 在 关系 数据 库 使 我 们 面临 以 下 五 大 不 匹配 的 问题 。 


不 匹配 


Granularity 


Inheritance 


Identity 


Associations 


Navigation 


描述 


有 时 候 ， 籽 有 哪些 具有 比 在 数据 库 中 对 应 的 表 的 数目 更 多 的 关 
的 对 象 模型 。 


RDBMS 中 没有 定义 任何 类 似 继承 是 面向 对 象 编 程 语 言 的 自然 范 
起 


o 


关系 数据 库 定义 的 ' 千 篇 一 律 ' 只 有 一 个 概念 : 主键 。 但 是 ，Java 
定义 了 对 象 标 识 (a== b) 和 对 象 相等 (那么 a.Equals (b) ) 


面向 对 象 的 语言 表示 使 用 的 对 象 引用 ， 其 中 的 上 午 RDBMS 代 表 
一 个 协会 作为 一 个 外 键 列 关联 。 


访问 Java 和 关系 数据 库 对 象 的 方法 是 根本 不 同 。 


对 象 - 关系 映射 (ORM) 是 解决 处 理 所 有 上 述 阻 抗 失 配 。 


什么 是 DRM ? 


ORM 代 表 对 象 - 关系 映射 (ORM) 是 一 种 编程 技术 的 ORM 系 统 已 通过 纯 JDBC 的 
优点 如 下 关系 数据 库 和 面向 对 象 的 编程 语言 ， 如 Java，C# 等 之 间 转 换 数 据 


S.N. HRA 
1 让 业务 代码 访问 对 象 ， 而 不 是 数据 库 表 。 
2 隐藏 了 面向 对 象 的 逻辑 SQL 查 询 详 情 。 
3 基于 JDBC 的 “引擎 盖 下 ” 
4 无 需 处 理 数据 库 实现 。 
5 基于 业务 概念 ， 而 不 是 数据 库 结 构 的 实体 。 
6 事务 管理 和 自动 密 钥 生成 。 
7 应 用 程序 的 快速 开发 。 


ORM 解 决 方案 由 以 下 四 种 实体 : 


S.N. 解决 

1 一 个 API 来 对 持久 化 类 的 对 象 执 行 基本 的 CRUD 操 作 。 
2 语言 或 AP 来 指定 引用 的 类 和 类 的 属性 查询 。 

3 一 个 可 配置 的 设备 ， 用 于 指定 映射 元 数据 。 


4 技术 与 事务 对 象 交 互 ， 以 执行 脏 数 据 检 查 ， 懒 关联 加 载 ， 以 及 其 他 优化 


功能 。 


Java ORM 框 架 : 


有 几 种 持久 性 框架 和 Java 的 ORM 方 案 。 持 久 性 框架 是 一 个 ORM 的 服务 ， 存 储 和 检 
索 对 象 到 关系 型 数据 库 。 

e 企业 JavaBeans 实 体 Bean 

e Java Data Objects 

e Castor 

e TopLink 

e Spring DAO 


Hibernate 


And many more 


Hibernate 概 述 ,Hibernate 是 什么 ? - hibernate 


Hibernate 是 对 Java 中 的 对 象 关系 映射 (ORM) 解决 方案 ， 它 由 加 文 : 金 (Gavin 
King) 在 2001 年 提出 并 创建 的 一 个 开源 持久 框架 。 它 是 一 个 强大 的 ， 高 性 能 的 对 象 
关系 持久 性 和 对 任何 Java 应 用 程序 的 查询 服务 。 


Hibernate 映 射 Java 类 到 数据 库 表 和 从 Java 数 据 类 型 到 SQL 数据 类 型 和 959% 的 通用 
数据 持久 化 相关 的 编程 任务 ， 解 放 了 开发 者 。 


Hibernate 位 于 传统 的 Java 对 象 和 数据 库 服 务 器 来 处 理 在 持久 化 的 基础 上 ， 适 当 的 
O/R 机 制 和 模式 ， 这 些 对 象 在 所 有 工作 对 象 之 间 。 


Ee 
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3 C3) 


Java Objects 
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Hibernate 优点 : 
e Hibernate 会 处 理 映 射 的 Java 类 来 使 用 XML 文件 ， 数 据 库 表 和 无 需 编写 任何 一 
行 代码 。 
提供 了 简单 的 API， 用 于 直接 从 数据 库 中 存储 和 检索 Java 对 象 。 
如 果 有 变化 ， 数 据 库 或 任何 表 中 的 那么 只 需要 修改 XML 文件 的 属性 。 
。 抽象 掉 不 熟悉 的 SQL 类 型 ， 并 提供 我 们 解决 熟悉 的 Java 对 象 。 
e Hibernate 不 要 求 应 用 服务 器 进行 操作 。 
操纵 数据 库 对 象 的 复杂 关联 。 
e 尽量 减少 与 智能 读 取 策略 数据 库 的 访问 。 
提供 数据 的 简单 查询 。 


支持 的 数据 库 : 


Hibernate 支 持 几 乎 所 有 主要 的 RDBMS。 以 下 是 Hibernate 支 持 的 几 个 数据 库 引 擎 列 


o 


e HSQL Database Engine 
e DB2/NT 


e MySQL 

e PostgreSQL 

e FrontBase 

e Oracle 

e Microsoft SQL Server Database 
e Sybase SQL Server 


e Informix Dynamic Server 


支持 的 技术 : 


Hibernate 支 持 各 种 各 样 的 其 他 技术 ， 包 括 以 下 内 容 : 
e XDoclet Spring 
e J2EE 
e Eclipse plug-ins 


e Maven 
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Hibernate2 +4 - hibernate 


Hibernate 架 构 是 分 层 的 ， 隔 离 的 不 必 知 道 底层 API。 Hibernate 中 使 用 数据 库 和 配 
置信 息 来 为 应 用 程序 提供 持久 化 服务 (以 及 持久 的 对 象 )。 


下 面 是 Hibernate 应 用 程序 体系 结构 的 一 个 非常 高 的 水 平视 图 。 


Java Application 


Persistent Object 


Hibernate 











下 面 是 Hibernate 的 应 用 架构 与 一 些 重要 的 核心 课程 的 详细 视图 。 
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Hibernate 使 用 各 种 现 有 的 Java API, S0JDBC, Javas&4API (JTA) 和 Java 命 名 
和 目录 接口 (JNDI) 。 JDBC 提 供 了 常见 的 关系 数据 库 功 能 的 抽象 的 一 个 基本 水 
平 ， 使 具有 JDBC 驱 动 程序 ，Hibernate 的 支持 几乎 任何 数据 库 。 JNDI 和 JTA 人 允许 
Hibernate 与 J2EE 应 用 服务 器 进行 集成 。 


以 下 部 分 列 出 了 每 个 参与 Hibernate 应 用 程序 体系 结构 的 类 的 对 象 的 简要 说 明 。 








JNDI 
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Configuration 对 象 : 


Configuration 对 象 是 你 在 任何 Hibernate 应 用 程序 中 创建 并 通常 在 应 用 程序 初始 化 创 
建 一 次 ， 第 一 个 Hibernate 的 对 象 。 它 代表 了 Hibernate 所 需 的 配置 或 属性 文件 。 
Configuration 对 象 提供 了 两 个 按键 组 成 部 分 : 


e 数据 库 连 接 : 这 是 通过 Hibernate 支 持 的 一 个 或 多 个 配置 文件 来 人 处理。 这 些 文件 
是 : hibernate.properties 和 hibernate.cfg.xml。 


e 类 映射 设置 此 组 件 创建 Java 类 和 数据 库 表 之 间 的 连接 


SessionFactory 对 象 : 


Configuration 对 象 用 于 创建 一 个 SessionFactory 对 象 ， 它 反 过 来 可 以 配置 Hibernate 
的 使 用 提供 的 配置 文件 的 应 用 程序 ， 并 人 允许 一 个 Session 对 象 被 实例 化 。 通 过 
SessionFactory 是 线程 安全 的 对 象 和 使 用 的 应 用 程序 的 所 有 线程 。 


通过 SessionFactory 是 重量 级 的 对 象 ， 因 此 通常 它 被 应 用 程序 时 创建 的 启动 和 保持 
以 备 后 用 。 将 使 用 一 个 单独 的 配置 文件 需要 每 个 数据 库 都 有 一 个 SessionFactory 对 
象 。 所 以 ， 如 果 正 在 使 用 多 个 数据 库 ， 那 么 就 需要 创建 多 个 SessionFactory 的 对 
象 。 


Session 对 象 : 

Session 对 象 用 于 获取 与 数据 库 的 物理 连接 。 Session 对 象 是 重量 轻 ， 设 计 了 一 个 互 
持久 化 对 象 被 保存 ， 并 通过 一 个 Session 对 象 中 

Ro 

会 话 中 的 对 象 不 应 该 保持 开放 很 长 一 段 时 间 ， 因 为 他 们 通常 不 被 线程 安全 的 ， 应 该 
被 创建 并 根据 需要 销毁 他 们 。 


Transaction 对 象 : 


事务 代表 一 个 工作 单元 与 数据 库 和 大 部 分 RDBMS 支 持 事务 功能 。 在 Hibernate 事 务 
是 由 一 个 基本 的 事务 管理 器 和 事务 (从 JDBC 或 JTA) RRB, 


这 是 一 个 可 选 的 对 象 和 Hibernate 应 用 程序 可 以 选择 不 使 用 这 个 接口 ， 而 不 是 在 他 们 
自己 的 应 用 程序 代码 管理 事务 。 


Query 对 象 : 


查询 对 象 使 用 SQL 或 Hibernate 查 询 语言 (HQL) 字符 串 从 数据 库 中 检索 数据 并 创建 
对 象 。 一 个 查询 实例 是 用 来 绑 定 查询 参数 ， 限 制 查询 返回 的 结果 数量 ， 并 最 终 执行 
查询 。 


Criteria 对 象 : 


Criteria 对 象 用 于 创建 和 执行 面向 对 象 的 条 件 查 询 来 检索 对 象 。 


Hibernate 环 境 配置 - hibernate 


本 章 将 解释 如 何 安装 Hibernate 和 其 他 相关 的 包 准 各 开发 环境 为 Hibernate 应 用 程 
序 。 我 们 将 使 用 MySQL 数 据 库 的 工作 ， 党 试 使 用 Hibernate 的 例子 ， 所 以 一 定 要 确 
保 已 经 安装 的 MySQL 数 据 库 。 有 关 MySQL 的 一 个 更 详细 信息 ， 可 以 查看 MySQL 教 


程 . 


FzHibernate: 
假定 你 已 经 拥有 Java 的 最 新 版 本 安装 在 机 器 上 。 以 下 是 简单 的 步骤 下 载 并 安装 
Hibernate。 


e 选择 是 否 要 在 Windows 或 UNIX 安 装 Hibernate， 然 后 继续 下 一 个 步 又， 下载 zip 
文件 适用 于 Windows， 而 Unix 则 为 . 纪 文 件 。 


e 下 载 Hibernate 最 新 版 本 http://www.hibernate.org/downloads. 


e 在 写 这 篇 教程 的 时 候 ， 我 下 载 了 hibernate-distribution-3.6.4.Final， 解 压缩 下 载 
的 文件 ， 目 录 结 构 如 下 所 示 。 


Name Date modified Type 

点 documentation 04/05/2011 15:16 File folder 

Js lib 14/05/2011 15:15 olc 

d. project 4/05/2011 14:44 File folder 
changelog.txt 5/2011 14:44 Text Dc 


| ! 

$= hibernate logo.gif /2011 14:44 3IF image 2 KE 
hibernate3 jar t 
hibernate-testing,jar H 


4/05/2011 14:44 Text Document er > WKP 
Igpl.txt 20111 ' Zing, co 


> PB P A» Rh 


安装 Hibernate: 
下 载 并 解压 Hibernate 安 装 最 新 版 本 ， 需 要 执行 下 面 两 个 简单 的 步骤 。 请 确保 你 设置 
CLASSPATH 变 量 正 确 ， 否 则 编译 应 用 程序 将 面临 问题 。 


e 现在 所 有 的 库 文件 拷贝 从 /lib 目录 到 CLASSPATH， 并 改变 classpath 变 量 包 括 
所 有 的 JAR 文 件 : 


最 后 复制 hibernate3.jar 里 的 文件 到 CLASSPATH。 该 文件 位 于 安装 的 根 目 
录 ，Hibernate 需 要 做 的 工作 主要 的 JAR。 


Hibernate Prerequisites: 


以 下 是 由 Hibernate 要 求 ， 应 该 开始 使 用 Hibernate 之 前 安装 它们 的 软件 包 Nib 列 
表 。 要 安装 这 些 软 件 包 ， 从 /lib 目 录 找 贝 库 文件 到 CLASSPATH， 并 相应 地 改变 
CLASSPATH  &, 


S.N. 
1 
2 
3 


Packages/Libraries 
dom4j - XML parsing www.dom4j.org/ 
Xalan - XSLT Processor http://xml.apache.org/xalan-j/ 
Xerces - The Xerces Java Parser http://xml.apache.org/xerces-j/ 


cglib - Appropriate changes to Java classes at runtime 
http://cglib.sourceforge.net/ 


log4j - Logging Faremwork http://logging.apache.org/log4j 
Commons - Logging, Email etc. http://jakarta.apache.org/commons 


SLF4J - Logging Facade for Java http://www.slf4j.org 
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Hibernate 要 求 预先 知道 在 哪里 可 以 找到 它 定 义 Java 类 是 如 何 关 联 到 数据 库 表 的 映 
射 信 息 。 Hibernate 也 需要 一 组 相关 的 数据 库 和 其 他 相关 参数 的 配置 设置 。 所 有 这 
些 信 息 通常 是 hibernate.properties， 一 个 标准 的 Java 属 性 文件 ， 或 者 作为 一 个 名 为 
hibernate.cfg.xml 的 XML 文件 。 


考虑 XML 格式 的 文件 hibernate.cfg.xml 中 指定 在 例子 必需 的 Hibernate 属 性 。 大 部 分 
的 属性 取 默 认 值 ， 它 不 需要 在 属性 文件 中 指定 它们 ， 除 非 它 真 的 是 必需 的 。 此 文件 
保存 在 应 用 程序 的 类 路 径 的 根 目 录 。 


Hibernate 属性 : 
以 下 是 需要 在 独立 情况 下 配置 一 个 数据 库 的 重要 属性 的 列表 : 


S.N. 属性 和 说 明 


hibernate.dialect This property makes Hibernate generate the 
appropriate SQL for the chosen database. 


1 
2 hibernate.connection.driver_class The JDBC driver class. 

3 hibernate.connection.url The JDBC URL to the database instance. 
4 hibernate.connection.username The database username. 

5 hibernate.connection.password The database password. 


hibernate.connection.pool size Limits the number of connections 


> waiting in the Hibernate database connection pool. 


hibernate.connection.autocommit Allows autocommit mode to be used 
for the JDBC connection. 


如 果 是 随 着 应 用 程序 服务 器 和 JNDI 使 用 一 个 数据 库 ， 那 么 就 必须 配置 以 下 属性 : 


S.N. 属性 和 说 明 


1 hibernate.connection.datasource The JNDI name defined in the 
application server context you are using for the application. 


2 hibernate.jndi.class The InitialContext class for JNDI. 

3 hibernate.jndi.<JNDIpropertyname> Passes any JNDI property you 
like to the JNDI /nitialContext. 

4 hibernate.jndi.url Provides the URL for JNDI. 

5 hibernate.connection.username The database username. 

6 hibernate.connection.password The database password. 


Hibernate 和 MySQL 数 据 库 : 


MySQL 是 最 受 欢迎 的 开源 数据 库 系统 之 一 。 让 我 们 创建 hibernate.cfg.xml 配 置 文 
件 ， 并 将 其 放置 在 应 用 程序 的 类 的 根 路 笃 。 必 须 确保 有 MySQL 数 据 库 可 供 TESTDB 
数据 库 ， 必 须 提供 一 个 用 户 test 来 访问 数据 库 。 


XML 配置 文件 必须 符合 Hibernate 3 配置 的 DTD， 可 从 
http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd. 


<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-configuration SYSTEM 
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> 


<hibernate-configuration> 

«session-factory» 

«property name="hibernate.dialect"> 
org.hibernate.dialect.MySQLDialect 

«/property» 

«property name="hibernate.connection.driver_class"> 
com.mysql.jdbc.Driver 

«/property» 


<!-- Assume test is the database name --> 

«property name="hibernate.connection.url"> 
jdbc:mysq1://localhost/test 

«/property» 

«property name="hibernate.connection.username"> 
root 

«/property» 

«property name="hibernate.connection.password"> 
root123 

«/property» 


<!-- List of XML mapping files --> 
«mapping resource-"Employee.hbm.xml"/» 


</session-factory> 
</hibernate-configuration> 


上 面 的 配置 文件 包含 这 都 与 hibernate 映 射 文件 <mapping> 标 签 ， 我 们 将 在 下 一 章 看 
到 到 底 什 么 是 Hibernate 映 射 文 件 ， 以 及 如 何 和 为 什么 要 使 用 它 。 以 下 是 各 种 重要 的 
数据 库 方 言 属性 类 型 的 列表 : 


Database 
DB2 
HSQLDB 
HypersonicSQL 
Informix 
Ingres 


Interbase 


Dialect Property 
org.hibernate.dialect. DB2Dialect 
org.hibernate.dialect. HSQLDialect 
org.hibernate.dialect. HSQLDialect 
org.hibernate.dialect.InformixDialect 
org.hibernate.dialect.IngresDialect 


org.hibernate.dialect.InterbaseDialect 


Microsoft SQL Server 2000 org.hibernate.dialect.SQL ServerDialect 
Microsoft SQL Server 2005 org.hibernate.dialect.SQL Server2005Dialect 
Microsoft SQL Server 2008 org.hibernate.dialect.SQL Server2008Dialect 
MySQL org.hibernate.dialect. MySQLDialect 


Oracle (any version) org.hibernate.dialect. OracleDialect 


Oracle 11g org.hibernate.dialect.Oracle10gDialect 
Oracle 10g org.hibernate.dialect.Oracle10gDialect 
Oracle 9i org.hibernate.dialect. Oracle9iDialect 
PostgreSQL org.hibernate.dialect.PostgreSQLDialect 
Progress org.hibernate.dialect.ProgressDialect 
SAP DB org.hibernate.dialect. SAPDBDialect 
Sybase org.hibernate.dialect.SybaseDialect 


Sybase Anywhere 


org.hibernate.dialect.SybaseAnywhereDialect 
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Session 对 象 用 于 获取 与 数据 库 的 物理 连接 。 Session 对 象 是 重量 轻 ， 设 计 了 一 个 互 
动 是 需要 与 数据 库 每 次 被 实例 化 。 持 久 化 对 象 被 保存 ， 并 通过 一 个 Session 对 象 中 


检索 。 


会 话 中 的 对 象 不 应 该 保持 开放 很 长 一 段 时 间 ， 因 为 他 们 通常 不 被 线程 安全 的 ， 他 们 
应 该 被 创建 并 根据 需要 挫 毁 他 们 。 这 次 会 议 的 主要 功能 是 提供 创建 ， 污 取 和 出 除 操 
作 映 射 的 实体 类 的 实例 。 实 例 中 可 能 存在 以 下 三 种 状态 之 一 在 给 定时 间 点 : 


e 短暂 性 : 持久 化 类 的 未 与 会 话 相 关联 ， 并 在 数据 库 中 没有 代表 性 ， 没 有 标识 值 
的 新 实例 被 Hibernate 认 为 是 暂时 的 。 


e. 持久 性 : 可 以 做 一 个 瞬 态 的 实例 持久 化 通过 将 它 与 一 个 会 话 相 关联 。 持 久 性 实 
例 都 有 一 个 表示 在 数据 库 中 ， 一 个 标识 符 值 ， 和 与 会 话 相关 联 。 


e 独立 性 : 一 旦 我 们 关闭 Hibernate 的 Session， 持 久 化 实例 将 成 为 一 个 分 离 的 实 
例 。 


一 个 Session 实 例 是 可 序列 化 的 ， 如 果 它 的 持久 化 类 是 可 序列 化 的 。 一 个 典型 的 事 
务 应 该 使 用 下 面 的 语句 : 


Session session = factory.openSession(); 
Transaction tx = null; 


tx = session.beginTransaction(); 
// do some work 
tx.commit(); 


catch (Exception e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 


如 果 Session 抛 出 异常 ， 事 务必 须 回 滚 ， 会 话 必 须 被 丢弃 。 


Session 接口 方法 : 

Session 接 口 提供 多 个 方法 ， 但 这 里 列 出 的 只 有 少数 重要 的 方法 ， 这 些 方 法 我 们 在 
本 教程 中 会 使 用 。 您 可 以 查看 Hibernate 文 档 Session 和 SessionFactory 相 关 方 法 的 
完整 列表 。 


S.N. 会 话 的 方法 和 说 明 


13 


14 


15 


16 


17 


18 


19 


Transaction beginTransaction() Begin a unit of work and return the 
associated Transaction object. 


void cancelQuery() Cancel the execution of the current query. 
void clear() Completely clear the session. 


Connection close() End the session by releasing the JDBC 
connection and cleaning up. 


Criteria createCriteria(Class persistentClass) Create a new Criteria 
instance, for the given entity class, or a superclass of an entity class. 


Criteria createCriteria(String entityName) Create a new Criteria 
instance, for the given entity name. 


Serializable getldentifier(Object object) Return the identifier value of 
the given entity as associated with this session. 


Query createFilter(Object collection, String queryString) Create a 
new instance of Query for the given collection and filter string. 


Query createQuery(String queryString) Create a new instance of 
Query for the given HQL query string. 


SQLQuery createSQLQuery(String queryString) Create a new 
instance of SQLQuery for the given SQL query string. 


void delete(Object object) Remove a persistent instance from the 
datastore. 


void delete(String entityName, Object object) Remove a persistent 
instance from the datastore. 


Session get(String entityName, Serializable id) Return the 
persistent instance of the given named entity with the given identifier, 
or null if there is no such persistent instance. 


SessionFactory getSessionFactory() Get the session factory which 
created this session. 


void refresh(Object object) Re-read the state of the given instance 
from the underlying database. 


Transaction getTransaction() Get the Transaction instance 
associated with this session. 


boolean isConnected() Check if the session is currently connected. 


boolean isDirty() Does this session contain any changes which must 
be synchronized with the database? 


boolean isOpen() Check if the session is still open. 


Serializable save(Object object) Persist the given transient instance, 
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first assigning a generated identifier. 


void saveOrUpdate(Object object) Either save(Object) or 
update(Object) the given instance. 


void update(Object object) Update the persistent instance with the 
identifier of the given detached instance. 


void update(String entityName, Object object) Update the 
persistent instance with the identifier of the given detached instance. 


Hibernate 持 久 化 类 - hibernate 
Hibernate 的 整个 概念 是 采取 从 Java 关 属性 的 值 ， 并 和 将 持久 到 数据 库 表 。 一 个 映射 
文件 Hibernate 的 帮助 确定 如 何 从 拉动 类 的 值 ， 并 将 它们 映射 与 表 和 相关 的 域 。 


其 对 象 或 实例 将 存储 在 数据 库 表 中 的 Java 类 在 Hibernate 中 称 为 持久 化 类 。 
Hibernate 的 效果 最 好 ， 如 果 这 些 类 遵循 一 些 简 单 的 规则 ， 也 称 为 普通 Java 对 象 
(POJO) 编程 模型 。 有 下 列 持 久 化 类 的 主要 规则 ， 但 是 ， 这 些 规则 并 不 是 必需 
的 。 


e 将 所 有 的 持久 化 Java 类 需要 一 个 默认 的 构造 玉 数 。 


e 所 有 类 应 该 包含 为 了 让 容易 识别 对 象 内 Hibernate 和 数据 库 的 ID。 此 属性 映射 到 
数据 库 表 的 主键 列 。 


所 有 属性 将 被 持久 化 应 该 声明 为 private， 并 已 在 JavaBean 风 格 的 定义 的 
getXXX 和 setXXX 方 法 。 


Hibernate 的 关键 功能 ， 人 代理， 取决 于 持久 化 类 或 者 是 非 final 的 ， 或 者 说 声明 的 
所 有 公共 方法 的 接口 的 实现 。 


。 所 有 的 类 不 扩展 或 实现 的 EJB 框 架 需 要 进行 一 些 专门 的 类 和 接口 。 


POJO 名 称 用 于 强调 一 个 给 定 的 对 象 是 一 个 普通 的 Java 对 象 ， 而 不 是 一 个 特殊 的 对 
象 ， 好 更 不 是 Enterprise JavaBean。 


一 个 简单 的 POJO 例 子 : 


基于 上 面 提 到 的 一 些 规则 ， 我 们 可 以 如 下 定义 一 个 POJO 类 : 


public class Employee { 
private int id; 
private String firstName; 
private String lastName; 
private int salary; 


public Employee() {} 

public Employee(String fname, String lname, int salary) { 
this.firstName = fname; 
this.lastName = lname; 
this.salary - salary; 


public int getId() ( 
return id; 


public void setId( int id ) { 
this.id = id; 

} 

public String getFirstName() { 
return firstName; 


public void setFirstName( String first_name ) { 
this.firstName = first_name; 


public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 
} 


public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
» 


Hibernate 有 映射 文件 - hibernate 


对 象 /关系 映射 的 XML 文档 中 通常 被 定义 。 这 个 映射 文件 指示 Hibernate 如 何 定义 的 
一 个 或 多 个 类 映射 到 数据 库 表 。 


虽然 很 多 Hibernate 用 户 选择 手工 编写 XML 中 ， 有 一 些 工 具 可 以 用 来 生成 映射 文档 。 
包括 XDoclet，Middlegen 和 AndroMDA 等 用 于 高 级 Hibernate 的 用 户 。 


让 我 们 考虑 我 们 的 对 象 业 坚持 在 下 一 节 中 定义 的 表 前 面 定义 的 POJO 类 。 


public class Employee { 
private int id; 
private String firstName; 
private String lastName; 
private int salary; 


public Employee() {} 

public Employee(String fname, String lname, int salary) { 
this.firstName - fname; 
this.lastName - lname; 
this.salary - salary; 


j 
public int getId() ( 
return id; 


} 
public void setId( int id ) { 
this.id = id; 


public String getFirstName() { 
return firstName; 


public void setFirstName( String first_name ) { 
this.firstName = first name; 


} 
public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 

} 

public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
} 
} 


会 有 一 个 表 对 应 于 每 一 个 对 象 ， 你 愿意 提供 持久 性 。 考 虑 上 述 目的 需要 存储 和 检索 
到 下 面 的 RDBMS 表 : 


create table EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


); 


基于 以 上 两 个 实体 ， 我 们 可 以 定义 它 指 示 Hibernate 如 何 定义 的 一 个 或 多 个 类 映射 到 
数据 库 表 下 面 的 映射 文件 。 


<?xml version="1.0" encoding="utf-8"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"» 


<hibernate-mapping> 
<class name="Employee" table="EMPLOYEE"> 
<meta attribute="class-description"> 
This class contains the employee detail. 
</meta> 
<id name="id" type="int" column="id"> 
<generator class="native"/> 
</id> 
<property name="firstName" column="first_name" type="string", 
«property name-"lastName" column="last_name" type-"string"/» 
«property name-"salary" column="Salary" type="int"/> 
</class> 
</hibernate-mapping> 


| ———————————— wd Ó9] 


保存 的 映射 文件 中 的 格式 : <classname>.hbm.xml。 我 们 保存 映射 文件 中 的 文件 
Employee.hbm.xml。 来 看 看 关于 在 映射 文件 中 使 用 的 映射 元 素 的 小 细节 : 


e 映射 文档 是 具有 <hibernate-mapping> 为 包含 所 有 的 <class> 元 素 的 根 元 素 的 
XML 文 档 。 


e 在 <class> 元 素 被 用 于 定义 数据 库 表 从 一 个 Java 类 特定 的 映射。 Java 类 名 指定 
使 用 class 元 素 的 name 属 性 和 使 用 表 属 性 数据 库 表 名 指定 。 


e <meta> 元 素 是 可 选 元 素 ， 可 以 用 来 创建 类 的 描述 。 


e <id> 元 素 映 射 在 类 中 的 唯一 ID 属性 到 数据 库 表 的 主键 。 id 元 素 的 name 属 性 是 
指 属性 的 类 和 column 属 性 是 指 在 数据 库 表 中 的 列 。 type 属 性 保存 了 Hibernate 
映射 类 型 ， 这 种 类 型 的 映射 业 会 从 Java 转 换 为 SQL 数 据 类 型 。 





e id 元 素 内 的 <generator> 元 素 被 用 来 自动 生成 的 主键 值 。 将 生成 元 素 的 class 属 
性 设置 为 原生 让 Hibernate 拿 起 无 论 是 identity，sequence 或 者 hilo 中 的 算法 来 创 
建 主 键 根据 底层 数据 库 的 支持 能 力 。 


e <property> 元 素 用 于 一 个 Java 类 的 属性 映射 到 数据 库 表 中 的 列 。 元 素 的 name 
属性 是 指 属性 的 类 和 column 属 性 是 指 在 数据 库 表 中 的 列 。 type 属 性 保存 了 
Hibernate 映 射 类 型 ， 这 种 类 型 的 映射 将 会 从 Java 转 换 为 SQL 数据 类 型 。 


还 有 这 将 在 映射 文件 中 使 用 ， 接 下 来 尽量 履 盖 尽 可 能 多 其 他 的 Hibernate 相 关 主 题 的 
其 他 属性 和 可 用 的 元 素 。 
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当 编 写 Hibernate 映 射 文件 ， 映 射 的 Java 数 据 类 型 到 关系 型 数据 库 的 数据 类 型 。 声 
明 及 在 映射 文件 中 使 用 的 类 型 不 是 Java 的 数据 类 型 ， 它 们 不 是 SQL 数据 库 的 数据 类 
型 。 这 些 类 型 就 是 所 谓 的 Hibernate 映 射 类 型 ， 它 可 以 从 Java 转 换 到 SQL 数 据 类 
H, REIRA. 


本 章 列 出 了 所 有 的 基本 ， 日 期 和 时 间 ， 大 对 象 ， 以 及 其 他 各 种 内 置 映 射 类 型 。 


Date 和 time 类 型 : 


基本 类 型 : 
映射 类 型 Java 类 型 ANSI SQL 类 型 
integer int or java.lang.Integer INTEGER 
long long or java.lang.Long BIGINT 
short short or java.lang.Short SMALLINT 
float float or java.lang.Float FLOAT 
double double or java.lang.Double DOUBLE 
big decimal java.math.BigDecimal NUMERIC 
character java.lang.String CHAR(1) 
string java.lang.String VARCHAR 
byte byte or java.lang.Byte TINYINT 
boolean boolean or java.lang.Boolean BIT 
yes/no boolean or java.lang.Boolean CHAR(1) (‘Y' or 'N') 
true/false boolean or java.lang.Boolean CHAR(1) (T or 'F') 


Mapping 类 型 Java 类 型 


date 

time 
timestamp 
calendar 


calendar_date 


java.util.Date or java.sql.Date 
java.util.Date or java.sql.Time 
java.util.Date or java.sql.Timestamp 
java.util.Calendar 


java.util.Calendar 


二 进 制 大 对 象 类 型 : 


Mapping 


binary 
text 
serializable 


clob 


blob 


Java 类 型 


byte[] 


java.lang.String 


any Java class that implements 
java.io.Serializable 


java.sql.Clob 
java.sql.Blob 


JDK-related 类 型 : 


Mapping 类 型 Java 类 型 
class java.lang.Class 
locale java.util.Locale 
timezone java.util. TimeZone 


currency 


java.util.Currency 


ANSI SQL 类 型 
DATE 
TIME 
TIMESTAMP 
TIMESTAMP 
DATE 


ANSI SQL 类 型 
VARBINARY (or 
BLOB) 

CLOB 


VARBINARY (or 
BLOB) 


CLOB 
BLOB 


ANSI SQL 类 型 
VARCHAR 
VARCHAR 
VARCHAR 
VARCHAR 


Hibernate 3: {J - hibernate 


我 们 堂 试 使 用 Hibernate 提 供 的 一 个 独立 应 用 程序 Java 持 久 化 例子 。 通 过 使 用 
Hibernate 技 术 创 建 Java 应 用 程序 ， 步 又 如 下 : 


创建 POJO 类 : 


在 创建 应 用 程序 的 第 一 步 是 建立 在 Java POJO 类 或 类 ， 具 体 取决 于 将 被 持久 化 到 数 
据 库 的 应 用 程序 。 让 我 们 考虑 我 们 的 Employee 类 的 getXXX 和 setXXX 方 法 ， 使 其 兼 
容 JavaBean 类 。 


POJO (普通 Java 对 象 ) 是 一 个 Java 对 象 ， 它 不 扩展 或 实现 分 别 需要 由 EJB 框 架 一 
些 专门 的 类 和 接口 。 所 有 普通 的 Java 对 象 都 是 POJO。 


当 设 计 一 个 类 里 面 要 Hibernate 持 久 化 ， 重 要 的 是 要 提供 的 JavaBeans 兼 容 的 代码 以 
及 将 工作 作为 索引 ， 就 像 在 Employee 类 的 id 属性 。 


public class Employee { 
private int id; 
private String firstName; 
private String lastName; 
private int salary; 


public Employee() {} 

public Employee(String fname, String lname, int salary) { 
this.firstName = fname; 
this.lastName = lname; 
this.salary - salary; 


public int getId() ( 
return id; 


public void setId( int id ) { 
this.id = id; 
} 


public String getFirstName() { 
return firstName; 


public void setFirstName( String first_name ) { 
this.firstName = first_name; 


public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 
} 


public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
} 


创建 数据 库 表 : 


第 二 步 是 在 数据 库 中 创建 表 。 会 有 一 张 表 对 应 于 每 一 个 对 象 提供 持久 性 。 考 虑 上 述 
目的 需要 存储 和 检索 到 下 面 的 RDBMS 表 : 


create table EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


); 


创建 映射 配置 文件 : 


这 一 步 是 创建 一 个 指示 Hibernate 如 何 定义 的 一 个 或 多 个 类 映射 到 数据 库 表 的 映射 文 
ft, 


<?xml version="1.0" encoding="utf-8"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"» 


<hibernate-mapping> 
<class name="Employee" table="EMPLOYEE"> 
<meta attribute="class-description"> 
This class contains the employee detail. 
</meta> 
<id name="id" type="int" column="id"> 
<generator class="native"/> 
</id> 
«property name="firstName" column="first_name" type="string", 
«property name-"lastName" column="last_name" type="string"/> 
«property name="Salary" column="Salary" type="int"/> 
</class> 
</hibernate-mapping> 





应 该 保存 的 映射 文件 中 的 格式 <classname>.hbm.xml。 我 们 保存 我 们 的 映射 文件 
中 的 文件 Employee.hbm.xml。 让 我 们 来 看 看 有 关上 映射 文件 的 小 细节 : 


e 了 映射 文档 是 具有 <hibernate-mapping> 为 包含 所 有 的 <class> 元 素 的 根 元 素 的 
XML 文档 。 


e <class> 元 素 被 用 于 定义 数据 库 表 从 一 个 Java 类 特定 的 映射 。 Java 类 名 指定 使 
用 class 元 素 的 hame 属 性 和 使 用 表 属 性 数据 库 表 名 指定 。 


e <meta> 元 素 是 可 选 元 素 ， 可 以 用 来 创建 类 的 描述 。 


e <id> 元 素 映射 在 类 中 的 唯一 ID 属性 到 数据 库 表 的 主键 。 id 元 素 的 name 属性 
是 指 属性 的 类 和 column 属性 是 指 在 数据 库 表 中 的 列 。 type 属 性 保存 了 
Hibernate 映 射 类 型 ， 这 种 类 型 的 映射 将 会 从 Java 转 换 为 SQL 数据 类 型 。 


e id 元 


素 内 的 «generator» 元 素 被 用 来 自动 生成 的 主键 值 。 将 生成 元 素 的 class 


属性 设置 为 原 产 于 让 Hibernate 无 论 是 identity，sequence 或 者 hilo 中 的 算法 来 创 
建 主键 根据 底层 数据 库 的 支持 能 


e «property» 元 素 用 于 一 个 Java 类 的 属性 映射 到 数据 库 表 中 的 列 。 元 素 的 name 
属性 是 指 属性 的 类 和 column 属 性 是 指 在 数据 库 表 中 的 列 。 type 属 性 保存 了 
Hibernate 映 射 类 型 ， 这 种 类 型 的 映射 将 会 从 Java 转 换 为 SQL 数据 类 型 。 


还 有 这 将 在 映射 文件 中 使 用 ， 我 会 尽量 覆盖 尽 可 能 多 的 在 讨论 其 他 的 Hibernate 相 天 
主题 的 其 他 属性 和 可 用 的 元 素 。 


创建 应 用 程序 类 


最 后 ， 我 们 将 创建 应 用 程序 类 main) 方法 来 运行 应 用 程序 。 我 们 将 使 用 这 个 应 用 程 
序 来 保存 一 些 展 员 的 记录 ， 然 后 我 们 将 申请 CRUD 操 作 上 的 记录 。 


Import 
Import 
Import 


Import 
Import 
Import 
Import 
Import 


public 


java.util.List; 
java.util.Date; 
java.util.Iterator; 


org.hibernate.HibernateException; 
org.hibernate.Session; 
org.hibernate. Transaction; 
org.hibernate.SessionFactory; 
org.hibernate.cfg.Configuration; 


class ManageEmployee { 


private static SessionFactory factory; 
public static void main(String[] args) { 


try{ 
factory = new Configuration().configure().buildSessionFact 


}catch (Throwable ex) { 
System.err.println("Failed to create sessionFactory object 
throw new ExceptionInInitializerError(ex); 


} 
ManageEmployee ME = new ManageEmployee(); 


/* Add few employee records in database */ 

Integer empID1 ME.addEmployee("Zara", "Ali", 1000); 
Integer empID2 .addEmployee("Daisy", "Das", 5000); 
Integer empID3 ME.addEmployee("John", "Paul", 10000); 


Wout d 
= 
m 


/* List down all the employees */ 
ME.listEmployees(); 


/* Update employee's records */ 
ME.updateEmployee(empID1, 5000); 


/* Delete an employee from the database */ 
ME.deleteEmployee(empID2); 


/* List down new list of the employees */ 
ME.listEmployees(); 


/* Method to CREATE an employee in the database */ 
public Integer addEmployee(String fname, String lname, int sala! 
Session session - factory.openSession(); 
Transaction tx - null; 
Integer employeeID - null; 
tryt 
tx = session.beginTransaction(); 
Employee employee - new Employee(fname, lname, salary); 
employeeID - (Integer) session.save(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
j 


return employeeID; 
} 
/* Method to READ all the employees */ 
public void listEmployees( ){ 
Session session = factory.openSession(); 
Transaction tx = null; 
try{ 
tx = session.beginTransaction(); 
List employees = session.createQuery("FROM Employee" ).lisi 
for (Iterator iterator = 
employees.iterator(); iterator .hasNext( ` 
Employee employee = (Employee) iterator.next(); 
System.out.print("First Name: " + employee.getFirstName 
System.out.print(" Last Name: " + employee.getLastName 
System.out.println(" Salary: " + employee.getSalary(). 
} 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
} 
} 


/* Method to UPDATE salary for an employee */ 
public void updateEmployee(Integer EmployeeID, int salary ){ 
Session session = factory.openSession(); 
Transaction tx = null; 
try{ 
tx = session.beginTransaction(); 
Employee employee = 
(Employee)session.get(Employee.class, Employee: 
employee.setSalary( salary ); 


session.update(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 


j 


} 
/* Method to DELETE an employee from the records */ 
public void deleteEmployee(Integer EmployeeID){ 
Session session = factory.openSession(); 
Transaction tx = null; 
try{ 
tx = session.beginTransaction(); 
Employee employee = 
(Employee)session.get(Employee.class, Employeell 
session.delete(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 





编译 和 执行 : 


下 面 是 步骤 来 编译 并 运行 上 述 应 用 程序 。 请 确保 已 在 进行 的 编译 和 执行 之 前 ， 适 当 
地 设置 PATH 和 CLASSPATH。 


e 创建 hibernate.cfg.xml 配 置 文件 中 配置 章节 解释 。 
e 创建 Employee.hbm.xml 映 射 文件 ， 如 上 图 所 示 。 
e 创建 Employee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 创建 ManageEmployee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 执行 ManageEmployee 二 进 制 文 件 来 运行 程序 。 
会 得 到 以 下 结果 ， 并 记录 将 在 EMPLOYEE 表 中 创建 。 


$java ManageEmployee 
eee wee VARIOUS LOG MESSAGES WILL DISPLAY HERE........ 


First Name: Zara Last Name: Ali Salary: 1000 
First Name: Daisy Last Name: Das Salary: 5000 
First Name: John Last Name: Paul Salary: 10000 
First Name: Zara Last Name: Ali Salary: 5000 
First Name: John Last Name: Paul Salary: 10000 


如 果 检 查 EMPLOYEE 表 ， 它 应 该 有 以 下 记录 : 


mysql> select * from EMPLOYEE; 


天 EE duce o demo + 
| id | first_name | last_name | salary | 
ductore s sooo ooo S aces cC m + 
| 29 | Zara | Ali | 5000 | 
| 31 | John | Paul | 10000 | 
下 Pomoc EEG doce e esee + 


2 rows in set (0.00 sec 


mysql> 


Hibernate O/RIŁ $} - hibernate 


到 目前 为 止 ， 我 们 已 经 看 到 了 非常 基本 的 O/R 映 射 使 用 Hibernate， 但 也 有 我 们 必须 
学 会 在 细节 三 个 最 重要 的 映射 绘制 的 主题 。 这 些 都 是 集合 的 映射 ， 关 联 的 实体 类 和 
组 件 映 射 之 间 的 映射 。 


集合 映射 : 


如 果 一 个 实体 或 类 有 上 收集 特定 变量 的 值 ， 那 么 我 们 就 可 以 用 在 Java 中 可 用 的 集合 接 
口中 的 任何 一 个 对 应 的 值 。 Hibernate 可 以 持久 java.util.Map，java.util.Set 中 ， 
java.util.SortedMap，java.util.SortedSet，java.util.List 和 持久 性 的 实体 或 值 的 任意 
阵列 的 实例 。 


集合 类 型 映射 和 说 明 


This is mapped with a <set> element and initialized with 


java.util.Set java.util.HashSet 


This is mapped with a <set> element and initialized with 
java.util.SortedSet java.util. TreeSet. The sort attribute can be set to either 
a comparator or natural ordering. 


This is mapped with a <list> element and initialized with 


ene java.util.ArrayList 


This is mapped with a <bag> or <ibag> element and 


java.util.Collection | initialized with java.util. ArrayList 


This is mapped with a <map> element and initialized 


java.util.Map with java.util. HashMap 


This is mapped with a <map> element and initialized 
java.util.SortedMap with java.util. TreeMap. The sort attribute can be set to 
either a comparator or natural ordering. 


数组 是 由 Hibernate 与 <primitive-array> 对 Java 基 本 值 类 型 和 针对 的 <array> 所 有 其 它 
支持 。 然 而 ， 他 们 很 少 用 ， 所 以 我 不 打算 讨论 这 些 问题 在 本 教程 中 。 

如 果 要 了 映射 是 不 直接 支持 Hibernate 的 用 户 定义 的 集合 接口 ， 需 要 告诉 Hibernate 有 
关 自 定义 集合 是 不 太 容易 的 ， 不 建议 使 用 的 语义 。 


关联 关系 映射 : 


关联 实体 类 和 表 之 间 的 关系 之 间 的 映射 是 ORM 的 灵魂 。 以 下 是 4 的 方法 ， 使 对 象 之 
间 的 关系 的 基数 可 以 表示 。 关 联 映射 可 以 是 单 向 和 双向 的 。 


映射 类 型 摘 述 


Many-to-One Mapping many-to-one relationship using Hibernate 
One-to-One Mapping one-to-one relationship using Hibernate 
One-to-Many Mapping one-to-many relationship using Hibernate 
Many-to-Many Mapping many-to-many relationship using Hibernate 


组 件 映 射 : 


这 是 非常 有 可 能 是 一 个 实体 类 可 以 有 一 个 引用 到 另 一 个 类 的 一 个 成 员 变 量 。 如 果 提 
到 类 没有 它 自己 的 生命 周期 ， 并 完全 依赖 于 所 属 的 实体 类 的 生命 周期 被 引用 类 ， 
此 因此 被 称 为 Component 类 。 


收集 组 件 的 映射 也 是 可 能 以 类 似 的 方式 只 是 作为 与 次 要 配置 差异 正规 集合 的 映射 。 
我 们 将 看 到 这 两 个 映射 详细 的 例子 。 
映射 类 型 描述 
Component Mappings 映射 一 类 具有 参考 到 另 一 个 类 的 一 个 成 员 变量 。 


Hibernate 注 解 - hibernate 


到 目前 为 止 ， 已 经 看 到 Hibernate 如 何 使 用 XML 映射 文件 从 POJO 的 数据 到 数据 库 表 
的 改造 ， 反 之 亦 然 。 Hibernate 注 解 是 一 个 没有 使 用 XML 文件 来 定义 映射 的 最 新 方 
法 。 可 以 在 除 或 替换 的 XML 映射 元 数据 使 用 注解 。 


Hibernate 的 注解 是 强大 的 方式 来 提供 元 数据 对 象 和 关系 表 的 映射 。 所 有 的 元 数据 被 
桂 到 一 起 的 代码 POJO java 文 件 这 可 以 帮助 用 户 在 开发 过 程 中 同时 要 了 解 表 的 结构 
和 POJO。 


如 果 打 算 让 应 用 程序 移植 到 其 他 EJB3 规 范 的 ORM 应 用 程序 ， 必 须 使 用 注解 来 表示 
映射 信息 ， 但 仍然 如 果 想 要 更 大 的 灵活 性 ， 那 么 应 该 使 用 基于 XML 的 映射 去 。 


环境 设置 Hibernate 注 释 


首先 ， 必 须 确 保 使 用 的 是 JDK5.0， 否 则 ， 需 要 JDK 升 级 到 JDK5.0 带 注解 的 原生 支 
持 的 优势 。 


其 次 ， 需 要 安装 Hibernate 的 3.x 注 解 分 发 包 ， 可 从 SourceForge 上 : (Download 
Hibernate Annotation) 并 拷贝 hibernate-annotations.jar, lib/hibernate-comons- 
annotations.jar 和 lib/ejb3-persistence.jar 从 Hibernate 注 解 分 配 到 CLASSPATH 


注释 的 类 实例 : 


正如 提 到 的 ， 同 时 使 用 Hibernate 注 释 工 作 的 所 有 元 数据 村 成 随 着 代码 的 POJO java 
文件 上 面 这 可 以 帮助 用 户 在 开发 过 程 中 同时 了 解 表 结构 和 POJO。 


考虑 到 将 要 使 用 下 面 的 EMPLOYEE 表 来 存储 的 对 象 : 


create table EMPLOYEE ( 
id INT NOT NULL auto_ increment, 
first_name VARCHAR(20) default NULL, 
last name VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


): 


下 面 是 用 注解 来 映射 与 定义 的 EMPLOYEE 表 的 对 象 Employee 类 的 映射 : 


import javax.persistence.*; 


QEntity 

@Table(name = "EMPLOYEE") 

public class Employee { 
@Id QGeneratedValue 
@Column(name = "id") 
private int id; 


@Column(name = "first_name") 
private String firstName; 


@Column(name = "last name") 
private String lastName; 


@Column(name = "salary" ) 
private int salary; 


public Employee() {} 
public int getId() ( 
return id; 


public void setId( int id ) { 
this.id = id; 
} 


public String getFirstName() { 
return firstName; 


public void setFirstName( String first_name ) { 
this.firstName = first_name; 
} 


public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 
} 


public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
} 


Hibernate 检 测 @Id 注 释 是 对 一 个 字段 ， 并 假设 它 应 该 直接 通过 在 运行 时 域 访 问 一 个 
对 象 的 属性 。 如 果 将 @lId 注 释 getld () 方法 ， 将 通过 getter 和 setter 方 法 默认 情况 下 
允许 访问 属性 。 因 此 ， 所 有 其 他 注释 也 被 放置 在 任 一 字段 或 getter 方 法 ， 以 下 所 选 
择 的 策略 。 下 面 的 部 分 将 解释 在 上 面 的 类 中 使 用 的 注释 。 


@Entity 注解 
在 EJB3 规 范 说 明 都 包含 在 javax.persistence 包 ， 所 以 我 们 导入 这 个 包 作 为 第 一 步 。 


其 次 ， 我 们 使 用 了 @Entity 注 解 来 这 标志 着 这 个 类 作为 一 个 实体 bean Employee 
类 ， 因 此 它 必须 有 一 个 无 参数 的 构造 函数 ， 总 算是 有 保 折 的 范围 可 见 。 


@Table 注解 : 
@Table 注 释 人 允许 指定 的 表 将 被 用 于 保存 该 实体 在 数据 库 中 的 详细 信息 。 


@Table 注 释 提 供 了 四 个 属性 ， 人 允许 覆盖 表 的 名 称 ， 它 的 目录 ， 它 的 架构 ， 并 执行 
对 列 的 唯一 约束 在 表 中 。 现 在 ， 我 们 使 用 的 是 刚刚 是 EMPLOYEE 表 的 名 称 。 


(Id 和 @GeneratedValue 注解 : 

每 个 实体 bean 将 有 一 个 主键 ， 注 释 在 类 的 @Id 注 解 。 主 键 可 以 是 单个 字段 或 根据 表 
结构 的 多 个 字段 的 组 合 。 

默认 情况 下 ，@Id 注 解 会 自动 确定 要 使 用 的 最 合适 的 主键 生成 策略 ， 但 可 以 通过 应 
用 @GeneratedValue 注 释 ， 它 接受 两 个 参数 ，strategy 和 generator， 不 打算 在 这 里 


讨论 ， 只 使 用 默认 的 默认 键 生 成 策略 。 让 Hibernate 确 定 要 使 用 的 generator 类 型 使 
不 同 数据 库 之 间 代 码 的 可 移植 性 。 


@Column 注解 : 
@Column 批 注 用 于 指定 的 列 到 一 个 字段 或 属性 将 被 映射 的 细节 。 可 以 使 用 列 注释 
以 下 最 常用 的 属性 : 

e。name 属 性 允许 将 显 式 指定 列 的 名 称 。 

e length 属性 允许 用 于 映射 一 个 value 尤 其 是 对 一 个 字符 串 值 的 列 的 大 小 。 

e nullable 属性 允许 该 列 被 标记 为 NOT NULL 生 成 架构 时 。 

e unique 属性 允许 被 标记 为 只 包含 唯一 值 的 列 。 


创建 应 用 程序 类 : 


最 后 ， 我 们 将 创建 应 用 程序 类 的 main 0 方法 来 运行 应 用 程序 。 我 们 将 使 用 这 个 应 
用 程序 ， 以 节省 一 些 员工 的 记录 ， 然 后 我 们 将 申请 CRUD 操 作 上 的 记录 。 


import java.util.List; 
import java.util.Date; 
import java.util.Iterator; 


import org.hibernate.HibernateException; 

import org.hibernate.Session; 

import org.hibernate. Transaction; 

import org.hibernate.cfg.AnnotationConfiguration; 
import org.hibernate.SessionFactory; 

import org.hibernate.cfg.Configuration; 


public class ManageEmployee { 
private static SessionFactory factory; 
public static void main(String[] args) { 
tryt 
factory - new AnnotationConfiguration(). 
configure(). 
//addPackage("com.xyz") //add package if used. 
addAnnotatedClass(Employee.class). 
buildSessionFactory(); 
}catch (Throwable ex) { 
System.err.println("Failed to create sessionFactory object 
throw new ExceptionInInitializerError(ex); 


} 
ManageEmployee ME = new ManageEmployee(); 


/* Add few employee records in database */ 

Integer empID1 ME.addEmployee("Zara", "Ali", 1000); 
Integer empID2 ME . addEmployee( "Daisy", "Das", 5000); 
Integer empID3 ME.addEmployee("John", "Paul", 10000); 


/* List down all the employees */ 
ME.listEmployees(); 


/* Update employee's records */ 
ME.updateEmployee(empID1, 5000); 


/* Delete an employee from the database */ 
ME.deleteEmployee(empID2); 


/* List down new list of the employees */ 
ME.listEmployees(); 


/* Method to CREATE an employee in the database */ 
public Integer addEmployee(String fname, String lname, int sala! 
Session session - factory.openSession(); 
Transaction tx - null; 
Integer employeeID - null; 
tryt 
tx = session.beginTransaction(); 
Employee employee - new Employee(); 
employee.setFirstName(fname); 
employee.setLastName(lname); 
employee.setSalary(salary); 
employeeID - (Integer) session.save(employee); 
tx.commit(); 
jcatch (HibernateException e) { 


if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
j 


return employeeID; 


/* Method to READ all the employees */ 
public void listEmployees( ){ 
Session session - factory.openSession(); 
Transaction tx - null; 
tryt 
tx = session.beginTransaction(); 
List employees = session.createQuery("FROM Employee").lis! 
for (Iterator iterator - 
employees.iterator(); iterator .hasNext( ` 
Employee employee = (Employee) iterator.next(); 
System.out.print("First Name: " + employee.getFirstName 
System.out.print(" Last Name: " + employee.getLastName 
System.out.println(" Salary: " + employee.getSalary(); 
} 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
} 
} 


/* Method to UPDATE salary for an employee */ 
public void updateEmployee(Integer EmployeeID, int salary ){ 
Session session = factory.openSession(); 
Transaction tx = null; 
tryt 
tx = session.beginTransaction(); 
Employee employee - 
(Employee)session.get(Employee.class, Employee: 
employee.setSalary( salary ); 
session.update(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 


} 


/* Method to DELETE an employee from the records */ 

public void deleteEmployee(Integer EmployeeID) { 
Session session - factory.openSession(); 
Transaction tx - null; 


try{ 
tx = session.beginTransaction(); 


Employee employee = 
(Employee)session.get(Employee.class, Employeell 
session.delete(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 





效 据 库 配置 : 


现在 ， 让 我 们 创建 hibernate.cfg.xml 配 置 文件 来 定义 数据 库 的 相关 参数 。 


<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-configuration SYSTEM 
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> 


<hibernate-configuration> 

<session-factory> 

<property name="hibernate.dialect"> 
org.hibernate.dialect.MySQLDialect 

«/property» 

«property name="hibernate.connection.driver_class"> 
com.mysql.jdbc.Driver 

«/property» 


<!-- Assume students is the database name --> 

«property name="hibernate.connection.url"> 
jdbc:mysq1://localhost/test 

«/property» 

«property name="hibernate.connection.username"> 
root 

«/property» 

«property name="hibernate.connection.password"> 
cohondob 

«/property» 


</session-factory> 
</hibernate-configuration> 


编译 和 执行 : 


下 面 是 步骤 来 编译 并 运行 上 述 应 用 程序 。 请 确保 已 在 进行 的 编译 和 执行 之 前 ， 适 当 


地 设置 PATH 和 CLASSPATH。 
e 从 路 径 中 删除 Employee.hbm.xml 映 射 文件 。 
e 创建 Employee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 创建 ManageEmployee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 执行 ManageEmployee 二 进 制 文件 来 运行 程序 。 

会 得 到 以 下 结果 ， 并 记录 将 在 EMPLOYEE 表 中 。 
$java ManageEmployee 
"VA Iva VARIOUS LOG MESSAGES WILL DISPLAY HERE........ 
First Name: Zara Last Name: Ali Salary: 1000 
First Name: Daisy Last Name: Das Salary: 5000 
First Name: John Last Name: Paul Salary: 10000 


First Name: Zara Last Name: Ali Salary: 5000 
First Name: John Last Name: Paul Salary: 10000 


如 果 检 查 EMPLOYEE 表 ， 它 应 该 有 以 下 记录 : 


mysql> select * from EMPLOYEE; 


ee ee nornon es Sees oes cba ge SS + 
| id | first_name | last_name | salary | 
ob So ae GS ee Hose saan + 
| 29 | Zara | Ali | 5000 | 
| 31 | John | Paul | 10000 | 
oe 天下 oa ee Boos soe + 


2 rows in set (0.00 sec 


mysql> 


Hibernate 4 33:4  - hibernate 


Hibernate 坦 询 语 言 (HQL) 是 一 种 面向 对 象 的 查询 语言 ， 类 似 于 SQL， 但 不 是 对 表 
和 列 操作 ，HQL 适 用 于 持久 对 象 和 它们 的 属性 。 HQL 查 询 由 Hibernate 转 换 成 传统 
的 SQL 查 询 ， 这 在 圈 上 的 数据 库 执行 操作 。 


虽然 可 以 直接 使 用 SQL 语 句 和 Hibernate 使 用 原生 SQL， 但 建议 使 用 HQL 尽 可 能 避免 
数据 库 可 移植 性 的 麻烦 ， 并 采取 Hibernate 的 SQL 生 成 和 缓存 策略 的 优势 。 


都 像 SELECT，FROM 和 WHERE 等 关键 字 不 区 分 大 小 写 ， 但 如 表 名 和 列 名 的 属性 
是 区 分 在 HQL 敏 感 。 


FROM 语句 


使 用 FROM 子 句 ， 如 果 要 加 载 一 个 完整 的 持久 化 对 象 到 内 存 中 。 下 面 是 一 个 使 用 
FROM 子 句 的 简单 的 语法 : 


String hql = "FROM Employee"; 
Query query = session.createQuery(hql); 
List results = query.list(); 


如 果 需 要 完全 限定 在 HQL 一 个 类 名 ， 只 需 指定 如 下 的 包 和 类 名 : 


String hql = "FROM com.hibernatebook.criteria.Employee"; 
Query query = session.createQuery(hql); 
List results - query.list(); 


AS 语句 


AS 子 句 可 以 用 来 别名 分 配给 类 中 的 HQL 查 询 ， 特 别 是 当 有 很 长 的 查询 。 例 如 ， 我 们 
前 面 简单 的 例子 是 以 下 几 点 : 


String hql = "FROM Employee AS E"; 
Query query = session.createQuery(hql); 
List results = query.list(); 


AS 关键 字 是 可 选 的， 也 可 以 直接 在 之 后 的 类 名 指定 别名 ， 如 下 所 示 : 


String hql = "FROM Employee E"; 
Query query = session.createQuery(hql); 
List results = query.list(); 


SELECT £4) 


SELECT 子 句 提供 了 更 多 的 控制 权 比 ffom 子 句 的 结果 集 。 如 果 想 获得 对 象 而 不 是 整 
个 对 象 的 几 个 属性 ， 使 用 SELECT 子 句 。 下 面 是 一 个 使 用 SELECT 语句 来 获取 
Employee 对 象 只 是 FIRST_NAME 字 段 的 简单 的 语法 : 


String hql = "SELECT E.firstName FROM Employee E"; 
Query query = session.createQuery(hql); 
List results = query.list(); 


值得 注意 的 是 在 这 里 ，Employee.firstName 是 Employee 对 象 的 一 个 属性 ， 而 不 是 
EMPLOYEE 表 的 一 个 字段。 


WHERE 子 名 


如 果 想 缩小 了 从 存储 返回 的 特定 对 象 ， 可 以 使 用 WHERE 子 句 。 下 面 是 一 个 使 用 
WHERE 子 句 的 简单 的 语法 : 


String hql = "FROM Employee E WHERE E.id = 10"; 
Query query = session.createQuery(hql); 
List results = query.list(); 


ORDER BY 子 句 


若 要 排序 HQL 坦 询 的 结果 ， 将 需要 使 用 ORDER BY 子 句 。 您 可 以 在 结果 集 按 升序 
(ASC) 或 降序 (DESC) 通过 在 对 象 的 任何 属性 排序 结果 。 下 面 是 一 个 使 用 
ORDER BY 子 句 的 简单 的 语法 : 


String hql = "FROM Employee E WHERE E.id > 10 ORDER BY E.salary DE: 
Query query = session.createQuery(hql); 
List results - query.list(); 





如 果 想 通过 一 个 以 上 的 属性 进行 排序 ， 你 会 仅仅 是 额外 的 属性 添加 到 由 子 句 用 逗号 
隔 开 ， 如 下 所 示 的 命 命 的 结尾 : 


String hql = "FROM Employee E WHERE E.id > 10 " + 

"ORDER BY E.firstName DESC, E.salary DESC "; 
Query query = session.createQuery(hql); 
List results = query.list(); 


GROUP BY +4) 


该 子 句 允许 从 Hibernate 的 它 基 于 属性 的 值 的 数据 库 和 组 提取 信息 ， 并 且 通 常 使 用 结 
果 包 括 总 值 。 下 面 是 一 个 使 用 GROUP BY 子 句 的 语法 很 简单 : 


String hql = "SELECT SUM(E.salary), E.firtName FROM Employee E " + 
"GROUP BY E.firstName"; 

Query query = session.createQuery(hql); 

List results = query.list(); 


a LLL BRI] 


使 用 命名 参 效 


Hibernate 命 名 在 其 HQL 查 询 参 数 支 持 。 这 使 得 编写 接受 来 自用 户 的 输入 容易 ， 不 必 
对 SQL 注 入 攻击 防御 HQL 查 询 。 下 面 是 一 个 使 用 命名 参数 的 简单 的 语法 : 


String hql = "FROM Employee E WHERE E.id = :employee_id"; 
Query query = session.createQuery(hql); 
query.setParameter("employee id',10); 

List results - query.list(); 


UPDATE 4) 


批量 更 新 是 新 的 HQL 与 Hibernate3， 以 及 不 同 的 删除 工作 ， 在 Hibernate 3 和 
Hibernate2 一 样 。 Query 接 口 现 在 包含 一 个 名 为 executeUpdate() 方 法 用 于 执行 HQL 
UPDATE 或 DELETE 语 句 。 


在 UPDATE 子 句 可 以 用 于 更 新 一 个 或 多 个 对 象 中 的 一 个 或 多 个 属性 。 下 面 是 一 个 使 
用 UPDATE 子 名 的 简单 的 语法 : 


String hql = "UPDATE Employee set salary = :salary " + 
"WHERE id = :employee_id"; 

Query query = session.createQuery(hql); 

query.setParameter("salary", 1000); 

query.setParameter("employee id", 10); 

int result = query.executeUpdate( ); 

System.out.println("Rows affected: " + result); 


DELETE £4) 


DELETE 子 句 可 以 用 来 删除 一 个 或 多 个 对 象 。 下 面 是 一 个 使 用 DELETE 子 句 的 简单 
的 语法 : 


String hql = "DELETE FROM Employee " + 

"WHERE id = :employee_id"; 
Query query = session.createQuery(hql); 
query.setParameter("employee_id", 10); 
int result = query.executeUpdate(); 
System.out.println("Rows affected: " + result); 


INSERT #4) 


HQL 支 持 INSERT INTO 子 句 中 只 记录 在 那里 可 以 插入 从 一 个 对 象 到 另 一 个 对 象 。 以 
下 是 使 用 INSERT INTO 子 句 的 简单 的 语法 : 


String hql = "INSERT INTO Employee(firstName, lastName, salary)" 
"SELECT firstName, lastName, salary FROM old_employee' 

Query query = session.createQuery(hql); 

int result = query.executeUpdate(); 





System.out.println("Rows affected: " + result); 
Art 
聚合 方法 


HQL 支 持 多 种 聚合 方法 ， 类 似 于 SQL。 他 们 工作 在 HQL 同 样 的 方式 在 SQL 和 下 面 的 
可 用 功能 列表 : 


S.N. 方法 描述 

1 avg(property name) The average of a property's value 

2 count(property name The number of times a property occurs in the 
or *) results 

3 max(property name) The maximum value of the property values 

4 min(property name) The minimum value of the property values 

5 sum(property name) The sum total of the property values 


DISTINCT 关 键 字 只 计算 在 该 行 设 定 的 唯一 值 。 下 面 的 查询 将 只 返回 唯一 的 计数 : 


String hql = "SELECT count(distinct E.firstName) FROM Employee E"; 


Query query = session.createQuery(hq1); 
List results = query -list(); 








了 — EE 
使 用 查询 分 页 
有 用 于 分 页 查询 接口 的 两 个 方法 。 
S.N. 方法 与 说 明 
1 Query setFirstResult(int startPosition) This method takes an integer 
that represents the first row in your result set, starting with row 0. 
2 Query setMaxResults(int maxResult) This method tells Hibernate to 


retrieve a fixed number maxResults of objects. 


采用 上 述 两 种 方法 一 起 ， 可 以 在 网 站 或 Swing 应 用 程序 构建 一 个 分 页 组 件 。 下 面 是 


例子 ， 可 以 扩展 来 获取 10 行 : 


String hql = "FROM Employee"; 

Query query = session.createQuery(hql); 
query.setFirstResult(1); 
query.setMaxResults(10); 

List results = query.list(); 


Hibernate 4 i4 IH - hibernate 


Hibernate 提 供 了 操作 对 象 ， 并 依次 数据 在 RDBMS 表 可 用 的 各 用 方式 。 其 中 一 个 方 
法 是 标准 的 APl， 它 允许 你 建立 一 个 标准 的 查询 对 象 编程 ， 可 以 套用 过 滤 规 则 和 地 
i, 


Hibernate 的 Session 接 口 提供 了 可 用 于 创建 一 个 返回 的 持久 化 对 象 的 类 的 实例 时 ， 
应 用 程序 执行 一 个 条 件 查 询 一 个 Criteria 对 象 createCriteria() 方 法 。 


以 下 是 最 简单 的 一 个 条 件 查询 的 例子 是 将 简单 地 返回 对 应 于 Employee 类 的 每 个 对 


o 


Criteria cr - session.createCriteria(Employee.class); 
List results - cr.list(); 


限制 与 标准 : 


可 以 使 用 add O 方法 可 用 于 Criteria 对 象 添 加 限制 条 件 查 询 。 下 面 是 例子 增加 一 个 
限制 与 薪水 返回 的 记录 是 等 于 2000 : 


Criteria cr = session.createCriteria(Employee.class); 
cr.add(Restrictions.eq("salary", 2000)); 
List results = cr.list(); 


以 下 是 几 个 例子 覆盖 不 同 的 场景 ， 并 且 可 以 根据 要 求 使 用 : 


Criteria cr = session.createCriteria(Employee.class); 


// To get records having salary more than 2000 
cr.add(Restrictions.gt("salary", 2000)); 


// To get records having salary less than 2000 
cr.add(Restrictions.lt("salary", 2000)); 


// To get records having fistName starting with zara 
cr.add(Restrictions.like("firstName", "zara%")); 


// Case sensitive form of the above restriction. 
cr.add(Restrictions.ilike("firstName", "zara%")); 


// To get records having salary in between 1000 and 2000 
cr.add(Restrictions.between("salary", 1000, 2000)); 


// To check if the given property is null 
cr.add(Restrictions.isNull("salary")); 


// To check if the given property is not null 
cr.add(Restrictions.isNotNull("salary")); 


// To check if the given property is empty 
cr.add(Restrictions.isEmpty("salary")); 


// To check if the given property is not empty 
cr.add(Restrictions.isNotEmpty("salary")); 


可 以 创建 AND 或 OR 使 用 LogicalExpression 限 制 如 下 条 件 : 


Criteria cr = session.createCriteria(Employee.class); 


Criterion salary = Restrictions.gt("salary", 2000); 
Criterion name = Restrictions.ilike("firstNname", "zara%") ; 


// To get records matching with OR condistions 
LogicalExpression orExp = Restrictions.or(salary, name); 
cr.add( orExp ); 

// To get records matching with AND condistions 
LogicalExpression andExp - Restrictions.and(salary, name); 
cr.add( andExp ); 


List results - cr.list(); 


虽然 上 述 所 有 条 件 ， 可 以 直接 使 用 HQL 在 前 面 的 教程 中 介绍 。 


分 页 使 用 标 ) 
还 有 的 标准 接口 ， 用 于 分 页 的 两 种 方法 。 


S.N. 方法 & 描述 
public Criteria setFirstResult(int firstResult) This method takes an 
1 integer that represents the first row in your result set, starting with row 
0. 


public Criteria setMaxResults(int maxResults) This method tells 
Hibernate to retrieve a fixed number maxResults of objects. 


采用 上 述 两 种 方法 一 起 ， 我 们 可 以 在 我 们 的 网 站 或 Swing 应 用 程序 构建 一 个 分 页 组 
件 。 下 面 是 例子 ， 可 以 扩展 来 每 次 获取 10 行 : 


Criteria cr = session.createCriteria(Employee.class); 
cr.setFirstResult(1); 

cr.setMaxResults(10); 

List results = cr.list(); 


排序 的 结果 : 


标准 的 API 提 供 了 org.hibernate.criterion.Order 类 排序 按 升序 或 降序 排列 你 的 结果 
集 ， 根 据 对 象 的 属性 。 这 个 例子 演示 了 如 何 使 用 Order 类 的 结果 集 进行 排序 : 


Criteria cr = session.createCriteria(Employee.class); 
// To get records having salary more than 2000 
cr.add(Restrictions.gt("salary", 2000)); 


// To sort records in descening order 
crit.addOrder(Order.desc("salary")); 


// To sort records in ascending order 
crit.addOrder(Order.asc("salary")); 


List results - cr.list(); 


FAMSRA : 


该 Criteria API 提 供 了 一 个 org.hibernate.criterion.Projections 类 可 用 于 获取 平均 值 ， 
最 大 值 或 最 小 值 的 属性 值 。Projections 类 是 类 似 于 类 限制 ， 因 为 它 提供 了 几 个 静态 
工厂 方法 用 于 获得 Projection 实例 。 provides the 


以 下 是 涉及 不 同 的 方案 的 一 些 例 子 ， 可 按 规定 使 用 : 


Criteria cr = session.createCriteria(Employee.class); 


// To get total row count. 
cr.setProjection(Projections.rowCount()); 


// To get average of a property. 
cr.setProjection(Projections.avg("salary")); 


// To get distinct count of a property. 
cr.setProjection(Projections.countDistinct("firstName") ); 


// To get maximum of a property. 
cr.setProjection(Projections.max("salary")); 


// To get minimum of a property. 
cr.setProjection(Projections.min("salary")); 


// To get sum of a property. 
cr.setProjection(Projections.sum("salary")); 


Criteria Queries 例子 : 


考虑 下 面 的 POJO 类 : 


public class Employee { 
private int id; 
private String firstName; 
private String lastName; 
private int salary; 


public Employee() {} 

public Employee(String fname, String lname, int salary) { 
this.firstName = fname; 
this.lastName = lname; 
this.salary - salary; 


public int getId() ( 
return id; 


public void setId( int id ) { 
this.id = id; 
} 


public String getFirstName() { 
return firstName; 


public void setFirstName( String first_name ) { 
this.firstName = first_name; 


public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 
} 


public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
} 


让 我 们 创建 下 面 的 EMPLOYEE 表 来 存储 Employee 对 象 : 


create table EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


): 


以 下 将 被 映射 文件 。 


<?xml 


versionz"1.0" encoding="utf-8"?> 


<!DOCTYPE hibernate-mapping PUBLIC 


"-//H 
"http 


«hiber 
«cl 


«/C 
«/hibe 


I — ——————————————————X—Mn7ÓME] 


ibernate/Hibernate Mapping DTD//EN" 
://www. hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 


nate-mapping> 
ass name="Employee" table="EMPLOYEE"> 
<meta attribute="class-description"> 
This class contains the employee detail. 
</meta> 
<id name="id" type="int" column="id"> 
<generator class="native"/> 
</id> 
«property name="firstName" column="first_name" type="string", 
«property name-"lastName" column="last_name" type-"string"/» 
«property name-"salary" column="Salary" type="int"/> 
lass» 
rnate-mapping> 





最 后 ， 我 们 将 创建 应 用 程序 类 的 main (0 方法 来 运行 ， 我 们 将 使 用 Criteria 查 询 的 应 


用 程序 : 


Import 
Import 
Import 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 
pri 
pub 


java.util.List; 
java.util.Date; 
java.util.Iterator; 


org.hibernate.HibernateException; 
org.hibernate.Session; 
org.hibernate.Transaction; 
org.hibernate.SessionFactory; 
org.hibernate.Criteria; 
org.hibernate.criterion.Restrictions; 
org.hibernate.criterion.Projections; 
org.hibernate.cfg.Configuration; 


class ManageEmployee { 

vate static SessionFactory factory; 

lic static void main(String[] args) { 

try{ 
factory = new Configuration().configure().buildSessionFaci 

catch (Throwable ex) { 
System.err.println("Failed to create sessionFactory object 
throw new ExceptionInInitializerError(ex); 


} 


ManageEmployee ME = new ManageEmployee(); 


/* Add few employee records in database */ 

Integer empID1 = ME.addEmployee("Zara", "Ali", 2000); 
Integer empID2 ME.addEmployee("Daisy", "Das", 5000); 
Integer empID3 = ME.addEmployee("John", "Paul", 5000); 


} 


Integer empID4 = ME.addEmployee("Mohd", "Yasee", 3000); 


/* List down all the employees */ 
ME.listEmployees(); 


/* Print Total employee's count */ 
ME.countEmployee(); 


/* Print Toatl salary */ 
ME.totalSalary(); 


/* Method to CREATE an employee in the database */ 
public Integer addEmployee(String fname, String lname, int sala! 


j 


Ua 


Session session - factory.openSession(); 
Transaction tx - null; 
Integer employeeID - null; 
tryt 
tx - session.beginTransaction(); 
Employee employee - new Employee(fname, lname, salary); 
employeeID - (Integer) session.save(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
jfinally { 
session.close(); 


j 


return employeeID; 


Method to READ all the employees having salary more than 20( 


public void listEmployees( ){ 


Session session - factory.openSession(); 
Transaction tx - null; 
tryt 
tx = session.beginTransaction(); 
Criteria cr - session.createCriteria(Employee.class); 
// Add restriction. 
cr.add(Restrictions.gt("salary", 2000)); 
List employees - cr.list(); 


for (Iterator iterator - 
employees.iterator(); iterator.hasNext(: 
Employee employee - (Employee) iterator.next(); 
System.out.print("First Name: " + employee.getFirstNam: 
System.out.print(" Last Name: " + employee.getLastName 
System.out.println(" Salary: " + employee.getSalary(). 
} 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 


session.close(); 

} 
} 
/* Method to print total number of records */ 
public void countEmployee(){ 

Session session = factory.openSession(); 

Transaction tx = null; 

try{ 


tx = session.beginTransaction(); 
Criteria cr = session.createCriteria(Employee.class); 


// To get total row count. 
cr.setProjection(Projections.rowCount()); 
List rowCount = cr.list(); 


System.out.println("Total Coint: " + rowCount.get(0) ); 
tx.commit(); 

jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 

jfinally { 
session.close(); 

} 

} 


/* Method to print sum of salaries */ 
public void totalSalary(){ 
Session session = factory.openSession(); 
Transaction tx = null; 
try{ 
tx = session.beginTransaction(); 
Criteria cr = session.createCriteria(Employee.class); 


// To get total salary. 
cr.setProjection(Projections.sum("salary")); 
List totalSalary = cr.list(); 


System.out.println("Total Salary: " + totalSalary.get(0) 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 





编译 和 执行 : 


下 面 是 步骤 来 编译 并 运行 上 述 应 用 程序 。 请 确保 您 已 在 进行 的 编译 和 执行 之 前 ， 适 
当地 设置 PATH 和 CLASSPATH。 


e 创建 hibernate.cfg.xml 配 置 文件 中 配置 章节 解释 。 
e 创建 Employee.hbm.xml 映 射 文件 ， 如 上 图 所 示 。 
e 创建 Employee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 创建 ManageEmployee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 执行 ManageEmployee 二 进 制 运行 程序 . 

会 得 到 以 下 结果 ， 并 记录 将 创建 在 EMPLOYEE 表 中 。 
$java ManageEmployee 
ee VARIOUS LOG MESSAGES WILL DISPLAY HERE........ 
First Name: Daisy Last Name: Das Salary: 5000 
First Name: John Last Name: Paul Salary: 5000 
First Name: Mohd Last Name: Yasee Salary: 3000 


Total Coint: 4 
Total Salary: 15000 


如 果 检 查 EMPLOYEE 表 ， 它 应 该 记录 如 下 : 


mysql> select * from EMPLOYEE; 


foi eed Ee SSeS eere ley eene ever Ses + 
| id | first_name | last_name | salary | 
Bp oe po eee fe d ao see + 
| 14 | Zara | Ali | 2000 | 
| 15 | Daisy | Das | 5000 | 
| 16 | John | Paul | 5000 | 
| 17 | Mohd | Yasee | 3000 | 
p See Ss aS oe Ss Hess ceu boo ass + 
4 rows in set (0.00 sec) 


mysql> 


Hibernate A ^ SQL - hibernate 


可 以 使 用 原生 SQL 来 表达 数据 库 查 询 ， 如 果 想 利用 数据 库 特 有 的 功能 ， 如 查询 提示 
或 者 Oracle 中 的 CONNECT 关 键 字 。 Hibernate3.x 人 允许 使 用 手写 SQL 语句 ， 包 括 存 
储 过 程 ， 所 有 的 创建 ， 更 新 ， 删 除 和 load 操 作 。 


应 用 程序 将 从 会 话 创 建 一 个 原生 SQL 坦 询 (Session 接 口上 ) createSQLQuery()A 
public SQLQuery createSQLQuery(String sqlString) throws HibernateE> 
mi = 8 


Nu s 3$—^SSSQLS$lcreatesQLQuery()75;&, M EURISQLZE RESHMA 
Hibernate 实 体 ， 联 接 ， 或 者 一 个 标量 结果 使 用 addEntity() 方 法 ，addJoin()， 和 
addScalar() 方 法 关联 的 字符 串 。 





标量 查询 : 


最 基本 的 SQL 查询 是 从 一 个 或 多 个 表 中 得 到 标量 (数值 ) 的 列表 。 以 下 是 语法 使 用 
原生 SQL 标量 的 值 : 


String sql = "SELECT first_name, salary FROM EMPLOYEE"; 
SQLQuery query = session.createSQLQuery(sql); 
query.setResultTransformer(Criteria.ALIAS TO ENTITY MAP); 
List results - query.list(); 


实体 的 查询 : 


上 面 的 查询 都 是 返回 标量 值 ， 也 就 是 从 resultset 中 返回 的 “ 裸 " 数 据 。 以 下 是 语法 通 
过 addEntity () 方法 来 从 原生 SQL 查询 获得 实体 对 象 作为 一 个 整体 。 


String sql = "SELECT * FROM EMPLOYEE"; 
SQLQuery query = session.createSQLQuery(sql); 
query.addEntity(Employee.class); 

List results = query.list(); 


命名 SQL 坦 询 : 


以 下 是 语法 通过 addEntity O 方法 来 从 原生 SQL 查询 获得 实体 对 象 和 使 用 命名 SQL 
查询 。 


String sql = "SELECT * FROM EMPLOYEE WHERE id = :employee_id"; 
SQLQuery query = session.createSQLQuery(sql); 
query.addEntity(Employee.class); 
query.setParameter("employee_id", 10); 

List results = query.list(); 


Native SQL 例子 : 
考虑 下 面 的 POJO 类 : 


public class Employee { 
private int id; 
private String firstName; 
private String lastName; 
private int salary; 


public Employee() {} 
public Employee(String fname, String lname, int salary) { 
this.firstName = fname; 
this.lastName = lname; 
this.salary = salary; 
} 
public int getId() { 
return id; 


public void setId( int id ) ( 
this.id - id; 


public String getFirstName() ( 
return firstName; 


public void setFirstName( String first name ) { 
this.firstName - first name; 
} 


public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 


public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
} 


让 我 们 创建 下 面 的 EMPLOYEE 表 来 存储 Employee 对 象 : 


create table EMPLOYEE ( 


id 


INT NOT NULL auto_increment, 


first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 


PRI 
DE 


MARY KEY (id) 


以 下 将 被 映射 文件 。 


<?xml 


version="1.0" encoding="utf-8"?> 


<!DOCTYPE hibernate-mapping PUBLIC 


"-//H 


ibernate/Hibernate Mapping DTD//EN" 


"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"» 


«hiber 


nate-mapping> 


<class name="Employee" table="EMPLOYEE"> 


</C 


<meta attribute="class-description"> 
This class contains the employee detail. 
</meta> 
<id name="id" type="int" column="id"> 
<generator class="native"/> 
</id> 
«property name="firstName" column="first_name" type="string", 
«property name-"lastName" column="last_name" type="string"/> 
«property name-"salary" column="Salary" type="int"/> 
lass> 


</hibernate-mapping> 





最 后 ， 我 们 将 创建 应 用 程序 类 的 main O 方法 来 运行 ， 我 们 将 使 用 原生 SQL 坦 询 的 
应 用 程序 : 


Import 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 


Java.util.*; 


org.hibernate.HibernateException; 
org.hibernate.Session; 

org. hibernate. Transaction; 
org.hibernate.SessionFactory; 
org.hibernate.SQLQuery; 
org.hibernate.Criteria; 

org. hibernate.Hibernate; 
org.hibernate.cfg.Configuration; 


class ManageEmployee { 


private static SessionFactory factory; 


pub 


lic static void main(String[] args) { 


} 


try{ 
factory = new Configuration().configure().buildSessionFact 


}catch (Throwable ex) { 
System.err.println("Failed to create sessionFactory object 
throw new ExceptionInInitializerError(ex); 


} 
ManageEmployee ME = new ManageEmployee(); 


/* Add few employee records in database */ 

Integer empID1 ME.addEmployee("Zara", "Ali", 2000); 
Integer empID2 .addEmployee("Daisy", "Das", 5000); 
Integer empID3 .addEmployee("John", "Paul", 5000); 
Integer empID4 .addEmployee("Mohd", "Yasee", 3000); 


Ho oH H I 
zo o 55 
mmm 


/* List down employees and their salary using Scalar Query *, 
ME.listEmployeesScalar(); 


/* List down complete employees information using Entity Que! 
ME.listEmployeesEntity(); 


/* Method to CREATE an employee in the database */ 
public Integer addEmployee(String fname, String lname, int sala! 


j 


jes 


Session session = factory.openSession(); 
Transaction tx = null; 
Integer employeeID = null; 
tryt 
tx = session.beginTransaction(); 
Employee employee - new Employee(fname, lname, salary); 
employeeID - (Integer) session.save(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
j 


return employeeID; 


Method to READ all the employees using Scalar Query */ 


public void listEmployeesScalar( ){ 


Session session - factory.openSession(); 

Transaction tx - null; 

tryt 
tx - session.beginTransaction(); 
String sql - "SELECT first name, salary FROM EMPLOYEE"; 
SQLQuery query = session.createSQLQuery(sq1); 
query.setResultTransformer(Criteria.ALIAS TO ENTITY MAP); 
List data - query.list(); 


for(Object object : data) 


{ 
Map row = (Map)object; 


System.out.print("First Name: " + row.get("first name" 
System.out.println(", Salary: " + row.get("salary")); 
} 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
} 


} 


/* Method to READ all the employees using Entity Query */ 
public void listEmployeesEntity( ){ 
Session session = factory.openSession(); 
Transaction tx = null; 
try{ 
tx = session.beginTransaction(); 
String sql = "SELECT * FROM EMPLOYEE"; 
SQLQuery query = session.createSQLQuery(sql); 
query.addEntity(Employee.class); 
List employees = query.list(); 


for (Iterator iterator = 
employees.iterator(); iterator.hasNext(: 
Employee employee - (Employee) iterator.next(); 
System.out.print("First Name: " + employee.getFirstName 
System.out.print(" Last Name: " + employee.getLastName 
System.out.println(" Salary: " + employee.getSalary(). 
} 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!=null) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 





编译 和 执行 : 


下 面 是 步骤 来 编译 并 运行 上 述 应 用 程序 。 请 确保 在 进行 的 编译 和 执行 之 前 ， 适 当地 
设置 PATH 和 CLASSPATH。 


e 创建 hibernate.cfg.xml 配 置 文件 中 配置 章节 解释 。 
e 创建 Employee.hbm.xml 映 射 文件 ， 如 上 图 所 示 。 
e 创建 Employee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 


e 创建 ManageEmployee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 执行 ManageEmployee 二 进 制 文件 来 运行 程序 。 
会 得 到 以 下 结果 ， 并 记录 将 在 EMPLOYEE 表 中 创建 。 


$java ManageEmployee 
Fa oto tc VARIOUS LOG MESSAGES WILL DISPLAY HERE........ 


First Name: Zara, Salary: 2000 

First Name: Daisy, Salary: 5000 

First Name: John, Salary: 5000 

First Name: Mohd, Salary: 3000 

First Name: Zara Last Name: Ali Salary: 2000 
First Name: Daisy Last Name: Das Salary: 5000 
First Name: John Last Name: Paul Salary: 5000 
First Name: Mohd Last Name: Yasee Salary: 3000 


如 果 检 查 EMPLOYEE 表 ， 它 应 该 记录 下 已 : 


mysql> select * from EMPLOYEE; 


foo a eue e e eas deceret dame + 
| id | first_name | last_name | salary | 
Pe SS Sa Hoss eene bao eas + 
| 26 | Zara | Ali | 2000 | 
| 27 | Daisy | Das | 5000 | 
| 28 | John | Paul | 5000 | 
| 29 | Mohd | Yasee | 3000 | 
Poraa eu cod chen eue soo gabe oss es + 


4 rows in set (0.00 sec) 


Hibernate: £x - hibernate 


缓存 是 所 有 关于 应 用 程序 的 性 能 优化 和 它 位 于 应 用 程序 和 数据 库 之 间 ， 以 避免 数据 
库 访 问 多 次 ， 让 性 能 关键 型 应 用 程序 有 更 好 的 表现 。 


缓存 对 Hibernate 很 重要 ， 它 采用 了 多 级 缓存 方案 下 文 所 述 : 


Hibernate 





Second-level Cache 


Optional 


jilosi eor 


第 一 级 缓存 : 


第 一 级 缓存 是 Session 的 缓存 ， 是 一 个 强制 性 的 缓存 ， 通 过 它 所 有 的 请 求 都 必须 通 
过 。 Session 对 象 不 断 自 身 的 动力 的 对 象 ， 提 交 到 数据 库 之 前 。 


如 果 发 出 多 个 更 新 一 个 对 象 ，Hibernate 试 图 拖延 尽 可 能 长 的 时 间 做 了 更 新 ， 以 减少 
发 出 的 更 新 SQL 语句 的 数量 。 如 果 您 关闭 会 话 ， 所 有 被 缓存 的 对 象 都 将 丢失 ， 要 人 么 
持久 ， 或 在 数据 库 中 更 新 。 


二 级 缓存 : 


二 级 缓存 是 可 选 的 缓存 和 一 级 缓存 ， 总 是 会 征询 任何 试图 找到 一 个 对 象 的 二 级 缓存 
之 前 。 第 二 级 缓存 可 以 在 每 个 类 和 每 个 集合 基础 上 进行 配置 ， 主 要 负责 在 会 话 缓存 
的 对 象 。 


任何 第 三 方 缓存 可 以 使 用 Hibernate。org.hibernate.cache.CacheProvider 接 口 提 
供 ， 必 须 实 施 提 供 Hibernate 一 个 句柄 缓存 实现 。 


查询 级 别 缓 存 : 


Hibernate 也 实现 了 查询 结果 集 缓存 与 二 级 缓存 的 紧密 集成 在 一 起 。 
这 是 一 个 可 选 功 能 ， 需 要 两 个 额外 的 物理 缓存 中 保存 缓存 的 查询 结果 和 地 区 当 一 个 


表 的 最 后 更 新 的 时 间 戳 。 这 只 是 针对 那些 使 用 相同 的 参数 经 前 运行 的 查询 非常 有 
用 3 


二 级 缓存 : 


Hibernate 使 用 一 级 缓存 ， 默 认 情 况 下 ， 你 什么 都 没有 做 使 用 第 一 级 缓存 。 让 我 们 直 
接 进 入 可 选 的 第 二 级 缓存 。 并 不 是 所 有 的 类 受益 于 缓存 ， 这 样 一 来 就 能 禁用 二 级 缓 
存 是 很 重要 的 


Hibernate 二 级 缓存 被 设置 为 两 个 步 骆 。 首 先 ， 必 须 决 定 要 使 用 的 并 发 策略 。 在 此 之 
后 ， 可 以 配置 缓存 过 期 和 使 用 缓存 提供 物理 缓存 属性 。 


并 发 策略 : 
并 发 策略 是 一 个 中 介 的 负责 存储 数据 项 在 缓存 并 从 缓存 中 检索 它们 。 如 果 要 启用 二 


级 缓存 ， 将 必须 决定 ， 为 每 个 持久 化 类 和 集合 ， 要 使 用 的 缓存 并 发 策略 。 


e Transactional: 使 用 这 种 策略 的 主要 读 取 数 据 的 地 方 ， 以 防止 过 时 的 数据 的 并 
发 事务 ， 在 更 新 的 罕见 情况 下 是 至 关 重 要 的 。 


e Read-write: 再 次 使 用 这 种 策略 的 主要 读 取 数 据 的 地 方 ， 以 防止 并 发 事务 陈旧 的 
数据 是 至 关 重 要 的 ， 在 更 新 的 罕见 情况 。 


e Nonstrict-read-write: 这 种 策略 不 保证 缓存 与 数据 库 之 间 的 一 致 性 。 使 用 此 策 
略 ， 如 果 数 据 很 少 改 变 和 陈旧 数据 的 可 能 性 很 小 关键 是 不 关注 。 


e Read-only: 并 发 策略 适用 于 数据 ， 永 远 不 会 改变 。 使 用 数据 仅 供 参 考 。 


如 果 我 们 要 使 用 第 二 级 缓存 为 我 们 的 Employee 类 ， 让 我 们 添加 告诉 Hibernate 使 用 
可 读 写 的 高 速 缓存 策略 Employee 实 例 所 需 的 映射 元 素 。 


<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http: //www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"» 


<hibernate-mapping> 
<class name="Employee" table="EMPLOYEE"> 
<meta attribute="class-description"> 
This class contains the employee detail. 
</meta> 
<cache usage="read-write"/> 
<id name="id" type="int" column="id"> 
<generator class="native"/> 
</id> 
«property name="firstName" column="first_name" type="string", 
«property name-"lastName" column="last_name" type-"string"/» 
«property name-"salary" column="Salary" type="int"/> 
</class> 
</hibernate-mapping> 


本 NE 


usage="read-write” [Rif & jc Hibernate FB — 4*8] ik 003 4t SERIGE 2 BIE. 


缓存 提供 者 : 


考虑 到 会 用 你 的 缓存 候选 类 的 并 发 策略 后 ， 下 一 步 就 是 选择 一 个 缓存 提供 程序 。 
Hibernate 人 迫使 选择 一 个 缓存 提供 整个 应 用 程序 。 


S.N. 缓存 名 称 描述 
它 可 以 在 内 存 或 磁盘 上 以 及 群集 缓存 缓存 ， 它 支持 可 选 





i Em ane 的 Hibernate 查 询 结 果 缓 存 。 

支持 缓存 内 存 和 磁 杀 在 一 个 JVM 中 ， 有 一 组 丰富 的 过 期 
2 O8Cache 策略 和 查询 绥 存 的 支持 。 
3 A 基于 JGroups 的 集群 缓存 。 它 使 用 群集 失效 ， 但 不 支持 


Hibernate 的 查询 缓存 


JBoss 一 个 完全 的 事务 复制 的 集群 缓存 也 是 基于 JGroups 的 组 
4 Cache 播 库 。 它 支持 复制 或 失效 ， 同 步 或 异步 通信 ， 乐 观 和 悲 
观 锁定 。 支 持 Hibernate 的 查询 缓存 


每 一 个 缓存 提供 程序 是 不 是 与 每 个 并 发 策略 兼容 。 以 下 兼容 性 矩阵 将 帮助 选择 合适 
的 组 合 。 


Read- Nonstrictread- Read- 


Strategy/Provider only write wie Transactional 
EHCache X X X 

OSCache X X X 

SwarmCache X X 

JBoss Cache X X 


在 指定 hibernate.cfg.xml 配 置 文件 中 的 缓存 提供 。 选 择 EHCache 作 为 第 二 级 缓存 提 
供 程 序 : 


<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-configuration SYSTEM 
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> 


<hibernate-configuration> 

<session-factory> 

<property name="hibernate.dialect"> 
org.hibernate.dialect.MySQLDialect 

</property> 

<property name="hibernate.connection.driver_class"> 
com.mysql.jdbc.Driver 

</property> 


<!-- Assume students is the database name --> 

«property name="hibernate.connection.url"> 
jdbc:mysq1://localhost/test 

«/property» 

«property name="hibernate.connection.username"> 
root 

«/property» 

«property name="hibernate.connection.password"> 
root123 

</property> 

<property name="hibernate.cache.provider_class"> 
org.hibernate.cache.EhCacheProvider 

</property> 


<!-- List of XML mapping files --> 
«mapping resource-"Employee.hbm.xml"/» 


</session-factory> 
</hibernate-configuration> 


现在 ， 需 要 指定 缓存 区 域 的 属性 。EHCache 都 有 自己 的 配置 文件 ehcache.xml， 在 
应 用 程序 在 CLASSPATH 中 。 在 ehcache.xml 中 Employee 类 高 速 缓存 配置 可 能 看 起 
来 像 这 样 : 


<diskStore path="java.io.tmpdir"/> 
<defaultCache 
maxElementsInMemory="1000" 
eternal="false" 
timeToIdleSeconds="120" 
timeToLiveSeconds="120" 
overflowToDisk="true" 

/> 


<cache name="Employee" 
maxElementsInMemory="500" 
eternal="true" 
timeToIdleSeconds="0" 
timeToLiveSeconds="0" 
over flowToDisk="false" 

/> 


就 这 样 ， 现 在 启用 Employee 类 的 二 级 缓存 和 Hibernate 现 在 二 级 缓存 ， 每 当 浏 览 到 
一 个 履 员 或 当 通过 标识 符 加 载 奢 员 。 


应 该 分 析 你 所 有 的 类 ， 并 选择 适当 的 缓存 策略 为 每 个 类 。 有 时 ， 二 级 缓存 可 能 降级 
的 应 用 程序 的 性 能 。 所 以 建议 到 基准 应 用 程序 第 一 次 没有 启用 缓存 ， 非 常 适合 缓存 
和 检查 性 能 。 如 果 缓 存 不 提高 系统 性 能 再 有 就 是 在 使 任何 类 型 的 缓存 是 没有 意义 
的 。 


查询 级 别 缓存 : 


使 用 查询 缓存 ， 必 须 先 使 用 hibernate.cache.use_query_cache="true" 属 性 配置 
件 中 激活 它 。 如 果 将 此 属性 设置 为 true， 让 Hibernate 的 在 内 存 中 创建 所 需 的 高 aA 
存 来 保存 查询 和 标识 符 集 。 


接 下 来 ， 使 用 查询 缓存 ， 可 以 使 用 Query 类 的 setCacheable (Boolean) 方法 。 例 
如 : 


Session session = SessionFactory.openSession(); 
Query query = session.createQuery("FROM EMPLOYEE"); 
query.setCacheable(true); 

List users - query.list(); 
SessionFactory.closeSession(); 


Hibernate 也 支持 通过 一 个 缓存 区 域 的 概念 非常 细 粒 度 的 缓存 支持 。 缓 存 区 是 这 是 给 
定 一 个 名 称 缓存 的 一 部 分 。 


Session session = SessionFactory.openSession(); 
Query query = session.createQuery("FROM EMPLOYEE"); 
query.setCacheable(true); 
query.setCacheRegion("employee"); 

List users - query.list(); 
SessionFactory.closeSession(); 


此 代码 使 用 方法 告诉 Hibernate 来 存储 和 查找 在 缓存 中 的 员工 方面 的 查询 。 
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考虑 这 样 一 种 情况 ， 当 需要 使 用 Hibernate 上 传 大 量 的 记录 到 数据 库 中 。 以 下 是 代码 
片段 实现 这 一 使 用 Hibernate : 


Session session = SessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 
for ( int i-0; i«100000; i++ ) { 
Employee employee - new Employee(..... Je 
session.save(employee); 
} 
tx.commit(); 
session.close(); 


因为 默认 情况 下 ，Hibernate 会 缓存 所 有 的 持久 对 象 在 session 级 别 的 缓存 ， 并 最 终 
应 用 程序 会 失败 并 发 生 OutOfMemoryException 某 处 50,000 条 记录 左右 。 如 果 使 用 
的 是 批量 处 理 与 Hibernate 解 决 这 个 问题 。 


要 使 用 批量 处 理 功能 ， 首 先 设置 hibernate.jdbc.batch_size 为 批量 大 小 若干 无 论 是 在 
20 或 50 根 据 对 象 的 大 小 。 这 将 告诉 每 X 行 插入 批 次 hibernate 的 容器 。 为 了 实现 这 个 
在 代码 中 ， 我 们 需要 做 一 点 修改 如 下 : 


Session session = SessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 
for ( int i-0; i«100000; i++ ) { 
Employee employee = new Employee(..... ie 
session.save(employee) ; 
if( i 96 50 == 0 ) { // Same as the JDBC batch size 
//flush a batch of inserts and release memory: 
session.flush(); 
session.clear(); 


} 


tx.commit(); 
session.close(); 


上 面 的 代码 将 正常 工作 INSERT 操 作 ， 但 如 果 愿 意 做 UPDATE 操 作 ， 那 么 可 以 使 用 
下 面 的 代码 实现 : 


Session session = sessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 


ScrollableResults employeeCursor = session.createQuery("FROM EMPLO" 
.scroll(); 
int count = 0; 


while ( employeeCursor.next() ) { 
Employee employee = (Employee) employeeCursor.get(0); 
employee.updateEmployee(); 
seession.update(employee); 
if ( ++count 96 50 = 0 ) { 
session.flush(); 
session.clear(); 
} 
} 
tx.commit(); 
session.close(); 


Ee 


He xs TBR 5 : 


让 我 们 修改 配置 文件 作为 补充 hibernate.jdbc.batch_size 属 性 : 





<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-configuration SYSTEM 
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> 


<hibernate-configuration> 

«session-factory» 

«property name="hibernate.dialect"> 
org.hibernate.dialect.MySQLDialect 

«/property» 

«property name="hibernate.connection.driver_class"> 
com.mysql.jdbc.Driver 

«/property» 


<!-- Assume students is the database name --> 

«property name="hibernate.connection.url"> 
jdbc:mysq1://localhost/test 

«/property» 

«property name="hibernate.connection.username"> 
root 

«/property» 

«property name="hibernate.connection.password"> 
root123 

«/property» 

«property name="hibernate.jdbc.batch_size"> 
50 

«/property» 


<!-- List of XML mapping files --> 
«mapping resource-"Employee.hbm.xml"/» 


</session-factory> 
</hibernate-configuration> 


考虑 下 面 的 POJO Employee X : 


public class Employee { 
private int id; 
private String firstName; 
private String lastName; 
private int salary; 


public Employee() {} 

public Employee(String fname, String lname, int salary) { 
this.firstName = fname; 
this.lastName = lname; 
this.salary - salary; 


public int getId() ( 
return id; 


public void setId( int id ) { 
this.id = id; 
} 


public String getFirstName() { 
return firstName; 


public void setFirstName( String first_name ) { 
this.firstName = first_name; 


public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 
} 


public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
} 


让 我 们 创建 下 面 的 EMPLOYEE 表 来 存储 Employee 对 象 : 


create table EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


): 


下 面 业 映射 文件 映射 员工 EMPLOYEE 表 的 对 象 。 


<?xml version="1.0" encoding="utf-8"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"» 


<hibernate-mapping> 
<class name="Employee" table="EMPLOYEE"> 
<meta attribute="class-description"> 
This class contains the employee detail. 
</meta> 
<id name="id" type="int" column="id"> 
<generator class="native"/> 
</id> 
«property name="firstName" column="first_name" type="string", 
«property name-"lastName" column="last_name" type="string"/> 
«property name-"salary" column="Salary" type="int"/> 
</class> 
</hibernate-mapping> 


Eee 
最 后 ， 我 们 将 创建 与 应 用 程序 类 main() 方 法 来 运行 ， 我 们 将 使 用 flush() 和 clear() 可 


Session 对 象 方法 ， 使 Hibernate 的 继续 写 这 些 记 录 到 数据 库 中 ， 而 不 是 它们 缓存 中 
的 应 用 内 存 。 





import 


import 
import 
import 
import 
import 
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pri 
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} 
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pub 


Java.util.*; 


org.hibernate.HibernateException; 
org.hibernate.Session; 
org.hibernate. Transaction; 
org.hibernate.SessionFactory; 
org.hibernate.cfg.Configuration; 


Class ManageEmployee { 

vate static SessionFactory factory; 

lic static void main(String[] args) { 

tryt 
factory = new Configuration().configure().buildSessionFac! 

}catch (Throwable ex) { 
System.err.println("Failed to create sessionFactory object 
throw new ExceptionInInitializerError(ex); 


j 


ManageEmployee ME - new ManageEmployee(); 


/* Add employee records in batches */ 
ME.addEmployees( ); 


Method to create employee records in batches */ 
lic void addEmployees( ){ 
Session session - factory.openSession(); 
Transaction tx - null; 
Integer employeeID - null; 
tryt 
tx - session.beginTransaction(); 
for ( int i=0; i«100000; i++ ) { 
String fname = "First Name " + i; 
String lname = "Last Name " + i; 
Integer salary = 1; 
Employee employee = new Employee(fname, lname, salary), 
session.save(employee); 
if( i % 50 = 0 ) ( 
session.flush(); 
session.clear(); 
} 
} 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
} 


return ; 








编译 和 执行 : 
下 面 是 步骤 来 编译 并 运行 上 述 应 用 程序 。 请 确保 您 已 在 进行 的 编译 和 执行 之 前 ， 适 
当地 设置 PATH 和 CLASSPATH。 

e 创建 hibernate.cfg.xml 配 置 文件 ， 如 上 面 所 述 。 

e 创建 Employee.hbm.xml 映 射 文件 ， 如 上 图 所 示 。 

e 创建 Employee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 

e 创建 ManageEmployee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 


e 执行 ManageEmployee 二 进 制 运行 将 在 EMPLOYEE 表 中 创建 100000 条 记录 程 
序 。 


Hibernate 7 #425 - hibernate 


正如 前 面 已 经 了 解 到 ， 在 Hibernate 中 ， 对 象 将 被 创建 并 人 保存。 一旦 对 象 已 经 改变 ， 
它 必 须 被 保存 到 数据 库 中 。 这 个 过 程 一 直 持 续 的 对 象 是 需要 的 ， 直 到 下 一 次 ， 并 且 
它 将 被 从 持久 存储 加 载 。 


因此 ， 一 个 对 象 通过 不 同 阶段 的 生命 周期 和 拦截 器 接口 提供 了 可 以 在 不 同 的 阶段 被 
调用 来 执行 一 些 任 务 所 需 的 方法 。 这 些 方 法 是 从 session 到 应 用 程序 的 回调 ， 人 允许 它 
被 保存 在 申请 前 检查 和 /或 操纵 持久 化 对 象 的 属性 ， 更 新 ， 删 除 或 加 载 。 以 下 是 拦截 
器 界面 中 所 有 可 用 的 方法 列表 : 


S.N. Method and 描述 


findDirty() This method is be called when the flush() method is called 


1 on a Session object. 


2 instantiate() This method is called when a persisted class is 
instantiated. 

3 isUnsaved() This method is called when an object is passed to the 
saveOrUpdate() method/ 

4 onDelete() This method is called before an object is deleted. 
onFlushDirty() This method is called when Hibernate detects that an 

5 object is dirty (ie. have been changed) during a flush i.e. update 
operation. 

6 onLoad() This method is called before an object is initialized. 

7 onSave() This method is called before an object is saved. 

8 postFlush() This method is called after a flush has occurred and an 


object has been updated in memory. 


9 preFlush() This method is called before a flush. 


Hibernate 拦 截 器 为 我 们 提供 了 完全 控制 对 象 如 何 将 目光 转向 应 用 程序 和 数据 库 。 


如 何 使 用 拦截 器 ? 


为 了 建立 一 个 拦截 器 可 以 直接 实现 Interceptor 接 口 的 类 或 继承 自 Emptylnterceptor 
类 。 以 下 将 简单 的 步骤 来 使 用 Hibernate 拦 截 功能 。 


创建 拦截 器 : 


我 们 将 在 例子 在 创建 和 更 新 Employee 对 象 时 ， 拦 截 器 的 方法 将 被 自动 调用 继承 自 
Emptylnterceptor。 可 以 实现 更 多 的 方法 按 您 的 要 求 。 


import java.io.Serializable; 
import java.util.Date; 
import java.util.Iterator; 


import org.hibernate.EmptyInterceptor; 
import org.hibernate.Transaction; 
import org.hibernate.type.Type; 


public class MyInterceptor extends EmptyInterceptor { 
private int updates; 
private int creates; 
private int loads; 


public void onDelete(Object entity, 
Serializable id, 
Object[] state, 
String[] propertyNames, 
Type[] types) { 
// do nothing 


j 


// This method is called when Employee object gets updated. 
public boolean onFlushDirty(Object entity, 
Serializable id, 
Object[] currentState, 
Object[] previousState, 
String[] propertyNames, 
Type[] types) { 
if ( entity instanceof Employee ) { 
System.out.println("Update Operation"); 
return true; 


return false; 


public boolean onLoad(Object entity, 
Serializable id, 
Object[] state, 
String[] propertyNames, 
Type[] types) { 
// do nothing 
return true; 
} 
// This method is called when Employee object gets created. 
public boolean onSave(Object entity, 
Serializable id, 
Object[] state, 
String[] propertyNames, 
Type[] types) { 
if ( entity instanceof Employee ) { 


System.out.println("Create Operation"); 
return true; 


return false; 
//called before commit into database 
public void preFlush(Iterator iterator) { 
System.out.println("preFlush"); 
//called after committed into database 


public void postFlush(Iterator iterator) { 
System.out.println("postFlush"); 
j 


创建 POJO 类 : 


现在 ， 让 我 们 修改 一 点 点 ， 我 们 使 用 的 EMPLOYEE 表 和 Employee 类 一 起 看 一 个 例 
Ff: 


public class Employee { 
private int id; 
private String firstName; 
private String lastName; 
private int salary; 


public Employee() {} 

public Employee(String fname, String lname, int salary) { 
this.firstName = fname; 
this.lastName = lname; 
this.salary - salary; 


public int getId() ( 
return id; 


public void setId( int id ) { 
this.id = id; 
} 


public String getFirstName() { 
return firstName; 


public void setFirstName( String first_name ) { 
this.firstName = first_name; 


public String getLastName() { 
return lastName; 


public void setLastName( String last_name ) { 
this.lastName = last_name; 
} 


public int getSalary() { 
return salary; 


public void setSalary( int salary ) { 
this.salary = salary; 
} 


创建 数据 库 表 : 


第 二 步 是 在 数据 库 中 创建 表 。 会 有 一 个 表 对 应 于 每 一 个 对 象 ， 愿 意 提供 持久 性 。 考 
虑 上 述 目的 需要 存储 和 检索 到 下 面 的 RDBMS 表 : 


create table EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


); 


创建 映射 配置 文件 : 


这 一 步 是 创建 一 个 指示 Hibernate 如 何 定义 的 一 个 或 多 个 类 映射 到 数据 库 表 的 映射 文 
ft, 


<?xml version="1.0" encoding="utf-8"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"» 


<hibernate-mapping> 
<class name="Employee" table="EMPLOYEE"> 
<meta attribute="class-description"> 
This class contains the employee detail. 
</meta> 
<id name="id" type="int" column="id"> 
<generator class="native"/> 
</id> 
«property name="firstName" column="first_name" type="string", 
«property name-"lastName" column="last_name" type="string"/> 
«property name="Salary" column="Salary" type="int"/> 
</class> 
</hibernate-mapping> 





创建 应 用 程序 类 


最 后 ， 我 们 将 创建 应 用 程序 类 的 main() 方 法 来 运行 应 用 程序 。 这 里 应 该 指出 的 是 ， 
在 创建 会 话 对 象 ， 我 们 使 用 了 拦截 器 类 作为 参数 。 


import java.util.List; 
import java.util.Date; 
import java.util.Iterator; 


import org.hibernate.HibernateException; 
import org.hibernate.Session; 

import org.hibernate.Transaction; 

import org.hibernate.SessionFactory; 


import org.hibernate.cfg.Configuration; 


public class ManageEmployee { 
private static SessionFactory factory; 
public static void main(String[] args) { 
tryt 
factory = new Configuration( ).configure().buildSessionFact 
}catch (Throwable ex) { 
System.err.println("Failed to create sessionFactory object 


} 


throw new ExceptionInInitializerError(ex); 


ManageEmployee ME = new ManageEmployee(); 


/* Add few employee records in database */ 


Integer empID1 
Integer empID2 
Integer empID3 


Va 


ME. 


Vis 


ME. 


/* 
ME 


jE 


ME. 


} 


ME.addEmployee("Zara", "Ali", 1000); 
ME.addEmployee("Daisy", "Das", 5000); 
ME.addEmployee("John", "Paul", 10000); 


List down all the employees */ 
listEmployees(); 


Update employee's records */ 
updateEmployee(empID1, 5000); 


Delete an employee from the database */ 


.deleteEmployee(empID2); 


List down new list of the employees */ 
listEmployees(); 


/* Method to CREATE an employee in the database */ 

public Integer addEmployee(String fname, String lname, int 
Session session = factory.openSession( new MyInterceptor() ), 
Transaction tx - null; 
Integer employeeID - null; 


try{ 


tx = session. beginTransaction(); 


sala! 


Employee employee - new Employee(fname, lname, salary); 


employeeID - (Integer) session.save(employee); 
tx.commit(); 


jcatch (HibernateException e) { 


if (tx!znull) tx.rollback(); 
e.printStackTrace(); 


}finally { 


} 


session.close(); 


return employeeID; 


/* Method to READ all the employees */ 
public void listEmployees( ){ 
Session session = factory.openSession( new MyInterceptor() ), 
Transaction tx - null; 


try{ 
tx = session.beginTransaction(); 


List employees = session.createQuery("FROM Employee").1ist 
for (Iterator iterator = 
employees.iterator(); iterator .hasNext( ` 
Employee employee = (Employee) iterator.next(); 
System.out.print("First Name: " + employee.getFirstName 
System.out.print(" Last Name: " + employee.getLastName 
System.out.println(" Salary: " + employee.getSalary(). 
} 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!=null) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 
} 
} 


/* Method to UPDATE salary for an employee */ 
public void updateEmployee(Integer EmployeeID, int salary ){ 
Session session = factory.openSession( new MyInterceptor() ), 
Transaction tx = null; 
try{ 
tx = session.beginTransaction(); 
Employee employee = 
(Employee)session.get(Employee.class, Employee: 
employee.setSalary( salary ); 
session.update(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
jfinally { 
session.close(); 
j 
} 


/* Method to DELETE an employee from the records */ 
public void deleteEmployee(Integer EmployeeID){ 
Session session = factory.openSession( new MyInterceptor() ), 
Transaction tx = null; 
try{ 
tx = session.beginTransaction(); 
Employee employee = 
(Employee)session.get(Employee.class, Employeell 
session.delete(employee); 
tx.commit(); 
jcatch (HibernateException e) { 
if (tx!znull) tx.rollback(); 
e.printStackTrace(); 
}finally { 
session.close(); 


} 


j 


«| — 








编译 和 执行 : 


下 面 是 步骤 来 编译 并 运行 上 述 应 用 程序 。 请 确保 已 在 进行 的 编译 和 执行 之 前 ， 适 当 
地 设置 PATH 和 CLASSPATH。 


e 创建 hibernate.cfg.xml 配 置 文件 中 配置 章节 解释 。 

e 创建 Employee.hbm.xml 映 射 文件 ， 如 上 图 所 示 。 

e 创建 Employee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 

e 创建 Mylnterceptorjava 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 

e 创建 ManageEmployee.java 源 文件 ， 如 上 图 所 示 ， 并 编译 它 。 
e 执行 ManageEmployee 二 进 制 文件 来 运行 程序 。 

会 得 到 以 下 结果 ， 并 记录 将 在 EMPLOYEE 表 中 创建 


$java ManageEmployee 
HARIeH mur VARIOUS LOG MESSAGES WILL DISPLAY HERE........ 


Create Operation 

preFlush 

postFlush 

Create Operation 

preFlush 

postFlush 

Create Operation 

preFlush 

postFlush 

First Name: Zara Last Name: Ali Salary: 1000 
First Name: Daisy Last Name: Das Salary: 5000 
First Name: John Last Name: Paul Salary: 10000 
preFlush 

postFlush 

preFlush 

Update Operation 

postFlush 

preFlush 

postFlush 

First Name: Zara Last Name: Ali Salary: 5000 
First Name: John Last Name: Paul Salary: 10000 
preFlush 

postFlush 


如 果 检 查 EMPLOYEE 表 ， 它 应 该 记录 信息 下 : 


mysql> select * from EMPLOYEE; 


Sooo sce sem ooo 站 dca eH. + 
| id | first_name | last_name | salary | 
ducc yd ses recor e ode. Se eve c Poe + 
| 29 | Zara | Ali | 5000 | 
| 31 | John | Paul | 10000 | 
ee e eco romeo Mora be + 


2 rows in set (0.00 sec 


mysql> 


iBATIS 教程 


iBATIS 


Database Programming 
iBATIS 是 一 个 持久 层 框架 ， 它 能 够 自动 在 Java、.NET 和 Ruby on Rails Bst ZR 


Ce ee ee eee 
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读者 


人 
用 情况 。 


必要 条 件 


在 继续 本 教程 之 前 ， 您 点 该 对 Java 编 程 语言 有 一 个 很 好 的 理解 。 因 为 要 义理 SQL 了 映 
射 ， 所 以 它 需 要 有 对 SQL 和 数据 库 的 概念 很 好 的 理解 。 


iBATIS 介 绍 ，iBATIS 是 什么 ” - ibatis 


iBATIS 的 是 一 个 持久 层 框架 ， 它 能 够 自动 在 Java, .NET 和 Ruby on Rails 中 与 SQL 
数据 库 和 对 象 之 间 的 映射 。 映 射 是 从 应 用 程序 逻辑 封装 在 XML 配置 文件 中 的 SQL 语 
AAR FA 


iBATIS 是 一 个 轻 量 级 的 框架 和 持久 性 API 适 合 持久 化 的 POJO (普通 Java 对 象 ) 。 


iBATIS 是 被 称 为 一 个 数据 映射 和 映射 需要 的 类 的 属性 和 数据 库 中 的 表 的 列 之 间 的 参 
数 和 结果 。 


iBATIS 和 其 他 持久 化 框架 ， 如 Hibernate 之 间 的 显著 区 别 在 于 ，iBATIS 强 调 使 用 


SQL， 而 其 他 的 框架 通常 使 用 一 个 自 定义 的 查询 语言 ， 具 有 Hibernate 查 询 语言 
(HQL) 或 Enterprise JavaBeans 的 查询 语言 (EJB QL) 。 


iBATIS 的 设计 理念 : 

iBatis 提 供 了 以 下 的 设计 理念 : 
e 简单 :iBATIS 的 被 广泛 认为 是 可 用 的 最 简单 的 持久 化 框架 之 一 。 
e 快速 开发 : iBATIS 的 理念 是 尽 一 切 可 能 ， 以 方便 超 快 速 开发 。 


e 可 移植 性 :iBATIS 可 用 于 几乎 任何 语言 或 平台 ， 如 Java，Ruby 和 C#， 微 
软 .NET 实 现 。 


独立 的 接口 : iBATIS 提 供 独 立 于 数据 库 的 接口 和 API， 帮 助 应 用 程序 的 其 余部 
分 保持 独立 的 任何 持久 性 相关 的 资源 ， 


开源 : iBATIS 是 自由 和 开放 源码 软件 。 


IBATISEY tir 


下 面 是 使 用 iBATIS 的 一 些 优势 : 


e 支持 存储 过 程 : iBATIS 的 SQL 封装 以 存储 过 程 的 形式 ， 使 业务 逻辑 保持 在 数据 
库 之 外 ， 应 用 程序 更 易于 部 署 和 测试 ， 更 便于 移植 。 


e 支持 内 舱 的 SQL : 预 编 译 器 不 是 必需 的 ， 并 有 完全 访问 所 有 的 SQL 语句 的 特 
性 。 


e 支持 动态 SQL: iBATIS 特 性 提供 基于 参数 动态 生成 SQL 查询 。 


e 支持 O / RM : iBATIS 支 持 许多 相同 的 功能 作为 一 个 O /RM 工具 ， 如 延迟 加 载 ， 
连接 抓 取 ， 缓 存 ， 运 行 时 代码 生成 和 继承 


先决 条 件 : 

在 开始 之 前 ， 要 确保 你 了 解 过 程 和 面向 对 象 编程 的 基本 知识 : 控制 结构 ， 数 据 结构 
Aes, X, TRE, 

iBATIS 使 用 Java 编 程 语言 开发 面向 数据 库 应 用 程序 。 

要 理解 Java 编 程 细节 可 以 通过 我 们 的 Java 教 程 。 


iIBATIS 配 置 环 境 - ibatis 


在 开始 使 用 iBATIS 开 发 之 前 ， 必 须 设置 你 的 环境 正常 。 本 教程 将 指导 您 用 几 个 步 又 
来 实现 的 工作 环境 。 


iBATIS 22x: 


这 里 有 几 个 简单 的 步骤 ， 需 要 开展 Linux 机 器 上 安装 iBATIS : 
e 下 载 iBATIS 的 最 新 版 本 下 载 iBATIS 
e 解压 下 载 的 文件 ， 从 包 中 提取 ,jar 文件 并 将 其 保存 在 相应 的 lib 目 录 下 。 
e 在 提取 .jar 文 件 适 当 设 置 PATH 和 CLASSPATH 变 量 。 
下 面 是 进行 Linux 机 器 下 载 iBATIS 的 二 进 制 文件 的 步骤 : 


$ unzip ibatis-2.3.4.726.zip 


inflating: META-INF/MANIFEST.MF 
creating: doc/ 
creating: lib/ 
creating: simple example/ 
creating: simple example/com/ 
creating: simple example/com/mydomain/ 
creating: simple example/com/mydomain/data/ 
creating: simple example/com/mydomain/domain/ 
creating: src/ 
inflating: doc/dev-javadoc.zip 
inflating: doc/user-javadoc.zip 
inflating: jar-dependencies.txt 
inflating: lib/ibatis-2.3.4.726.jar 
inflating: license.txt 
inflating: notice.txt 
inflating: release.txt 
$pwd 
/var/home/ibatis 


$set PATH=$PATH: /var/home/ibatis/ 
$set CLASSPATH=$CLASSPATH: /var/home/ibatis 
/lib/ibatis-2.3.4.726.jar 


数据 库 设置 


使 用 下 面 的 语法 在 MySQL 数 据 库 中 创建 EMPLOYEE 表 : 


mysql> CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


创建 SqlIMapConfig.xml 


考虑 以 下 几 点 : 
。 我 们 将 使 用 JDBC 来 访问 数据 库 testdb. 
e MySQL 的 JDBC 了 驱动 程序 是 "com.mysql.jdbc.Driver". 
e 连接 URL 是 "jdbc:mysql://localhost:3306/testdb". 
。 使 用 的 用 户 名 和 密码 是 "root" and "root". 
e SQL 语句 映射 的 所 有 操作 将 被 描述 在 "Employee.xml". 


基于 上 述 假设 ， ERE 个 XML 配置 文件 ，nameSqlMapConfig.xml 以 下 内 
容 。 这 就 是 需要 提供 所 需 的 iBatis 的 所 有 配置 : 


这 两 个 文件 SqlMapConfig.xml 和 Employee.xml 存在 于 类 路 径 。 现 在 ， 我 们 将 保持 
Employee.xml 文 件 为 空 ， 我 们 将 格式 转换 的 在 随后 的 章节 内 容 。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMapConfig 

PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-config-2.dtd"> 


<sqlMapConfig> 
<settings useStatementNamespaces="true"/> 
<transactionManager type="JDBC"> 
<dataSource type="SIMPLE"> 
<property name="JDBC.Driver" 
value-"com.mysql.jdbc.Driver"/» 
«property name="JDBC.ConnectionURL" 
value="jdbc:mysql://localhost:3306/testdb"/> 
«property name="JDBC.Username" value="root"/> 
<property name="JDBC.Password" value="root"/> 
</dataSource> 
</transactionManager> 
«sqlMap resource="Employee. xml"/> 
«/sqlMapConfig» 


还 有 其 他 一 些 可 选 的 属性 ， 您 可 以 在 SqlMapConfig.xml 文 件 中 设置 


<property name="JDBC.AutoCommit" value="true"/> 

<property name="Pool.MaximumActiveConnections" value="10"/> 
<property name="Pool.MaximumIdleConnections" value="5"/> 
<property name="Pool.MaximumCheckoutTime" value="150000"/> 
<property name="Pool.MaximumTimeToWait" value="500"/> 

«property name="Pool.PingQuery" value="Select 1 from Employee"/> 


<property name="Pool.PingEnabled" value="false"/> 


[j| ues RS 


iBATIS 6) E RF - ibatis 


若 要 使 用 iBATIS 执 行 的 任何 CRUD (创建 ， 写 入 ， 更 新 和 删除 ) 操作 ， 需 要 创建 一 
个 的 POJO (普通 Java 对 象 ) 类 对 应 的 表 。 本 课程 介绍 的 对 象 ， 将 “模式 "的 数据 库 
表 中 的 行 。 


POJO 类 必须 实现 所 有 执行 所 需 的 操作 所 需 的 方法 。 
我 们 已 经 在 MySQL 下 有 EMPLOYEE 表 : 


CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_ increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


Employee POJO # : 
我 们 会 在 Employee.java 文 件 中 创建 Employee 类 ， 如 下 所 示 : 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


/* Define constructors for the Employee class. */ 
public Employee() {} 


public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


j 
) /* End of Employee */ 
可 以 定义 方法 来 设置 表 中 的 各 个 字段 。 下 一 章节 将 告诉 你 如 何 获得 各 个 字段 的 值 。 


Employee.xml 文件 : 


要 定义 使 用 iBATIS SQL 映射 语句 中 ， 我 们 将 使 用 <insert> 标 签 ， 这 个 标签 定义 中 ， 
我 们 会 定义 将 用 于 在 lbatisinsert.java 文 件 的 数据 库 执行 SQL INSERT4 “id” 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


<sqlMap namespace="Employee"> 
«insert id-"insert" parameterClass="Employee"> 


insert into EMPLOYEE(first name, last name, salary) 
values (#first_name#, #last_name#, #salary#) 


<selectKey resultClass="int" keyProperty="id"> 
select last_insert_id() as id 
</selectKey> 


</insert> 


</sqlMap> 


ix &parameterClass : 可 以 采取 一 个 值 作为 字符 串 ， 整 型 ， 浮 点 型 ，double 或 根据 
要 求 任何 类 的 对 象 。 在 这 个 例子 中 ， 我 们 将 通过 Employee 对 象 作为 参数 而 调用 
SqlMap 类 的 insert 方 法 。 


如 果 您 的 数据 库 表 使 用 IDENTITY，AUTO_INCREMENT 或 串 行列 或 已 定义 的 


SEQUENCE/GENERATOR， 可 以 使 用 <selectKey> 元 素 在 的 <insert> 语 句 中 使 用 或 
返回 数据 库 生 成 的 值 。 


IbatisInsert.java 文件 : 


文件 将 应 用 程序 级 别 的 逻辑 在 Employee 表 中 搬入 记录 : 


import 
import 
import 
import 
import 
import 


public 


com. ibatis.common.resources.Resources; 
com.ibatis.sqlmap.client.SqlMapClient; 
com.ibatis.sqlmap.client.SqlMapClientBuilder; 
java.io.*; 

java.sql.SQLException; 

Java.util.*; 


class IbatisInsert{ 


public static void main(String[] args) 

throws IOException, SQLException{ 

Reader rd = Resources.getResourceAsReader ("SqlMapConfig. xml"); 
SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd); 


/* This would insert one record in Employee table. */ 
System.out.println("Going to insert record..... ys 
Employee em - new Employee("Zara", "Ali", 5000); 


smc. 


insert("Employee.insert", em); 


System.out.println("Record Inserted Successfully "); 


[AR 


编译 和 运行 : 


下 面 是 步骤 来 编译 并 运行 上 述 软 件 。 请 确保 已 在 进行 的 编译 和 执行 之 前 ， 适 当地 设 
置 PATH 和 CLASSPATH。 


e 创建 Employee.xml 如 上 所 示 。 


e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 
e 创建 lbatislnsertjava 如 上 图 所 示 ， 并 编译 它 。 
e 执行 lbatislnsert 二 进 制 文 件 来 运行 程序 。 
会 得 到 下 面 的 结果 ， 并 创 纪 录 的 将 在 EMPLOYEE 表 中 创建 。 


$java IbatisInsert 
Going to insert record..... 
Record Inserted Successfully 


去 查看 EMPLOYEE 表 ， 它 应 该 有 如 下 结果 : 


mysql> select * from EMPLOYEE; 


qp eee 0 
| 1 | Zara | Ali 
aS RA VA e eee TL S 


1 row in set (0.00 sec) 


iBATIS 读 取 操 作 - ibatis 


sc een eee 建 操作 表 。 本 章 将 告诉 你 如 何 使 用 iBATIS 来 读 
取 o 


我 们 已 经 在 MySQL 下 有 EMPLOYEE 表 : 


CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


); 


此 表 有 如 下 只 有 一 条 记录 : 


mysql> select * from EMPLOYEE; 


Pec eter 全 下 ase faa + 
| id | first_name | last_name | salary | 
foo es SS Sas Peo eS ess Eee eee + 
| 1 | Zara | Ali | 5000 | 
eae ose ps See p anaa dE + 


1 row in set (0.00 sec) 


Employee POJO #: 


要 执行 读 操作 ， 我 们 将 修改 Employee 类 中 Employee.java 文 件 ， 如 下 所 示 : 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


/* Define constructors for the Employee class. */ 
public Employee() {} 


public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


} 


/* Here are the method definitions */ 
public int getId() { 
return id; 


} 
public String getFirstName() { 
return first_name; 


} 
public String getLastName() { 
return last_name; 


} 
public int getSalary() { 
return salary; 


} 
} /* End of Employee */ 


Employee.xml 文件 : 


要 定义 使 用 iBATIS SQL 映射 语句 ， 我 们 将 增加 <select> 标 记 在 Employee.xml 文 件 ， 
这 个 标签 定义 中 ， 我 们 会 定义 将 用 于 在 lbatisRead.java 文 件 的 数据 库 执行 SQL 
SELECT 查询 的 "id"。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


«sqlMap namespace="Employee"> 

<insert id="insert" parameterClass="Employee"> 
INSERT INTO EMPLOYEE(first_name, last_name, salary) 
values (#first_name#, #last_name#, #salary#) 


<selectKey resultClass="int" keyProperty="id"> 
select last_insert_id() as id 
</selectKey> 


</insert> 

«select id="getAll" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 

</select> 

</sqlMap> 


在 这 里 ， 我 们 没有 使 用 WHERE 子 句 和 SQL SELECT 语句 。 后 续 章 节 将 演示 如 何 用 
WHERE 和 SELECT 语句 子 句 ， 以 及 如 何 将 值 传递 到 WHERE 子 句 。 


IbatisRead.java 文件 : 


该 文件 将 上 应用 程序 级 别 的 逻辑 从 历 员 Employee 表 中 读 出 记录 : 


import com.ibatis.common.resources.Resources; 

import com.ibatis.sqlmap.client.SqlMapClient; 

import com.ibatis.sqlmap.client.SqlMapClientBuilder; 
import java.io.*; 

import java.sql.SQLException; 

import java.util.*; 


public class IbatisRead{ 
public static void main(String[] args) 
throws IOException, SQLException{ 
Reader rd = Resources.getResourceAsReader ("SqlMapConfig. xml"); 
SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd); 


/* This would read all records from the Employee table. */ 

System.out.println("Going to read records..... ae 

List <Employee> ems = (List<Employee>) 
smc.queryForList("Employee.getAll", null); 

Employee em - null; 

for (Employee e : ems) { 


System.out.print(" ^" + e.getId()); 
System.out.print(" ^" + e.getFirstName()); 
System.out.print(" ^" + e.getLastName()); 
System.out.print(" ^" + e.getSalary()); 

em = e; 

System.out.println(""); 


j 


System.out.println("Records Read Successfully "); 


二 Eg 


编译 和 运行 : 
下 面 是 步骤 来 编译 并 运行 上 述 应 用 。 请 确保 您 已 在 进行 的 编译 和 执行 之 前 ， 适 当地 
设置 PATH 和 CLASSPATH。 
e 创建 Employee.xml 如 上 所 示 。 
e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 
e 创建 lbatisRead.java 如 上 图 所 示 ， 并 编译 它 。 
e 执行 lbatisRead 二 进 制 文件 来 运行 程序 。 
你 会 得 到 下 面 的 结果 ， 并 且 将 记录 从 EMPLOYEE 表 中 读 取 。 


Going to read records..... 
1 Zara Ali 5000 
Record Reads Successfully 


iBATIS 更 新 操作 - ibatis 


上 一 章 展 示 了 如 何 使 用 iBATIS 对 表 进 行 读 取 操 作 。 本 章 将 告诉 你 如 何在 一 个 表 中 使 
用 iBATIS 更 新 记录 。 


我 们 已 经 在 MySQL 下 有 EMPLOYEE 表 : 


CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_ increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


); 


此 表 有 如 下 只 有 一 条 记录 : 


mysql> select * from EMPLOYEE; 


Pec eter 全 下 ase faa + 
| id | first_name | last_name | salary | 
foo es SS Sas Peo eS ess Eee eee + 
| 1 | Zara | Ali | 5000 | 
eae ose ps See p anaa dE + 


1 row in set (0.00 sec) 


Employee POJO #: 


要 执行 UDPATE 操 作 ， 需 要 修改 Employee.java 文 件 ， 如 下 所 示 : 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


/* Define constructors for the Employee class. */ 
public Employee() {} 


public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


} 


/* Here are the required method definitions */ 
public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 

} 

public String getFirstName() { 
return first_name; 


public void setFirstName(String fname) { 
this.first_name = fname; 


public String getLastName() { 
return last_name; 


public void setlastName(String lname) { 
this.last name = lname; 


} 
public int getSalary() { 


return salary; 


public void setSalary(int salary) { 
this.salary = salary; 


} 


) /* End of Employee */ 


Employee.xml 文件 : 


要 定义 使 用 iBATIS SQL 映射 语句 ， 我 们 想 补 充 的 <Update> 标 签 Employee.xml 文 
件 ， 这 个 标签 定义 中 ， 我 们 会 定义 将 用 于 在 lbatisUpdate.java 文 件 的 数据 库 执 行 
SQL UPDATE 查 询 的 "id”。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


«sqlMap namespace="Employee"> 

<insert id="insert" parameterClass="Employee"> 
INSERT INTO EMPLOYEE(first_name, last_name, salary) 
values (#first_name#, #last_name#, #salary#) 


<selectKey resultClass="int" keyProperty="id"> 
select last_insert_id() as id 
</selectKey> 


</insert> 
«select id-"getAll" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 


«/select» 


«update id-"update" parameterClass="Employee"> 
UPDATE EMPLOYEE 


SET first name = #first_name# 
WHERE id = #id# 

</update> 

</sqlMap> 


IbatisUpdate.java 文件 : 


文件 将 应 用 程序 级 别 的 逻辑 来 更 新 记录 到 Employee 表 : 


import com.ibatis.common.resources.Resources; 

import com.ibatis.sqlmap.client.SqlMapClient; 

import com.ibatis.sqlmap.client.SqlMapClientBuilder; 
import java.io.*; 

import java.sql.SQLException; 

import java.util.*; 


public class IbatisUpdate{ 
public static void main(String[] args) 
throws IOException, SQLException{ 
Reader rd = Resources.getResourceAsReader ("SqlMapConfig. xml"); 
SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd); 


/* This would update one record in Employee table. */ 
System.out.println("Going to update record..... e 
Employee rec - new Employee(); 

rec.setId(1); 

rec.setFirstName( "Roma"); 
smc.update("Employee.update", rec ); 
System.out.println("Record updated Successfully "); 


System.out.println("Going to read records..... ae 
List <Employee> ems = (List<Employee>) 
smc.queryForList("Employee.getAll", null); 

Employee em - null; 

for (Employee e : ems) ( 
System.out.print(" " 
System.out.print(" " 
System.out.print(" " 
System.out.print(" " 
em = e; 
System.out.println(""); 


.getId()); 
.getFirstName()); 
.getLastName( )); 
.getSalary()); 


t+ 二 十 十 
0000 


j 


System.out.println("Records Read Successfully "); 


| ————— äl 
编译 和 运行 : 
下 面 是 步骤 来 编译 并 运行 上 述 软 件 。 请 确保 您 已 在 进行 的 编译 和 执行 之 前 ， 适 当地 
设置 PATH 和 CLASSPATH。 

e 创建 Employee.xml 如 上 所 示 。 

e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 

e 创建 lbatisUpdate.java 如 上 图 所 示 ， 并 编译 它 。 


e 执行 lbatisUpdate 二 进 制 文件 来 运行 程序 。 


得 到 下 面 的 结果 ， 并 创建 纪录 在 EMPLOYEE 表 进行 更 新 和 更 高 版 本 相同 的 记录 将 
从 EMPLOYEE 表 中 读 出 。 


Going to update record..... 
Record updated Successfully 
Going to read records..... 
1 Roma Ali 5000 
Records Read Successfully 


iBATIS m REEF - ibatis 


本 章 将 教 你 如 何 从 表 中 使 用 iBATIS 删 除 记 录 。 
我 们 已 经 在 MySQL 下 有 EMPLOYEE 表 : 


CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


): 


假设 这 个 表 是 有 两 条 记录 如 下 : 


mysql> select * from EMPLOYEE; 


PSS oe SoS onanan n T S55 5e5 dl S + 
| id | first_name | last_name | salary | 
Goo a eb Soe Se e eS dece eee eese se + 
| 1 | Zara | Ali | 5000 | 
| 2 | Roma | Ali | 3000 | 
paso sha Soe ese ee c ee eve sse + 


2 row in set (0.00 sec) 


Employee POJO #: 


要 执行 删除 操作 ， 就 需要 修改 Employee.java 文 件 。 因 此 ， 让 我 们 保持 它 不 变 ， 在 
上 一 章 我 们 使 用 过 。 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


/* Define constructors for the Employee class. */ 
public Employee() {} 


public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


} 


/* Here are the required method definitions */ 
public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 

} 

public String getFirstName() { 
return first_name; 


public void setFirstName(String fname) { 
this.first_name = fname; 


public String getLastName() { 
return last_name; 


public void setlastName(String lname) { 
this.last name = lname; 


} 
public int getSalary() { 


return salary; 


public void setSalary(int salary) { 
this.salary = salary; 


} 


) /* End of Employee */ 


Employee.xml 文件 : 


要 定义 使 用 iBATIS SQL 映射 语句 中 ， 我 们 将 增加 <Delete> 键 标签 Employee.xml 文 
件 ， 这 个 标签 定义 中 ， 我 们 会 定义 将 用 于 在 lbatisDelete.java 文 件 执行 SQL 
DELETE 查 询 数 据 库 的 “id”。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


«sqlMap namespace="Employee"> 

<insert id="insert" parameterClass="Employee"> 
INSERT INTO EMPLOYEE(first_name, last_name, salary) 
values (#first_name#, #last_name#, #salary#) 


<selectKey resultClass="int" keyProperty="id"> 
select last_insert_id() as id 
</selectKey> 


</insert> 
«select id-"getAll" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 


«/select» 


«update id-"update" parameterClass="Employee"> 
UPDATE EMPLOYEE 


SET first name = #first_name# 
WHERE id = #id# 
</update> 


<delete id="delete" parameterClass="int"> 
DELETE FROM EMPLOYEE 
WHERE id = #id# 

</delete> 


</sqlMap> 


IbatisDelete.java 文件 : 


文件 将 应 用 程序 级 别 的 逻辑 从 Employee 表 中 删除 记录 : 


import com.ibatis.common.resources.Resources; 

import com.ibatis.sqlmap.client.SqlMapClient; 

import com.ibatis.sqlmap.client.SqlMapClientBuilder; 
import java.io.*; 

import java.sql.SQLException; 

import java.util.*; 


public class IbatisDelete{ 
public static void main(String[] args) 
throws IOException, SQLException{ 
Reader rd = Resources.getResourceAsReader ("SqlMapConfig. xml"); 
SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd); 


/* This would delete one record in Employee table. */ 
System.out.println("Going to delete record..... e 
int id - 1; 


smc.delete("Employee.delete", id ); 
System.out.println("Record deleted Successfully "); 


System.out.println("Going to read records..... AN 
List <Employee> ems = (List<Employee>) 
smc.queryForList("Employee.getAll", null); 

Employee em - null; 

for (Employee e : ems) { 
System.out.print(" " 
System.out.print(" " 
System.out.print(" " 


.getid()); 
.getFirstName()); 
.getLastName()); 


+++ 十 
0000 


System.out.print(" " + e.getSalary()); 
em = e; 
System.out.println(""); 
} 
System.out.println("Records Read Successfully "); 
} 


:| 


编译 和 运行 : 
下 面 是 步骤 来 编译 并 运行 上 述 软 件 。 请 确保 已 在 进行 的 编译 和 执行 之 前 ， 适 当地 设 
置 PATH 和 CLASSPATH。 

e 创建 Employee.xml 如 上 所 示 。 

e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 

e 创建 lbatisDelete.java 如 上 图 所 示 ， 并 编译 它 。 


e 执行 lbatisDelete 二 进 制 文件 来 运行 程序 。 


得 到 以 下 结果 ，ID=1 将 在 EMPLOYEE 表 中 被 删除 ， 并 读 取 EMPLOYEE 表 中 的 一 条 
记录 。 


Going to delete record..... 
Record deleted Successfully 
Going to read records..... 
2 Roma Ali 3000 
Records Read Successfully 


iBATIS23 RERH - ibatis 


resultMap 的 元 素 是 在 iBATIS 的 最 重要 和 最 强大 的 元 素 。 您 可 以 通过 使 用 iBATIS 的 
结果 映射 减少 高 达 90% 的 JDBC 编 码 ， 在 某 些 情况 下 ， 可 以 让 你 做 JDBC 不 支持 的 事 


情 。 


ResultMaps 的 设计 是 这 样 的 简单 语句 不 需要 明确 的 结果 映射 ， 以 及 更 复杂 的 报表 要 
求 不 超过 绝对 必要 说 明 的 关系 。 


本 章 将 只 给 你 一 个 简单 的 介绍 iBATIS 的 结果 映射 。 
我 们 已 经 在 MySQL 下 有 EMPLOYEE 表 : 


CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


); 


此 表 有 如 下 两 条 记录 : 

mysql> select * from EMPLOYEE; 

be sash ecce eee dpud + 
| id | first_name | last_name | salary | 
P eS ee SS dee oe SS pb ee + 
| 1 | Zara | Ali | 5000 | 
| 2 | Roma | Ali | 3000 | 
Tcp eee SoS Se oone pS aaa + 


2 row in set (0.00 sec) 


Employee POJO #: 


使 用 iBATIS 的 结果 映射 ， 需 要 修改 Employee.java 文 件 。 因 此 ， 让 我 们 保持 它 ， 因 
为 它 已 经 在 前 一 章 中 使 用 过 。 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


/* Define constructors for the Employee class. */ 
public Employee() {} 


public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


} 


/* Here are the required method definitions */ 
public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 

} 

public String getFirstName() { 


return first_name; 


public void setFirstName(String fname) { 
this.first_name = fname; 


public String getLastName() { 
return last name; 


public void setlastName(String lname) { 
this.last name - lname; 


} 
public int getSalary() { 


return salary; 


public void setSalary(int salary) { 
this.salary = salary; 


} 


) /* End of Employee */ 


Employee.xml 文件 : 


在 这 里 ， 我 们 将 修改 Employee.xml 文 件 介绍 <resultMap></ resultMap> 标 记 。 这 个 
标签 就 必须 在 我 们 <select> 标 记 的 resultMap 属 性 运行 此 结果 映射 这 是 需要 一 个 id。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


«sqlMap namespace="Employee"> 


<!-- Perform Insert Operation --> 

<insert id="insert" parameterClass="Employee"> 
INSERT INTO EMPLOYEE(first name, last name, salary) 
values (#first_name#, #last_name#, #salary#) 


<selectKey resultClass="int" keyProperty="id"> 
select last_insert_id() as id 


</selectKey> 
</insert> 
<!-- Perform Read Operation --> 


«select id-"getAll" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 
«/select» 


<!-- Perform Update Operation --> 
«update id="update" parameterClass="Employee"> 
UPDATE EMPLOYEE 


SET first name = #first_name# 
WHERE id = #id# 

</update> 

<!-- Perform Delete Operation --> 


<delete id="delete" parameterClass="int"> 
DELETE FROM EMPLOYEE 
WHERE id = #id# 

</delete> 


<!-- Using ResultMap --> 
<resultMap id="result" class="Employee"> 
<result property="id" column="id"/> 
<result property="first_name" column="first_name"/> 
«result property="last_name" column="last_name"/> 
«result property-"salary" column="Salary"/> 
«/resultMap» 
«select id="useResultMap" resultMap="result"> 
SELECT * FROM EMPLOYEE 
WHERE id=#id# 
</select> 


</sqlMap> 


IbatisResultMap.java 文件 : 
文件 将 应 用 程序 级 别 的 逻辑 ， 从 使 用 结果 映射 Employee 表 中 读 取 记录 : 


import 
import 
import 
import 
import 
import 


public 


com.ibatis.common.resources.Resources; 
com.ibatis.sqlmap.client.SqlMapClient; 
com.ibatis.sqlmap.client.SqlMapClientBuilder; 
java.io.* 

java.sql.SQLException; 

Java.util.*; 


class IbatisResultMap{ 


public static void main(String[] args) 

throws IOException, SQLException{ 

Reader rd = Resources.getResourceAsReader ("SqlMapConfig. xml"); 
SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd); 


int 


id = 1; 


System.out.println("Going to read record..... oye 
Employee e = (Employee)smc.queryForObject 


("Employee.useResultMap", id); 


System.out.println("ID: " + e.getId()); 
System.out.println("First Name: " + e.getFirstName()); 
System.out.println("Last Name: " + e.getLastName()); 
System.out.println("Salary: " + e.getSalary()); 


System.out.println( "Record read Successfully "); 


ES 到 


编译 和 运行 
下 面 是 步骤 来 编译 并 运行 上 还 术 软 件 。 请 确保 您 已 在 进行 的 编译 和 执行 之 前 ， 适 当地 
设置 PATH 和 CLASSPATH。 


e 创建 Employee.xml 如 上 所 示 。 

e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 

e MN E EUM 并 编译 它 。 
e 执行 lbatisResultMap 二 进 制 文 件 来 运行 程序 。 
会 得 到 下 面 的 结果 是 对 EMPLOYEE 表 的 读 操作 。 


Going to read record..... 
ID: 1 

First Name: Zara 

Last Name: Ali 

Salary: 5000 

Record read Successfully 


iBATIS 存 储 过 程 - ibatis 


使 用 iBATIS 配 置 来 调用 存储 过 程 。 为 了 理解 这 一 章 ， 首 先 需 要 了 解 我 们 是 如 何在 
MySQL 中 创建 一 个 存储 过 程 。 


在 继续 对 本 章 学 习 之 前 ， 可 以 通过 MySQL 存 储 过 程 。 
我 们 已 经 在 MySQL 下 有 EMPLOYEE 表 : 


CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


); 


让 我 们 在 MySQL 数 据 库 中 创建 以 下 存储 过 程 。 


DELIMITER $$ 


DROP PROCEDURE IF EXISTS ^testdb'.'getEmp' $$ 
CREATE PROCEDURE `testdb`.`getEmp` 
(IN empid INT) 
BEGIN 
SELECT * FROM EMPLOYEE 
WHERE ID - empid; 
END $$ 


DELIMITER; 


考虑 EMPLOYEE 表 是 有 两 条 记录 如 下 : 


mysql> select * from EMPLOYEE; 


oon ote ooo eee Sooo oo Macen anna + 
| id | first_name | last_name | salary | 
TEE a A TEE + 
| 1 | Zara | Ali | 5000 | 
| 2 | Roma | Ali | 3000 | 
Mano aono nananana PospssogeonS Ho + 


2 row in set (0.00 sec) 


Employee POJO #: 


使 用 存储 过 程 ， 你 就 需要 修改 Employee.java 文 件 。 因 此 ， 让 我 们 保持 它 ， 因 为 它 
是 在 前 一 章 。 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


/* Define constructors for the Employee class. */ 
public Employee() {} 


public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


} 


/* Here are the required method definitions */ 
public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 

} 

public String getFirstName() { 
return first_name; 


public void setFirstName(String fname) { 
this.first_name = fname; 


public String getLastName() { 
return last_name; 


public void setlastName(String lname) { 
this.last name = lname; 


} 
public int getSalary() { 


return salary; 


public void setSalary(int salary) { 
this.salary = salary; 


} 
) /* End of Employee */ 


Employee.xml #: 


在 这 里 ， 我 们 将 修改 Employee.xml 文 件 介 绍 <procedure></procedure> 和 
<parameterMap></parameterMap>#riz. iX &B«procedure»«/procedure» 4; 28 
一 个 jd， 我 们 会 用 我 们 的 应 用 程序 来 调用 存储 过 程 。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


«sqlMap namespace="Employee"> 


<!-- Perform Insert Operation --> 

<insert id="insert" parameterClass="Employee"> 
INSERT INTO EMPLOYEE(first_name, last_name, salary) 
values (#first_name#, #last_name#, #salary#) 


<selectKey resultClass="int" keyProperty="id"> 
select last_insert_id() as id 


</selectKey> 
</insert> 
<!-- Perform Read Operation --> 


«select id="getAll" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 
</select> 


<!-- Perform Update Operation --> 
<update id="update" parameterClass="Employee"> 
UPDATE EMPLOYEE 


SET first name = #first_name# 
WHERE id = #id# 

</update> 

<!-- Perform Delete Operation --> 


<delete id="delete" parameterClass="int"> 
DELETE FROM EMPLOYEE 
WHERE id = #id# 

</delete> 


<!-- To call stored procedure. --> 
«procedure id="getEmpInfo" resultClass="Employee" 
parameterMap="getEmpInfoCall"> 

{ call getEmp( #acctID# ) } 

</procedure> 

<parameterMap id="getEmpInfoCall" class="map"> 
<parameter property="acctID" jdbcType="INT" 
javaType="java.lang.Integer" mode="IN"/> 

</parameterMap> 


</sqlMap> 


IbatisSP.java 文件 : 
文件 将 点 用 程序 级 别 的 逻辑 读 取 使 用 结果 映射 Employee 表 员工 的 姓名 name : 


import 
import 
import 
import 
import 
import 


public 


com.ibatis.common.resources.Resources; 
com.ibatis.sqlmap.client.SqlMapClient; 
com.ibatis.sqlmap.client.SqlMapClientBuilder; 
java.io.* 

java.sql.SQLException; 

Java.util.*; 


class IbatisSP{ 


public static void main(String[] args) 

throws IOException, SQLException{ 

Reader rd = Resources.getResourceAsReader ("SqlMapConfig. xml"); 
SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd); 


int 


id = 1; 


System.out.println("Going to read employee name..... E 
Employee e - (Employee)smc.queryForObject 


("Employee.getEmpInfo", id); 


System.out.println("First Name: " + e.getFirstName()); 


System.out.println("Record name Successfully "); 


n n——— C'ÁOÀ—————————————ÉeÓ—" nu 


编译 和 运行 
下 面 是 步骤 来 编译 并 运行 上 述 应 用 程序 。 请 确保 您 在 进行 的 编译 和 执行 之 前 ， 适 当 
地 设置 PATH 和 CLASSPATH。 
e 创建 Employee.xml 如 上 所 示 。 
e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 
e 创建 lbatisSPjava 如 上 图 所 示 ， 并 编译 它 。 
e 执行 lbatisSP 二 进 制 文件 来 运行 程序 。 
导 到 以 下 结果 : 


Going to read record..... 
ID: 1 

First Name: Zara 

Last Name: Ali 

Salary: 5000 

Record read Successfully 


IBATIS 2 SQL - ibatis 


使 用 动态 查询 是 iBatis 一 个 非常 强大 的 功能 。 有 时 你 已 经 改变 WHERE 子 句 条 件 的 基 
础 上 你 的 参数 对 象 的 状态 。 在 这 种 情况 下 的 iBATIS 提 供 Ta 
用 ， 以 提高 SQL 语 得 句 的 重用 性 和 灵活 性 的 动态 SQL 标签 


所 有 的 逻辑 是 使 用 一 些 额 外 的 标签 放 在 : XML 文件 。 下 面 是 一 个 例子 ， 其 中 的 
SELECT 语句 将 努力 在 两 个 方面 : 


e 如 果 想 传递 一 个 ID， 然 后 它 会 返回 所 有 和 与 该 ID 的 记录 ， 
e 否则 ， 将 返回 所 有 履 员 ID 为 NULL 的 记录 。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


«sqlMap namespace="Employee"> 
«select id="findByID" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 
«dynamic prepend="WHERE "> 
<isNull property="id"> 
id IS NULL 
«/isNull» 
«isNotNull property="id"> 
id = #id# 
</isNotNull> 
</dynamic> 
</select> 
</sqlMap> 


可 以 使 用 <isNotEmpty> 标 签 如 下 检查 条 件 。 在 此 条 件 下 将 增加 ， 只 有 当 通 过 属性 不 


7] 286 


«select id="findByID" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 
«dynamic prepend="WHERE "> 
<isNotEmpty property="id"> 


id = #id# 
</isNotEmpty> 
</dynamic> 


</select> 


如 果 想 查询 对 id 和 /或 奢 员 的 名 字 选 取 。SELECT 语 句 如 下 : 


«select id="findByID" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 
«dynamic prepend="WHERE "> 
<isNotEmpty prepend="AND" property="id"> 
id = #id# 
</isNotEmpty> 
<isNotEmpty prepend="0R" property="first_name"> 
first name = #first_name# 
</isNotEmpty> 
</dynamic> 
</select> 


例如 : 动态 SQL 


下 面 的 例子 将 展示 如 何 编写 SELECT 语句 中 使 用 动态 SQL。 考 虑 ， 我 们 已 经 在 
MySQL 下 有 EMPLOYEE 表 : 


CREATE TABLE EMPLOYEE ( 
id INT NOT NULL auto_increment, 
first_name VARCHAR(20) default NULL, 
last name  VARCHAR(20) default NULL, 
salary INT default NULL, 
PRIMARY KEY (id) 


): 


此 表 有 如 下 只 有 一 条 记录 : 


mysql> select * from EMPLOYEE; 


lecce oe sese po soe SS deve sere + 
| id | first_name | last_name | salary | 
TL a ee 0 ssa + 
| 1 | Zara | Ali | 5000 | 
| 2 | Roma | Ali | 3000 | 
| 3 | Noha | Ali | 7000 | 
BPS pa oe fp ce qo E + 


3 row in set (0.00 sec) 


Employee POJO #: 


要 执行 读 取 操 作 ， 让 我 们 在 EmployeeJjava 文 件 Employee 类 ， 如 下 所 示 : 


public class Employee { 
private int id; 
private String first_name; 
private String last_name; 
private int salary; 


/* Define constructors for the Employee class. */ 
public Employee() {} 


public Employee(String fname, String lname, int salary) { 
this.first_name = fname; 
this.last name = lname; 
this.salary - salary; 


} 


/* Here are the method definitions */ 
public int getId() { 
return id; 


} 
public String getFirstName() { 
return first_name; 


} 
public String getLastName() { 
return last_name; 


} 
public int getSalary() { 
return salary; 


} 
} /* End of Employee */ 


Employee.xml 文件 : 


要 定义 使 用 iBATIS SQL 映 射 语句 ， 我 们 将 增加 在 以 下 文件 Employee.xml 修 改 
<select> 标 记 和 这 个 标签 定义 ， 我 们 将 定义 一 个 “id"”， 这 将 被 用 于 lbatisReadDy.java 
文件 上 执行 动态 SQL 的 SELECT 坦 询 数据 库 。 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE sqlMap 

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 


«sqlMap namespace="Employee"> 
«select id="findByID" resultClass="Employee"> 
SELECT * FROM EMPLOYEE 
«dynamic prepend="WHERE "> 
<isNotNull property="id"> 
id = #id# 
</isNotNull> 
</dynamic> 
</select> 
</sqlMap> 


上 面 的 SELECT 语句 将 努力 在 两 个 方面 (—) 如果 想 传递 一 个 ID， 然 后 将 相应 的 编 
号 (二) 返回 的 记录 ， 否 则 将 返回 所 有 记录 。 


IbatisReadDy.java 文件 : 


文件 将 点 用 程序 级 别 的 逻辑 从 Employee 表 污 出 的 条 件 记录 : 


import com.ibatis.common.resources.Resources; 

import com.ibatis.sqlmap.client.SqlMapClient; 

import com.ibatis.sqlmap.client.SqlMapClientBuilder; 
import java.io.*; 

import java.sql.SQLException; 

import java.util.*; 


public class IbatisReadDy{ 
public static void main(String[] args) 
throws IOException, SQLException{ 
Reader rd=Resources.getResourceAsReader ("SqlMapConfig.xml"); 
SqlMapClient smc-SqlMapClientBuilder.buildSqlMapClient(rd); 


/* This would read all records from the Employee table.*/ 
System.out.println("Going to read records..... ys 
Employee rec - new Employee(); 

rec.setId(1); 


List «Employee» ems = (List<Employee>) 
smc.queryForList("Employee.findByID", rec); 

Employee em - null; 

for (Employee e : ems) ( 


System.out.print(" ^" + e.getId()); 
System.out.print(" ^" + e.getFirstName()); 
System.out.print(" ^" + e.getLastName()); 
System.out.print(" ^" + e.getSalary()); 
em = e; 
System.out.println(""); 
} 
System.out.println("Records Read Successfully "); 
} 


} 


编译 和 运行 : 
下 面 是 步骤 来 编译 并 运行 上 述 应 用 。 请 确保 已 在 进行 的 编译 和 执行 之 前 ， 适 当地 设 
置 PATH 和 CLASSPATH。 
e 创建 Employee.xml 如 上 所 示 。 
e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 
e 创建 lbatisReadDyjava 如 上 图 所 示 ， 并 编译 它 。 
e 执行 lbatisReadDy 二 进 制 文件 来 运行 程序 。 
会 得 到 下 面 的 结果 ， 并 且 将 记录 从 EMPLOYEE 表 中 读 取 。 


Going to read records..... 
1 Zara Ali 5000 
Record Reads Successfully 


试 试 上 面 的 例子 中 通过 传递 空 值 作为 smc.queryForList (“Employee.findByID”, 
NULL) 。 


iBATIS OGNL 表达 式 


iBATIS 的 提供 了 强大 的 基于 OGNL 的 表达 式 来 消除 其 他 元 素 。 
e if 语句 
e choose, when, otherwise 语句 
e where 语句 


e foreach 语句 


ifia: 
最 常见 的 事情 在 动态 SQL 是 有 条 件 地 包括 一 个 where 子 句 的 一 部 分 。 例 如 : 


«select id="findActiveBlogwithTitleLike" 
parameterType="Blog" resultType="Blog"> 
SELECT * FROM BLOG 
WHERE state = 'ACTIVE. 
«if test="title != null"> 
AND title like #{title} 
</if> 
</select> 


这 条 语句 会 提供 功能 的 可 选 的 文本 搜索 类 型 。 如 果 没 有 传递 title， 那 么 所 有 激活 的 
博客 将 被 退回 。 但 是 ， 如 果 传 递 一 个 标题 ， 它 会 寻找 标题 以 like 给 定 的 条 件 。 


可 以 包括 多 个 if 条 件 如 下 : 
最 常见 的 事情 在 动态 SQL 是 有 条 件 地 包括 一 个 where 子 句 的 一 部 分 。 例 如 : 


«select id="findActiveBlogwithTitleLike" 
parameterType="Blog" resultType="Blog"> 
SELECT * FROM BLOG 
WHERE state = 'ACTIVE. 
«if test="title != null"> 
AND title like #{title} 


</if> 
<if test="author != null"> 
AND author like #{author} 
</if> 
</select> 


choose, when, otherwise 语句 : 


iBATIS 提 供 了 一 个 选择 的 元 素 ， 它 类 似 于 Java 的 switch 语 句 。 这 有 助 于 选择 很 多 种 


情况 。 


下 面 的 例子 将 只 搜索 标题 上 如 果 提 供 ， 那 么 只 有 由 作者 如 果 已 提供 。 如 果 没 有 提 
供 ， 让 我 们 只 返回 精 选 的 博客 : 


«select id="findActiveBlogwithTitleLike" 
parameterType="Blog" resultType="Blog"> 
SELECT * FROM BLOG 
WHERE state = 'ACTIVE. 


<choose> 
«when test="title !- null"> 
AND title like #{title} 
</when> 
«when test="author != null and author.name != null"> 
AND author like #{author} 
</when> 
<otherwise> 
AND featured = 1 
</otherwise> 
</choose> 
</select> 


where 324): 


如 果 我 们 看 一 下 前 面 的 例子 中 ， 如 果 没 有 一 个 条 件 满足 会 发 生 什么 事 ? 最 终 SQL 看 
起 来 像 这 样 : 


SELECT * FROM BLOG 
WHERE 


这 会 失败 ， 但 iBATIS 有 一 个 简单 的 改变 一 个 简单 的 解决 方案 ， 让 一 切 工作 正常 : 


<select id="findActiveBlogLike" 
parameterType="Blog" resultType="Blog"> 
SELECT * FROM BLOG 


<where> 
<if test="state != null"> 
state = #{state} 
</if> 


<if test="title != null"> 
AND title like #{title} 


</if> 
<if test="author != null> 
AND author like #{author} 
</if> 
</where> 
</select> 


where 元 素 知 道 只 有 插入 WHERE ， 如 果 有 一 个 由 含 标签 返回 的 任何 内 容 。 此 外 ， 
如 果 该 内 容 开 头 AND 或 OR， 它 知道 剥离 其 关闭 。 


foreach% : 


foreach 元 素 是 非常 强大 的 ， 并 允许 你 指定 一 个 集合 ， 声 明 可 以 在 元 素 的 体内 可 用 于 
项 目 和 索引 变量 。 


它 也 允许 你 指定 打开 和 关闭 的 字符 串 ， 并 添加 一 个 分 隔 符 放置 在 迭代 之 间 。 可 以 建 
立 一 个 IN 条 件 如 下 : 


«select id-"selectPostIn" resultType="domain.blog.Post"> 


SELECTIS 
FROM POST P 
WHERE ID in 


«foreach item="item" index="index" collection="list" 
openz"(" separator="," close=")"> 
#{item} 
«/foreach» 
«/select» 


IBATIS;3 ix - ibatis 
这 是 很 容易 ， 同 时 与 iBATIS 的 工作 程序 进行 调试 。 iBATIS 有 内 和 置 的 日 志 支 持 ， 并 适 
用 于 下 列 日 志 库 ， 并 在 这 个 顺序 搜索 他 们 。 
e Jakarta Commons 日 志 记 录 (JCL) 。 
e Log4J 
e JDK 日 志 
可 以 使 用 任何 上 面 列 出 的 库 在 iBATIS。 


调试 和 Log4J : 


假设 你 要 使 用 Log4J， 这 是 最 好 用 的 日 志 记 录 。 继 续 操 作 之 前 ， 需 要 交叉 检查 以 下 


e Log4J JAR 文件 (log4j-{version}.jar) 应 在 CLASSPATH 中 。 

e 必须 在 CLASSPATH 中 提供 log4j.properties。 
下 面 是 一 个 log4j.properties 文 件 。 请 注意 ， 某 些 行 被 注释 掉 了 。 你 可 以 取消 他 们 ， 
如 果 你 需要 额外 的 调试 信息 。 


# Global logging configuration 
log4j.rootLogger-ERROR, stdout 


10g4]j.logger.com.ibatis=DEBUG 


# shows SQL of prepared statements 
#10g4j.logger .java.sql.Connection=DEBUG 


# shows parameters inserted into prepared statements 
#10g4j.logger .java.sql.PreparedStatement=DEBUG 


# shows query results 
#1o0g4j.logger.java.sql.ResultSet=DEBUG 


#10g4j.logger.java.sql.Statement=DEBUG 
# Console output 
log4j.appender.stdout-org.apache.10g4j.ConsoleAppender 


log4j.appender.stdout.layout-org.apache.log4j.PatternLayout 
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n 


可 以 找到 完整 的 Log4J 文 档 ， 从 Apaches 网 站 : Log4J 文档 . 


iBATIS 调试 例子 : 


下 面 的 Java 类 是 一 个 非常 简单 的 例子 ， 初 始 化 ， 然 后 使 用 Java 应 用 程序 Log4J 的 日 
志 库 。 它 位 于 CLASSPATH 中 上 面 提 到 的 属性 文件 。 


import org.apache.log4j.Logger; 


import com.ibatis.common.resources.Resources; 

import com.ibatis.sqlmap.client.SqlMapClient; 

import com.ibatis.sqlmap.client.SqlMapClientBuilder; 
import java.io.*; 

import java.sql.SQLException; 

import java.util.*; 


public class IbatisUpdate{ 
static Logger log - Logger.getLogger( 
IbatisUpdate.class.getName()); 


public static void main(String[] args) 

throws IOException, SQLException{ 

Reader rd = Resources.getResourceAsReader ("SqlMapConfig.xmLl"); 
SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd); 


/* This would insert one record in Employee table. */ 
log.info("Going to update record..... an ie 

Employee rec = new Employee(); 

rec.setId(1); 

rec.setFirstName( "Roma"); 
smc.update("Employee.update", rec ); 

log.info("Record updated Successfully "); 


log.debug("Going to read records..... n 

List «Employee» ems = (List<Employee>) 
smc.queryForList("Employee.getAll", null); 

Employee em - null; 

for (Employee e : ems) { 


System.out.print(" ^" + e.getId()); 
System.out.print(" ^" + e.getFirstName()); 
System.out.print(" ^" + e.getLastName()); 
System.out.print(" ^" + e.getSalary()); 
em = e; 
System.out.println(""); 

} 

log.debug("Records Read Successfully "); 


} 
} 
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编译 和 运行 : 


下 面 是 步骤 来 编译 并 运行 上 述 软件 。 请 确保 您 已 在 进行 的 编译 和 执行 之 前 ， 适 当地 
设置 PATH 和 CLASSPATH。 


e 创建 Employee.xml 如 上 所 示 。 

e 创建 Employee.java 如 上 图 所 示 ， 并 编译 它 。 
e 创建 lbatisUpdate.java 如 上 图 所 示 ， 并 编译 它 。 
e 创建 log4j.properties 文 件 ， 如 上 图 所 示 。 

e 执行 lbatisUpdate 二 进 制 文件 来 运行 程序 。 


会 得 到 下 面 的 结果 ， 并 记录 在 EMPLOYEE 表 进行 更 新 , 然后 相同 的 记录 将 被 从 
EMPLOYEE 表 中 读 出 。 


DEBUG [main] - Created connection 28405330. 
DEBUG [main] - Returned connection 28405330 to pool. 
DEBUG [main] - Checked out connection 28405330 from pool. 
DEBUG [main] - Returned connection 28405330 to pool. 

1 Roma Ali 5000 

2 Zara Ali 5000 

3 ara Ali 5000 


调试 方法 : 
在 上 面 的 例子 中 ， 我 们 只 使 用 info() 方 法 ， 但 可 以 使 用 以 下 任何 一 种 方法 按 你 的 需 
要 : 


public void trace(Object message); 
public void debug(Object message); 
public void info(Object message); 
public void warn(Object message); 
public void error(Object message); 
public void fatal(Object message); 
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iBatis 和 Hibernate 之 间 有 着 较 大 的 差异 ， 但 两 者 解决 方案 很 好 ， 因 为 他 们 有 特定 的 
领域 。 我 个 人 建议 使 用 iBATIS 的 ， 如 果 : 
e 你 想 创建 自己 的 SQL， 并 愿意 维持 他 们 . 
。 你 的 环境 是 由 关系 数据 模型 驱动 的 。 
e. 你 的 项 目 工 作 有 复杂 架构 的 。 
简单 地 要 使 用 Hibernate， 如 果 : 
。 你 的 环境 是 由 对 象 模型 驱动 的 ， 并 希望 自动 生成 的 SQL。 
要 计算 的 一 些 区 别 : 
e iBATIS : 
o 简单 
。 更 快 的 开发 时 间 
o 灵活 
o 封装 尺寸 更 小 
e Hibernate: 
o 为 你 生成 SQL， 这 意味 着 你 不 用 花 时 间 在 SQL 上 。 
o 提供 了 许多 更 先进 的 高 速 缓存 
o 高 可 扩展 性 


另 一 个 区 别 是 ，iBATIS 利 用 SQL 语句 可 能 是 依赖 数据 库 ， 使 用 Hibernate 的 HQL 是 
相对 独立 于 数据 库 ， 它 是 更 容易 改变 数据 库 。 


Hibernate 映 射 的 Java 作 为 POJO 对 象 ，iBatis 将 ResultSet 映 射 ， 从 JDBC API 给 出 
POJO OBJETS 的 数据 库 表 。 


如 果 您 使 用 存储 过 程 ， 那 么 在 Hibernate 中 可 以 做 到 这 一 点 ， 但 它 在 iBATIS 上 比较 有 点 
困难 。 作 为 一 种 替代 的 解决 方案 iBATIS 的 映射 结果 集 对 象 ， 所 以 没 必 要 去 关心 表 结 
构 。 这 非常 适用 于 存储 过 程 ， 非 常 适用 于 报表 应 用 程序 等 

最 后 ，Hibernate 和 iBATIS 的 都 是 开源 的 对 象 关系 映射 (ORM) 在 同行 业 中 可 用 的 
工具 。 使 用 这 些 工 具 的 取决 于 你 。Hibernate 和 iBatis 两 者 也 有 来 自 Spring 框 架 的 良 
好 支持 ， 以 便 它 不 应 该 是 一 个 问题 ， 选 择 其 中 之 一 。 


iBATOR 人 介绍， 什么 是 iBATOR ? - ibatis 
iBATOR 是 一 个 代码 生成 器 ， 用 于 iBATIS。 iBATOR 内 部 检查 的 一 个 或 多 个 数据 库 
表 和 将 生成 iBATIS 的 工件 ， 可 用 于 访问 表 。 


稍 后 ， 您 可 以 编写 自 定 义 的 SQL 代码 或 存储 过 程 来 满足 您 的 要 求 。 iBATOR 产 生 以 
下 项 目 : 


e SglMap XML 文件 
e Java 类 相 匹 配 的 表 的 主键 和 字段 
e 使 用 上 述 对 象 DAO 类 (可 选 ) 


iBATOR 可 以 运行 作为 一 个 独立 的 JAR 文 件 ， 或 作为 一 个 Ant 任 务 ， 或 者 作为 一 个 
Eclipse 插件 。 本 教程 将 教 你 生成 jiBATIS 的 配置 文件 格式 命令 行 的 简单 的 方法 。 


下 载 iBATOR : 


如 果 您 使 用 的 IDE 是 Eclipse， 上 比 其 他 下 载 独 立 的 JAR。 独 立 的 JAR 包 括 一 个 Ant 任 务 
来 运行 BATOR， 或 者 您 也 可 以 从 Java 代 码 中 的 命 合 行 运行 BATOR。 
e You can download zip file from Download iBATOR. 


e You can check online documentation: iBATOR Documentation. 


Generating Configuration File: 


To get up and running quickly with Abator, follow these steps: 


Step 1: 
Create and fill out a configuration file ibatorConfig.xml appropriately. At a 
minimum, you must specify: 


e A<jdbcConnection> element to specify how to connect to the target 
database. 


e A<javaModelGenerator> element to specify target package and target 
project for generated Java model objects 


e A<sqiMapGenerator> element to specify target package and target project 
for generated SQL map files. 


e A<daoGenerator> element to specify target package and target project for 
generated DAO interfaces and classes (you may omit the <daoGenerator> 
element if you don't wish to generate DAOs). 


e At least one database <table> element 


NOTE: See the XML Configuration File Reference page for an example of an 
Abator configuration file. 


Step 2: 


Save the file in some convenient location for example at: empibatorConfig.xml). 
Step 3: 
Now run Abator from the command line with a command line as follows: 


java -jar abator.jar -configfile empabatorConfig.xml -overwrite 
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This will tell Abator to run using your configuration file. It will also tell Abator to 
overwrite any existing Java files with the same name. If you want to save any 
existing Java files, then omit the -overwriteparameter. 


If there is a conflict, Abator will save the newly generated file with a unique name. 


After running Abator, you will need to create or modify the standard iBATIS 
configuration files to make use of your newly generated code. This is explained in 
next section. 


Tasks After Running Abator: 


After you run Abator, you will need to create or modify other iBATIS configuration 
artifacts. The main tasks are as follows: 


e Create or Modify the SqlMapConfig.xml file. 
e Create or modify the dao.xml file (only if using the iBATIS DAO Framework). 


Each task is described in detail below: 


Updating the SqlMapConfig.xml File: 


iBATIS uses an XML file, commonly named SqlMapConfig.xml, to specify 
information for a database connection, a transaction management scheme, and 
SQL map XML files that will be used in an iBATIS session. 


Abator cannot create this file for you because Abator knows nothing about your 
execution environment. However, some of the items in this file relate directly to 
Abator generated items. 


Abator specific needs in the configuration file are as follows: 
e Statement namespaces must be enabled. 
e Abator generated SQL Map XML files must be listed . 


For example, suppose that Abator has generated an SQL Map XML file called 
MyTable SqlMap.xml, and that the file has been placed in the test.xml package of 
your project. The SglMapConfig.xml file should have these entries: 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE sqlMapConfig 
PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-config-2.dtd"> 


«sq1MapConfig» 
<!-- Statement namespaces are required for Abator --> 
«settings useStatementNamespaces="true" /» 


«!-- Setup the transaction manager and data source that are 
appropriate for your environment 
T 
«transactionManager type="... "> 
«dataSource type="... "> 
</dataSource> 
</transactionManager> 


<!-- SQL Map XML files should be listed here --> 
<sqlMap resource-z"test/xml/MyTable SqlMap.xml" /> 


</sqlMapConfig> 


If there is more than one SQL Map XML file (as is quite common), then the files 
can be listed in any order with repeated <sqlMap> elements after the 
<transactionManager> element. 


Updating the dao.xml File: 


The iBATIS DAO framework is configured by an xml file commonly called dao.xml. 


The iBATIS DAO framework uses this file to control the database connection 
information for DAOs, and also to list the DAO implementation classes and DAO 
interfaces. 


In this file you should specify the path to your SqiMapConfig.xml file, and all the 
Abator generated DAO interfaces and implementation classes. 


For example, suppose that Abator has generated a DAO interface called 
MyTableDAO and a implementation class called MyTableDAOlmpl, and that the 
files have been placed in the test.dao package of your project. 


dao.xml 文 件 应 该 有 这 些 项 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE daoConfig 
PUBLIC "-//ibatis.apache.org//DTD DAO Configuration 2.0//EN" 
"http://ibatis.apache.org/dtd/dao-2.dtd"> 


<daoConfig> 
<context> 
«transactionManager type="SQLMAP"> 
«property name-"SqlMapConfigResource" 
value-"test/SqlMapConfig.xml"/» 
</transactionManager> 


<!-- DAO interfaces and implementations 
should be listed here --> 
«dao interface="test.dao.MyTableDAO" 
implementation-"test.dao.MyTableDAOImpl" /> 


</context> 


</daoConfig> 


NOTE: This step is only required if you generated DAOs for the iBATIS DAO 
framework. 


Jackson 教 程 


Jackson 是 一 个 简单 基于 Java 应 用 库 ，Jackson 可 以 轻松 的 将 Java 对 象 转换 成 json 对 
象 和 xml 文 档 ， 同 样 也 可 以 将 son、xml 转 换 成 Java 对 象 。Jackson 所 依赖 的 jar 包 较 
少 ， 简 单 易 用 并 且 性 能 也 要 相对 高 些 ， 并 且 Jackson 社 区 相对 比较 活跃 ， 更 新 速度 
也 比较 快 。 


TER 


e 容易 使 用 - jackson API 提 供 了 一 个 高 层次 外 观 ， 以 简化 常用 的 用 例 。 

e 无需 创建 映射 - API 提 供 了 默认 的 映射 大 部 分 对 象 序列 化 。 

e 性 能 高 - 快速 ， 低 内 存 占 用 ， 适 合 大 型 对 象 图 表 或 系统 。 

干净 的 JSON - jackson 创 建 一 个 干净 和 紧凑 的 JSON 结 果 ， 这 是 让 人 很 容易 阅 


读 。 
不 依赖 - 库 不 需要 任何 其 他 的 库 ， 除 了 JDK。 
开源 代码 - jackson 是 开源 的 ， 可 以 免费 使 用 。 


三 种 方式 处 理 JSON 


提供 了 三 种 不 同 的 方法 来 人 处理 JSON 


e. 流 式 API - 读 取 并 将 JSON 内 容 写 入 作为 离散 事件 。 JsonParser 读 取 数 据 ， 而 
JsonGenerator 写 入 数据 。 它 是 三 者 中 最 有 效 的 方法 ， 是 最 低 的 开销 和 最 快 的 
读 / 写 操作 。 它 类 似 于 Stax 解 析 器 XML。 


e 树 模型 - 准备 JSON 文 件 在 内 存 里 以 树 形式 表示 。 ObjectMapper 构 建 
JsonNode 节 点 树 。 这 是 最 灵活 的 方法 。 它 类 似 于 XML 的 DOM 解 析 器 。 


e 数据 绑 定 - 转换 JSON 并 从 POJO (普通 Java 对 象 ) 使 用 属性 访问 或 使 用 注释 。 
它 有 两 个 类 型 。 


o 简单 的 数据 绑 定 - 转换 JSON 和 Java Maps, Lists, Strings, Numbers, 
Booleans 和 null 对 象 。 


o 全 部 数据 绑 定 - 转换 为 JSON 从 任何 JAVA 类 型 。 


ObjectMapper 读 / 写 JSON 两 种 类 型 的 数据 绑 定 。 数 据 绑 定 是 最 方便 的 方式 
是 类 似 XML 的 JAXB 解 析 器 。 


Jackson ÄRR iB - Jackson 教 程 


本 地 环境 设置 

由 于 Jackson 是 基于 Java 编 程 语言 的 ， 所 以 需要 设置 Java 开 发 环境 ， 这 里 介绍 如 何 
下 载 安 装 设置 Java。 请 按照 以 下 步骤 来 设置 环境 。 

Java SE 是 免费 的 ， 点 击 下 载 链接 : 下 载 Java 根据 操作 系统 版 本 下 载 对 应 版 本 安 


AX 
To 


按照 说 明 下 载 java 并 运行 .exe 到 机 器 上 安装 。 一 旦 机 器 上 安装 了 Java， 还 需要 设置 
环境 变量 指向 正确 的 安装 目录 : 


Setting up the path for windows 2000/XP: 


假设 你 已 经 安装 在 c:Program Filesjavajdk 目录 : 
。 在 “我 的 电脑 "右键 单 击 并 选择 "属性 "。 
e 在 "高 级 "选项 卡 下 单 击 “ 环 境 变 量 " 按 钮 。 


e 现在， 改变“PATH" 变 量 ， 因 此 它 也 要 包含 Java 可 执行 文件 路 径 。 例 如 ， 如 果 该 
路 径 当 前 设置 为 'C:WINDOWSSYSTEM32', 那 么 改变 路 径 看 起 来 就 是 
'C:WINDOWSSYSTEM32;c:Program Filesjavajdkin'. 


设置 为 Linux，UNIX，Solaris 和 FreeBSD 的 路 径 : 
环境 变量 PATH 应 设置 为 指向 已 安装 的 Java 二 进 制 文件 的 位 置 。 请 参考 shell 文 件 ， 
如 果 这 样 做 还 搞 不 定 的 话 。 


例如 ， 如 果 使 用 bash 作 为 shell， 那么 将 下 面 的 行 添加 到 最 后 一 行 '.bashrc: export 
PATH-7/path/to/java:$ PATH' 


一 些 流 行 的 Java 编 辑 器 : 
要 编写 Java 程 序 ， 需 要 一 个 文本 编辑 器 。 在 市 场 上 可 用 的 更 复杂 的 IDE。 但 现在 ， 
可 以 考虑 下 列 之 一 : 


e Notepad: 在 Windows 机 器 上 ， 可 以 使 用 像 记 事 本 的 任何 简单 的 文本 编辑 器 CU) 
学 者 推荐 ) ，TextPad。 


。 Netbeans: 是 一 个 Java IDE， 它 是 开源 和 免费 的 ， 可 从 以 下 地 址 下 
载 : http:/Awww.netbeans.org/index.html. 


e Eclipse: 也 是 一 个 Java IDE 开 发 由 Eclipse 开源 社区 ， 可 以 从 
http://www.eclipse.org/ Fix 【本 教程 推荐 使 用 】 


下 载 jackson 存 档 


从 jackson-all-1.9.0.jar.zip 下 载 jackson jar 文 件 的 最 新 版 本 。 在 写 这 篇 教程 的 时 候 ， 
下 载 的 是 jackson-1.9.0.jar 并 将 其 复制 到 C:>jackson 文 件 夹 中 。 


OS 轨 档 名 称 
Windows jackson-all-1.9.0.jar 
Linux jackson-all-1.9.0.jar 
Mac jackson-all-1.9.0.jar 
设置 jackson 环 境 


设置 jackson_HOME 环 境 交 量 指向 Guava jar 被 存储 在 计算 机 上 的 基本 目录 位 置 。 假 
设 ， 我 们 已 经 提取 jackson-all-1.9.0.jar，jackson 文 件 夹 不 同 的 操作 系统 如 下 。 


OS 输出 
Windows 设置 环境 变量 jackson HOME 到 C:jackson 
Linux export jackson HOME-/usr/local/jackson 
Mac export jackson HOME-/Library/jackson 

ix i CLASSPATH & © 


设置 CLASSPATH 环 境 变 量 指向 jackson jar 的 位 置 。 假 设 我 们 已 经 存储 jackson- 
all-1.9.0.jar 在 不 同 的 操作 系统 的 jackson 文件 夹 如 下 。 


OS Output 


Windows 设置 环境 变量 CLASSPATH 
A %CLASSPATH%;%jackson_ HOME%jackson-all-1.9.0.jar;.; 


export CLASSPATH=$CLASSPATH:$jackson_ HOME/jackson-all- 
1.9.0 jar:. 


export CLASSPATH=$CLASSPATH:$jackson_ HOME/jackson-all- 
1.9.0 jar:. 


Linux 


Mac 


Jackson 第 一 个 程序 - Jackson 教 程 


再 进入 学 习 jackson 库 的 细节 之 前 ， 让 我 们 来 看 看 应 用 程序 操作 功能 。 在 这 个 例子 
中 ， 我 们 创建 一 个 Student 类 。 将 创建 一 个 JSON 字 符 串 学 生 的 详细 信息 ， 并 将 其 反 
序列 化 到 学 生 的 对 象 ， 然 后 将 其 序列 化 到 JSON 字 符 串 。 

创建 一 个 名 为 JacksonTester 在 Java 类 文件 C:\>Jackson WORKSPACE. 


X fF: JacksonTester.java 


import java.io.IOException; 
import org.codehaus. jackson. JsonParseException; 
import org.codehaus.jackson.map.JsonMappingException; 


import org.codehaus.jackson.map.ObjectMapper; 


import org.codehaus.jackson.map.SerializationConfig; 


public class JacksonTester { 


j 


public static void main(String args[]){ 


ObjectMapper mapper = new ObjectMapper(); 
String jsonString = "{\"name\":\"Mahesh\", \"age\":21}"; 


//map json to student 
try { 


Student student = mapper.readValue(jsonString, Student.cl: 


System.out.println(student); 


mapper.enable(SerializationConfig.Feature.INDENT OUTPUT); 
jsonString - mapper.writeValueAsString(student); 


System.out.println(jsonString); 


) catch (JsonParseException e) ( 
e.printStackTrace(); 

) catch (JsonMappingException e) { 
e.printStackTrace(); 

) catch (IOException e) { 
e.printStackTrace(); 

j 


class Student { 


private String name; 

private int age; 

public Student(){} 

public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 


public int getAge() { 
return age; 


public void setAge(int age) ( 
this.age - age; 


} 
public String toString(){ 

return "Student [ name: "+name+", age: 
} 


Woe age+ n ihe 











使 用 javac 编 译 如 下 类 : 


C:NJackson WORKSPACE»javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 


C:NJackson WORKSPACE»java JacksonTester 


验证 输出 


Student [ name: Mahesh, age: 21 ] 
{ 


"name" : "Mahesh", 
"age" : 21 
} 
步骤 - 需要 记 住 
以 下 是 这 里 要 考虑 的 重要 步骤 。 
第 1 步 : 创建 ObjectMapper 对 象 。 
创建 ObjectMapper 对 象 。 它 是 一 个 可 重复 使 用 的 对 象 。 


ObjectMapper mapper = new ObjectMapper(); 


第 2 步 : 反 序 列 化 JSON 到 对 象 。 


从 JSON 对 象 使 用 readValue() 方 法 来 获取 。 通 过 JSON 字 符 串 和 对 象 类 型 作为 参数 
JSON 字 符 串 /来 源 。 


//Object to JSON Conversion 
Student student = mapper.readValue(jsonString, Student.class); 


第 3 步 : 序列 化 对 象 到 JSON。 
使 用 writeValueAsString() 方 法 来 获取 对 象 的 JSON 字 符 串 表示 。 


//Object to JSON Conversion 
jsonString = mapper.writeValueAsString(student); 


Jackson ObjectMapper # - Jackson 教 程 


ObjectMapper 类 是 Jackson 库 的 主要 类 。 它 提供 一 些 功 能 将 转换 成 Java 对 象 匹配 
JSON 结 构 ， 反 之 亦 然 。 它 使 用 JsonParser 和 JsonGenerator 的 实例 实现 JSON 实 际 
的 读 / 写 。 


we = 
A FAR 
以 下 是 org.codehaus.jackson.map.ObjectMapper 类 的 声明 : 


public class ObjectMapper 
extends ObjectCodec 
implements Versioned 


PRE X 


S.N. 类 & 描述 


static class ObjectMapper.DefaultTypeResolverBuilder 定制 
1 TypeResolverBuilder， 提 供 所 谓 的 “默认 输入 ”使 用 类 型 解析 构建 器 CH, 
enableDefaultTyping() 了 解 详细 信息 ) 。 


2 static class ObjectMapper.DefaultTyping 使 用 enableDefaultTyping() 
枚 举 指 定 什么 样 的 类 型 (X) 默认 输入 应 该 使 用 。 


S.N. His HAN & 描述 
ObjectMapper() FANEJA ERZ BO MERA JsonFactory ùh Z2 sq fE 


1 FiStdSerializerProviderfF 7; HSerializerProvider, 3f 
BeanSerializerFactory/F 7; K:SerializerFactory, 
2 ObjectMapper(JsonFactory jf) 构造 使 用 指定 的 JsonFactory 构 建 必要 


的 JsonParsers 和 /或 JsonGenerators 映 射 。 


3 ObjectMapper(JsonFactory jf, SerializerProvider sp, 
DeserializerProvider dp) 


ObjectMapper(JsonFactory jf, SerializerProvider sp, 
4 DeserializerProvider dp, SerializationConfig sconfig, 
DeserializationConfig dconfig) 


ObjectMapper(SerializerFactory sf) 不 推荐 使 用 。 使 用 其 他 构造 来 代 
5 5, 注意 ， 可 以 设置 序列 化 工厂 
setSerializerFactory (org.codehaus.jackson.map.SerializerFactory) 


继承 的 方法 


这 个 类 继承 了 以 下 类 方法 : 


e java.lang.Object 


ObjectMapper 示 例 


<a name="ad"></a> 选 择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> 
Jackson WORKSPACE 


File: JacksonTester.java 


import java.io.IOException; 
import org.codehaus. jackson. JsonParseException; 
import org.codehaus.jackson.map.JsonMappingException; 


import org.codehaus.jackson.map.ObjectMapper; 


import org.codehaus.jackson.map.SerializationConfig; 


public class JacksonTester { 


j 


public static void main(String args[]){ 


ObjectMapper mapper = new ObjectMapper(); 
String jsonString = "{\"name\":\"Mahesh\", \"age\":21}"; 


//map json to student 
try { 


Student student = mapper.readValue(jsonString, Student.cl: 


System.out.println(student); 


mapper.enable(SerializationConfig.Feature.INDENT OUTPUT); 
jsonString - mapper.writeValueAsString(student); 


System.out.println(jsonString); 


) catch (JsonParseException e) ( 
e.printStackTrace(); 

) catch (JsonMappingException e) { 
e.printStackTrace(); 

) catch (IOException e) { 
e.printStackTrace(); 

} 


class Student { 


private String name; 

private int age; 

public Student(){} 

public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public int getAge() { 
return age; 


public void setAge(int age) { 
this.age = age; 


} 
public String toString(){ 

return "Student [ name: "+name+", age: 
} 


"ap age+ n qus 











验证 结果 


使 用 javac 编译 如 下 类 : 


C:NJackson WORKSPACE»javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 


C:NJackson WORKSPACE»java JacksonTester 


验证 输出 


Student [ name: Mahesh, age: 21 ] 
{ 


"name" : "Mahesh", 
"age" : 21 
} 


Jackson 对 象 序 列 化 - Jackson 教 程 


这 里 将 介绍 将 Java 对 象 序列 化 到 一 个 JSON 文 件 ， 然 后 再 读 取 JSON 文 件 获取 转换 
为 对 象 。 在 这 个 例子 中 ， 创 建 了 Student 类 。 创 建 和 有 学 生 对 象 以 JSON 表 示 在 一 个 
student.json 文 件 。 


创建 一 个 名 为 JacksonTester 在 Java 类 文件 在 C:\>Jackson WORKSPACE. 


X fF: JacksonTester.java 


import java.io.File; 
import java.io.IOException; 


import org.codehaus. jackson. JsonGenerationException; 
import org.codehaus. jackson. JsonParseException; 
import org.codehaus. jackson.map.JsonMappingException; 
import org.codehaus. jackson.map.ObjectMapper; 


public class JacksonTester { 
public static void main(String args[]){ 

JacksonTester tester = new JacksonTester(); 

try { 
Student student = new Student(); 
student.setAge(10); 
student.setName("Mahesh") ; 
tester.writeJSON(student); 


Student studenti - tester.readJSON(); 
System.out.println(student1); 


) catch (JsonParseException e) ( 
e.printStackTrace(); 

) catch (JsonMappingException e) { 
e.printStackTrace(); 

) catch (IOException e) ( 
e.printStackTrace(); 

j 


j 


private void writeJSON(Student student) throws JsonGenerationEx¢ 
ObjectMapper mapper = new ObjectMapper(); 
mapper .writeValue(new File("student.json"), student); 


} 


private Student readJSON() throws JsonParseException, JsonMappir 
ObjectMapper mapper = new ObjectMapper(); 
Student student = mapper.readValue(new File("student.json"), 
return student; 


} 


class Student { 
private String name; 
private int age; 
public Student(){} 
public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public int getAge() { 
return age; 


public void setAge(int age) ( 
this.age - age; 


public String toString()( 
return "Student [ name: "+name+", age: "+ age+ " ]"; 





} 
} 
验证 结果 
使 用 javac 编译 如 下 类 : 


C:\Jackson_WORKSPACE>javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 
C:NJackson WORKSPACE»java JacksonTester 
验证 输出 结果 


Student [ name: Mahesh, age: 10 ] 


Jackson 数 据 绑 定 - Jackson 教 程 
数据 绑 定 API 用 于 JSON 转 换 和 使 用 属性 访问 或 使 用 注解 POJO( 普 通 Java 对 象 )。 以 
下 是 它 的 两 个 类 型 。 


e 简单 数据 绑 定 - 转换 JSON， 从 Java Maps, Lists, Strings, Numbers, Booleans 
和 null 对 象 。 


e 完整 数据 绑 定 - 转换 JSON 到 任何 JAVA 类 型 。 我 们 将 在 下 一 章 分 别 绑 定 。 


ObjectMapper 读 /于 JSON 两 种 类 型 的 数据 绑 定 。 数 据 绑 定 是 最 方便 的 方式 是 类 似 
XML 的 JAXB 解 析 器 。 


简单 的 数据 绑 定 


简单 的 数据 绑 定 是 指 JSON 了 映射 到 Java 核 心 数据 类 型 。 下 表 列 出 了 JSON 类 型 和 
Java 类 型 之 间 的 关系。 


Sr. No. JSON 类 型 Java 类 型 
1 object LinkedHashMap<String,Object> 
2 array ArrayList<Object> 
3 string String 
4 complete number Integer, Long or BigInteger 
5 fractional number Double / BigDecimal 
6 true | false Boolean 
7 null null 


让 我 们 来 看 看 简单 的 数据 操作 绑 定 。 在 这 里 ， 我 们 将 映射 JAVA 基本 类 型 直接 
JSON， 反 之 亦 然 。 


创建 一 个 名 为 JacksonTester 在 Java 类 文件 在 目录 C:\>Jackson_WORKSPACE. 


File: JacksonTester.java 


import java.io.File; 

import java.io.IOException; 
import java.util.HashMap; 
import java.util.Map; 


import org.codehaus. jackson. JsonGenerationException; 
import org.codehaus. jackson. JsonParseException; 
import org.codehaus. jackson.map.JsonMappingException; 


import org.codehaus. jackson.map.ObjectMapper; 


public class JacksonTester { 
public static void main(String args[]){ 
JacksonTester tester = new JacksonTester(); 


try { 
ObjectMapper mapper = new ObjectMapper(); 


Map<String,Object> studentDataMap = new HashMap<String, 
int[] marks = {1,2,3}; 


Student student = new Student(); 
student.setAge(10); 
student.setName("Mahesh") ; 

// JAVA Object 
studentDataMap.put("student", student); 

// JAVA String 

studentDataMap.put("name", "Mahesh Kumar"); 
// JAVA Boolean 
studentDataMap.put("verified", Boolean.FALSE); 
// Array 

studentDataMap.put("marks", marks); 


mapper .writeValue(new File("student.json"), studentDat: 
//result student.json 


// "student": ("name" :"Mahesh", "age":10}, 
// "marks":[1,2,3], 


// "verified":false, 
// "name":"Mahesh Kumar" 
//} 


studentDataMap = mapper.readValue(new File("student.js¢ 


System.out.println(studentDataMap.get("student")); 
System.out.println(studentDataMap.get("name")); 
System.out.println(studentDataMap.get("verified")); 
System.out.println(studentDataMap.get("marks")); 
) catch (JsonParseException e) { 
e.printStackTrace(); 
) catch (JsonMappingException e) { 
e.printStackTrace(); 
) catch (IOException e) { 
e.printStackTrace(); 


} 
} 


class Student { 
private String name; 
private int age; 
public Student(){} 
public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public int getAge() { 
return age; 


public void setAge(int age) { 


} 
public String toString(){ 
return "Student [ name: "+name+", age: "+ age+ " ]"; 


this.age = age; 





} 
} 
验证 结果 
使 用 javac 编 译 如 下 类 : 


C:\Jackson_WORKSPACE>javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 


C:NJackson WORKSPACE»java JacksonTester 


验证 输出 结果 


{name=Mahesh, age=10} 
Mahesh Kumar 

false 

[1, 2, 3] 


Jackson 全 数据 绑 定 - Jackson 教 程 
完全 数据 绑 定 是 指 JSON 映 射 到 任何 Java 对 象 。 


//Create an ObjectMapper instance 
ObjectMapper mapper = new ObjectMapper(); 
//map JSON content to Student object 


Student student = mapper.readValue(new File("student.json"), Studer 


//map Student object to JSON content 
mapper.writeValue(new File("student.json"), student); 


ij — ğ 


让 我 们 来 看 看 简单 的 数据 操作 绑 定 。 在 这 里 ， 我 们 将 直接 映射 Java 对 象 到 JSON， 
反之 亦 然 。 


创建 一 个 名 为 JacksonTester 在 Java 类 文件 目录 C:\>Jackson_WORKSPACE. 


File: JacksonTester.java 


import java.io.File; 
import java.io.IOException; 


import org.codehaus. jackson. JsonGenerationException; 
import org.codehaus. jackson. JsonParseException; 
import org.codehaus. jackson.map.JsonMappingException; 
import org.codehaus. jackson.map.ObjectMapper; 


public class JacksonTester { 
public static void main(String args[]){ 

JacksonTester tester = new JacksonTester(); 

try { 
Student student = new Student(); 
student.setAge(10); 
student.setName("Mahesh") ; 
tester .writeJSON(student) ; 


Student studenti = tester.readJSON(); 
System.out.println(student1); 


) catch (JsonParseException e) ( 
e.printStackTrace(); 

) catch (JsonMappingException e) { 
e.printStackTrace(); 

) catch (IOException e) { 
e.printStackTrace(); 

} 





private void writeJSON(Student student) throws JsonGenerationExt 
ObjectMapper mapper - new ObjectMapper(); 
mapper.writeValue(new File("student.json"), student); 


j 


private Student readJSON() throws JsonParseException, JsonMappir 
ObjectMapper mapper = new ObjectMapper(); 
Student student = mapper.readValue(new File("student.json"), 
return student; 


} 


class Student { 
private String name; 
private int age; 
public Student(){} 
public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public int getAge() { 
return age; 


public void setAge(int age) { 
this.age = age; 


} 
public String toString(){ 
return "Student [ name: "+name+", age: "+ age+ " ]"; 





} 
} 
验证 结果 
使 用 javac 编 译 如 下 类 : 


C:\Jackson_WORKSPACE>javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 
C:\Jackson_WORKSPACE>java JacksonTester 
验证 输出 


Student [ name: Mahesh, age: 10 ] 
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Jackson 数 据 绑 定 泛 型 - Jackson 教 程 


在 简单 的 数据 绑 定 中 ， 我 们 使 用 String 作 为 关键 对 象 ， 并 作为 一 个 值 对 象 映射 类 。 
相反 ， 我 们 可 以 使 用 具体 的 Java 对 象 和 类 型 强制 转换 到 JSON 使 用 。 


考虑 下 面 的 例子 使 用 一 个 类 的 UserData 来 保存 用 户 专用 数据 。 
创建 一 个 名 为 JacksonTester 在 Java 类 文件 目录 C:\>Jackson WORKSPACE. 
文件 名 : JacksonTester.java 


import java.io.File; 

import java.io.IOException; 
import java.util.Arrays; 
import java.util.HashMap; 
import java.util.List; 
import java.util.Map; 


import org.codehaus. jackson. JsonGenerationException; 
import org.codehaus. jackson. JsonParseException; 
import org.codehaus. jackson.map.JsonMappingException; 
import org.codehaus. jackson.map.ObjectMapper; 

import org.codehaus.jackson.type.TypeReference; 


public class JacksonTester { 
public static void main(String args[]){ 
JacksonTester tester = new JacksonTester(); 


try { 
ObjectMapper mapper = new ObjectMapper(); 


Map <string, style="box-sizing: border-box;" userdata=' 
UserData studentData = new UserData(); 
int[] marks = {1,2,3}; 


Student student = new Student(); 

student.setAge(10); 

student.setName("Mahesh") ; 

// JAVA Object 

studentData.setStudent (student); 

// JAVA String 

studentData.setName("Mahesh Kumar"); 

// JAVA Boolean 

studentData.setVerified(Boolean.FALSE); 

// Array 

studentData.setMarks(marks); 

TypeReference ref = new TypeReference<map<string, userdé 
userDataMap.put("studentDatad", studentData); 
mapper.writeValue(new File("student.json"), userDataMa| 
/AL 

// "studentDatai": 


} 


// "student": 

// { 

// "name" :"Mahesh", 
// "age":10 

// }, 

// "name":"Mahesh Kumar", 
// "verified":false, 

2. "marks" :[1,2,3] 

// } 

//} 


userDataMap = mapper.readValue(new File("student.json" 


System.out.println(userDataMap.get("studentData1").get: 
System.out.println(userDataMap.get("studentData1").get! 
System.out.println(userDataMap.get("studentData1").get" 
System.out.println(Arrays.toString(userDataMap.get("sti 


) catch (JsonParseException e) ( 
e.printStackTrace(); 
) catch (JsonMappingException e) { 
e.printStackTrace(); 
) catch (IOException e) { 
e.printStackTrace(); 
j 


class Student ( 


j 


private String name; 

private int age; 

public Student(){} 

public String getName() { 
return name; 


public void setName(String name) { 
this.name - name; 
j 


public int getAge() { 
return age; 


public void setAge(int age) { 
this.age - age; 
} 


public String toString(){ 
return "Student [ name: "+name+", age: "+ age+ " ]"; 
} 


class UserData { 


private Student student; 
private String name; 
private Boolean verified; 
private int[] marks; 


public UserData() {} 


public Student getStudent() { 
return student; 


public void setStudent(Student student) { 
this.student = student; 


j 
public String getName() ( 
return name; 


public void setName(String name) { 
this.name - name; 


public Boolean getVerified() { 
return verified; 


public void setVerified(Boolean verified) ( 
this.verified - verified; 


} 
public int[] getMarks() { 
return marks; 


public void setMarks(int[] marks) { 
this.marks = marks; 


}</map<string, userdata></string, ></string, > 
a 岂 
验证 输出 


使 用 javac 编 译 如 下 类 : 





C:\Jackson_WORKSPACE>javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 


C:\Jackson_WORKSPACE>java JacksonTester 


验证 输出 


Student [ name: Mahesh, age: 10 ] 
Mahesh Kumar 

false 

[1, 2, 3] 


Jackson 树 模型 - Jackson 教 程 


树 模 型 准备 JSON 文 件 的 内 存 树 表示 。 ObjectMapper 构 建 JsonNode 节 点 树 。 这 是 
最 灵活 的 方法 。 它 类 似 于 DOM 解 析 器 的 XML。 


从 JSON 创 建树 


ObjectMapper 提 供 一 个 指针 树 的 根 节点 在 读 取 JSON 之 后 。 根 节点 可 用 于 通 历 完全 
树 。 考 虑 下 面 的 代码 片段 获得 提供 JSON 字 符 串 的 根 节 点 。 


//Create an ObjectMapper instance 

ObjectMapper mapper = new ObjectMapper(); 

String jsonString = "{\"name\":\"Mahesh Kumar\", \"age\":21,\"verit 
//create tree from JSON 

JsonNode rootNode = mapper.readTree(jsonString); 


= 
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JsonNode nameNode - rootNode.path("name"); 
System.out.println("Name: "+ nameNode.getTextValue()); 


JsonNode marksNode - rootNode.path("marks"); 
Iterator «jsonnode style="box-sizing: border-box;">iterator = mark: 


i) ————HB 


示例 


创建 一 个 名 为 JacksonTester 在 Java 类 文件 目录 C:\>Jackson WORKSPACE. 





File: JacksonTester.java 


import java.io.IOException; 
import java.util.Iterator; 


import org.codehaus. jackson. JsonNode; 

import org.codehaus. jackson. JsonParseException; 
import org.codehaus. jackson.map.JsonMappingException; 
import org.codehaus. jackson.map.ObjectMapper; 


public class JacksonTester { 
public static void main(String args[]){ 
JacksonTester tester = new JacksonTester(); 
try { 
ObjectMapper mapper = new ObjectMapper(); 
String jsonString = "{\"name\":\"Mahesh Kumar\", \"age\": 
JsonNode rootNode = mapper.readTree(jsonString); 


JsonNode nameNode = rootNode.path("name"); 
System.out.println("Name: "+ nameNode.getTextValue()); 


JsonNode ageNode - rootNode.path("age"); 
System.out.println("Age: " + ageNode.getIntValue()); 


JsonNode verifiedNode - rootNode.path("verified"); 
System.out.println("Verified: " + (verifiedNode.getBoolear 


JsonNode marksNode - rootNode.path("marks"); 
Iterator<JsonNode> iterator = marksNode.getElements(); 
System.out.print("Marks: [ "); 
while (iterator.hasNext()) { 
JsonNode marks = iterator.next(); 
System.out.print(marks.getIntValue() + " "); 
} 
System.out.println("]"); 
) catch (JsonParseException e) ( 
e.printStackTrace(); 
) catch (JsonMappingException e) { 
e.printStackTrace(); 
) catch (IOException e) { 
e.printStackTrace(); 
} 





验证 输出 结果 


使 用 javac 编 译 如 下 类 : 


C:NJackson WORKSPACE»javac JacksonTester.java 


现在 运行 jacksonTester 看 到 结果 : 


C:\Jackson_WORKSPACE>java JacksonTester 


验证 输出 


Name: Mahesh Kumar 
Age: 21 

Verified: No 

Marks: [ 100 90 85 ] 


树 到 JSON 转 换 


在 这 个 例子 中 ， 我 们 已 经 使 用 JsonNode 并 将 其 写 入 到 一 个 JSON 文 件 ， 并 读 回 创建 
了 一 棵 树 。 


创建 一 个 名 为 JacksonTester 在 Java 类 文件 目录 C:\>Jackson_WORKSPACE. 


File: JacksonTester.java 


import java.io.File; 
import java.io.IOException; 
import java.util.Iterator; 


import org.codehaus. jackson. JsonNode; 

import org.codehaus. jackson. JsonParseException; 
import org.codehaus. jackson.map.JsonMappingException; 
import org.codehaus. jackson.map.ObjectMapper; 

import org.codehaus. jackson.node.ArrayNode; 

import org.codehaus. jackson.node.ObjectNode; 


public class JacksonTester { 
public static void main(String args[]){ 
JacksonTester tester = new JacksonTester(); 


try { 
ObjectMapper mapper = new ObjectMapper(); 


JsonNode rootNode = mapper.createObjectNode( ); 
JsonNode marksNode = mapper.createArrayNode( ); 
((ArrayNode)marksNode).add(100); 

( (ArrayNode)marksNode).add(90); 

( (ArrayNode)marksNode).add(85); 

((ObjectNode) rootNode).put("name", "Mahesh Kumar"); 
((ObjectNode) rootNode).put("age", 21); 
((ObjectNode) rootNode).put("verified", false); 
((ObjectNode) rootNode).put("marks",marksNode); 


mapper.writeValue(new File("student.json"), rootNode); 


rootNode = mapper.readTree(new File("student.json")); 


JsonNode nameNode = rootNode.path("name"); 
System.out.println("Name: "+ nameNode.getTextValue()); 


JsonNode ageNode - rootNode.path("age"); 
System.out.println("Age: " + ageNode.getIntValue()); 


JsonNode verifiedNode - rootNode.path("verified"); 
System.out.println("Verified: " + (verifiedNode.getBoolear 


JsonNode marksNodei = rootNode.path("marks"); 
Iterator<JsonNode> iterator = marksNode1.getElements(); 
System.out.print("Marks: [ "); 
while (iterator.hasNext()) { 
JsonNode marks = iterator.next(); 
System.out.print(marks.getIntValue() + " "); 
} 
System.out.println("]"); 
) catch (JsonParseException e) ( 
e.printStackTrace(); 
) catch (JsonMappingException e) { 
e.printStackTrace(); 
) catch (IOException e) { 
e.printStackTrace(); 





} 
} 
} 
验证 结果 
使 用 javac 编 译 如 下 类 : 


C:NJackson WORKSPACE»javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 


C:\Jackson_WORKSPACE>java JacksonTester 


验证 输出 


Name: Mahesh Kumar 
Age: 21 

Verified: No 

Marks: [ 100 90 85 ] 


从 树 到 Java 对 象 转换 


在 这 个 例子 中 ， 我 们 已 经 使 用 JsonNode 并 将 其 写 入 到 一 个 JSON 文 件 ， 并 回 读 然后 
将 一 个 Student 对 象 其 转换 为 创建 了 一 棵 树 。 


创建 一 个 名 为 JacksonTester 在 Java 类 文件 目录 C:\>Jackson WORKSPACE. 


File: JacksonTester.java 


import 
import 
import 


import 
import 
import 
import 
import 
import 


public 
pub 


java.io.File; 
java.io. IOException; 
java.util.Arrays; 


org.codehaus. jackson. JsonNode; 
org.codehaus. jackson. JsonParseException; 
org.codehaus. jackson.map. JsonMappingException; 
org.codehaus. jackson.map.ObjectMapper; 
org.codehaus. jackson.node.ArrayNode; 
org.codehaus. jackson.node.ObjectNode; 


class JacksonTester ( 
lic static void main(String args[]){ 
JacksonTester tester = new JacksonTester(); 


try { 
ObjectMapper mapper - new ObjectMapper(); 


JsonNode rootNode = mapper.createObjectNode( ); 
JsonNode marksNode - mapper.createArrayNode( ); 

( (ArrayNode)marksNode).add(100); 
((ArrayNode)marksNode).add(90); 

( (ArrayNode)marksNode).add(85); 

((ObjectNode) rootNode).put("name", "Mahesh Kumar"); 
((ObjectNode) rootNode).put("age", 21); 
((ObjectNode) rootNode).put("verified", false); 
((ObjectNode) rootNode).put("marks",marksNode); 


mapper.writeValue(new File("student.json"), rootNode); 
rootNode - mapper.readTree(new File("student.json")); 
Student student - mapper.treeToValue(rootNode, Student.cl: 


System.out.println("Name: "+ student.getName()); 
System.out.println("Age: " + student.getAge( )); 
System.out.println("Verified: " + (student.isVerified() ? 
System.out.println("Marks: "-«Arrays.toString(student.getM: 
) catch (JsonParseException e) ( 
e.printStackTrace(); 
) catch (JsonMappingException e) { 
e.printStackTrace(); 
) catch (IOException e) { 
e.printStackTrace(); 


} 


class Student { 
String name; 
int age; 
boolean verified; 
int[] marks; 
public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public int getAge() { 
return age; 


public void setAge(int age) { 
this.age = age; 


public boolean isVerified() { 
return verified; 


public void setVerified(boolean verified) { 
this.verified = verified; 


} 
public int[] getMarks() { 
return marks; 


public void setMarks(int[] marks) { 
this.marks = marks; 





} 
} 
验证 结果 
使 用 javac 编 译 如 下 类 : 


C:\Jackson_WORKSPACE>javac JacksonTester.java 


现在 运行 jacksonTester 看 到 结果 : 


C:\Jackson_WORKSPACE>java JacksonTester 


验证 输出 


Name: Mahesh Kumar 
Age: 21 

Verified: No 

Marks: [ 100 90 85 ] 


Jackson 流 式 API - Jackson 教 程 


流 式 API 读 取 和 写 入 JSON 内 容 离 散 事件 。 JsonParser 读 取 数 据 ， 而 JsonGenerator 
写 入 数据 。 它 是 三 者 中 最 有 效 的 方法 ， 是 最 低 开 销 和 最 快 的 读 / 写 操作 。 它 类 似 于 
XML 的 Stax 解 析 器 。 


在 本 文中 ， 我 们 将 展示 的 使 用 Jackson 的 流 式 API 读 写 JSON 数 据 。 流 式 API 工 作 使 
用 JSON 为 每 一 个 细节 的 都 是 要 小 心 处 理 。 下 面 的 例子 将 使 用 两 个 类 : 


e JsonGenerator - 写 信 JSON 字 符 串 。 
e JsonParser - 解析 JSON 字 符 串 。 


使 用 JsonGenerator 写 入 JSON 


使 用 JsonGenerator 是 非常 简单 的 。 首 先 使 用 JsonFactory.createJsonGenerator() 方 
法 创建 一 个 JssonGenerator， 并 用 write*() 方 法 来 写 每 一 个 JSON 值 。 


JsonFactory jasonFactory = new JsonFactory(); 
JsonGenerator jsonGenerator = jasonFactory.createJsonGenerator (new 
"student.json"), JsonEncoding.UTF8); 


MU ah 
jsonGenerator.writeStartObject(); 
// "name" : "Mahesh Kumar" 


jsonGenerator.writeStringField("name", "Mahesh Kumar"); 


BE 





让 我 们 来 看 看 JsonGenerator 操 作 。 创 建 一 个 名 为 JacksonTester 的 Java 类 文件 在 目 
录 C:\>Jackson_WORKSPACE. 


File: JacksonTester.java 


import java.io.File; 
import java.io.IOException; 
import java.util.Map; 


import org.codehaus. jackson. JsonEncoding; 

import org.codehaus. jackson. JsonFactory; 

import org.codehaus. jackson. JsonGenerator; 

import org.codehaus. jackson. JsonParseException; 
import org.codehaus. jackson.map.JsonMappingException; 
import org.codehaus.jackson.map.ObjectMapper; 


public class JacksonTester { 
public static void main(String args[]){ 
JacksonTester tester = new JacksonTester(); 


try { 


JsonFactory jasonFactory = new JsonFactory(); 


JsonGenerator jsonGenerator = jasonFactory.createJsonGene! 
"student.json"), JsonEncoding.UTF8); 


TTX 
jsonGenerator.writeStartObject(); 
// "name" : "Mahesh Kumar" 


jsonGenerator.writeStringField("name", "Mahesh Kumar"); 
// "age" : 21 

jsonGenerator.writeNumberField("age", 21); 

// "verified" : false 
jsonGenerator.writeBooleanField("verified", false); 
// "marks" : [100, 90, 85] 
jsonGenerator.writeFieldName("marks"); 

// T 

jsonGenerator.writeStartArray(); 

77 100, 90, 85 

jsonGenerator.writeNumber(100); 
jsonGenerator.writeNumber(90); 
jsonGenerator.writeNumber(85); 

// ] 

jsonGenerator .writeEndArray(); 

// } 

jsonGenerator.writeEndObject(); 
jsonGenerator.close(); 


//result student.json 


//4{ 

// "name":"Mahesh Kumar", 
// "age":21, 

// "verified":false, 

// "marks":[100,90,85] 
//} 


ObjectMapper mapper = new ObjectMapper(); 
Map<String,Object> dataMap = mapper.readValue(new File("si 


System.out.println(dataMap.get("name") ); 
System.out.println(dataMap.get("age")); 
System.out.println(dataMap.get("verified")); 
System.out.println(dataMap.get("marks")); 


) catch (JsonParseException e) ( 


e.printStackTrace(); 


) catch (JsonMappingException e) { 


e.printStackTrace(); 


} catch (IOException e) { 


} 


e.printStackTrace(); 








使 用 javac 编 译 如 下 类 : 


C:\Jackson_WORKSPACE>javac JacksonTester.java 


现在 运行 jacksonTester 看 到 的 结果 : 


C:\Jackson_WORKSPACE>java JacksonTester 


验证 输出 


Mahesh Kumar 
21 

false 

[100, 90, 85] 


使 用 JsonParser 读 取 JSON 


使 用 JsonParser 是 非常 简单 的 。 首 先 使 用 JsonFactory.createJsonParser() 方 法 创建 
JsonParser， 并 使 用 它 的 nextToken() 方 法 来 读 取 每 个 JSON 字 符 串 作为 标记 。 检 查 
每 个 邻 牌 和 相应 的 过 程 。 


JsonFactory jasonFactory = new JsonFactory(); 
JJsonParser jsonParser = jasonFactory.createJsonParser(new File("s1 
while (jsonParser.nextToken() != JsonToken.END OBJECT) { 
//get the current token 
String fieldname = jsonParser.getCurrentName( ); 
if ("name".equals(fieldname)) { 
//move to next token 
jsonParser.nextToken(); 
System.out.println(jsonParser.getText()); 





让 我 们 来 看 看 JsonParser 的 操作 。 创 建 一 个 名 为 JacksonTester 在 Java 类 在 文件 夹 
C:\>Jackson_WORKSPACE. 


X fF: JacksonTester java 


import java.io.File; 
import java.io.IOException; 


import org.codehaus. jackson. JsonEncoding; 


import 
import 
import 
import 
import 
import 


public 


org. 
org. 


org 


org. 
org. 
org. 


codehaus. 
codehaus. 
.codehaus. 
codehaus. 
codehaus. 
codehaus. 


jackson. JsonFactory; 

jackson. JsonGenerator; 

jackson. JsonParseException; 
jackson. JsonParser; 

jackson. JsonToken; 
jackson.map.JsonMappingException; 


class JacksonTester ( 
public static void main(String args[]){ 


JacksonTester tester = 
try { 


new JacksonTester(); 


JsonFactory jasonFactory = new JsonFactory(); 


JsonGenerator jsonGenerator = jasonFactory.createJsonGenei 
"student.json"), JsonEncoding.UTF8); 


jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 
jsonGenerator 


.writeStartObject(); 
.writeStringField("name", 
.writeNumberField("age", 21); 
.writeBooleanField("verified", false); 
.writeFieldName("marks"); 
.writeStartArray(); // [ 

.writeNumber (100); 

.writeNumber (90); 

.writeNumber (85); 

.writeEndArray(); 

.WwriteEndObject(); 

.close(); 


"Mahesh Kumar"); 


//result student.json 


//{ 

// "name":"Mahesh Kumar", 
// "age":21, 

// "verified":false, 

// "marks" :[100, 90,85] 
//} 


JsonParser jsonParser = 
while (jsonParser.nextToken() 


jasonFactory.createJsonParser (new 
!= JsonToken.END OBJECT) { 


//get the current token 


String fieldname = 
.equals(fieldname)) { 


if ("name" 


jsonParser.getCurrentName(); 


//move to next token 
jsonParser .nextToken(); 
System.out.println(jsonParser.getText()); 


j 

if("age".equals(fieldname))( 
//move to next token 
jsonParser.nextToken( ); 
System.out.println(jsonParser.getNumberValue()); 


if("verified".equals(fieldname) ) { 
//move to next token 
jsonParser .nextToken(); 


System.out.println(jsonParser.getBooleanValue()); 


if("marks".equals(fieldname))( 
//move to [ 
jsonParser.nextToken(); 
// loop till token equal to "]" 
while (jsonParser.nextToken() != JsonToken.END ARRA" 
System.out.println(jsonParser.getNumberValue()); 
} 


} 


} catch (JsonParseException e) { 
e.printStackTrace(); 

} catch (JsonMappingException e) { 
e.printStackTrace(); 

} catch (IOException e) { 
e.printStackTrace(); 





验证 结果 


编译 使 用 javac 编 译 如 下 类 : 


C:\Jackson_WORKSPACE>javac JacksonTester.java 


现在 运行 jacksonTester 看 到 结果 如 下 : 


C:NJackson WORKSPACE»java JacksonTester 


验证 输出 


Mahesh Kumar 
21 

false 

[100, 90, 85] 


JasperReports 教 程 


asper Reports 
Jasper 报 表 是 一 个 开源 的 Java 报 表 引 车， 是 基于 Java 的 ， 它 没有 自己 的 表达 式 话 


N 
1A o 


由 于 JasperReports 是 一 个 Java 类 库 ， 而 不 是 针对 最 终 用 户 ， 而 是 有 针对 那些 需要 
报表 功能 添加 到 自己 的 应 用 程序 的 Java 开 发 人 员 。 


读者 


本 教程 为 Java 开 发 那些 愿意 充实 自己 的 报表 技术 而 编制 。 完 成 本 教程 后 ， 
JasperReports 熟 悉 程 序 达 到 


BU dE ARTE 


在 继续 本 教程 ， 应 该 对 Java 编 程 语言 的 一 个 很 好 的 理解 。 还 需要 对 Apache AntB 
本 理解 ， 因 为 所 有 的 例子 都 被 编译 和 执行 中 使 用 ANT。 





1 - Java Ui 


如 果 想 学 习 JAVA 入 门 ， 推 荐 以 下 教程 
Java 教 程 


2 - ANT 教 程 


如 果 想 使 用 Apache Ant， 那 么 可 以 通过 以 教程 学 习 。 
ANT 教 程 


JasperReports 人 门 ，JasperReports 是 什么 ? - 
JasperReports 教 程 


什么 是 报表 
报表 是 从 数据 库 中 的 数据 有 意义 和 良好 汇总 信息 。 通 常情 况 下 ， 日 常 活动 是 自动 化 


和 数据 汇总 到 一 个 决策 支持 的 格式 “报告 "。 报 表 作 为 奇迹 ， 当 一 般 的 杂乱 数据 转换 
成 迷人 的 图 表 ， 图 形 和 其 他 图 形 表 示 转 换 。 


报表 模板 


一 般 有 以 下 报表 布局 之 后 是 许多 商业 报告 生成 工具 来 生成 报告 。 
TITLE 





PAGEHEADER 
COLUMNHEADER 
DETAIL 


COLUMNFOOTER 
PAGEFOOTER 


Ziiuaj eau 





以 下 是 图 中 提 到 的 每 个 元 件 的 描述 。 


元 素 描述 


标题 包含 该 报告 的 标题 。 它 只 会 出 现 一 次 ， 在 报告 的 一 开 
始 ， 例 如 , “Yiibai 教 程 报告 "。 


PageHeader 可 能 包含 日 期 和 时 间 的 信息 和 /或 组 织 的 名 称 。 
这 出 现在 每 个 页 面 的 顶部 。 


ColumnHeader 列 出 了 要 在 报表 中 显示 ， 例 如 , “作者 姓 
columnHeader ”名 ”,“ 启 动 时 间 ”， “完成 时 间 "” 具 体 字段 , "LEN BRE 
期 "等 的 名 称 。 


详细 信息 在 这 里 显示 的 特定 字段 (在 的 columnHeader 列 表 ) 
条 目 ， 例 如 部 分 "Manisha", "9:00", "18:00", "9", "10.02.2013". 


ColumnFooter 可 以 显示 的 任何 字段 的 总 和 ， 例 如 ，"Total 
Hours Worked: 180" 


PageFooter 可 能 包含 页 面 计数 信息 。 它 出 现在 每 个 页 面 的 底 
部 ， 例 如 ，"1/23". 


摘要 包含 从 “细节 "部 分 推断 出 的 信息 ， 例 如 ， 工 作 小 时 为 每 个 
summary 作者 的 数量 列表 ， 总 工时 为 每 个 作者 可 以 把 视力 表 像 饼 图 ， 
曲线 图 等 ， 为 更 好 的 比较 。 


title 


pageHeader 


detail 
columnFooter 


pageFooter 


Jasper 报 表 


报表 开发 过 程 中 面临 的 常见 故障 归纳 在 以 下 几 点 : 
o 核心 变化 : 为 了 反映 业务 发 生变 化 或 改进 它 通 常 以 改变 报告 的 核心 远 辑 。 


e 结果 输出 : 有 各 种 各 样 的 格式 ， 报 表 可 导出 到 如 : HTML, XA, PDF, MS 
Excel, RTF, ODT, 283m, XML AIR. 


e 复杂 报表 : 子 报表 和 交叉 表 报 告 是 很 好 的 例子 。 

e 图 表 报 表 : 视觉 图 为 例 。 图 ， 饼 图 ，XY 折 线 图 ， 条 形 图 ， 仪 表 和 时 间 序 列 
为 了 消除 上 述 点 的 开销 ， 并 促进 报告 过 程 中 ， 很 多 框架 ， 工 具 ， 库 和 第 三 方 应 用 进 
行 了 介绍 。Jasper Report 报表 是 其 中 之 一 。 

Jasper Report 是 一 个 开源 的 Java 报 表 引 擎 ， 它 不 像 其 他 的 报表 工具 ， 例 如 Crystal 
报表 是 基于 Java 的 ， 没 有 自己 的 表达 式 语 法 。JasperReports 有 提供 丰富 的 内 容 到 
屏幕 上 ， 到 打印 机 ， 或 转换 成 PDF，HTML，XLS，RTF，ODT，CSV，TXT 和 


XML 文件 的 能 力 。 因 为 它 不 是 一 个 独立 的 工具 ， 它 不 能 被 安装 在 其 自身 。 相 反 ， 它 
是 由 包括 它 在 点 用 程序 的 CLASSPATH 库 财 入 到 Java 应 用 程序 。 


JasperReports 是 一 个 Java 类 库 ， 而 不 是 针对 最 终 用 户 ， 而 是 有 针对 性 的 对 谁 需要 
的 报表 功能 添加 到 自己 的 应 用 程序 的 Java 开 发 人 员 。 


JasperReports #$ A 


一 些 主要 的 JasperReport 的 功能 包括 : 


具有 灵活 的 报表 布局 。 

它 可 以 用 文字 或 图 形 显示 数据 。 

开发 人 员 可 以 通过 多 种 方式 提供 数据 。 

它 可 以 接受 来 自 多 个 数据 源 的 数据 。 

它 可 以 生成 水 印 (水 印 是 这 样 的 方式 被 放置 在 主 图 像 的 副 图 像 ) 
它 可 以 生成 子 报表 。 

它 能 够 导出 报表 到 多 种 格式 的 。 


JasperReport 环 境 设 置 - JasperReports 教 程 


JasperReport 是 一 个 纯 Java 库 ， 而 不 是 一 个 独立 的 应 用 程序 。 它 不 能 单独 运行 ， 
此 它 需 要 被 徐 入 到 另 一 个 客户 端 或 服务 器 端的 Java 应 用 程序 。 因 为 它 是 基于 Java 
它 可 以 在 任何 支持 Java 的 平台 (JDK1.3 及 以 上 ) 上 运行。 所 有 JasperReports 的 功 
能 是 聚集 在 一 个 JAR 文 件 中 ， 一 般 名 称 为 : jasperreports-x.x.x.jar. JasperReport 
: 这 个 JAR 文 件 必需 及 可 选 库 (压缩 文件 ) 可 以 从 网 站 上 下 载 。 下 载 最 新 的 
反 本 。 


ZIP 文 件 包 含 JasperReports 源 代码 ， 相 关 JAR 和 大 量 的 实例 演示 JasperReport 功 能 
以 及 JasperReportsJAR 文 件 。 


JasperReport 环 境 配置 


要 开始 创建 我 们 需要 设置 环境 准备 。 解 压缩 下 载 的 JasperReport ZIP 文 件 到 任何 位 
iB (在 我 们 的 例子 中 ， 我 们 已 经 提取 到 C: oolsjasperreports-5.0.1) 。 解 压缩 文件 
的 目录 结构 如 下 图 示 : 











sperreports-5.0 











dress Ic SH 

Name ^ Size Type Date Modfied 
(build File Folder 1/3/2013 2:33 PM 
[demo Fie Folder 1/3/2013 2:35 PM 
(Sadist File Folder 1/3/2013 2:33 PM 
{docs File Folder 1/3/2013 2:35 PM 
lib File Folder 1/3/2013 2:35PM 
sre File Folder 1/3/2013 2:35 PM 
[zi .classpath 3KB CLASSPATH File 11/23/2012 4:41 Pm 
[e .project I KB PROJECT File 11/23/2012 4:41 PM 
(2 build.xml 25KB XML Document 11/23/2012 4:48 PM 
(E) changes.txt S8KB Text Document 1/3/2013 2:01 PM 
E] llcense.txt 8KB Text Document 11/23/2012 4:41 PM 
[= porn. xral 13KB XML Document 1/3/2013 1:35 PM 
(=) readme.txt 3KB Text Document 11/235277]7 FH el 


下 面 是 所 有 目录 的 详细 信息 : 
e build: 包含 已 编译 的 JasperReport 类 文件 。 
e demo: 包含 演示 JasperReports 功 能 几 个 方面 的 各 种 例子 。 


e dist: 包含 的 JasperReports-x.x.x.jar 文 件 。 将 这 个 JAR 文 件 添加 到 
CLASSPATH. 


e docs: 包含 了 JasperReports 的 文档 的 本 地 副本 。 


e lib: 包含 所 需 的 所 有 JAR 文 件 ， 这 样 既 可 以 建立 JasperReports， 并 把 它 用 在 我 
们 的 应 用 程序 。 


e src: 包含 了 JasperReports 的 源 代 码 。 


build.xml: Ant 构 建文 件 构建 JasperReports 的 源 代 码 。 如 果 不 打算 修改 
JasperReports， 并 不 需要 使 用 这 个 文件 ， 因 为 JasperReports 发 布 成 已 编译 的 
形式 。 

changes.txt: 一 个 文本 文件 解释 的 JasperReports 类 库 的 当前 和 以 前 版 本 之 间 的 


Ze Fo 


e license.txt: 包含 LGPL ( 较 宽 松 通用 公共 许可 证 ) 许可 的 全 文 文本 文档 。 
e readme.txt: 一 个 文本 文件 包含 有 关 如 何 建立 和 执行 提供 的 示例 说 明 。 


基本 上 ， 我 们 只 使 用 jasperreports-x.x.x.jar 在 lib 目 录 下 的 路 程 和 JAR 下 生成 报表 。 
由 于 Jasper 报 表 作 为 一 个 开源 的 工具 ， 如 果 任 何 缺 陷 或 错误 执行 的 jasperreports- 
x.x.x.jar 中 是 公认 的 ， 我 们 可 以 修复 它 并 使 用 build.xml 文 件 再 次 生成 的 JAR 文 件 。 


iz 1a CLASSPATH 


要 使 用 JasperReport， 需 要 设置 下 列 文件 到 CLASSPATH 中 : 


e jasperreports-x.x.x.jar, 其 中 x.x.x 是 JasperReports 的 版 本 。 此 目录 下 找到 C: 
oolsjasperreports-x.x.xdist). 


e lib 子 目录 中 的 所 有 JAR 文 件 (C: oolsjasperreports-x.x.xlib). 


在 安装 的 时 候 ， 我 们 使 用 JasperReport5.0.1 版 本 。 在 “我 的 电脑 "右键 单 击 并 选择 “ 属 
性 “高 级 ?选项 卡 下 单 击 “ 环 境 变 量 " 按 钮 。 现 在 有 了 这 个 更 新 的 “路 径 ? 变 量 添加 : C: 
oolsjasperreports-5.0.1distjasperreports-5.0.1.jar;C: oolsjasperreports-5.0.1lib;. 现 
在 ， 可 以 创建 报表 了 。 


> 在 本 教程 中 的 所 有 例子 中 ， 已 经 使 用 Ant 任 务 来 生成 报告 。 构 建文 件 会 自己 负责 ， 
包括 所 有 所 需 的 JAR 生 成 报告 。 因 此 ， 设 定 上 述 的 CLASSPATH 只 会 帮助 生成 报 
表 ， 而 无 需 使 用 ANT。 
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在 本 教程 中 的 所 有 例子 : 
e 使 用 简单 的 文本 编辑 器 写 人 。 
e 已 保存 的 目录 下 C: oolsjasperreports-5.0.1 estsrccomyiibai. 
e 已 编译 并 从 命令 提示 符 下 执行 ， 使 用 Apache Ant。 我 们 将 使 用 它 我 们 将 在 Ant 


build.xml 文 件 中 的 后 续 章节 中 导入 abaseBuild.xml 文 件 。 将 此 文件 保存 到 C: 
oolsjasperreports-5.0.1 est. 以 下 是 baseBuild.xml 文 件 的 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportExample" basedir="."> 
<description>Previews our JasperReport XML Design</description> 


«property name-"file.name" value="jasper_report_template" /> 
<!-- Directory where the JasperReports project file was extracte 
needs to be changed to match the local environment --> 
«property name="jasper.dir" valuez"../" /> 

«property name="dist.dir" value="${jasper.dir}/dist" /» 
«property name="lib.dir" value="${jasper.dir}/lib" /> 

«property name="Src.dir" value="src" /> 


<property 
<property 


name-"classes.dir" value="classes" /> 
name-"main-class" value="com.yiibai.HelpMe" /> 


<path id="classpath"> 
<pathelement location="./" /> 
<pathelement location="${classes.dir}" /> 
<fileset dir="${lib.dir}"> 
«include namez'"**/*,jar" /> 
</fileset> 
<fileset dir="${dist.dir}"> 
«include namez"**/*,jar" /> 
</fileset> 


</path> 


«target name-"compile" depends="clean-sample"> 

«mkdir dir="${classes.dir}"/> 

«javac srcdir="${src.dir}" destdir="${classes.dir}" 
classpathref="classpath" /> 


</target> 


<target name="run" depends="compile"> 
<echo message="Running class : ${main-class}"/> 
<java fork="true" classname="${main-class}"> 
<classpath> 


<path refid="classpath" /> 


</classpath> 


</java> 


</target> 


<target name="clean-sample"> 
<delete dir="${classes.dir}" /> 
<delete file="./${file.name}.jasper" /> 
<delete file="./${file.name}.jrprint" /> 


</target> 
</project> 


| 
此 文件 具有 所 有 必需 的 目标 ， 上 比如 清除 目录 ， 编 译 java 文 件 ， 并 执行 类 文件 。 


以 下 是 baseBuild.xml 提 到 的 细节 不 同 的 目录 。 假 设 当 前 目录 是 C: 
oolsjasperreports-5.0.1 est): 


jasper.dir: 是 C: oolsjasperreports-5.0.1 directory 


lib.dir: 是 C: oolsjasperreports-5.0.1lib directory 
e src.dir: = C: oolsjasperreports-5.0.1 estsrc 
e classes.dir: = C: oolsjasperreports-5.0.1 estclasses 


e main-class: com.yiibai.HelpMe. 这 个 类 执行 ， 如 果 没 有 类 文件 名 是 在 命令 行 中 
通过 一 个 简单 的 类 。 将 此 文件 保存 到 C: oolsjasperreports-5.0.1 
estsrccomyiibai. 


package com.yiibai; 


public class HelpMe ( 
public static void main(String[] args) { 
System.out.println("This is the default class executed." 
* "Please pass the fully qualified class" 
+ " name to be executed as command line" 
* " parameter, for example," 
* " com.yiibai.HelpMe "); 


Jasper 管理 类 


还 有 的 类 ， 它 们 将 被 用 来 编译 JRXML 报 表 设 计 ， 以 填补 报表 ， 打 印 报表 ， 导 出 为 
PDF，HTML 和 XML 文件 ， 坦 看 生成 的 报表 和 报表 设计 序号 。 


JasperFillManager 






export 


JapserExportManger 
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e net.sf.jasperreports.engine.JasperCompileManager: 用 于 编译 JRXML 报 表 模 
板 。 


e net.sf.jasperreports.engine.JasperFillManager: 用 于 填充 一 个 报表 ， 从 数据 源 
的 数据 


e net.sf.jasperreports.engine.JasperPrintManager: 用 于 打印 的 JasperReports 类 
库 生 成 的 文件 


e net.sfjasperreports.engine.JasperExportManager: 用 于 获取 PDF，HTML 或 
XML 内 容 以 供 报表 填充 过 程 中 产生 的 文件 


e net.sf.jasperreports.view.Jasper Viewer: 它 代 表 了 一 个 简单 的 Java Swing 应 用 
程序 ， 可 以 加 载 和 显示 报表 。 


e net.sf.jasperreports.view.JasperDesign Viewer: 用 于 在 设计 时 预览 报表 模板 。 


设置 Apache ANT 


我 们 将 构建 所 有 的 例子 使 用 Apache Ant。 所 以 请 检查 ANT - 设置 Apache Ant 环 境 。 


JasperReport4 mA HA - JasperReports 教 程 


JasperReports 的 主要 目的 是 为 了 在 一 个 简单 而 灵活 的 方式 创建 页 面 为 导向 ， 准 备 
好 打印 文档 。 下 面 的 流程 图 描述 了 一 个 典型 的 工作 流程 ， 同 时 创建 报表 。 


Design Phase 
(Create JRXML file) 


Compile 
{compile JRXML to 
Jasper template) 


Execution Phase 


(Fill the Jasper template 
with data to generate 
Jasper print file(.jrprint)) 


Export Phase 
(Export the report to 
any desired format) 
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如 在 图 片 的 生命 周期 具有 以 下 明显 的 阶段 


1. 设计 报表 在 这 一 步 中 ， 我 们 创建 JRXML 文 件 ， 该 文件 是 包含 的 报表 布局 定义 的 
XML 文 档 。 我 们 可 以 使 用 任何 文本 编辑 器 或 iReportDesigner 手 动 创建 它 。 如 果 
iReportDesigner 使 用 的 布局 被 设计 成 可 视 化 的 方式 时 ，JRXML 实 际 的 结构 可 
以 被 忽略 。 


2. 编译 报表 在 这 一 步 中 JRXML 被 编译 为 二 进 制 对 象 称 为 Jasper 文 件 (*.jasper)。 
做 此 编译 是 出 于 性 能 方面 的 考虑 。Jasper 文 件 是 什么 ? 它 需 要 随 应 用 程序 以 运 


3. 执行 报表 (数据 填充 到 报表 ) 在 该 步 又 中 从 应 用 程序 数据 被 填充 在 已 编译 的 报 
表 。 类 net.sf.jasperreports.engine.JasperFilManager 提 供 了 必要 的 功能 ， 填 补 
了 报告 中 的 数据 。Jasper 打 印 文件 (*.jrprint) 被 创建 ， 它 可 以 用 来 打印 或 者 导出 


报告 。 


4. 导出 报表 到 所 需 的 格式 在 这 一 步 中 ， 我 们 可 以 导出 在 上 一 步 中 使 用 
JasperExportManager 任 何 格式 创建 的 Jasper 打 印 文件 。 由 于 Jasper 提供 各 种 
形式 的 导出 ， 因 此 具有 相同 的 输入 ， 我 们 可 以 创建 数据 的 多 种 表示 形式 。 


上 述 每 个 步骤 的 详细 介绍 将 在 以 后 的 章节 中 解释 。 


JasperReporti& iz i+ - JasperReports 教 程 


在 JRXML 模 板 (或 JRXML 文 件 ) 中 的 JasperReport 都 是 标准 的 XML 文件 ， 

以 .JRXML 扩 展 。 所 有 JRXML 文 件 包 含 标签 <jasperReport>， 作 为 根 元 素 。 这 反 过 
来 又 包含 许多 子 元 素 (所 有 这 些 都 是 可 选 的 ) 。JasperReport 框 架 ， 可 以 义理 不 同 
类 型 的 数据 源 。 在 本 教程 中 ， 我 们 将 展示 如 何 生 成 一 个 基本 的 报表 ， 只 是 通过 传递 
Java 数 据 对 象 (使 用 Java Bean) 集合 传 给 JasperReport 引 擎 。 最 后 报表 应 显示 的 
人 的 名 单 的 名 字 和 国家 。 


本 章 介绍 如 何 设计 一 个 JasperReport。 下 面 的 步骤 将 在 本 章 中 : 
e 创建 一 个 JRXML 报 表 模 板 。 
e 预览 XML 报 表 模 板 。 


创建 一 个 JRXML 报 表 模 槐 


创建 JRXML 文 件 ， 该 文件 是 jasper_report_template.jrxml 使 用 文本 编辑 器 ， 并 保存 
此 文件 按照 我 们 的 环境 设置 ， 在 C: oolsjasperreports-5.0.1 est 。 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design/, 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 
«jasperReport xmlns-"http://jasperreports.sourceforge.net/jasperrej 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
XSi:schemaLocation="http://jasperreports.sourceforge.net/jasperrepc 
http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" 
name-"jasper report template" language="groovy" pageWidth="595" 
pageHeight="842" columnWidth="555" leftMargin-"20" rightMargin="20' 
topMargin="20" bottomMargin="20"> 
<queryString> 
«1[CDATA[]]» 
«/queryString» 
«field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ] ]></fieldDescription> 
</field> 
<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 
</field> 
<columnHeader> 
<band height="23"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="3" width="535" 
height="15" backcolor="#70A9A9" /> 
<box> 
«bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 


«text»«![CDATA[]]» </text> 
</staticText> 
<staticText> 
<reportElement x="414" y="3" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
«text»«! [CDATA[Country]]»«/text» 
</staticText> 
<staticText> 
<reportElement x="0" y="3" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Name] ]></text> 
</staticText> 
</band> 
</columnHeader> 
<detail> 
<band height="16"> 
<staticText> 
«reportElement mode-"Opaque" x="0" y="0" width="535" 
height="14" backcolor="#E5ECF9" /> 
<box> 
<bottomPen lineWidth="0.25" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
<text><![CDATA[]]> </text> 
</staticText> 
<textField> 
<reportElement x="414" y="0" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{country} ] ]> 
</textFieldExpression> 
</textField> 
<textField> 
<reportElement x="0" y="0" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$SF {name} ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
</jasperReport> 
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下 面 是 在 上 述 报表 模板 主要 字段 的 详细 信息 : 


e <queryString>: 这 是 空 的 〈 因 为 我 们 传递 的 数据 通过 Java Beans) . MBAS 
以 检索 报表 结果 的 SQL 语句 。 


e <field name>: 此 元 素 用 于 从 数据 源 或 查询 数据 映射 到 报表 模板 。name 是 重复 
使 用 到 报表 主体 〈 它 们 大 小 写 敏 感 ) 。 


e <fieldDescription>: 此 元 素 的 映射 字段 名 称 与 XML 文件 中 的 相应 元 素 。 
e <staticText>: 这 个 定义 不 依赖 于 任何 数据 源 ， 变 量 ， 参 数 或 报表 表达 式 静 态 文 


e <textFieldExpression>: 这 定义 结果 字段 的 外 观 。 


e $F{country}: 这 是 一 个 包含 结果 的 预定 义 字段 的 标签 <field name> 的 变量 的 
值 。 


e «band»: 包含 显示 在 报表 中 的 数据 。 
一 旦 报表 设计 已 准 各 就 绪 ， 将 其 保存 在 C: 目录 。 


预览 XML 报 表 模 板 


有 提供 的 实用 工具 net.sf.jasperreports.view.JasperDesignViewer 在 JasperReports 
的 JAR 文 件 ， 这 有 助 于 预览 报表 设计 ， 而 无 需 编译 或 填充 它 。 此 实用 程序 是 一 个 独 
立 的 Java 应 用 程序 ， 因 此 可 以 使 用 ANT 执 行 。 


让 我 们 来 写 一 个 Ant 目 标 viewDesignXML 坦 看 JRXML。 因 此 ， 让 我 们 在 C: 
oolsjasperreports-5.0.1 est 目 录 创 建 和 保存 build.xml (应 放置 在 JRXML 在 同一 个 目 
录 下 ) 。 这 里 是 build.xml 文 件 : 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default-"viewDesignXML" basedir=" 


«import file-"baseBuild.xml" /> 
«target name-"viewDesignXML" description="Design viewer is laur 
to preview the JXML report design."-» 
«java classname- "net.sf.jasperreports.view.JasperDesignViewe! 
fork="true"> 
<arg value="-XML" /> 
«arg value="-F${file.name}.jrxml" /> 
<classpath refid="classpath" /> 
</java> 
</target> 


</project> 
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接 下 来 ， 让 我 们 打开 命令 提示 符 并 转 到 build.xml 文 件 放 置 的 目录 。 执 行 命令 ant (由 
于 viewDesignXML 是 默认 的 目标 ) 。 输 出 如 下 : 


CE oolsjasperreports-5.0.1 est>ant 
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml 
viewDesignXML: 


[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[java] log4j:WARN Please initialize the log4j system properly. 


Log4j 的 警告 可 以 忽略 ， 如 上 面 执行 的 结果 ， 一 个 标 有 "JasperDesignViewer 窗口 打 
开 ， 显 示 我 们 的 报表 模板 的 预览 。 


Jasperf)esignViegwer 
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正如 我 们 看 到 获得 的 数据 只 报表 表达 式 显 示 ， 作 为 JasperDesignViewer 没 有 获得 实 
际 的 数据 源 或 报表 参数 。 通 过 关闭 窗口 或 按 下 Ctrl-C 在 命令 行 窗 口 终 止 
JasperDesignViewer。 


JasperReport 编 译 报表 设计 - JasperReports 教 程 
我 们 在 前 面 的 章节 中 产生 的 JasperReport 模 板 (JRXML 文 件 ) 。 这 个 文件 不 能 直接 


用 于 生成 报告 。 它 必须 被 编译 成 JasperReport 的 “本 地 二 进 制 "格式 ， 称 为 
Jasperfile。 在 编制 我 们 把 JasperDesign 对 象 转换 成 JasperReport 的 对 象 : 


| net.sf.jasperreports.engine.design.JasperDesign objects | 





net.sf.jasperreports.engine.JasperReport objects 


接口 net.sf.jasperreports.engine.design.JRCompiler 编 译 过 程 中 起 着 核心 的 一 部 
分 。 这 个 接口 有 根据 用 于 报表 表达 式 语 言 ， 它 可 以 只 要 编译 器 可 以 实现 在 运行 时 计 
算 它 被 用 Java 编 写 的 ，Groovy，JavaScript 的 或 任何 其 他 脚本 语言 的 几 个 实现 。 我 
们 可 以 通过 以 下 两 种 方式 编译 JRXML 文 件 : 


1. 提供 编程 编译 。 
2. 编译 通过 ANT 任 务 。 


JRXML 提 供 编 程 编 译 


JasperReports 的 API 提 供 了 一 个 门面 类 
net.sf.jasperreports.engine.JasperCompileManager 用 于 编译 JasperReport。 这 个 
类 包含 几 个 公共 静态 方法 编制 的 报告 模板 。 模 板 的 源 可 以 从 文件 ， 输 入 流 ， 内 存 中 
的 对 象 。 


该 jrxml 文 件 (jasper_report_template.jrxml) 的 内 容 如 下 。 它 被 保存 在 目录 C: 
oolsjasperreports-5.0.1 est: 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design/, 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperre; 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://jasperreports.sourceforge.net/jasperrep« 
http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" 
name="jasper_report_template" language="groovy" pageWidth="595" 
pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20' 
topMargin="20" bottomMargin="20"> 


<queryString> 


<! [CDATA[ ]]> 
</queryString> 
<field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ] ]></fieldDescription> 
</field> 
<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 
</field> 
<columnHeader> 
<band height="23"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="3" width="535" 
height="15" backcolor="#70A9A9" /> 
<box> 
«bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<staticText> 
<reportElement x="414" y="3" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
«text»«! [CDATA[Country]]»«/text» 
</staticText> 
<staticText> 
<reportElement x="0" y="3" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Name] ]></text> 
</staticText> 
</band> 
</columnHeader> 
<detail> 
<band height="16"> 
<staticText> 
«reportElement mode-"Opaque" x="0" y="0" width="535" 
height="14" backcolor="#E5ECF9" /> 
«box» 
«bottomPen lineWidth="0.25" lineColor="#CCCCCC" /» 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<textField> 
<reportElement x="414" y="0" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 


</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{country} ] ]> 
</textFieldExpression> 
</textField> 
<textField> 
<reportElement x="0" y="0" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F {name} ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
</jasperReport> 





PER Em. LExhjasper report template.jrxml X: 464 44 iF. 


package com.yiibai; 


import net.sf.jasperreports.engine.JRException; 
import net.sf.jasperreports.engine.JasperCompileManager; 


public class JasperReportCompile { 


public static void main(String[] args) { 
String sourceFileName - "C://tools/jasperreports-5.0.1/test" 
"/jasper report template.jrxml"; 


System.out.println("Compiling Report Design ..."); 
try { 
[pres 
* Compile the report to a file name same as 
* the JRXML file name 
2A 
JasperCompileManager.compileReportToFile(sourceFileName); 
) catch (JRException e) { 
e.printStackTrace(); 
} 


System.out.println("Done compiling!!! ..."); 





模板 编译 


至 于 下 一 步 ， 让 我 们 保存 上 面 的 文件 内 容 C: oolsjasperreports-5.0.1 
estsrccomyiibaiJasperReportCompile.java 并 导入 baseBuild.xml 在 为 下 面 的 
build.xml 文 件 。baseBuild.xml 已 经 编译 和 运行 的 目标 : 


<?xml version="1.0" encoding="UTF-8"?> 
<project name="JasperReportTest" default="run" basedir="."> 


«import file="baseBuild.xml"/> 
</project> 


接 下 来 ， 让 我 们 打开 命令 行 窗 口 并 转 到 build.xml 文 件 放置 的 目录 。 最 后 执行 的 命令 
ant -Dmain-class=com.yiibai.JasperReportCompile 如 下 : 


CA oolsjasperreports-5.0.1 est>ant -Dmain-class-com.yiibai.]J: 
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml 
compile: 

[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:27: 


warning: 'includeantruntime' was not set, defaulting to 
build.sysclasspath-last;set to false for repeatable builds 
[javac] Compiling 1 source file to C: oolsjasperreports-5.0 


run: 
[echo] Runnin class : com.yiibai.JasperReportCompile 
[java] Compiling Report Design ... 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[java] log4j:WARN Please initialize the log4j system properly 
[java] Done compiling!!! 


BUILD SUCCESSFUL 
Total time: 8 seconds 


[gi € ———ÁM—— n] 


正如 上 文 编译 的 结果 ， 会 看 到 jasper_report_template.jasper 得 到 了 语言 生成 的 模板 
文件 在 C: oolsjasperreports-5.0.1 est 目录 。 





预览 编译 报表 模板 
net.sf.jasperreports.view.JasperDesignViewer 正如 在 前 面 的 章节 中 讨论 可 用 来 预 
览 编 译 报告 模板 以 及 JRXML 模 板 。 


为 了 进一步 推动 ， 让 我 们 添加 一 个 新 的 目标 viewDesign 上 述 build.xml 文 件 ， 这 将 让 
我 们 先 看 盾 编 译 报告 。 下 面 是 修改 后 build.xml : 导入 文件 - baseBuild.xml 做 好 环境 
设置 ， 并 应 放置 在 同一 目录 中 的 build.xml。 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewDesign" basedir="."> 


«import file-"baseBuild.xml" /> 
«target name-"viewDesign" description-"Design viewer is launchec 
to preview the compiled report design." 
«java classname-"net.sf.jasperreports.view.JasperDesignViewe! 
fork="true"> 
«arg value="-F${file.name}.jasper" /> 
<classpath refid="classpath" /> 
</java> 
</target> 


</project> 


本 一 一 一 





让 我 们 执行 命令 : ant (viewDesign 是 默认 的 目标 ) ， 在 命令 提示 符 下 。 
JasperDesignViewer 窗 口 打 开 显 示 Jasper 文 件 如 下 : 
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通过 ANT 任 务 编 译 


报告 模板 编译 更 像 是 比 一 个 运行 时 的 工作 设计 时 的 工作 ，JasperReport 库 具有 一 个 
自 定 义 ANT 任 务 。 因 为 当 在 运行 时 创建 JRXML 文 件 某 些 情况 下 ， 不 能 使 用 此 ANT 任 
务 。 自 定义 ANT 任 务 被 称 为 JRC 和 由 类 实现 : 
net.sf.jasperreports.ant.JRAntCompileTask。 其 语法 和 行为 是 非常 相似 的 内 置 
<javac> ANT 任 务 。 


模板 编译 


让 我 们 添加 新 的 目标 编译 报表 设计 ， 以 我 们 现 有 的 build.xml。 这 里 使 用 与 文件 集 的 
柑 套 <src> 标 签 中 指定 的 源 文件 夹 。 岂 套 的 源 标签 人 允许 编译 器 ， 可 通过 许多 不 同 的 
地 点 分 散 ， 在 一 个 单一 的 根 报表 源 文 件 夹 不 进行 分 组 报告 模板 。 下 面 是 修改 后 的 

build.xml : 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default-"compilereportdesing" base 
«import file-"baseBuild.xml" /> 
«target name-"viewDesign" description-"Design viewer is launchec 
to preview the compiled report design." 
«java classname="net.sf.jasperreports.view. JasperDesignViewel 
fork="true"> 
«arg value="-F${file.name}.jasper" /> 
<classpath refid="classpath" /> 
</java> 
</target> 


«target name-"compilereportdesing" description="Compiles the JX) 
file and produces the .jasper file."> 
<taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 


</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
</jrc> 
</target> 
</project> 
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ant (compilereportdesing 是 默认 的 目标 ) 输出 为 如 下 : 





C: oolsjasperreports-5.0.1 est>ant 
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml 


compilereportdesing: 
[jrc] Compiling 1 report design files. 
[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 10g4j:WARN See 
http://logging.apache.org/10g4j/1.2/faq.htmllZnoconfig 
for more info. 
[jrc] File : 
Ct oolsjasperreports-5.0.1 estjasper_report_template. jt 


BUILD SUCCESSFUL 
Total time: 5 seconds 


Fo a 


文件 jasper_report_ template.jasper 是 在 文件 系统 〈 在 我 们 的 例子 中 为 C: 
oolsjasperreports-5.0.1 est 目 录 ) 产生 的 。 这 个 文件 是 相同 的 通过 调用 
net.sf.jasperreports.engine.JasperCompileManager.compileReportToFile()f Fr Æ 
成 一 个 。 我 们 可 以 预览 这 个 jasper 文 件 ， 执 行 ant viewDesign. 





JasperReport 填 充 报表 - JasperReports 教 程 


任何 报告 工具 的 主要 目的 是 为 了 生产 出 高 品质 的 文档 。 举 报 填 充 过程 有 助 于 报告 工 
具 通 过 操纵 数据 集 来 实现 这 一 目标 。 需 要 报表 填充 过 程 的 主要 输入 是 : 


e 报表 模板 : 这 是 实际 的 JasperReport 文 件 


e 报告 参数 : 这 些 所 传递 的 报表 填充 时 间 给 引擎 基本 上 都 是 命名 的 值 。 我 们 将 在 
报表 参数 章节 讨论 。 
e 数据 源 : 我 们 可 以 从 一 系列 像 一 个 SQL 查询 ，XML 文 件 ，CSV 文 件 ， 一 个 
HQL (Hibernate$;4;$ 8) 查询 ，Java Beans 的 集合 等 数据 源 的 填补 Jasper 
这 个 文件 将 详细 讨论 在 报表 数据 源 的 篇 章 。 
这 个 过 程 产生 的 输出 。jrprint 是 一 个 文档 随时 查看 ， 打 印 或 导出 为 其 他 格式 。 外 观 
类 net.sf.jasperreports.engine.JasperFillManager 通 常用 于 填充 一 个 报表 模板 与 数 
据 。 这 个 类 有 各 种 f 册 ReportXXX() 方 法 ， 填 补报 表 模 板 《模板 可 以 位 于 磁盘 上 ， 从 
输入 流 采 集 ， 或 直接 提供 的 内 存 ) 。 


主要 有 两 类 在 此 外 观 类 他 ReportXXX() 方 法 : 


1. 第 一 种 类 型 ， 接 收 java.sql.Connection 对 象 作为 第 三 个 参数 。 大 多 数 情况 下 报 
表 都 充满 了 从 关系 数据 库 中 的 数据 。 这 是 通过 : 


o 通过 JDBC 连 接 到 数据 库 。 

o 包括 报表 模板 中 的 SQL 查 询 。 

o JasperReports 引 擎 使 用 传 入 的 连接 并 执行 SQL 查 询 。 
o 因此 ， 一 个 报表 数据 源 产生 填充 的 报告 。 


2. 第 二 类 ， 收 到 net.sf.jasperreports.engine.JRDataSource 对 象 ， 当 提供 其 他 形 
式 的 数据 来 填补 。 


填充 报告 模板 


让 我 们 来 写 一 个 报表 模板 。 在 JRXML 文 件 (C: oolsjasperreports-5.0.1 
estjasper report template.jrxml) 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design/, 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 
«jasperReport xmlns-"http://jasperreports.sourceforge.net/jasperrej 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://jasperreports.sourceforge.net/jasperrep« 
http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" 
name-"jasper report template" language="groovy" pageWidth="595" 


pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20' 
topMargin="20" bottomMargin="20"> 


<queryString> 
<! [CDATA[]]> 
</queryString> 
<field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ] ]></fieldDescription> 
</field> 
<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 
</field> 
<columnHeader> 
<band height="23"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="3" width="535" 
height="15" backcolor="#70A9A9" /> 
<box> 
«bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<staticText> 
<reportElement x="414" y="3" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
«text»«! [CDATA[Country]]»«/text» 
</staticText> 
<staticText> 
<reportElement x="0" y="3" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Name] ]></text> 
</staticText> 
</band> 
</columnHeader> 
<detail> 
<band height="16"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="0" width="535" 
height="14" backcolor="#E5ECF9" /> 
«box» 
«bottomPen lineWidth="0.25" lineColor="#CCCCCC" /» 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<textField> 


<reportElement x="414" y="0" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{country} ] ]> 
</textFieldExpression> 
</textField> 
<textField> 
<reportElement x="0" y="0" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{name } ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
</jasperReport> 


eR) 





接 下 来 ， 让 我 们 通过 Java 数 据 对 象 (Java bean) 集合 ， 到 Jasper 报 表 引 擎 ， 填 补 
了 这 一 编译 报告 。 


写 一 个 POJO DataBean.java 表 示 数 据 对 象 (Java bean) 。 这 个 类 定义 了 两 个 字符 
串 对 象 名 称 和 国家 。 把 它 保存 到 目录 C: oolsjasperreports-5.0.1 
estsrccomyiibai. 


package com.yiibai; 


public class DataBean { 
private String name; 
private String country; 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 
this.country = country; 
} 


} 


编写 一 个 类 DataBeanList.java 具 有 业务 逻辑 生成 java bean 对 象 的 集合 。 这 是 进 一 
Pease, 生成 报表 。 在 这 里 ， 我 们 添加 在 列表 DataBean 进 行 对 象 。 把 
它 保 存 到 目录 C: oolsjasperreports-5.0.1 estsrccomyiibai. 


package com.yiibai; 
import java.util.ArrayList; 


public class DataBeanList { 
public ArrayList<DataBean> getDataBeanList() { 
ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); 


return dataBeanList; 


j 


VENE 
* This method returns a DataBean object, 
* with name and country set in it. 
TA 
private DataBean produce(String name, String country) ( 
DataBean dataBean - new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 


j 
sd m SE 


编写 一 个 类 DataBeanList.java 具 有 业务 逻辑 生成 java bean 对 象 的 集合 。 这 是 进 一 
ee 生成 报告 。 在 这 里 ， 我 们 添加 在 列表 4 DataBean 进 行 对 
象 。 把 它 保存 到 目录 C: oolsjasperreports-5.0.1 estsrccomyiibai. 


package com.yiibai; 


import java.util.ArrayList; 
import java.util.HashMap; 
import java.util.Map; 


import net.sf.jasperreports.engine.JRException; 
import net.sf.jasperreports.engine.JasperFillManager; 
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource, 


public class JasperReportFill { 
@SuppressWarnings("unchecked" ) 
public static void main(String[] args) { 
String sourceFileName = 
"c://tools/jasperreports-5.0.1/test/jasper_report_template 
DataBeanList DataBeanList = new DataBeanList(); 
ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(: 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters = new HashMap(); 

try { 
JasperFillManager.fillReportToFile( 
sourceFileName, 
parameters, 
beanColDataSource); 

) catch (JRException e) { 
e.printStackTrace(); 





生成 报表 


现在 ， 我 们 将 编译 并 使 用 我 们 的 定期 Ant 构 建 过 程 执行 这 些 文件 。 build.xml 文 件 如 
下 图 所 示 : 


> 导入 文件 - baseBuild.xml 环 境 设 置 ， 并 应 放置 在 同一 目录 中 的 build.xml。 


<?xml version="1.0" encoding="UTF-8"?> 
<project name="JasperReportTest" default="executereport" basedir=" 
«import file-z"baseBuild.xml"/-» 


«target name="executereport" depends="compile, compilereportdesir 
<echo message="Im here"/> 
</target> 
<target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid-"classpath" /> 
«/jrc» 
«/target» 
</project> 


接 下 来 ， 让 我 们 打开 命 合 行 窗口 并 转 到 build.xml 文 件 放 置 的 目录 。 最 后 ， 执 行 命 倒 


ant -Dmain-class=com.yiibai.JasperReportFill (executereport 是 默认 的 目 
标 ) ， 如 下 所 示 : 





e oolsjasperreports-5.0.1 est»ant -Dmain-class-com.yiibai.]J: 
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml 
compile: 

[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:27: 


warning: 'includeantruntime' was not set, defaulting to 
build.sysclasspath-last; set to false for repeatable builds 
[javac] Compiling 1 source file to 

e oolsjasperreports-5.0.1 estclasses 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] log4j:WARN Please initialize the log4j system properly 


BUILD SUCCESSFUL 
Total time: 8 seconds 








如 上 述 执行 结果 的 文件 jasper_report_template.jrprint 是 在 同一 目录 中 为 .jasper 文 件 
(在 这 种 情况 下 ， 它 是 产生 在 C: oolsjasperreports-5.0.1 est). 


JasperReport 查 看 和 打印 报告 - JasperReports 教 
程 


报表 填充 过 程 JasperPrint 对 象 的 输出 可 以 使 用 内 置 的 浏览 器 组 件 来 查看 ， 打 印 或 导 
出 到 更 多 的 流行 的 文件 格式 ， 如 PDF，HTML，RTF，XLS，ODT，CSV 或 XML。 
Jasper 文 件 查 看 和 打印 将 包括 在 本 章 中 。 导 出 将 包括 在 下 一 章 导 出 报表 . 


查看 报表 


JasperReport 提 供 了 一 个 内 置 的 浏览 器 观看 原始 格式 生成 的 报表 。 这 是 一 个 基于 
Swing 的 组 件 和 其 他 Java 应 用 程序 可 以 无 需 PROB US RUBER, AB a Bd 
印 此 集成 组 件 。net.sf.jasperreports.view.JRViewer 类 表示 这 个 可 视 组 件 。 这 个 类 也 
可 以 被 定制 为 每 个 应 用 程序 的 需要 ， 通 过 继承 它 。 


JasperReports 也 有 用 来 查看 报表 的 可 视 化 组 件 Swing 应 用 程序 。 此 应 用 程序 可 以 帮 
助 在 相同 的 格式 查看 报表 为 *.jrprint 就 产生 了 。 这 个 Swing 应 用 程序 是 在 类 
net.sf.jasperreports.view.JasperViewer 实 现 。 要 使 用 此 功能 ， 我 们 可 以 把 这 个 包 成 
一 个 Ant 目 标 ， 以 查看 报表 。 


查看 生成 的 报告 
下 面 的 示例 演示 如 何 查 看 使 用 JasperViewer 类 的 报表 。 


让 我 们 来 写 一 个 报告 模板 。 在 JRXML 文 件 (C: oolsjasperreports-5.0.1 
estjasper_report_template.jrxml) 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design/, 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 
«jasperReport xmlns-"http://jasperreports.sourceforge.net/jasperrej 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://jasperreports.sourceforge.net/jasperrep« 
http://jasperreports.sourceforge.net/xsd/jasperreport .xsd" 
name-"jasper report template" language="groovy" pageWidth="595" 
pageHeight="842" columnWidth="555" leftMargin-"20" rightMargin="20' 
topMargin="20" bottomMargin="20"> 


<queryString> 

<! [CDATA[ ]]> 

</queryString> 

<field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ] ]></fieldDescription> 

</field> 

<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 


</field> 
<columnHeader> 
<band height="23"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="3" width="535" 
height="15" backcolor="#70A9A9" /> 
<box> 
«bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<staticText> 
<reportElement x="414" y="3" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
«text»«! [CDATA[Country]]»«/text» 
</staticText> 
<staticText> 
<reportElement x="0" y="3" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Name] ]></text> 
</staticText> 
</band> 
</columnHeader> 
<detail> 
<band height="16"> 
<staticText> 
«reportElement mode-"Opaque" x="0" y="0" width="535" 
height="14" backcolor="#E5ECF9" /> 
«box» 
«bottomPen lineWidth="0.25" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<textField> 
<reportElement x="414" y="0" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{country} ] ]> 
</textFieldExpression> 
</textField> 
<textField> 
<reportElement x="0" y="0" width="136" height="15" /> 


<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F {name} ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
</jasperReport> 


«| d 








接 下 来 ， 让 我 们 通过 Java 数 据 对 象 (Java bean) 的 集合 ， 到 Jasper 报 表 引 擎 ， 填 
补 了 这 一 编译 报告 。 


写 一 个 POJO DataBean.java 表 示 数 据 对 象 (的 Java bean) 。 这 个 类 定义 了 两 个 字 
符 串 对 象 name 和 country。 把 它 保存 到 目录 C: oolsjasperreports-5.0.1 
estsrccomyiibai. 


package com.yiibai; 


public class DataBean { 
private String name; 
private String country; 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 
this.country = country; 
} 


} 


编写 一 个 类 DataBeanList.java 具 有 业务 逻辑 生成 java bean 对 象 的 集合 。 这 是 进 一 
步 传递 到 Jasper 报表 引擎 ， 生 成 报告 。 在 这 里 ， 我 们 添加 在 列表 中 的 4 个 DataBean 
进行 对 象 。 把 它 保存 到 目录 C: oolsjasperreports-5.0.1 estsrccomyiibai. 


package com.yiibai; 
import java.util.ArrayList; 


public class DataBeanList { 
public ArrayList<DataBean> getDataBeanList() { 
ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); 


return dataBeanList; 


j 


VENE 
* This method returns a DataBean object, 
* with name and country set in it. 
TA 
private DataBean produce(String name, String country) ( 
DataBean dataBean - new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 


} 
hI | 
写 一 个 主 类 文件 JasperReportFill.java， 它 从 类 (DataBeanList) 得 到 的 java bean 


的 集合 ， 并 将 其 传递 到 Jasper 报 表 引 擎 ， 填 补 了 报告 模板 。 把 它 保存 到 目录 C: 
oolsjasperreports-5.0.1 estsrccomyiibai. 


package com.yiibai; 


import java.util.ArrayList; 
import java.util.HashMap; 
import java.util.Map; 


import net.sf.jasperreports.engine.JRException; 
import net.sf.jasperreports.engine.JasperFillManager; 
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource, 


public class JasperReportFill { 
@SuppressWarnings("unchecked" ) 
public static void main(String[] args) { 
String sourceFileName = 
"c://tools/jasperreports-5.0.1/test/jasper_report_template 
DataBeanList DataBeanList = new DataBeanList(); 
ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(: 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters = new HashMap(); 

try { 
JasperFillManager.fillReportToFile( 
sourceFileName, 
parameters, 
beanColDataSource); 

) catch (JRException e) { 
e.printStackTrace(); 





让 我 们 来 写 一 个 目标 viewFillReport 的 build.xml 文 件 。 build.xml 文 件 如 下 所 示 : 
> 导入 文件 - baseBuild.xml 环 境 设置 ， 并 应 放置 在 同一 目录 中 的 build.xml。 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewFillReport" basedir=' 
«import file="baseBuild.xml"/> 


<target name="ViewFillReport" depends="compile, compilereportdes: 
description="Launches the report viewer 
to preview the report stored in the .JRprint file."> 
<java classname="net.sf.jasperreports.view. JasperViewer" forl 
«arg value="-F${file.name}.JRprint" /> 
<classpath refid="classpath" /> 
</java> 
</target> 
<target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
<taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir=","> 
<src> 
<fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid-"classpath" /> 
«/jrc» 
«/target» 
</project> 


| m um 
接 下 来 ， 让 我 们 打开 命令 行 窗 口 并 转 到 build.xml| 文 件 放 置 的 目录 。 最 后 执行 的 命令 


ant -Dmain-class=com.yiibai.JasperReportFill (viewFillReport 是 默认 的 目 
标 ) 。 因 此 ， 我 们 看 到 一 个 JasperViewer 窗 口 ， 如 下 面 的 屏幕 : 








Hioni egy 





打印 报表 


我 们 可 以 使 用 net.sf.jasperreports.engine.JasperPrintManager 类 打印 的 
JasperReports 类 库 生 成 的 文件 (在 他 们 的 专 有 格式 i.eJasperPrint 对 象 )。 这 是 依 
赖 于 Java2 API 打 印 一 个 假象 类 。 我 们 还 可 以 打印 文档 ， 一 旦 JasperReport 的 文档 
导出 为 其 他 格式 ， 如 HTML 或 PDF。 


打印 生成 的 报告 


下 面 的 代码 演示 报表 的 打印 。 让 我 们 更 新 现 有 的 类 JasperReportFil。 我 们 将 使 用 
JasperPrintManager.printReport() 方 法 。 此 方法 需要 源 文 件 名 .jrprint (这 里 我 们 通 
过 我 们 在 上 一 步 生 成 的 使 用 方法 JasperFilIlManager.fillReportToFile()) 作为 第 一 个 
ES 第 二 个 参数 是 布尔 值 ， 用 于 显示 标准 打印 对 话 框 (我 们 将 其 设置 为 true 这 

里 o 


package com.yiibai; 


import java.util.ArrayList; 
import java.util.HashMap; 
import java.util.Map; 


import net.sf.jasperreports.engine.JRException; 

import net.sf.jasperreports.engine.JasperFillManager; 

import net.sf.jasperreports.engine.JasperPrintManager; 

import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource, 


public class JasperReportFill { 

@SuppressWarnings("unchecked" ) 

public static void main(String[] args) { 
String sourceFileName = "c://tools/jasperreports-5.0.1/" + 

"test/jasper_report_template. jasper"; 

String printFileName = null; 
DataBeanList DataBeanList = new DataBeanList(); 
ArrayList <databean>dataList = DataBeanList.getDataBeanList(_ 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters = new HashMap(); 
try { 
printFileName = JasperFillManager .fillReportToFile( 
sourceFileName, 
parameters, 
beanColDataSource); 
if(printFileName != null){ 
JasperPrintManager.printReport( 
printFileName, true); 
} 
} catch (JRException e) { 
e.printStackTrace(); 
} 
} 


}</databean> 


现在 ， 让 我 们 将 此 文件 保存 到 目录 C: oolsjasperreports-5.0.1 estsrccomyiibai. 我 们 
将 使 用 ANT 编 译 并 执行 此 文件 .build.xml 文 件 的 内 容 如 下 : 





<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="executereport" basedir=" 
«import file-z"baseBuild.xml"/» 


«target name="executereport" 
depends="compile, compilereportdesing, run"> 
<echo message="Im here"/> 
</target> 
«target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
<taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
«/jrc» 
«/target» 
</project> 


[ipud SSS 
接 下 来 ， 让 我 们 打开 命令 提示 符 并 转 到 build.xml| 文 件 放 置 的 目录 。 最 后 ， 执 行 命令 


ant -Dmain-class=com.yiibai.JasperReportPrint. 因此 ， 会 出 现 一 个 打印 对 话 
框 。 单 击 确定 以 打印 文档 。 





JasperReport 导 出 报表 - JasperReports 教 程 


我 们 已 经 看 到 在 前 面 的 章节 中 ， 如 何 打印 和 查看 的 JasperReport 生 成 的 文档 。 在 这 
里 ， 我 们 将 看 到 如 何在 其 他 格式 ， 如 PDF，HTML 和 XLS 转换 或 导出 这 些 报告 。 
Facade 类 net.sf.jasperreports.engine.JasperExportManager 提 供 实现 这 一 功能 。 导 
出 方式 转变 JasperPrint 对 象 (.jrprint 文 件 ) 导入 到 不 同 的 格式 。 


下 面 的 代码 (JasperReportExport.java) 演示 了 JasperReport 文 档 的 导出 过 程 。 该 
JasperExportManager 提 供 的 方法 将 报表 导出 成 PDF，HTML 和 XML。 导 出 到 使 用 
的 类 net.sf.jasperreports.engine.export.JRXIsExporter 的 XLS 格式 。 此 代码 生成 以 
下 三 个 文件 : 


e sample_report.pdf 
e sample report.htmll 


e sample report.xls 


导出 为 其 他 格式 


让 我 们 来 写 一 个 报表 模板 。 在 JRXML 文 件 的 内 容 (C: oolsjasperreports-5.0.1 
estjasper_report_template.jrxml) 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design/, 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 
«jasperReport xmlns-"http://jasperreports.sourceforge.net/jasperrej 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://jasperreports.sourceforge.net/jasperrep« 
http://jasperreports.sourceforge.net/xsd/jasperreport .xsd" 
name-"jasper report template" language-"groovy" pageWidth="595" 
pageHeight="842" columnWidth="555" leftMargin-"20" rightMargin="20' 
topMargin="20" bottomMargin="20"> 


<queryString> 

<! [CDATA[]]> 

</queryString> 

<field name="country" class="java.lang.String"> 
<fieldDescription><![CDATA[country]]></fieldDescription> 

</field> 

<field name="name" class="java.lang.String"> 
<fieldDescription><![CDATA[name]]></fieldDescription> 

</field> 

<columnHeader> 

<band height="23"> 

<staticText> 
«reportElement mode="Opaque" x="0" y="3" width="535" 

height="15" backcolor="#70A9A9" /> 


<box> 
«bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<staticText> 
<reportElement x="414" y="3" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
«text»«! [CDATA[Country]]»«/text» 
</staticText> 
<staticText> 
<reportElement x="0" y="3" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Name] ]></text> 
</staticText> 
</band> 
</columnHeader> 
<detail> 
<band height="16"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="0" width="535" 
height="14" backcolor="#E5ECF9" /> 
«box» 
«bottomPen lineWidth="0.25" lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«![CDATA[]]» </text> 
</staticText> 
<textField> 
<reportElement x="414" y="0" width="121" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<![CDATA[$F{country} ] ]> 
</textFieldExpression> 
</textField> 
<textField> 
<reportElement x="0" y="0" width="136" height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F {name} ] ]> 
</textFieldExpression> 
</textField> 


</band> 
</detail> 


</jasperReport> 


‘| 





接着 ，POJO 文 件 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.java 的 内 
容 如 下 : 


package com.yiibai; 


public class DataBean { 


j 


private String name; 
private String country; 


public String getName() ( 


return name; 


public void setName(String name) { 
this.name - name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 
this.country = country; 
} 


文件 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 的 内 容 如 下 : 





package com.yiibai; 


import 


java.util.ArrayList; 


public class DataBeanList { 


public ArrayList«DataBean» getDataBeanList() { 


ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); 


return dataBeanList; 


j 


VENE 
* This method returns a DataBean object, 
* with name and country set in it. 
TA 
private DataBean produce(String name, String country) ( 


写 一 个 主 


DataBean dataBean = new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 


类 文件 JasperReportFiljava， 它 从 类 (DataBeanList) 获取 java beans 


合 ， 并 将 其 传递 到 Jasper 报表 引擎 ， 填 补 了 报表 模板 。 把 它 保 存 到 目录 C: 
oolsjasperreports-5.0.1 estsrccomyiibai. 


packag 


import 
import 
import 


import 
import 
import 
import 
import 
import 


public 
@Su 
pub 


e com.yiibai; 


java.util.ArrayList; 
java.util.HashMap; 


java.util.Map; 


net.sf.jasperreports.engine.JRException; 
net.sf.jasperreports.engine.JRExporterParameter; 
net.sf.jasperreports.engine.JasperExportManager ; 
net.sf.jasperreports.engine.JasperFillManager; 
net.sf.jasperreports.engine.data. JRBeanCollectionDataSource, 
net.sf.jasperreports.engine.export.JRXlsExporter; 


class JasperReportFill { 
ppressWarnings("unchecked" ) 
lic static void main(String[] args) { 
String sourceFileName = "c://tools/jasperreports-5.0.1/" 


+ "test/jasper_report_template.jasper"; 
String printFileName = null; 
DataBeanList DataBeanList = new DataBeanList(); 
ArrayList <databean>dataList = DataBeanList.getDataBeanList(: 
JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters = new HashMap(); 
try { 
printFileName = JasperFillManager.fillReportToFile(sourcel 
parameters, beanColDataSource); 
if (printFileName != null) { 
P REN 
* 1- export to PDF 
uA 
JasperExportManager.exportReportToPdfFile(printFileNam: 
"C://sample report.pdf"); 


RE 
* 2- export to HTML 
5 
JasperExportManager.exportReportToHtmlFile(printFileNar 
"C://sample report.htm11"); 


[Ps 
* 3- export to Excel sheet 
ws 
JRXlsExporter exporter = new JRXlsExporter(); 


exporter.setParameter(JRExporterParameter.INPUT FILE N/ 
printFileName); 

exporter.setParameter(JRExporterParameter.OUTPUT FILE ! 
"C://sample_report.xls"); 


exporter.exportReport(); 
} catch (JRException e) { 
e.printStackTrace(); 
} 
} 


}</databean> 


TEJ E 





在 这 里 ， 我 们 已 经 包括 了 逻辑 Jasper 打印 文件 导出 到 PDF，HTML 和 XLS 格式 。 


生成 报表 


让 我 们 用 我 们 的 常规 Ant 构 建 过 程 编译 和 执行 上 述 文件 。 build.xml 文 件 如 下 图 所 
小 ， 


<?xml version="1.0" encoding="UTF-8"?> 


<project name="JasperReportTest" default="executereport" basedir=" 
«import file-z"baseBuild.xml"/-» 


«target name="executereport" depends="compile, compilereportdesir 
<echo message="Im here"/> 
</target> 
<target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
<jrc destdir="."> 
<src> 
<fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid-"classpath" /> 
«/jrc» 
«/target» 
</project> 





进入 命 
[三 | 


从 
TI 
。 最 后 执行 的 命令 Ec. -Dmain-class-com yiibai.JasperReportFill. 输出 如 下 所 


提示 符 ， 然 后 转 到 目录 C: oolsjasperreports-5.0.1 est， 其 中 build.xml 已 放 


s p e 


C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai. Jé 
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml 


clean-sample: 
[delete] Deleting directory C: oolsjasperreports-5.0.1 esi 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 


compile: 
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasse 
[javac] C: oolsjasperreports-5.0.1 estaseBuild. xml: 28: 
warning: 'includeantruntime' was not set, defaulting t 
[javac] Compiling 4 source files to C: oolsjasperreports-5.t( 


compilereportdesing: 
[jrc] Compiling 1 report design files. 
[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 10g4j:WARN See http://1logging.apache.org/109g4j/1.2/faq 
[jrc] File : C: oolsjasperreports-5.0.1 estjasper repoi 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] log4j:WARN Please initialize the log4j system properly 


executereport: 
[echo] Im here 


BUILD SUCCESSFUL 
Total time: 32 seconds 


| = $ 


正如 上 面 执行 的 结果 ， 会 发 现 三 个 文件 sample_report.pdf，sample_report.htmll, 
sample_report.xls 已 生成 在 C: 目录 . 





JasperReport 报 表 参 效 - JasperReportsAf= 


填充 一 个 报表 的 主要 输入 是 : 报表 模板 ， 参 数 和 数据 源 。 本 章 将 介绍 这 些 参 数 ， 并 
在 接 下 来 的 章节 中 ， 我 们 将 介绍 数据 源 。 

参数 是 在 报表 填充 操作 传递 给 报表 引擎 的 对 象 引 用 。 参 数 传递 有 用 的 数据 到 报表 引 
擎 ， 它 可 以 不 通过 数据 源 来 传递 的 数据 是 有 用 的 。 如 作者 姓名 ， 报 告 等 的 标题 数 
I 0 BB 0 i 
的 元 素 。 


参数 声明 
参数 声明 很 简单 ， 如 下 所 示 : 


<parameter name="exampleParameter" class="java.lang.String" /> 


name 属 性 


parameter> 元 素 的 name 属 性 是 强制 性 的 。 它 通过 名 称 引用 的 参数 在 报表 表达 式 。 
参数 名 应 该 是 一 个 单词 。 它 不 应 该 包含 任何 特殊 字符 ， 如 句号 或 逗号 。 


class 属 性 
class 属 性 也 是 强制 性 的 ， 它 指定 了 参数 值 的 类 名 。 它 的 默认 值 是 java.lang.String。 


这 是 可 以 改变 的 ， 以 在 运行 时 可 用 任何 类 。 不 论 报 表 参 数 的 类 型 ， 引 擎 采用 构造 于 
$P 人 标记 是 用 来 报表 表达 ， 从 而 使 手工 投射 不 必要 。 


AESA 
以 下 是 预定 义 的 报表 参数 ， 准 备 在 表达 式 中 使 用 : 


Parameter Name 


REPORT_PARAMETERS_MAP 


REPORT_CONNECTION 
REPORT_DATA_SOURCE 


REPORT_MAX_COUNT 
REPORT_SCRIPTLET 


REPORT_LOCALE 
REPORT_RESOURCE_BUNDLE 


REPORT_TIME_ZONE 


REPORT_VIRTUALIZER 


REPORT CLASS LOADER 


IS IGNORE PAGINATION 


例子 


描述 
包含 所 有 用 户 定义 和 内 置 参 数 映 身 


这 指向 用 于 JDBC 数 据 源 的 用 户 提 供 
java.sql.Connection 中 


这 是 JRDataSource 代 表 任 一 用 户 提 供 的 实 侈 
的 内 置 的 数据 源 类 型 或 用 户 定义 


这 是 一 个 java.lang.Integer 的 值 ， 从 而 允许 
从 数据 源 限制 记录 。 


这 指向 
net.sf.jasperreports.engine.JRAbstractScrip 
和 包含 报表 的 scriptlet， 由 用 户 提 供 的 一 个 实 


N 


这 是 一 个 java.util.Locale 的 实例 ， 包 含 资源 
需 的 语言 环境 


这 指向 java.util.ResourceBundle 对 象 科 包 合 
地 化 的 消息 


这 是 一 个 java.util.TimeZone 的 实例 ， 用 于 日 
格式 


这 是 
net.sf.jasperreports.engine.JRVirtualizerobj 
一 个 实例 ， 以 及 用 于 网 页 的 虚拟 化 〈 优 化 内 
消耗 ) 


这 是 在 报告 充填 过 程 中 使 用 的 加 载 ， 如 图 像 ， 
字体 和 子 报表 模板 资源 java.lang.ClassLoad 
的 实例 


如 果 设 置 为 java.lang.Boolean.TRUE 报 告 将 ; 
一 个 很 长 的 网 页 和 分 页 符 来 产生 不 会 发 生 


让 我 们 通过 ReportTitle 和 Author 报 表 (由 JasperReportFill.java 生 成 ) 。 经 修订 的 
文件 C: oolsjasperreports-5.0.1 estsrccomyiibaiJasperReportFill.java 如 下 : 


packag 


import 
import 
import 


import 
import 
import 


public 
@Su 
pub 


e com.yiibai; 


java.util.ArrayList; 
java.util.HashMap; 
java.util.Map; 


net.sf.jasperreports.engine.JRException; 
net.sf.jasperreports.engine.JasperFillManager; 
net.sf.jasperreports.engine.data. JRBeanCollectionDataSource, 


class JasperReportFill { 
ppressWarnings("unchecked" ) 
lic static void main(String[] args) { 
String sourceFileName = 
"C://tools/jasperreports-5.0.1/test/jasper_report_template. ,ji 


DataBeanList DataBeanList = new DataBeanList(); 
ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(_ 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters - new HashMap(); 
VER 
* Passing ReportTitle and Author as parameters 
wy 
parameters.put("ReportTitle", "List of Contacts"); 
parameters.put("Author", "Prepared By Manisha"); 


try { 
JasperFillManager .fillReportToFile( 


sourceFileName, parameters, beanColDataSource); 
) catch (JRException e) { 
e.printStackTrace(); 





POJO 文 件 的 内 容 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.java 如 下 
所 示 : 


package com.yiibai; 


public class DataBean { 
private String name; 
private String country; 


public String getName() { 


return name; 


public void setName(String name) { 
this.name - name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 


this.country = country; 
} 


文件 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 的 内 容 如 
F: 


package com.yiibai; 
import java.util.ArrayList; 


public class DataBeanList { 
public ArrayList<DataBean> getDataBeanList() { 
ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); 


return dataBeanList; 


j 


VENE 
* This method returns a DataBean object, 
* with name and country set in it. 
TA 
private DataBean produce(String name, String country) ( 
DataBean dataBean - new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 


让 我 们 添加 参数 <ReportTitle> 和 <AUTHOR> 我 们 现 有 的 报告 模板 ( 章 报表 设 

it) 。 报 告 标题 和 作者 将 在 报表 的 开头 显示 。 修 订 后 的 报告 模板 

(jasper report template.jrxml) 如 下 。 将 其 保存 到 C: oolsjasperreports-5.0.1 est 
目录 : 


<?xml version="1.0"?> 

<!DOCTYPE jasperReport PUBLIC 

"//JasperReports//DTD Report Design//EN" 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 


«jasperReport xmlns="http://jasperreports.sourceforge.net/jasperre; 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://jasperreports.sourceforge.net/jasperrep« 
http://jasperreports.sourceforge.net/xsd/jasperreport. xsd" 
name="jasper_report_template" pageWidth="595" 

pageHeight="842" columnWidth="515" 

leftMargin="40" rightMargin="40" topMargin="50" bottomMargin="50"> 
«parameter name="Author" class="java.lang.String"/>** 


<queryString> 
<! [CDATA[ ]]> 


</queryString> 


<field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ] ]></fieldDescription> 
</field> 


<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 
</field> 


<title> 
<band height="70"> 
<line> 
<reportElement x="0" y="0" width="515" 
height="1"/> 
</line> 
<textField isBlankWhenNull-"true" bookmarkLevel="1"> 
<reportElement x="0" y="10" width="515" 
height="30"/> 
<textElement textAlignment-"Center"- 
<font size="22"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<![CDATA[$P{ReportTitle}] ]> 
</textFieldExpression> 
<anchorNameExpression><! [CDATA["Title" ] ]> 
</anchorNameExpression> 
</textField> 
<textField isBlankWhenNull="true"> 
«reportElement x="0" y="40" width="515" height="20"/> 
«textElement textAlignment="Center'"> 
<font size="10"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$P{Author}] ]> 
</textFieldExpression> 
</textField> 
</band> 
</title> 


<columnHeader> 
«band height="23"> 
<staticText> 

«reportElement mode="Opaque" x="0" y="3" 
width="535" height="15" 
backcolorz'"470A9A9" /> 
<box> 
<bottomPen lineWidth="1.0" 
lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
<text><! [CDATA[]]» 
</text> 


</staticText> 

<staticText> 
«reportElement x="414" y="3" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 

<font isBold="true" /> 

</textElement> 
<text><! [CDATA[Country] ]></text> 

</staticText> 

<staticText> 
<reportElement x="0" y="3" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 

<font isBold="true" /> 

</textElement> 
<text><! [CDATA[Name] ]></text> 

</staticText> 

</band> 
</columnHeader> 


<detail> 
<band height="16"> 
<staticText> 
«reportElement mode-"Opaque" x="0" y="0" 
width="535" height="14" 
backcolor="#E5ECF9" /> 
<box> 
«bottomPen lineWidth="0.25" 
lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
<text><! [CDATA[] ]> 
</text> 
</staticText> 
<textField> 
«reportElement x="414" y="0" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{country}] ]> 
</textFieldExpression> 
</textField> 
<textField> 
<reportElement x="0" y="0" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 


<! [CDATA[$F {name} ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
</jasperReport> 


‘| 


报表 生成 


编译 和 执行 使 用 常规 Ant 构 建 过 程 上 面 的 文件 。 build.xml 文 件 中 的 内 容 (根据 目录 
保存 C: oolsjasperreports-5.0.1 est) 情况 如 下 。 


> 导入 文件 - baseBuild.xml 可 以 从 环境 设置 章节 中 了 解 ， 并 应 放置 在 同一 目录 中 的 
build.xml, 








<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewFillReport" basedir=' 
«import file-"baseBuild.xml" /> 
«target name="viewFillReport" 
depends="compile, compilereportdesing, run" 
description="Launches the report viewer to preview 
the report stored in the .JRprint file."- 
«java classname="net.sf.jasperreports.view. JasperViewer" 
fork="true"> 
<arg value="-F${file.name}.JRprint" /> 
<classpath refid="classpath" /> 
</java> 
</target> 
«target name-"compilereportdesing" 
description-"Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
<SrC> 
<fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
«/jrc» 
«/target» 
</project> 








‘| 





接 下 来 ， 让 我 们 打开 命令 行 窗 口 并 转 到 build.xml 文 件 放置 的 目录 。 最 后 执行 的 命令 
ant -Dmain-class=com.yiibai.JasperReportFill (viewFullReport 是 默认 的 目 
标 ) ， 如 下 所 示 : 


C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai. Jt 
Buildfile: C: oolsjasperreports-5.0.1 estuild. xml 
clean-sample: 
[delete] Deleting directory C: oolsjasperreports-5.0.1 esi 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper_re 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
compile: 
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasse 
[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:28: w 


'includeantruntime' was not set, defaulting to build.sysclassp: 
set to false for repeatable builds 
[javac] Compiling 7 source files to C: oolsjasperreports-5.( 


compilereportdesing: 
[jrc] Compiling 1 report design files. 
[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 10g4j:WARN See http://1logging.apache.org/109g4j/1.2/faq 
for more info. 
[jrc] File : C: oolsjasperreports-5.0.1 estjasper repoi 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] log4j:WARN Please initialize the log4j system properly 


viewFillReport: 
[java] 1og4j :WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] 109g4j:WARN Please initialize the log4j system properly 


BUILD SUCCESSFUL 
Total time: 18 seconds 





正如 上 文 编 译 的 结果 ，JasperViewer 窗 口 打开 如 下 面 的 屏幕 : 


TutorialsPoint Java 技术 教程 


DEN &i&le ir 





List of Contacts 


Prepwed gy Manisha 








Vy eon 


在 这 里 ， 我 们 看 到 的 是 ， 报 表 头 "List Of Contacts"， 并 着 有 "Prepared By 
Manisha" 显示 在 报表 的 开头 。 
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数据 源 的 结构 数据 容器 。 同 时 生成 报告 ，Jasper 报 表 引 擎 获得 来 自 数据 源 的 数据 。 
数据 可 以 从 数据 库 ，XML 文 件 ， 对 象 数组 和 集合 中 的 对 象 来 获得 。 我 们 将 在 本 章 填 
充 报 告 所 看 到 的 f 仙 ReportXXX() 方 法 ， 预 计 将 收 到 该 报告 的 数据 源 其 以 填充 ， 在 
net.sf.jasperreports.engine.JRDataSource 对 象 或 一 个 java.sql.Connection 中 的 形式 


( 当 报 表 数 据 在 关系 数据 库 中 找到 ) 。 
JRDataSource 接 口 只 有 两 个 方法 ， 这 应 该 被 实现 : 

1. public boolean next() throws JRException; 

2. public Object getFieldValue(JRField jrField) throws JRException; 


从 数据 源 中 检索 数据 的 唯一 方法 是 通过 使 用 报表 字段 。 有 一 个 JRDataSource 接 口 
的 几 个 默认 的 实现 ， 根 据 不 同 的 数据 源 中 的 记录 被 获得 的 方式 。 


数据 源 的 实现 


下 表 总 结 了 数据 源 和 它们 的 实现 类 。 


Datasource Implementation Class 
JDBC net.sf.jasperreports.engine.JRResultSetDataSource 
qe net.sf.jasperreports.engine.data. JRBeanCollectionDataSource, 


net.sf.jasperreports.engine.data. JRBeanArrayDataSource 


net.sf.jasperreports.engine.data. JRMapArrayDataSource, 


Map pasen net.sf.jasperreports.engine.data.JRMapCollectionDataSource 


TableModel net.sf.jasperreports.engine.data.JRTableModelDataSource 


XML net.sf.jasperreports.engine.data. JRXmlDataSource 

CSV net.sf.jasperreports.engine.data. JRCsvDataSource 

XLS net.sf.jasperreports.engine.data. JRXIsDataSource 

Empty net.sf.jasperreports.engine. JREmptyDataSource 
JDBC?2X a 


JRResultSetDataSource 类 关联 入 一 个 java.sql.ResultSet 对 象 。 这 是 当 报 表 数 据 从 
关系 数据 库 中 提取 最 常用 的 数据 源 实现 。 如 果 ajava.sql.Connection 传 递 给 引擎 来 代 
替 ， 它 首先 执行 相关 的 查询 ， 并 将 该 返回 java.sql.ResultSet 中 的 对 象 在 一 个 
JRResultSetDataSource 实 例 。 


JAVABEAN 数 据 来 源 


JRBeanArrayDataSource 类 和 JRBeanCollectionDataSource 表 示 实 现 ， 可 以 分 别 
包装 的 JavaBean 对 象 的 数组 或 集合 。 数 组 或 集合 中 的 每 个 对 象 都 将 被 视 为 对 这 种 
类 型 的 数据 源 中 的 一 个 记录 。 一 个 特定 的 JavaBean 属 性 和 相应 的 报表 字段 之 间 的 
映射 是 通过 命名 约定 进行 。 报 表 字 上段 的 名 称 必须 是 相同 的 所 指定 的 JavaBeans 的 规 
范 JavaBean 属 性 的 名 称 。 


> 在 本 教程 中 的 所 有 例子 中 ， 我 们 使 用 JRBeanCollectionDataSource。 


基于 MAP 的 数据 来 源 


如 果 父 级 应 用 程序 已 经 存储 在 内 存 中 的 java.util.Map 对 象 提供 的 申报 数据 的 实现 类 
JRMapArrayDataSource 和 JRMapCollectionDataSource 非 常 有 用 。 被 包装 的 数组 
或 集合 中 的 每 个 映射 对 象 被 认为 是 数据 源 中 的 一 个 虚拟 的 记录 ， 每 个 报表 字段 的 值 
从 映射 中 使 用 报表 字段 名 作为 键 提取 。 


TableModel 的 数据 来 源 

在 许多 客户 端 应 用 程序 ， 数 据 以 表格 形式 显示 。 在 许多 应 用 中 常见 的 需求 是 允许 用 
户 打印 该 表格 形式 的 报告 。 实 现 类 JRTableModelDataSource 使 生成 的 表格 格式 的 
Swing 应 用 程序 报告 的 任务 。 这 个 类 封装 了 一 个 javax.swing.table.TableModel 对 
象 。 列 在 包装 的 TableModel 对 象 可 以 通过 他 们 的 名 字 或 他 们 的 基于 0 索引 来 访问 。 
XML 数据 源 

类 JRXmlDataSource 是 基于 DOM， 它 使 用 XPath 表达 式 来 选择 XML 文档 数据 的 数据 
源 的 实现 。 XML 数据 源 中 的 记录 是 通过 XPath 表达 式 选 择 的 节点 元 素 表示 。 字 段 值 
是 由 每 个 记录 使 用 由 字段 描述 (JRXML<fieldDescription> 元 素 ) 所 提供 的 XPath 表 
> XPath 是 用 于 导航 XML 文档 的 属性 和 元 素 的 语言 。 有 关 XPath 更 多 信息 可 以 在 这 里 
找到 http://www.w3.org/TR/xpath. 

CSV 数 据 来 源 

JRCsvDataSource 代表 了 从 结构 化 文本 文件 中 检索 其 数据 的 数据 源 的 实现 ， 通 常 
为 CSV。 字 段 值 是 正在 使 用 他 们 的 列 索 引 检 索 。 

xls 数 据 来 源 

JRXIsDataSource 代表 其 检索 的 Excel 文 件 的 数据 的 数据 源 的 实现 。 报 表 字 段 映 射 
为 这 个 数据 源 的 实现 也 是 基于 字段 列 索 引 。 


空 数据 来 源 


类 JREmptyDataSource， 模 拟 与 内 部 虚拟 空 的 记录 给 定数 量 的 数据 源 。 它 是 由 用 户 
界面 的 工具 来 提供 基本 的 报表 预览 功能 ， 或 在 特殊 报告 模板 ， 或 用 于 测试 和 调试 目 
的 。 


重 绕 数 据 源 


net.sf.jasperreports.engine.JRRewindableDataSource 扩 展 的 基本 
JRDataSourceinterface。 它 增加 了 只 有 一 个 方法 为 MoveFirst() 到 接口 。 这 种 方法 的 
目的 是 将 光标 移动 到 数据 源 中 的 第 一 个 元 素 。 

与 放置 在 带 内 子 报表 不 允许 拆 分 由 于 isSplitAllowed=“false” 的 设 定 ， 并 且 没 有 足够 
的 空间 ， 在 当前 页 上 对 要 呈现 的 子 报表 工作 时 ， 重 绕 的 数据 源 是 有 用 的 。 


以 上 所 有 数据 源 的 实现 是 可 回 退 除 JRResultSetDataSource， 因 为 它 不 支持 移动 记 
录 指 针 回 来 。 这 对 只 有 当 该 数据 源 是 用 它 传递 给 子 报表 之 前 手动 换 一 个 
java.sql.ResultSet 中 的 一 个 问题 。 这 是 没有 问题 ， 如 果 SQL 查 询 驻 留 在 子 报表 模 
板 ， 该 引擎 将 在 下 一 个 页 面 上 重新 启动 子 报 表 时 ， 再 次 执行 它 。 


数据 源 提供 者 


JasperReports 库 有 一 个 接口 net.sf.jasperreports.engine.JRDataSourceProvider。 

这 有 助 于 创建 和 处 理 数据 源 对 象 。 当 创建 使 用 GUI 工 具 报 表 模 板 ， 则 需要 自 定义 报 
表 的 数据 源 的 特殊 工具 。JRDataSourceProvider 是 为 了 堵塞 自 定义 数据 源 到 设计 工 
具 的 标准 方法 。 自 定义 实现 该 接口 应 实现 以 下 方法 ， 使 创建 和 配置 数据 源 对 象 和 方 
法 ， 上 面 列 出 数据 源 如 果 可 能 的 话 ， 里 面 可 用 的 报表 字段 : 


public boolean supportsGetFieldsOperation(); 


public JRField[] getFields(JasperReport report) 
throws JRException, UnsupportedOperationException; 


public JRDataSource create(JasperReport report) throws JRExceptic 


public void dispose(JRDataSource dataSource) throws JRException; 


imm—————M—— — — n 
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报表 字段 是 代表 数据 源 和 报表 模板 之 间 的 数据 映射 元 素 。 字 段 可 以 在 报告 中 的 表达 
式 进行 组 合 ， 以 获得 所 需 的 输出 。 报 表 模 板 可 以 包含 雳 个 或 更 多 的 <field> 元 素 。 当 
声明 报表 字段 ， 数 据 源 应 提供 相应 的 数据 到 所 有 在 报告 模板 中 定义 的 字段 。 


字段 声明 做 如 下 : 


<field name="FieldName" class="java.lang.String"/> 


name 属 性 
<field> 元 素 的 name 属 性 是 强制 性 的 。 它 通过 名 称 引 用 的 报表 表达 的 字段 。 


class 属 性 


class 属 性 指定 的 字段 值 的 类 名 。 它 的 默认 值 是 java.lang.String。 这 是 可 以 改变 的 ， 
以 在 运行 时 可 用 任何 类 。 不 论 一 个 报表 字段 的 类 型 ， 引 擎 采用 铸造 于 该 $F 标记 用 
于 报表 表达 式 ， 从 而 使 手工 投射 不 必要 。 


字段 摘 述 


<fieldDesciption> 元 素 是 可 选 元 素 。 实 现 自 定义 的 数据 源 ， 例 如 ， 当 这 是 非常 有 用 
的 。 我 们 可 以 存储 一 个 密 钥 或 一 些 信息 ， 使 用 它 我 们 可 以 在 运行 时 自 定义 数据 源 中 
检索 字段 的 值 。 通 过 使 用 <fieldDesciption> 元 素 而 不 是 字段 名 ， 可 以 检索 从 数据 源 
中 的 字段 值 时 容易 克服 字段 命名 约定 的 限制 。 


下 面 是 一 段 代 码 从 我 们 现 有 的 jrxml 文 件 〈 第 二 章 报 告 的 设计 ) 。 在 这 里 我 们 可 以 看 
到 name, class 和 fieldDescription 元 素 的 使 用 。 


<field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ]]></fieldDescription> 

</field> 

<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 

</field> 


排序 字段 


数据 的 排序 是 必要 的 ， 数 据 源 实现 不 支持 它 (如 CSV 数 据 源 ) ，JasperReports 的 
支持 在 内 存 领域 为 基础 的 数据 源 排序 。 排 序 可 以 使 用 的 报表 模板 的 一 个 或 多 个 
<sortField> 元 素来 完成 。 


如 果 指 定 ATLEAST1 排 序 字 段 ， 在 报告 填充 过 程 中 的 数据 源 传递 给 
JRSortableDataSource 实 例 。 这 反 过 来 从 获取 数据 源 中 的 所 有 记录 ， 根 据 指 定 的 字 
段 进 行 排序 的 内 存 中 ， 并 蔡 换 原来 的 数据 源 。 


排序 字段 名 称 应 该 是 相同 的 报表 字段 名 称 。 用 于 排序 的 字段 应 该 具有 实现 
java.util.Comparable 类 型 。 进 行 自 然 顺序 排序 的 所 有 字段 除外 java.lang.String 类 型 
(对 于 字符 串 类 型 ， 对 应 报告 的 填充 区 域 自动 分 页 使 用 ) 。 当 有 多 个 排序 字段 指 
定 ， 排 序 将 使 用 的 字段 进行 中 它们 出 现在 报告 模板 的 顺序 排序 键 。 下 面 的 例子 
demonstartes 显 示 排 序 功 能 。 


Sorted Report 例子 


sortField> 元 素 添加 到 我 们 现 有 的 报告 模板 (第 报表 设计 ) 。 让 我 们 排序 字段 
country 降序 排列 。 修 订 后 的 报告 模板 (jasper_report_template.jrxml) 如 下 。 将 其 
保存 到 C: oolsjasperreports-5.0.1 est directory: 


<?xml version="1.0"?> 

<!DOCTYPE jasperReport PUBLIC 

"//JasperReports//DTD Report Design//EN" 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 


«jasperReport xmlns="http://jasperreports.sourceforge.net/jasperre; 
<parameter name="ReportTitle" class="java.lang.String"/> 
<parameter name="Author" class="java.lang.String"/> 
<queryString> 
«1[CDATA[]]» 
«/queryString» 
«field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ] ]></fieldDescription> 
</field> 
<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 
</field> 
**<sortField name="country" order="Descending"/> 
<sortField name="name"/>** 
<title> 
<band height="70"> 
<line> 
<reportElement x="0" y="0" width="515" 
height="1"/> 
</line> 
<textField isBlankWhenNull-"true" bookmarkLevel="1"> 
<reportElement x="0" y="10" width="515" 
height="30"/> 
<textElement textAlignment="Center'"> 
<font size="22"/> 


</textElement> 


<textFieldExpression class="java.lang.String"> 
<![CDATA[$P{ReportTitle}] ]> 
</textFieldExpression> 
<anchorNameExpression><! [CDATA["Title" ] ]> 


</anchorNameExp 
</textField> 


ression> 


<textField isBlankWhenNull="true"> 


<reportElement 


x="0" y="40" width="515" height="20"/> 


«textElement textAlignment="Center'"> 
<font size="10"/> 


</textElement> 
<textFieldExpre 
<! [CDATA[$P{Aut 


ssion class="java.lang.String"> 
hor}]]> 


</textFieldExpression> 


</textField> 
</band> 
</title> 
<columnHeader> 
<band height="23"> 
<staticText> 


<reportElement mode="Opaque" x="0" y="3" 


width="535" 


height="15" 


backcolor="#70A9A9" /> 


<box> 


<bottomPen lineWidth="1.0" 


lineColor="#CCC 
</box> 
<textElement /> 
<text><! [CDATA[ 
</text> 
</staticText> 
<staticText> 
<reportElement 
height="15" /> 
<textElement te 
verticalAlignme 
<font is 
</textElement> 
«text»«! [CDATA[ 
«/staticText» 
<staticText> 
<reportElement 
height="15" /> 
<textElement te 
verticalAlignme 
<font isBold 
</textElement> 
<text><! [CDATA[ 
</staticText> 
</band> 
</columnHeader> 
<detail> 


ccc" /> 


]]> 


x="414" y="3" width="121" 
xtAlignment="Center" 
nt="Middle"> 

Bold="true" /> 


Country]]»«/text» 


x="0" y="3" width="136" 
xtAlignment="Center" 
nt="Middle"> 

="true" /> 


Name] ]></text> 


<band height="16"> 
<staticText> 
<reportElement mode-"Opaque" x="0" y="0" 
width="535" height="14" 
backcolor="#E5ECF9" /> 
<box> 
«bottomPen lineWidth="0.25" 
lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
<text><! [CDATA[]]» 
</text> 
</staticText> 
<textField> 
<reportElement x="414" y="0" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<![CDATA[$F{country} ] ]> 
</textFieldExpression> 
</textField> 
<textField> 
«reportElement x="0" y="0" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F {name} ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
</jasperReport> 


4 _ E 


在 java 代 码 报告 填充 保持 不 变 。 该 文件 C: oolsjasperreports-5.0.1 
estsrccomyiibaiJasperReportFill. java 的 内 容 如 下 : 





packag 


import 
import 
import 


import 
import 
import 


public 
@Su 
pub 


e com.yiibai; 


java.util.ArrayList; 
java.util.HashMap; 
java.util.Map; 


net.sf.jasperreports.engine.JRException; 
net.sf.jasperreports.engine.JasperFillManager; 
net.sf.jasperreports.engine.data. JRBeanCollectionDataSource, 


class JasperReportFill { 
ppressWarnings("unchecked" ) 
lic static void main(String[] args) { 
String sourceFileName = 
"C://tools/jasperreports-5.0.1/test/jasper_report_template. ,ji 


DataBeanList DataBeanList = new DataBeanList(); 
ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(_ 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters - new HashMap(); 
VER 
* Passing ReportTitle and Author as parameters 
uA 
parameters.put("ReportTitle", "List of Contacts"); 
parameters.put("Author", "Prepared By Manisha"); 


try { 
JasperFillManager.fillReportToFile( 


sourceFileName, parameters, beanColDataSource); 
) catch (JRException e) { 
e.printStackTrace(); 





POJOX FC: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.javaB S 5 #40 
F: 


package com.yiibai; 


public class DataBean { 
private String name; 
private String country; 


public String getName() { 


return name; 


public void setName(String name) { 
this.name - name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 


this.country = country; 
} 


文件 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 的 内 容 如 
F: 


package com.yiibai; 
import java.util.ArrayList; 


public class DataBeanList { 
public ArrayList<DataBean> getDataBeanList() { 
ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); 


return dataBeanList; 


j 


VENE 
* This method returns a DataBean object, 
* with name and country set in it. 
TA 
private DataBean produce(String name, String country) ( 
DataBean dataBean - new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 


j 
Rb | 


报表 生成 
我 们 将 编译 和 执行 使 用 我 们 常规 Ant 构 建 过 程 上 面 的 文件 。 build.xml 文 件 (目录 下 
保存 的 内 容 C: oolsjasperreports-5.0.1 est) 如 下 : 


> 导入 文件 - baseBuild.xml 从 环境 设置 章节 中 了 解 ， 并 应 放置 在 同一 目录 中 的 
build.xml. 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewFillReport" basedir=' 
«import file-"baseBuild.xml" /> 
«target name="viewFillReport" 
depends="compile, compilereportdesing, run" 
description="Launches the report viewer to preview 
the report stored in the .JRprint file."> 
<java classname="net.sf.jasperreports.view. JasperViewer" 
fork="true"> 
<arg value="-F${file.name}.JRprint" /> 
<classpath refid="classpath" /> 
</java> 
</target> 
«target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
«/jrc» 
«/target» 
</project> 


aE 
接 下 来 ， 打 开 命 邻 行 窗口 并 转 到 build.xml 文 件 放置 的 目录 。 最 后 执行 命令 ant - 


Dmain-class=com.yiibai.JasperReportFi (viewFullReport 是 默认 的 目标 ) , 
如 下 所 示 : 





C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai. Jé 


Buildfile: C: oolsjasperreports-5.0.1 estuild. xml 
clean-sample: 
[delete] Deleting directory C: oolsjasperreports-5.0.1 esi 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
compile: 
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasse 
[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:28: w 


'includeantruntime' was not set, defaulting to build.sysclassp: 
set to false for repeatable builds 
[javac] Compiling 7 source files to C: oolsjasperreports-5.( 


compilereportdesing: 
[jrc] Compiling 1 report design files. 
[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 109g4j:WARN See http://1logging.apache.org/109g4j/1.2/faq 
for more info. 
[jrc] File : C: oolsjasperreports-5.0.1 estjasper repoi 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] 109g4j:WARN Please initialize the log4j system properly 


viewFillReport: 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] log4j:WARN Please initialize the log4j system properly 


BUILD SUCCESSFUL 
Total time: 18 seconds 


ss SS 
正如 上 文 编 译 的 结果 ， 一 个 JasperViewer 窗 口 打 开 如 下 面 的 屏幕 : 
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V.Anand NN 
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EFE 
Page 4 ol 1 pe 


在 这 里 ， 我 们 可 以 看 到 ，country 排 列 的 字母 顺序 降序 排列 。 
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报表 表达 式 是 JasperReports 使 我 们 能 够 显示 在 报表 上 的 数据 计算 的 强大 功能 。 计 
算出 数据 不 是 一 个 静态 数据 ， 并 和 且 不 要 特别 的 撤 实 参数 或 数据 源 字段 位 闻 的 数据 。 
报表 表达 式 是 由 组 合 报表 参数 ， 字 段 和 静态 数据 。 默 认 情 况 下 ，Java 语 言 是 用 于 编 
写 报 表 的 表达 式 。 其 他 脚本 语言 如 Groovy 脚 本 语言 ，JavaScript 或 BeanShell 脚 
本 ， 报 表 表 达 式 是 由 JasperReports 编 译 器 支持 。 


本 章 将 解释 如 何 报表 表达 式 工 作假 设 他 们 一 直 只 用 Java 语 言 编写 的 。 在 JRXML 报 表 
模板 ， 那 里 有 定义 表达 式 几 个 元 素 ， 如 下 所 示 : 


e <variableExpression> 

e <initialValueExpression> 
e <groupExpression> 

e <printWhenExpression> 
e <imageExpression> 


e <textFieldExpression> 


声明 表达 式 
基本 上 ， 所 有 的 报表 表达 式 是 可 以 参考 的 报表 字段 ， 报 表 变 量 和 报表 参数 Java 表 达 


字段 引用 表达 式 


使 用 在 表达 式 中 一 个 报表 字段 参考 ， 字 上 段 的 名 称 必须 放 在 $F{ 和 } 字 符 序 列 之 间 ， 如 
下 图 所 示 。 


<textfieldexpression> 
$F {Name} 
</textfieldexpression> 


下 面 是 一 段 代 码 从 我 们 现 有 的 jrxml 文 件 ， 从 报表 设计 章节 中 了 解 : 


<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{country}]]> 
</textFieldExpression> 


引用 在 表达 式 中 的 变量 ， 我 们 必须 把 像 在 下 面 的 例子 中 的 变量 名 放 在 $V{ 和 } 之 间 : 


<textfieldexpression> 
"Total height : " + $V{SumOfHeight} + " ft." 
</textfieldexpression> 


参数 参考 表达 


引用 在 表达 式 中 的 一 个 参数 ， 该 参数 的 名 称 应 放 在 $ P{ 和 } 之 间 ， 如 下 面 的 例子 : 


<textfieldexpression> 
"ReportTitle : " + $P{Title} 
</textfieldexpression> 


下 面 是 一 段 代 码 从 现 有 的 jrxml 文 件 ， 这 用 来 表示 参数 在 表达 式 中 引用 。 


<textField isBlankWhenNull="true" bookmarkLevel="1"> 
<reportElement x="0" y="10" width="515" height="30"/> 
<textElement textAlignment="Center"> 
<font size="22"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$P{ReportTitle}]]> 
</textFieldExpression> 
<anchorNameExpression> 
<![CDATA["Title"]]> 
</anchorNameExpression> 
</textField> 
<textField isBlankWhenNull="true"> 
«reportElement x="0" y="40" width="515" height="20"/> 
«textElement textAlignment="Center"> 
<font size="10"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$P {Author} ] ]> 
</textFieldExpression> 
</textField> 


正如 在 上 面 看 到 ， 参 数 ， 字 段 和 变量 引用 ， 其 实 是 真正 的 Java 对 象 。 从 参数 ， 字 段 
或 在 报表 模板 所 作 的 变量 声明 知道 他 们 的 类 ， 基 至 可 以 在 表达 式 中 调用 的 对 象 引用 
的 方法 。 


下 面 的 示例 演示 如 何 提取 并 显示 java.lang.String 报 表 字 段 的 第 一 个 字母 "Name": 


<textFieldExpression> 
$F{Name}.substring(0, 1) 
</textFieldExpression> 


引用 在 表达 式 中 的 资源 ， 关 键 要 $R{ 和 } 之 间 放 像 下 面 的 例子 : 


<textfieldexpression> 
$R{report. title} 
</textfieldexpression> 


基于 运行 时 提供 的 语言 环境 和 report.title 键 ， 报 表 模 板 相关 的 资源 包 加 载 。 因 此 ， 
报表 标题 是 从 资源 包 中 提取 字符 串 值 显示 。 更 多 关于 国际 化 可 以 在 国际 化 一 章 中 找 


到 。 
计算 器 


计算 器 是 JasperReports， 其 计算 表达 式 和 增 量 交 量 或 数据 集 在 报表 填充 时 间 的 实 
体 。 在 编译 过 程 中 ， 信 息 被 产生 并 存储 在 由 编译 器 在 编译 报表 。 在 报表 ， 填 充 时 间 
此 信息 用 于 构建 net.sf.jasperreports.engine.fill.JRCalculator 类 的 一 个 实例 。 


Java 源 文件 生成 ， 并 通过 对 飞 基于 Java 的 报表 编译 器 编译 。 这 个 生成 的 类 是 
JRCalculator 子 类 ， 并 通过 将 其 编译 产生 的 字 节 码 存 储 在 JasperReport 对 象 的 内 
部 。bytcode 被 加 载 在 报表 填充 时 间 和 由 此 产生 的 类 被 实例 化 ， 以 获得 所 需 的 表达 
式 求 值 计算 器 对 象 。 


条 件 表达 式 


定义 变量 表达 式 时 ，Jasper 报 表 不 支持 if-else 语 句 。 相 反 ， 可 以 使 用 三 元 运算 符 
{cond}? 6&1) : { 语 句 2}。 可 以 伐 套 这 个 操作 符 Java 表 达 式 里 面 获 得 基于 多 个 条 
件 所 需 的 输出 。 


在 报表 条 件 表 达 式 的 示例 


让 我 们 修改 现 有 报告 的 模板 (第 报表 设计 ) ， 并 增加 对 country 条 件 表 达 式 。 修 订 后 
的 报表 模板 (jasper_report_template.jrxml) 如 下 。 将 其 保存 到 C: 
oolsjasperreports-5.0.1 est 目录 : 


<?xml version="1.0"?> 
<!DOCTYPE jasperReport PUBLIC 
"//JasperReports//DTD Report Design//EN" 


"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 


«jasperReport xmlns-"http://jasperreports.sourceforge.net/jasperrej 
«parameter name="ReportTitle" class="java.lang.String"/> 
<parameter name="Author" class="java.lang.String"/> 
<queryString> 
<! [CDATA[]]> 
</queryString> 
<field name="country" class="java.lang.String"> 
<fieldDescription><![CDATA[country]]></fieldDescription> 
</field> 
<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 
</field> 
<sortField name="country" order="Descending"/> 
<sortField name="name"/> 
<title> 
<band height="70"> 
<line> 
«reportElement x="0" y="0" width="515" 
height="1"/> 
</line> 
«textField isBlankWhenNull-"true" bookmarkLevel="1"> 
«reportElement x="0" y="10" width="515" 
height="30"/> 
«textElement textAlignment="Center"> 
<font size="22"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<![CDATA[$P{ReportTitle}] ]> 
</textFieldExpression> 
<anchorNameExpression><! [CDATA["Title" ] ]> 
</anchorNameExpression> 
</textField> 
<textField isBlankWhenNull="true"> 
«reportElement x="0" y="40" width="515" height="20"/> 
«textElement textAlignment="Center'"> 
<font size="10"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$P{Author}] ]> 
</textFieldExpression> 
</textField> 
</band> 
</title> 
<columnHeader> 
«band height="23"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="3" 
width="535" height="15" 
backcolor="#70A9A9" /> 
<box> 
<bottomPen lineWidth="1.0" 


lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«! [CDATA[] ]> 
</text> 
</staticText> 
<staticText> 
<reportElement x="414" y="3" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Country] ]></text> 
</staticText> 
<staticText> 
<reportElement x="0" y="3" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Name] ]></text> 
</staticText> 
</band> 
</columnHeader> 
<detail> 
<band height="16"> 
<staticText> 
«reportElement mode="Opaque" x="0" y="0" 
width="535" height="14" 
backcolor="#E5ECF9" /> 
<box> 
«bottomPen lineWidth="0.25" 
lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
<text><! [CDATA[ ] ]> 
</text> 
</staticText> 
<textField> 
«reportElement x="414" y="0" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
«font size="9" /> 
</textElement> 
«textFieldExpression class-"java.lang.String"» **«![CD/ 
«/textFieldExpression» 
«/textField» 
<textField> 
<reportElement x="0" y="0" width="136" 
height="15" /> 


<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F {name} ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
</jasperReport> 


aj ] 








Java 代 码 填充 报表 如 下 。 该 文件 的 内 容 C: oolsjasperreports-5.0.1 
estsrccomyiibaiJasperReportFill.java 如 下 所 述 。 


packag 


import 
import 
import 


import 
import 
import 


public 
@Su 
pub 


e com.yiibai; 


java.util.ArrayList; 
java.util.HashMap; 
java.util.Map; 


net.sf.jasperreports.engine.JRException; 
net.sf.jasperreports.engine.JasperFillManager; 
net.sf.jasperreports.engine.data. JRBeanCollectionDataSource, 


class JasperReportFill { 
ppressWarnings("unchecked" ) 
lic static void main(String[] args) { 
String sourceFileName = 
"C://tools/jasperreports-5.0.1/test/jasper_report_template. ,ji 


DataBeanList DataBeanList = new DataBeanList(); 
ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(_ 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters - new HashMap(); 
VER 
* Passing ReportTitle and Author as parameters 
uA 
parameters.put("ReportTitle", "List of Contacts"); 
parameters.put("Author", "Prepared By Manisha"); 


try { 
JasperFillManager.fillReportToFile( 


sourceFileName, parameters, beanColDataSource); 
) catch (JRException e) { 
e.printStackTrace(); 





POJO 文 件 的 内 容 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.java 情 
况 如 下 : 


package com.yiibai; 


public class DataBean { 
private String name; 
private String country; 


public String getName() { 


return name; 


public void setName(String name) { 
this.name - name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 


this.country = country; 
} 


将 增加 country 字 段 在 Java bean 列 表 为 空 的 新 纪录 。 该 文件 的 内 容 C: 
oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 情况 如 下 : 


package com.yiibai; 
import java.util.ArrayList; 


public class DataBeanList { 
public ArrayList<DataBean> getDataBeanList() { 
ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); **dataBe 
return dataBeanList; 


j 


ffs 
* This method returns a DataBean object, 
* with name and country set in it. 
SÉ 
private DataBean produce(String name, String country) ( 
DataBean dataBean - new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 





报表 生成 


我 们 将 编译 和 执行 使 用 我 们 常规 Ant 构 建 过 程 上 面 的 文件 。build.xml 文 件 中 的 内 容 
(根据 目录 保存 : C: oolsjasperreports-5.0.1 est) 情况 如 下 。 导 入 文件 - 
baseBuild.xml， 并 应 放置 在 同一 目录 build.xml。 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewFillReport" basedir=' 
«import file-"baseBuild.xml" /> 
«target name="viewFillReport" 
depends="compile, compilereportdesing, run" 
description="Launches the report viewer to preview 
the report stored in the .JRprint file."> 
<java classname="net.sf.jasperreports.view. JasperViewer" 
fork="true"> 
<arg value="-F${file.name}.JRprint" /> 
<classpath refid="classpath" /> 
</java> 
</target> 
«target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
«/jrc» 
«/target» 
</project> 


ee 
接 下 来 ， 让 我 们 打开 命令 行 窗口 并 转 到 build.xml 文 件 放 置 的 目录 。 最 后 执行 的 命令 


ant -Dmain-class=com.yiibai.JasperReportFill (viewFullReport 是 默认 的 目 
标 ) ， 如 下 所 示 : 





C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai. Jé 


Buildfile: C: oolsjasperreports-5.0.1 estuild. xml 
clean-sample: 
[delete] Deleting directory C: oolsjasperreports-5.0.1 esi 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
compile: 
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasse 
[javac] C: oolsjasperreports-5.0.1 estaseBuild. xml: 28: 


warning: 'includeantruntime' was not set, defaulting to build.: 
set to false for repeatable builds 
[javac] Compiling 3 source files to C: oolsjasperreports-5.( 


compilereportdesing: 
[jrc] Compiling 1 report design files. 
[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 10g4j:WARN See 
http://logging.apache.org/10g4j/1.2/faq.htmllZnoconfig for m 
[jrc] File : C: oolsjasperreports-5.0.1 estjasper repoi 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] 109g4j:WARN Please initialize the log4j system properly 


viewFillReport: 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] 109g4j:WARN Please initialize the log4j system properly 


BUILD SUCCESSFUL 
Total time: 5 minutes 5 seconds 


Ce oolsjasperreports-5.0.1 est> 





正如 上 文 编 译 的 结果 ，JasperViewer 窗 口 打开 如 下 面 的 屏幕 : 


TutorialsPoint Java 技术 教程 





List of Contacts 


Prepared By Manisha 


EE MESS X 
Dennis Ritchie 
Manisha 
V.Anand 
Shrinath 
Tanmay 








iouis 





在 这 里 ， 可 以 看 到 ， 因 为 没有 通过 该 字段 country 任 何 数据 的 最 后 一 条 记录 ，“NO 
COUNTRY" 正 在 打印 。 
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报表 变量 是 建立 在 报表 表达 式 之 上 的 特殊 对 象 。 报 表 变 量 简化 以 下 任务 : 
e 报表 ， 其 中 大 量 使 用 在 整个 报告 模板 表达 式 。 这 些 表达 式 可 以 通过 使 用 报表 变 


量 只 能 声明 一 次 。 


e 计数 ， 求 和 和， 平均 ， 最 低 ， 最 高 ， 方 差 等 : 报表 变量 可 以 基于 像 对 应 的 表达 式 
的 值 执行 各 种 计算 


如 果 变 量 是 在 报表 设计 定义 ， 那 么 这 些 可 以 通过 在 表达 式 中 的 新 变量 引用 。 因 此 ， 
在 该 变量 是 在 报表 设计 中 声明 的 顺序 是 非常 重要 的 。 


«variable name="CityNumber" class="java.lang.Integer" incrementType 
incrementGroup="CityGroup" calculation="Count"> 
<variableExpression> 

<![CDATA[Boolean. TRUE ] ]> 
</variableExpression> 
</variable> 


A ÉÉÉÉÉ————E 
如 上 面 所 看 到 的 ，<variable> 元 素 包含 属性 的 数量 。 这 些 属性 总 结 如 下 : 





name 属 性 


类 似 的 参数 和 字段 ，</variable> 元 素 的 name 属 性 是 强制 性 的 。 它 允许 引用 由 它 的 声 
明 的 名 称 在 报表 表达 式 中 的 变量 。 


class 属 性 


class 属 性 也 是 强制 性 的 ， 它 指定 了 变量 值 的 类 名 。 它 的 默认 值 是 java.lang.String。 
这 是 可 以 改变 的 ， 在 classpath 可 用 的 任何 类 无 论 是 在 报表 编译 时 间 和 报告 充填 时 
间 。 无 论 报告 值 的 类 型 ， 引 擎 采用 该 $V 人 标记 是 用 来 报告 表达 ， 从 而 不 必要 手动 投 


f. 


计算 方法 


这 个 属性 决定 的 变量 填充 报表 时 要 执行 什么 计算 。 下 面 的 小 节 描 述 所 有 的 
<variable> 元 素 的 计算 属性 的 可 能 值 。 


Average: 变量 的 值 是 变量 表达 式 的 每 一 个 非 空 值 的 平均 值 。 有 效 期 仅 为 数值 变 


量 。 
Count: 该 变量 的 值 是 变量 表达 式 非 空 实例 的 数量 。 

First: 变量 的 值 是 变量 表达 式 的 第 一 个 实例 的 值 。 随 后 的 值 将 被 忽略 。 
Highest: 变量 的 值 是 变量 表达 式 的 最 高 值 。 

Lowest: 该 变量 的 值 是 变量 表达 式 在 报表 中 的 最 低 值 。 

Nothing: 不 进行 计算 的 变量 。 


StandardDeviation: 该 变量 的 值 是 所 有 非 空 值 匹 配 报 表 表 达 式 的 标准 偏差 。 有 
效 期 仅 为 数值 变量 。 


Sum: 该 变量 的 值 是 由 报表 表达 式 返回 所 有 非 空 值 的 总 和 。 


System: 该 变量 的 值 是 一 个 自 定义 计算 〈 计 算 该 变量 自己 的 值 ， 使 用 
JasperReports 小 脚本 功能 


Variance: 该 变量 的 值 是 一 个 报表 变量 的 表达 式 求 值 返回 的 所 有 非 空 值 的 方 


o 


Jg &FACTORYCLASS 


此 属性 确定 填充 报表 上 的 当前 记录 时 ， 用 于 计算 变量 的 值 的 类 。 默 认 值 是 任何 类 实 
现 net.sf.jasperreports.engine.fill.JRIncrementerFactory。 工 厂 类 将 被 用 于 由 发 动机 
来 实例 化 对 象 的 增 量 在 运行 时 根据 该 变量 中 设置 的 计算 属性 。 


INCREMENTTYPE 


这 个 


决定 何 时 重新 计算 变量 的 值 。 此 属性 使 用 的 值 ， 如 下 : 
Column: 该 变量 的 值 重新 计算 各 列 的 结尾 

Group: 当 指定 incrementGroup 改 变 该 组 的 变量 值 重 新 计算 。 
None: 该 变量 的 值 重新 计算 每 个 记录 。 

Page: 该 变量 的 值 被 重新 计算 在 每 一 页 的 末尾 。 

Report: 该 变量 的 值 被 重新 计算 一 次 ， 在 报表 的 末尾 。 


INCREMENTGROUP 


这 决定 了 该 变量 的 值 被 重新 计算 ， 当 incrementType 是 组 的 名 称 。 这 需要 在 JRXML 
报表 模板 中 声明 的 任何 组 的 名 称 。 


RESETTYPE 


这 决定 了 当 一 个 变量 的 值 被 复位 。 此 属性 使 用 的 值 ， 如 下 : 
e Column: 该 变量 的 值 复位 在 每 一 列 的 开头 。 
e Group: 该 变量 的 值 是 当 指定 incrementGroup 修 改组 复位 。 
e None: 该 变量 的 值 不 会 被 重 置 。 
e Page: 该 变量 的 值 复位 在 每 一 页 的 开头 。 
e Report: 该 变量 的 值 复位 只 有 一 次 ， 在 报表 的 开头 。 


RESETGROUP 


这 决定 了 该 变量 的 值 复 位 ， 当 resetType 是 组 的 名 称 。 该 属性 的 值 是 在 JRXML 报 表 
模板 中 声明 的 任何 组 的 名 称 。 


内 置 报表 变量 
有 一 些 内 置 的 系统 变量 ， 准 各 在 表达 式 中 使 用 ， 如 下 所 示 : 


Variable Name 描述 
这 个 变量 的 值 是 它 的 当前 页 码 。 它 可 以 被 用 来 同时 显 
PAGE_NUMBER 示 当 前 页 面 的 数量 和 使 用 JasperReports 文 本 字段 的 元 


素 ，evaluationTime 属 性 的 一 种 特殊 的 功能 的 总 页 数 。 
COLUMN NUMBER ”这 个 变量 包含 了 当前 的 列 号 
REPORT_COUNT 此 报表 变量 包含 的 处 理 记录 的 总 数 。 
PAGE COUNT 这 个 变量 包含 了 生成 当前 页 面 时 所 人 处理 的 记录 数 。 
COLUMN_COUNT 这 个 变量 包含 了 生成 当前 列 时 所 处理 的 记录 数 。 


这 个 变量 的 名 称 是 从 它 所 对 应 的 组 ， 后 级 为 _COUNT 
GroupName COUNT ”序列 的 名 称 派生 的 。 这 个 变量 包含 的 记录 在 当前 组 的 
数量 


Bo 


we 


例子 


让 一 个 变量 (countNumber) 加 入 到 现 有 的 报表 模板 〈 第 报表 设计 ) 。 我 们 将 前 组 
数 到 每 个 记录 。 修 订 后 的 报告 模板 (jasper_report_template.jrxml) 如 下 。 将 其 保 
存 到 C: oolsjasperreports-5.0.1 est 目录 : 


<?xml version="1.0"?> 

<!DOCTYPE jasperReport PUBLIC 

"//JasperReports//DTD Report Design//EN" 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 


«jasperReport xmlns-"http://jasperreports.sourceforge.net/jasperrej 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://jasperreports.sourceforge.net/jasperrep« 
http://jasperreports.sourceforge.net/xsd/jasperreport .xsd" 
name-"jasper report template" pageWidth="595" 

pageHeight="842" columnWidth="515" 

leftMargin="40" rightMargin="40" topMargin="50" bottomMargin="50"> 
<parameter name="ReportTitle" class="java.lang.String"/> 
<parameter name="Author" class="java.lang.String"/> 


<queryString> 
<![CDATA[ ]]> 
</queryString> 


<field name="country" class="java.lang.String"> 
<fieldDescription> 
<! [CDATA[country] ]> 
</fieldDescription> 
</field> 


<field name="name" class="java.lang.String"> 
<fieldDescription> 
<! [CDATA [name] ]> 
«/fieldDescription» 
</field> **«variable name="CcountNumber" class-"java.lang.Integei 
<variableExpression> 
<! [CDATA[Boolean. TRUE ] ]> 
</variableExpression> 
</variable>** 
<title> 
<band height="70"> 
<line> 
«reportElement x="0" y="0" width="515" 
height="1"/> 
</line> 
«textField isBlankWhenNull-"true" bookmarkLevel="1"> 
«reportElement x="0" y="10" width="515" 
height="30"/> 
«textElement textAlignment="Center'"> 
<font size="22"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$P{ReportTitle}]]> 
</textFieldExpression> 
<anchorNameExpression> 
<![CDATA["Title"]]> 
</anchorNameExpression> 
</textField> 
<textField isBlankWhenNull-"true"» 
«reportElement x="0" y="40" width="515" height="20"/> 
«textElement textAlignment-"Center"- 
«font size="10"/> 


</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$P{Author}] ]> 
</textFieldExpression> 
</textField> 
</band> 
</title> 


<columnHeader> 
<band height="23"> 

<staticText> 
«reportElement mode-"Opaque" x="0" y="3" 
width="535" height="15" 
backcolor="#70A9A9" /> 
<box> 
«bottomPen lineWidth="1.0" 
lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
«text»«! [CDATA[]]» 
</text> 

</staticText> 

<staticText> 
<reportElement x="414" y="3" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 

<font isBold="true" /> 

</textElement> 
<text><! [CDATA[Country]]»«/text» 

</staticText> 

<staticText> 
<reportElement x="0" y="3" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 

<font isBold="true" /> 

</textElement> 
<text><! [CDATA[Name] ]></text> 

</staticText> 

</band> 
</columnHeader> 


<detail> 
<band height="16"> 
<staticText> 

«reportElement mode-"Opaque" x="0" y="0" 

width="535" height="14" 

backcolor="#E5ECF9" /> 

<box> 
<bottomPen lineWidth="0.25" 
lineColor="#CCCCCC" /> 

</box> 


<textElement /> 
<text><! [CDATA[] ]> 
</text> 

</staticText> 

<textField> 
«reportElement x="414" y="0" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 

<font size="9" /> 

</textElement> 
<textFieldExpression class="java.lang.String"> 
<![CDATA[$F{country} ] ]> 
</textFieldExpression> 

«/textField- 

<textField> 
<reportElement x="0" y="0" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
«textFieldExpression class-"java.lang.String"» **«![CD/ 
«/textFieldExpression» 

«/textField» 

</band> 
</detail> 
</jasperReport> 





在 java 代 码 报表 充填 保持 不 变 。 文 件 C: oolsjasperreports-5.0.1 
estsrccomyiibaiJasperReportFilljava 内 容 如 下 : 


packag 


import 
import 
import 


import 
import 
import 


public 
@Su 
pub 


e com.yiibai; 


java.util.ArrayList; 
java.util.HashMap; 
java.util.Map; 


net.sf.jasperreports.engine.JRException; 
net.sf.jasperreports.engine.JasperFillManager; 
net.sf.jasperreports.engine.data. JRBeanCollectionDataSource, 


class JasperReportFill { 
ppressWarnings("unchecked" ) 
lic static void main(String[] args) { 
String sourceFileName = 
"C://tools/jasperreports-5.0.1/test/jasper_report_template. ,ji 


DataBeanList DataBeanList = new DataBeanList(); 
ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(_ 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters - new HashMap(); 
VER 
* Passing ReportTitle and Author as parameters 
wy 
parameters.put("ReportTitle", "List of Contacts"); 
parameters.put("Author", "Prepared By Manisha"); 


try { 
JasperFillManager .fillReportToFile( 


sourceFileName, parameters, beanColDataSource); 
) catch (JRException e) { 
e.printStackTrace(); 





POJO 文 件 的 内 容 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.javaBg AR 
如 下 : 


package com.yiibai; 


public class DataBean { 
private String name; 
private String country; 


public String getName() { 


return name; 


public void setName(String name) { 
this.name - name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 


this.country = country; 
} 


该 文件 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 的 内 容 如 
F: 


package com.yiibai; 
import java.util.ArrayList; 


public class DataBeanList { 
public ArrayList<DataBean> getDataBeanList() { 
ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); 


return dataBeanList; 


j 


VENE 
* This method returns a DataBean object, 
* with name and country set in it. 
TA 
private DataBean produce(String name, String country) ( 
DataBean dataBean - new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 


} 
i  J1 
报表 生成 


我 们 将 编译 和 执行 使 用 我 们 常规 Ant 构 建 过 程 上 面 的 文件 。 build.xml 文 件 中 的 内 容 
(根据 目录 保存 在 C: oolsjasperreports-5.0.1 est) 如 下 。 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewFillReport" basedir=' 
«import file-"baseBuild.xml" /> 
«target name="viewFillReport" 
depends="compile, compilereportdesing, run" 
description="Launches the report viewer to preview 
the report stored in the .JRprint file."> 
<java classname="net.sf.jasperreports.view. JasperViewer" 
fork="true"> 
<arg value="-F${file.name}.JRprint" /> 
<classpath refid="classpath" /> 
</java> 
</target> 
«target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
«/jrc» 
«/target» 
</project> 


J E III 
接 下 来 ， 打 开 命令 行 窗口 并 转 到 build.xml 文 件 放 置 的 目录 。 最 后 执行 的 命 分 ant - 


Dmain-class=com.yiibai.JasperReportFill (viewFullIReport 默 认 的 目标 ) ， 如 
下 所 示 : 





C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai. Jé 


Buildfile: C: oolsjasperreports-5.0.1 estuild. xml 
clean-sample: 
[delete] Deleting directory C: oolsjasperreports-5.0.1 esi 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
compile: 
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasse 
[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:28: w 


'includeantruntime' was not set, defaulting to build.sysclassp: 
set to false for repeatable builds 
[javac] Compiling 7 source files to C: oolsjasperreports-5.( 


compilereportdesing: 
[jrc] Compiling 1 report design files. 
[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 109g4j:WARN See http://1logging.apache.org/109g4j/1.2/faq 
for more info. 
[jrc] File : C: oolsjasperreports-5.0.1 estjasper repoi 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] 109g4j:WARN Please initialize the log4j system properly 


viewFillReport: 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] log4j:WARN Please initialize the log4j system properly 


BUILD SUCCESSFUL 
Total time: 18 seconds 


ss SS 
正如 上 文 编 译 的 结果 ， 一 个 JasperViewer 窗 口 打 开 如 下 面 的 屏幕 : 
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Jasper¥iewer = imb. 


aso iLe] Cmn 








List of Contacts 


Prepared By Manisha 


1 Dennis Ritchie 
2. Manisha 
3.V Anand 
4 Shrinath 





在 这 里 ， 我 们 看 到 ， 计 数 前 级 为 每 个 记录 。 
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JasperReports 报 表 区 段 - JasperReports 教 程 


我 们 将 在 本 章 开 始 ， 一 个 简单 的 报表 模板 的 结构 看 。 依 祥 画 荫 芒 JasperReports 的 
结构 报表 模板 注 类 到 多 个 区 段 。 部 分 是 有 规定 的 高 度 ， 并 且 可 以 包含 像 直 线 ， 和 矩 
形 ， 图 像 或 文本 字段 对 象 报 表 的 部 分 。 


通过 提供 的 报表 数据 源 的 虚拟 记录 的 报表 引擎 通 历 ， 在 报表 填充 的 时 候 。 根 据 每 个 
部 分 的 定义 的 行为 ， 引 擎 则 呈现 每 个 报表 节 在 适当 的 时 候 。 举 例 来 说 ， 细 节 部 分 的 
数据 源 中 呈现 为 每 个 记录 。 当 页 中 断 ， 页 眉 和 页 面 页 脚 节 在 需要 时 提供 。 


在 JasperReports 术 语 ， 报 表 区 段 也 被 称 为 报表 带 区 。 部 分 是 由 一 个 或 多 个 频段 。 
这 些 部 分 在 报告 生成 时 间 反 复 填 充 并 写 在 文件 最 后 。 


主要 章节 
在 JasperReports 报 表 模 板 主 要 有 以 下 几 个 部 分 : 


<title></title> 
<pageheader></pageheader> 
<columnheader></columnheader> 
<groupheader></groupheader> 
<detail></detail> 
<groupfooter></groupfooter> 
<columnfooter></columnfooter> 
<pagefooter></pagefooter> 
<lastpagefooter></lastpagefooter> 
<summary></summary> 
<nodata></nodata<> 
<background></background> 


下 表 总 结 了 每 个 部 分 : 


Section 
Title 


Page 
Header 


Column 
Header 


Group 
Header 


Detail 


Group 
Footer 


Column 
Footer 


Page 
Footer 


Last Page 
Footer 


Summary 


No Data 


Background 


描述 
本 节 中 只 出 现 一 次 在 报表 的 开头 。 
这 部 分 出 现在 每 一 页 的 开头 生成 的 文档 中 。 


这 部 分 显示 在 生成 的 文档 中 的 每 一 列 的 开关 。 如 果 报 表 只 有 一 个 
定义 列 ， 那 么 列 标题 和 脚注 部 分 被 忽略 。 


这 部 分 是 由 一 个 报告 组 (组 章 ) 引入 。 每 次 分 组 表达 式 改 变 其 
值 ， 组 页 眉 部 分 上 面 印 的 细节 部 分 。 在 情况 下 ， 如 果 超 过 一 个 组 
被 定义 ， 组 页 丑 打 印 在 组 定义 的 顺序 。 


这 部 分 是 重复 的 报表 的 数据 源 提供 的 数据 的 每 一 行 。 细 节 部 分 可 
以 由 多 个 频段 。 


这 部 分 是 由 一 个 报告 组 (组 章 ) 引入 。 该 组 页 脚 节 印 下 的 分 组 表 
达 式 的 值 更 改 前 的 细节 部 分 。 组 页 脚 始终 打印 在 数据 源 的 数据 的 
最 后 一 行 。 在 情况 下 ， 如 果 超 过 一 个 组 被 定义 ， 组 页 脚 打 印 在 组 
定义 的 顺序 相反 。 


本 节 将 出 现在 每 一 列 的 底部 。 如 果 报 告 的 列 数 为 1， 则 列 标题 和 
脚注 部 分 被 忽略 。 


本 节 出 现在 每 个 页 面 的 底部 。 


ee ee 
部 分 也 存在 ， 那 么 这 可 能 不 是 该 文件 的 最 后 一 页 。 这 部 分 有 时 是 
有 用 的 ， 当 汇 总 信息 具有 在 最 后 一 页 的 底部 显示 、 


本 节 中 只 出 现 一 次 在 报告 的 末尾 


这 部 分 被 打印 时 ， 当 无 资料 打印 报表 属性 设置 为 无 数据 段 。 如 果 
<noData> 部 在 报告 模板 中 定义 ， 并 且 如 果 数 据 源 是 空 的 ， 那 么 
<noData> 部 分 将 是 唯一 一 个 在 填充 时 考虑 ， 其 含量 将 产生 报表 
输出 。 


背景 部 分 会 显示 每 一 页 上 ， 并 不 能 浴 出 到 下 一 个 页 面 。 放 在 这 一 
部 分 的 元 素 在 页 面 初始 化 的 时 候 求 值 ， 并 显示 在 背景 中 。 所 有 其 
他 的 页 面 对 象 被 显示 在 背景 上 对 象 的 顶部 。 这 部 分 是 用 于 创建 页 
面 水 印 有 用 。 


部 分 ， 元 素 和 属性 的 关系 
下 图 显示 的 元 素 和 属性 在 报表 中 的 部 分 关系 。 
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<printWhenExpression> 









Section Elements 








iios, corn 


section 元 素 


所 有 上 述 报表 部 分 都 是 可 选 的 。 但 任何 报表 模板 将 至 少 有 一 个 这 样 的 部 分 。 每 一 节 
都 包含 一 个 单一 的 <band> 元 素 作为 其 唯一 的 子 元 素 。 一 个 <band> 可 以 包含 雳 个 或 
多 个 下 列子 元 素 : 


这 些 元 素 都 必须 包含 一 个 <reportElement> 作 为 其 第 一 个 元 素 (除了 
elementGroup) 。 一 个 <reportElement> 决 定 了 数据 是 如 何 贷 定 了 该 特定 元 素 。 与 
变量 和 参数 ， 不 要 求 报表 内 容 有 一 个 名 字 ， 因 为 通常 不 需要 获得 一 个 报表 模板 内 的 
任何 单个 元 素 。 


下 表 总 结 了 <reportElement> 属 性 : 


adi 描述 有 效 值 
à yA FT a A 1— HEMA 
x 件 的 x 坐标 。 | EER, HRD 


一 个 整数 值 ， 表 示 在 y 以 像素 为 


y HE 元 素 的 坐标 。 此 属性 是 必需 
Te | B, 
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width 


height 


key 


stretchType 


positionType 


isPrintRepeatedValues 


mode 


isRemoveLineWhenBlank 


isPrintInFirstWholeBand 


指定 频带 元 


件 的 高 度 。 


带 元 素 的 唯 
一 标识 符 。 


指定 包含 带 
延伸 当 元 素 
如 何 延伸 


指定 当 频 带 
延伸 元 素 的 
位 置 。 


如 果 指 定 的 
值 重 复 打 
印 。 


指定 元 素 的 


背景 模式 


如 果 指 定 了 
当 它 是 空 


白 ， 并 有 在 
相同 的 水 平 
空间 没有 其 
他 元 素 的 元 
素 应 被 删 
除 。 


如 果 指 定 的 
元 素 必 须 打 
印 在 整个 频 
段 ， 也 就 是 
说 ， 未 被 报 
表 的 页 面 或 
列 之 间 分 割 
的 波段 。 


一 个 整数 值 ， 表 示 该 元 素 的 宽 
度 以 像素 为 单位 。 此 属性 是 必 


需 的 。 


一 个 整数 值 ， 表 示 以 像素 为 元 
素 的 高 度 。 此 属性 是 必需 的 。 


唯一 字符 串 值 。 


NoStretch (default): 该 元 素 不 
zx 
*, RelativeToTallestObject: 
该 元 素 将 伸展 以 适应 它 的 组 的 
最 高 的 对 

象 。RelativeToBand: 该 元 素 
将 延伸 到 适合 带 的 高 度 。 


Float: 元 素 将 取决 于 周围 元 件 
的 尺寸 移 

动 。FixRelativeToTop 
(default): 该 元 素 将 保持 一 个 固 
定 的 位 置 相 对 于 带 的 顶 

#8, FixRelativeToBottom: 该 
元 素 将 保持 一 个 固定 的 位 置 相 
对 于 带 的 底部 。 


true (default): 重复 的 值 将 被 
打印 出 来 。false: 重复 的 值 将 
不 被 打印 出 来 。 


不 透明 的 ， 透 明 的 


true, false 


true, false 


指定 是 否 当 

频带 浴 出 到 
isPrintWhenDetailOverFlows ”新 页 或 列 中 true, false 

的 元 素 将 被 

打印 出 来 。 

指定 在 指定 
| 的 组 改变 元 | 
printWhenGroupChanges SENS ae tT string /é 

印 。 


ELEME HFE, RAF 
预定 义 值 中 的 一 个 十 六 进 制 
指定 元 素 的 RGB 值 : black, blue, cyan, 


Ecol 前 景色 。 darkGray, gray, green, 
lightGray, magenta, orange, 
pink, red, yellow, white. 

虽 定 元 z = AA =v & E? EUR 

backcolor darc 同样 作为 有 效 值 的 前 景 

段 属性 

以 下 是 报表 的 部 分 属性 : 

高 度 

该 部 分 的 高 度 指 定 高 度 ， 该 特定 部 分 的 像素 ， 是 非常 重要 的 在 整体 报表 设计 。 
打印 当 表 达 陈 


布尔 表达 式 ， 确 定 该 部 分 是 否 应 打印 或 不 打印 。 


SPLIT ALLOWED 


一 个 标志 ， 指 示 该 部 分 是 否 人 允许 分 裂 时 ， 它 不 适合 在 当前 页 面 上 上。 如果 为 true， 该 
部 分 将 被 转移 到 下 一 个 页 面 。 注 意 ， 如 果 一 节 不 适合 下 页 上 ， 那 么 将 会 考虑 该 标志 
的 值 的 拆 分 。 splitType 可 以 利用 以 下 值 : 


e splitType-"Stretch" : 拆 分 拉 伸 内 容 。 如 果 该 部 分 在 当前 页 上 延伸 (如果 可 用 空 
间 小 于 宣 高 度 ) ， 这 是 添加 到 原始 高 度 的 区 域 是 否 人 允许 分 割 到 下 页 

e splitType="Prevent" : 避免 在 第 一 次 尝试 分 割 。 如 果 部 分 不 适合 在 下 一 页 中 ， 
分 割 通常 发 生 ， 预 防 频 带 分 割 是 有 效 的 只 有 在 第 一 次 分 割 尝试 。 


e splitType="Immediate" : 立即 绘制 。 该 频段 允许 的 任何 地 方 ， 除 了 分 割 高 于 其 
最 顶端 的 元 素 。 


例子 


为 演示 开始 每 个 部 分 让 我 们 编写 报表 模板 (jasper_report_template.jrxml) 。 将 此 
文件 保存 到 C: oolsjasperreports-5.0.1 est 目 录 。 在 这 个 文件 中 ， 我 们 将 显示 在 每 个 
部 分 的 文本 (上面 所 讨论 的 ) 。 该 文件 的 内 容 如 下 所 述 : 


<?xml version="1.0" encoding="UTF-8"?> 

«jasperReport xmlns-"http://jasperreports.sourceforge.net/jasperrej 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://jasperreports.sourceforge.net/jasperrep: 
http://jasperreports.sourceforge.net/xsd/jasperreport .xsd" 
name-"jasper report template" pageWidth-z" 300" pageHeight="300" coli 
leftMargin="0" rightMargin="0" topMargin="0" bottomMargin="0" > 


<title> 
<band height="50"> 
<textField> 
<reportElement x="100" y="16" 
width="100" height="20"/> 
«textElement/» 
<textFieldExpression> 
«1[CDATA["Title"]]» 
</textFieldExpression> 
</textField> 
</band> 
</title> 
<pageHeader> 
<band height="40"> 
<textField> 
«reportElement mode="Opaque" x="100" y="10" 
width="90" height="20"/> 
<textElement> 
<font isBold="true"/> 
</textElement> 
<textFieldExpression> 
<![CDATA["Page Header" ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</pageHeader> 
<columnHeader> 
<band height="40"> 
<textField> 
«reportElement x="100" y="10" width="90" 
height="20"/> 
<textElement> 
<font isItalic="true"/> 
</textElement> 
<textFieldExpression> 
<![CDATA["Column Header" ] ]> 
</textFieldExpression> 


</textField> 
</band> 
</columnHeader> 
<detail> 
<band height="40"> 
<textField> 
«reportElement mode="Opaque" x="100" y="10" width="90" 
height="20" backcolor="#99CCFF"/> 
«textElement/» 
<textFieldExpression> 
<![CDATA["Report Details"]]> 
</textFieldExpression> 
</textField> 
</band> 
</detail> 
<columnFooter> 
<band height="40"> 
<textField> 
«reportElement x="100" y="10" width="90" 
height="20"/> 
<textElement/> 
<textFieldExpression> 
<! [CDATA[ "Column Footer"]]» 
</textFieldExpression> 
</textField> 
</band> 
</columnFooter> 
<pageFooter> 
<band height="40"> 
<textField> 
<reportElement x="100" y="10" 
width="90" height="20"/> 
<textElement/> 
<textFieldExpression> 
<! [CDATA[ "Page Footer"]]> 
</textFieldExpression> 
</textField> 
</band> 
</pageFooter> 
<lastPageFooter> 
<band height="40"> 
<textField> 
<reportElement x="100" y="10" width="90" 
height="20"/> 
<textElement/> 
<textFieldExpression> 
<! [CDATA[ "Last Page Footer"]]> 
</textFieldExpression> 
</textField> 
</band> 
</lastPageFooter> 
<summary> 
<band height="40"> 


<textField> 
«reportElement x="100" y="10" width="90" 
height="20"/> 
<textElement/> 
<textFieldExpression> 
<![CDATA["Summary" ] ]> 
</textFieldExpression> 
</textField> 
</band> 
</summary> 
</jasperReport> 


«| md 








java 代 码 填写 并 生成 报告 如 下 。 保 存 这 个 文件 JasperReportFill.java 到 C: 
oolsjasperreports-5.0.1 estsrccomyiibai 目录 . 


package com.yiibai; 


import net.sf.jasperreports.engine.JREmptyDataSource; 
import net.sf.jasperreports.engine.JRException; 
import net.sf.jasperreports.engine.JasperFillManager; 


public class JasperReportFill { 
public static void main(String[] args) { 
String sourceFileName = 
"C://tools/jasperreports-5.0.1/test/" + 
"jasper report template.jasper"; 


try { 
JasperFillManager.fillReportToFile(sourceFileName, null, 


new JREmptyDataSource()); 
} catch (JRException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


} 


EE ni 


在 这 里 ， 我 们 填充 报表 时 ， 以 模拟 一 个 数据 源 ， 在 这 一 个 记录 使 用 
JREmptyDataSource 的 实例 ， 但 与 所 有 在 这 个 单一 记录 为 null 的 字段 。 


报表 生成 


将 编译 和 执行 使 用 常规 Ant 构 建 过程 上 面 的 文件 build.xml 文 件 中 的 内 容 (根据 目录 
保存 : C: oolsjasperreports-5.0.1 est) 情况 如 下 。(saved under directory C: 
oolsjasperreports-5.0.1 est) 如 下 . 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewFillReport" basedir=' 
«import file-"baseBuild.xml" /> 
«target name="viewFillReport" 
depends="compile, compilereportdesing, run" 
description="Launches the report viewer to preview 
the report stored in the .JRprint file."> 
<java classname="net.sf.jasperreports.view. JasperViewer" 
fork="true"> 
<arg value="-F${file.name}.JRprint" /> 
<classpath refid="classpath" /> 
</java> 
</target> 
«target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
«/jrc» 
«/target» 
</project> 


acr —————————————————MáeÀÁ 
接 下 来 ， 让 我 们 打开 命令 行 窗口 并 转 到 build.xml 文 件 放 置 的 目录 。 最 后 执行 的 命令 


ant -Dmain-class=com.yiibai.JasperReportFill (viewFullReport 是 默认 的 目 
标 ) ， 如 下 所 示 : 





C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai. Jé 


Buildfile: C: oolsjasperreports-5.0.1 estuild. xml 
clean-sample: 
[delete] Deleting directory C: oolsjasperreports-5.0.1 esi 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper_re 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper_re 
compile: 
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasse 
[javac] C: oolsjasperreports-5.0.1 estaseBuild. xml: 28: 
warning: 'includeantruntime' was not set, defau 
[javac] Compiling 1 source file to C: oolsjasperreports-5.0 
compilereportdesing: 


[jrc] Compiling 1 report design files. 

[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFac 

[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 10g4j:WARN See http://1logging.apache.org/109g4j/1.2/faq 
[jrc] File : C: oolsjasperreports-5.0.1 estjasper repoi 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnviro 
[java] log4j:WARN Please initialize the log4j system properly 


viewFillReport: 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnviro 
[java] log4j:WARN Please initialize the log4j system properly 


BUILD SUCCESSFUL 
Total time: 18 minutes 22 seconds 


LEN: 
正如 上 文 编 译 的 结果 ，JasperViewer 窗 口 打开 如 下 面 的 屏幕 : 





ifi Rj [=| 





Title 

Page Header 
Column Header 
Report Details 
Summary 
Column Footar 


Last Page Footer 











在 这 里 ， 我 们 可 以 在 每 个 文本 被 打印 的 部 分 看 到 。 但 上 应当 注意 的 是 ， 作 为 JRXML 包 
含 <lastPageFooter> 元 件 ， 它 将 被 显示 在 报表 ， 而 不 是 所 显示 的 <pageFooter> 元 素 
的 最 后 一 页 。 如 果 有 多 个 列 的 <columnHeader> 和 <columnFooter> 元 素 将 只 显示 在 
报告 中 。 
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组 在 JasperReports 的 协助 组 织 对 报告 的 数据 以 逻辑 方式 。 报 告 组 代表 连续 记录 的 
数据 源 中 有 一 些 共同 点 ， 上 比如 某 个 报表 字段 的 值 的 序列 。 报 告 组 由 <group> 元 素 定 
义 。 一 个 报表 可 以 有 任意 数量 的 组 。 一 旦 声明 ， 群 体 可 以 在 整个 报告 中 提 到 的 。 


报告 组 有 三 个 要 素 : 
e Group expression: 这 表示 必须 改变 ， 以 启动 一 个 新 的 数据 组 中 的 数据 。 
e Group header section: 帮助 位 置 标签 在 分 组 数据 的 开始 。 
e Group footer section: : 帮助 位 置 标签 在 分 组 数据 的 末尾 。 


在 截至 于 若 该 组 表达 变化 ， 一 组 发 生 断 裂 和 相应 的 <groupFooter> 和 
<groupHeader> 部 分 的 值 插 和 人 到 生成 的 文档 中 报告 充填 时 数据 源 的 迭代 。 


> 报表 组 的 机 制 不 执行 由 数据 源 所 提供 的 资料 的 任何 排序 。 数 据 分 组 按 预期 工作 ， 
只 有 当 数 据 源 中 的 记录 按照 报告 中 使 用 的 组 表达 式 已 经 下 兮 。 


属性 组 
group TRARRE, 使 我 们 能 够 控制 分 组 的 数据 是 如 何 布局 。 属 性 概括 于 下 


属性 描述 


这 是 强制 性 的 。 它 通过 名 称 引 用 该 组 中 的 报表 
表达 式 。 它 遵循 相同 的 命名 约定 我 们 ， 我 们 提 


name 到 的 报告 参数 ， 字 段 和 报表 变量 。 它 可 以 在 其 
他 JRXML 属 性 被 用 于 当 想 引用 一 个 特定 的 报 
告 组 。 


当 设 置 为 true 时 ， 每 个 数据 组 将 开始 一 个 新 的 
列 。 默 认 值 是 false 


当 设 置 为 true 时 ， 每 个 数据 组 将 开始 一 个 新 的 


isStartNewColumn 


isStartNewPage ELE. BGK false 
MA 、 + - Hr " St Fp — AN 2 
isResetPageNumber 当 设 置 为 true， 该 报告 页 码 料 每 一 个 新 组 开始 


时 被 重 置 。 默 认 值 是 false 


当 设 置 为 true 时 ， 组 头 会 被 重印 每 一 页 上 。 默 
认 值 是 false 


定义 在 列 的 底部 ， 以 便 将 组 头 当 前 列 所 需要 的 
minHeightToStartNewPage — sis BNE, RHEE RS HOE, 


呈现 在 页 面 上 的 组 页 脚 的 位 置 ， 以 及 其 有 关 的 
报告 的 部 分 它 后 面 的 行为 。 它 的 值 可 以 是 : 


isReprintHeaderOnEachPage 


footerPosition Normal, StackAtBottom, ForceAtBottom, 
CollateAtBottom.3kik\ Œ Normal 
M EAS 4 \ in š gl ro 4 —j 
TEE 当 设 置 为 true， 将 阻止 该 集团 从 分 割 它 第 一 次 


突破 的 党 试 


例子 


让 我 们 添加 一 个 组 (CountryGroup) 现 有 的 报告 模板 〈 章 报表 设计 ) 。 每 个 国家 的 
次 数 进行 计数 ， 计 数 显示 为 组 页 脚 。 在 组 头 中 每 个 记录 的 计数 前 级 。 修 订 后 的 报告 
模板 (jasper report template.jrxml) 如 下 。 将 其 保存 到 C: oolsjasperreports- 
5.0.1est 目录 : 


<?xml version="1.0"?> 

<!DOCTYPE jasperReport PUBLIC 

"//JasperReports//DTD Report Design//EN" 
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> 


«jasperReport xmlns="http://jasperreports.sourceforge.net/jasperre; 
xmlns:xsi-'http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://jasperreports.sourceforge.net/jasperrep« 
http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" 
name="jasper_report_template" pageWidth="595" 

pageHeight="842" columnWidth="515" 

leftMargin="40" rightMargin="40" topMargin="50" bottomMargin="50"> 


<parameter name="ReportTitle" class="java.lang.String"/> 
«parameter name="Author" class="java.lang.String"/> 


<queryString> 
<![CDATA[ ]]> 
</queryString> 


<field name="country" class="java.lang.String"> 
<fieldDescription><! [CDATA[country ] ]></fieldDescription> 
</field> 


<field name="name" class="java.lang.String"> 
<fieldDescription><! [CDATA[name] ]></fieldDescription> 
</field> 
<sortField name="country" order="Descending"/> 
<sortField name="name"/> 
<variable name="CountryNumber" class="java.lang.Integer" 
incrementType="Group" incrementGroup="CountryGroup" 
calculation="Count"> 
<variableExpression><! [CDATA[Boolean. TRUE] ]></variableExpres: 
«/variable» **«group name="CountryGroup" minHeightToStar tNewPage 
<groupExpression><! [CDATA[$F{country}] ]></groupExpression> 
<groupHeader> 
<band height="20"> 
<textField evaluationTime="Group" evaluationGroup="Cour 
bookmarkLevel="1"> 
«reportElement mode="Opaque" x="0" y="5" width="515' 
height="15" backcolor="#COCOCO"/> 
«box leftPadding="10"> 
«bottomPen lineWidth="1.0"/> 


«/box» 

«textElement/» 

«textFieldExpression class="java.lang.String"> 
<![CDATA[" " + String.valueOf($V(CountryNumber): 


+ String.valueOf ($F{country}) ]]> 
</textFieldExpression> 
<anchorNameExpression> 

<![CDATA[String.valueOf ($F{country}) ]]> 
</anchorNameExpression> 


</textField> 
</band> 
</groupHeader> 
<groupFooter> 
<band height="20"> 
<staticText> 


<reportElement x="400" y="1" width="60" height="15", 
<textElement textAlignment="Right"/> 
«text»«![CDATA[Count :]]></text> 

</staticText> 

<textField> 
<reportElement x="460" y="1" width="30" height="15", 
<textElement textAlignment="Right"/> 
«textFieldExpression class="java.lang.Integer"> 


<! [CDATA[$V{CountryGroup_COUNT}] ]> 
</textFieldExpression> 
</textField> 
</band> 
</groupFooter> 
</group>** 
<title> 
<band height="70"> 
<line> 
<reportElement x="0" y="0" width="515" 
height="1"/> 
</line> 
<textField isBlankWhenNull-"true" bookmarkLevel="1"> 
<reportElement x="0" y="10" width="515" 
height="30"/> 
«textElement textAlignment="Center'"> 
<font size="22"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<![CDATA[$P{ReportTitle}] ]> 
</textFieldExpression> 
<anchorNameExpression><! [CDATA["Title" ] ]> 
</anchorNameExpression> 
</textField> 
<textField isBlankWhenNull="true"> 
«reportElement x="0" y="40" width="515" height="20"/> 
<textElement textAlignment="Center'"> 
<font size="10"/> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$P{Author}] ]> 
</textFieldExpression> 
</textField> 
</band> 
</title> 


<columnHeader> 
<band height="23"> 

<staticText> 
«reportElement mode-"Opaque" x="0" y="3" 
width="535" height="15" 
backcolor="#70A9A9" /> 
<box> 
<bottomPen linewWidth="1.0" 
lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
<text><! [CDATA[ ] ]> 
</text> 

</staticText> 

<staticText> 
<reportElement x="414" y="3" width="121" 
height="15" /> 


<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Country] ]></text> 
</staticText> 
<staticText> 
<reportElement x="0" y="3" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font isBold="true" /> 
</textElement> 
<text><! [CDATA[Name] ]></text> 
</staticText> 
</band> 
</columnHeader> 


<detail> 
<band height="16"> 
<staticText> 
«reportElement mode-"Opaque" x="0" y="0" 
width="535" height="14" 
backcolor="#E5ECF9" /> 
<box> 
«bottomPen lineWidth="0.25" 
lineColor="#CCCCCC" /> 
</box> 
<textElement /> 
<text><! [CDATA[ ] ]> 
</text> 
</staticText> 
<textField> 
«reportElement x="414" y="0" width="121" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle"> 
<font size="9" /> 
</textElement> 
<textFieldExpression class="java.lang.String"> 
<! [CDATA[$F{country}] ]> 
</textFieldExpression> 
</textField> 
<textField> 
<reportElement x="0" y="0" width="136" 
height="15" /> 
<textElement textAlignment="Center" 
verticalAlignment="Middle" /> 
«textFieldExpression class="java.lang.String"> 
<! [CDATA[$SF {name} ] ]> 
</textFieldExpression> 
</textField> 
</band> 


</detail> 
</jasperReport> 


«| m 











在 java 代 码 报表 填充 保持 不 变 。 该 文件 的 内 容 C: oolsjasperreports-5.0.1 
estsrccomyiibaiJasperReportFill.java 如 下 : 


package com.yiibai; 


import java.util.ArrayList; 
import java.util.HashMap; 
import java.util.Map; 


import net.sf.jasperreports.engine.JRException; 
import net.sf.jasperreports.engine.JasperFillManager; 
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource, 


public class JasperReportFill { 
@SuppressWarnings("unchecked" ) 
public static void main(String[] args) { 
String sourceFileName = 
"C://tools/jasperreports-5.0.1/test/jasper_report_template. jé 


DataBeanList DataBeanList = new DataBeanList(); 
ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(: 


JRBeanCollectionDataSource beanColDataSource = 
new JRBeanCollectionDataSource(dataList); 


Map parameters - new HashMap(); 
Jf ets 
* Passing ReportTitle and Author as parameters 
ur d 
parameters.put("ReportTitle", "List of Contacts"); 
parameters.put("Author", "Prepared By Manisha"); 


try { 
JasperFillManager.fillReportToFile( 


sourceFileName, parameters, beanColDataSource); 
) catch (JRException e) { 
e.printStackTrace(); 





该 POJO 文 件 的 内 容 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.java 如 
下 : 


package com.yiibai; 
public class DataBean { 
private String name; 
private String country; 
public String getName() ( 
return name; 
} 


public void setName(String name) { 
this.name = name; 
} 


public String getCountry() { 
return country; 
} 


public void setCountry(String country) { 
this.country = country; 
} 


该 文件 的 内 容 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 如 下 : 


package com.yiibai; 
import java.util.ArrayList; 


public class DataBeanList { 
public ArrayList<DataBean> getDataBeanList() { 
ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(), 


dataBeanList.add(produce("Manisha", "India")); 
dataBeanList.add(produce("Dennis Ritchie", "USA")); 
dataBeanList.add(produce("V.Anand", "India")); 
dataBeanList.add(produce("Shrinath", "California")); 


return dataBeanList; 


j 


VENE 
* This method returns a DataBean object, 
* with name and country set in it. 
TA 
private DataBean produce(String name, String country) ( 
DataBean dataBean - new DataBean(); 
dataBean.setName(name); 
dataBean.setCountry(country); 
return dataBean; 


} 
i  J1 
报表 生成 


我 们 将 编译 和 执行 使 用 我 们 常规 Ant 构 建 过 程 上 面 的 文件 .build.xml 文 件 中 的 内 容 
(根据 目录 保存 C: oolsjasperreports-5.0.1 est) 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
«project name="JasperReportTest" default="ViewFillReport" basedir=' 
«import file-"baseBuild.xml" /> 
«target name="viewFillReport" 
depends="compile, compilereportdesing, run" 
description="Launches the report viewer to preview 
the report stored in the .JRprint file."> 
<java classname="net.sf.jasperreports.view. JasperViewer" 
fork="true"> 
<arg value="-F${file.name}.JRprint" /> 
<classpath refid="classpath" /> 
</java> 
</target> 
«target name="compilereportdesing" 
description="Compiles the JXML file and 
produces the .jasper file."> 
«taskdef name="jrc" 
classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
<classpath refid="classpath" /> 
</taskdef> 
«jrc destdir="."> 
«src» 
«fileset dir="."> 
«include namez"*.jrxml" /> 
</fileset> 
«/src» 
«classpath refid="classpath" /> 
«/jrc» 
</target> 
</project> 


IE 
接 下 来 ， 让 我 们 打开 命令 行 窗口 并 转 到 build.xml 文 件 放 革 的 目录 。 最 后 执行 的 命令 


ant -Dmain-class=com.yiibai.JasperReportFill (viewFullReport 是 默认 的 目标 ) , 
如 下 所 示 : 





C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai. Jé 


Buildfile: C: oolsjasperreports-5.0.1 estuild. xml 
clean-sample: 
[delete] Deleting directory C: oolsjasperreports-5.0.1 esi 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper rt 
compile: 
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasse 
[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:28: w 


'includeantruntime' was not set, defaulting to build.sysclassp: 
set to false for repeatable builds 
[javac] Compiling 7 source files to C: oolsjasperreports-5.( 


compilereportdesing: 
[jrc] Compiling 1 report design files. 
[jrc] 10g4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory). 
[jrc] 10g4j:WARN Please initialize the log4j system properly 
[jrc] 109g4j:WARN See http://1logging.apache.org/109g4j/1.2/faq 
for more info. 
[jrc] File : C: oolsjasperreports-5.0.1 estjasper repoi 


run: 
[echo] Runnin class : com.yiibai.JasperReportFill 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] 109g4j:WARN Please initialize the log4j system properly 


viewFillReport: 
[java] log4j:WARN No appenders could be found for logger 
(net.sf.jasperreports.extensions.ExtensionsEnvironment). 
[java] log4j:WARN Please initialize the log4j system properly 


BUILD SUCCESSFUL 
Total time: 18 seconds 


SS SS SS 
正如 上 文 编 译 的 结果 ，JasperViewer 窗 口 打开 如 下 面 的 屏幕 : 
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List of Contacts 


Praparad By Marisha 
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在 这 里 ， 我 们 看 到 ， 各 个 国家 分 组 和 发 生 每 个 国家 的 计数 显示 在 每 个 组 页 脚 。 
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Java 基础 


Java 简介 


Javaz= Sun Microsystems 公 司 于 1995 年 5 月 推出 的 Java 面 向 对 象 程序 设计 语言 和 
Java 平 台 的 总 称 。 由 James Gosling 和 同事 们 共同 研发 ， 并 在 1995 年 正式 推出 。 


Java 分 为 三 个 体系 : 


e JavaSE (J2SE) (Java2 Platform Standard Edition，java 平 台 标 准 版 ) 
e JavaEE(J2EE)(Java 2 Platform,Enterprise Edition，java 平 台 企 业 版 ) 
e JavaME(J2ME)(Java 2 Platform Micro Edition，java 平 台 微 型 版 )。 


2005 年 6 月 ，JavaOne 大 会 召开 ，SUN 公 司 公 开 Java SE 6。 此 时 ，Java 的 各 种 版 
本 已 经 更 名 以 取消 其 中 的 数字 "2" : J2EE 更 名 为 Java EE, J2SE 更 名 为 Java SE, 
J2ME 更 名 为 Java ME, 


主要 特性 
Java 语 言 是 简单 的 : 


Java 语 言 的 语法 与 C 语 言 和 C++ 语言 很 接近 ， 使 得 大 多 数 程序 员 很 容易 学 习 和 
使 用 。 另 一 方面 ，Java 丢 弃 了 C++ 中 很 少 使 用 的 、 很 难 理解 的 、 全 人 迷惑 的 那 
些 特 性 ， 如 操作 符 重 载 、 多 继承 、 自 动 的 强制 类 型 转换 。 特 别 地 ，Java 语 言 不 
caer 而 是 引用 。 并 提供 了 自动 的 废料 收集 ， 使 得 程序 员 不 必 为 内 存 管理 
而 担忧 。 


Java 语 言 是 面向 对 象 的 : 


Java 语 言 提 供 类 、 接 口 和 继承 等 原 语 ， 为 了 简单 起 见 ， 只 支持 类 之 间 的 单 继 

承 ， 但 支持 接口 之 间 的 多 继承 ， 并 支持 类 与 接口 之 间 的 实现 机 制 (关键 字 为 

implements) 。Java 语 言 全 面 支持 动态 绑 定 ， 而 C++ 语言 只 对 虚 函 数 使 用 动态 
绑 定 。 总 之 ，Java 语 言 是 一 个 纯 的 面向 对 象 程序 设计 语言 。 


Java 语 言 是 分 布 式 的 : 


Java 语 言 支持 Internet 应 用 的 开发 ， 在 基本 的 Java 应 用 编程 接口 中 有 一 个 网 络 
应 用 编程 接口 (avanet ， 它 提供 了 用 于 网 络 应 用 编程 的 类 库 ， 包 括 URL、 
URLConnection、Socket、ServerSocket 等 。Java 的 RMI (远程 方法 激活 ) 机 
制 也 是 开发 分 布 式 应 用 的 重要 手段 。 


Java 语 言 是 健壮 的 : 

Java 的 强 类 型 机 制 、 异 常 处 理 、 垃 圾 的 自动 收集 等 是 Java 程 序 健壮 性 的 重要 保 
证 。 对 指针 的 丢弃 是 Java 的 明智 选择 。Java 的 安全 检查 机 制 使 得 Java 更 具 健 壮 
性 。 


e Java 语言 是 安全 的 : 





Java 通 常 被 用 在 网 络 环境 中 ， 为 此 ，Java 提 供 了 一 个 安全 机 制 以 防 悉 意 代 码 的 
攻击 。 除 了 Java 话 言 具有 的 许多 安全 特性 以 外 ，Java 对 通过 网 络 下 载 的 类 具有 
一 个 安全 防范 机 制 〈 类 ClassLoader) ， 如 分 配 不 同 的 名 字 空 间 以 防 蔡 代 本 地 
的 同名 类 、 字 节 代 码 检 查 ， 并 提供 安全 管理 机 制 (类 SecurityManager) 让 
Java 应 用 设置 安全 哈 兵 。 


Java 语 言 是 体系 结构 中 立 的 : 


Java 程 序 (后 级 为 java 的 文件 ) 在 Java 平 台 上 被 编译 为 体系 结构 中 立 的 字 节 码 
格式 (后 级 为 class 的 文件 ) ， 然 后 可 以 在 实现 这 个 Java 平 台 的 任何 系统 中 运 
行 。 这 种 途径 适合 于 异 构 的 网 络 环境 和 软件 的 分 发 。 


Java 语 言 是 可 移植 的 : 


这 种 可 移植 性 来 源 于 体系 结构 中 立 性 ， 另 外 ，Java 还 严格 规定 了 各 个 基本 数据 
类 型 的 长 度 。Java 系 统 本 身 也 具有 很 强 的 可 移植 性 ，Java 编 译 器 是 用 Java 实 现 
的 ，Java 的 运行 环境 是 用 ANSI C 实 现 的 。 


e Java 语言 是 解释 型 的 : 


如 前 所 述 ，Java 程 序 在 Java 平 台 上 被 编译 为 字 节 码 格式 ， 然 后 可 以 在 实现 这 个 
Java 和 平台 的 任何 系统 中 运行 。 在 运行 时 ，Java 平 台中 的 Java 解 释 器 对 这 些 字 节 
码 进 行 解释 执行 ， 执 行 过程 中 需要 的 类 在 联接 阶段 被 载 人 到 运行 环境 中 。 


Java 是 高 性 能 的 : 


与 那些 解释 型 的 高 级 脚本 语言 相 比 ，Java 的 确 是 高 性 能 的 。 事 实 上 ，Java 的 运 
行 速度 随 着 JIT(Just-In-Time) 编译 器 技术 的 发 展 越 来 越 接近 于 C++。 


e Java 语 言 是 多 线程 的 : 


在 Java 语 言 中 ， 线 程 是 一 种 特殊 的 对 象 ， 它 必须 由 Thread 类 或 其 子 (5h) 类 来 
创建 。 通 常 有 两 种 方法 来 创建 线程 : 其 一 ， 使 用 型 构 为 Thread(Runnable) 的 构 
造 子 将 一 个 实现 了 Runnable 接 口 的 对 象 包装 成 一 个 线程 ， 其 二 ， 从 Thread 类 
派生 出 子 类 并 重 写 run 方 法 ， 使 用 该 子 类 创建 的 对 象 即 为 线程 。 值 得 注意 的 是 
Thread 类 已 经 实现 了 Runnable 接 口 ， 因 此 ， 任 何 一 个 线程 均 有 它 的 run 方 法 ， 
而 run 方 法 中 包含 了 线程 所 要 运行 的 代码 。 线 程 的 活动 由 一 组 方法 来 控制 。 
Java 语 言 支持 多 个 线程 的 同时 执行 ， 并 提供 多 线程 之 间 的 同步 机 制 〈 关 键 字 为 
synchronized) 。 


Javaj SEMAN: 


Java 语 言 的 设计 目标 之 一 是 适应 于 动态 变化 的 环境 。Java 程 序 需要 的 类 能 够 动 
态 地 被 载 人 到 运行 环境 ， 也 可 以 通过 网 络 来 载 人 所 需要 的 类 。 这 也 有 利于 软件 
的 升级 。 另外，Java 中 的 类 有 一 个 运行 时 刻 的 表示 ， 能 进行 运行 时 刻 的 类 型 检 
查 。 


发 展 历 史 


e 1995 年 5 月 23 日 ，Java 语 言 诞生 
e 1996 年 1 月 ， 第 一 个 JDK-JDK1.0 诞 生 


19964F4A, 10/4 8& BRERA oS AS ER = d Pe AJAVARR A 
1996 年 9 月 ， 约 8.3 万 个 网 页 应 用 了 JAVA 技术 来 制作 

1997 年 2 月 18 日 ，JDK1.1 发 布 

1997 年 4 月 2 日 ，JavaOne 会 议 召 开 ， 参 与 者 全 一 万 人 ， 创 当时 全 球 同类 会 议 规 
模 之 纪录 

1997 年 9 月 ，JavaDeveloperConnection 社 区 成 员 超 过 十 万 

1998 年 2 月 ，JDK1.1 被 下 载 超过 2,000,000 次 

1998 年 12 月 8 日 ，JAVA2 企 业 平台 J2EE 发 布 

1999 年 6 月 ，SUN 公 司 发 布 Java 的 三 个 版 本 : 标准 版 (JavaSE ,以 前 是 
J2SE) 、 企 业 版 (JavaEE 以 前 是 J2EE) 和 微型 版 (JavaME， 以 前 是 J2ME) 
2000 年 5 月 8 日 ，JDK1.3 发 布 

2000 年 5 月 29 日 ，JDK1.4 发 布 

2001 年 6 月 5 日 ，NOKIA 宣 布 ， 到 2003 年 将 出 售 1 亿 部 支持 Java 的 手机 
2001 年 9 月 24 日 ，J2EE1.3 发 布 

2002 年 2 月 26 日 ，J2SE1.4 发 布 ， 自 此 Java 的 计算 能 力 有 了 大 幅 提升 

2004 年 9 月 30 日 18:00PM，J2SE1.5 发 布 ， 成 为 Java 语 言 发 展 史 上 的 又 一 里 程 
碑 。 为 了 表示 该 版 本 的 重要 性 ，J2SE1.5 更 名 为 Java SE 5.0 

2005 年 6 月 ，JavaOne 大 会 召开 ，SUN 公 司 公 开 Java SE 6。 此 时 ，Java 的 各 
种 版 本 已 经 更 名 ， 以 取消 其 中 的 数字 "2" : J2EE 更 名 为 Java EE，J2SE 更 名 为 
Java SE，J2ME 更 名 为 Java ME 

2006 年 12 月 ，SUN 公 司 发 布 JRE6.0 

2009 年 04 月 20 日 ， 甲 骨 文 74 亿 美元 收购 Sun。 取 得 java 的 版 权 。 

2010 年 11 月 ， 由 于 甲骨 文 对 于 Java 社 区 的 不 友善 ， 因 此 Apache 扬 言 将 退出 
JCP[4]. 

2011 年 7 月 28 日 ， 甲 骨 文 发 布 java7.0 的 正式 版 。 


Java 开 发 工具 


Java 语 言 尽 量 保证 系统 内 存在 1G 以 上 ， 其 他 工具 如 下 所 示 : 


rz J+ 
安装 


Linux 系统 或 者 Windows 95/98/2000/XP, WIN 7/8 系 统 
Java JDK7 

Notepad 编 辑 器 或 者 其 他 编辑 器 。 

IDE : Eclipse 


好 以 上 的 工具 后 ， 我 们 就 可 以 输出 Java 的 第 一 个 程序 "Hello World ! " 


public class MyFirstJavaProgram { 


public static void main(String []args) { 
System.out.println("Hello World"); 
j 


在 下 一 章节 我 们 将 介绍 如 何 配 置 java 开 发 环境 。 


Java 开 发 环境 配置 


在 本 章节 中 我 们 将 为 大 家 介绍 如 何 搭建 Java 开 发 环境 。 
window 系 统 安装 java 


下 载 JDK 


首先 我 们 需要 下 载 java 开 发 工具 包 JDK， 下 载 地 
HE : http:/Awww.oracle.com/technetwork/java/javase/downloads/index.html, 533; 
如 下 下 载 按钮 : 


下 载 后 JDK 的 安装 根据 提示 进行 ， 还 有 安装 JDK 的 时 候 也 会 安装 JRE， 一 并 安装 就 
可 以 了 。 


安装 JDK， 安 装 过 程 中 可 以 自 定义 安装 目录 等 信息 ， 例 如 我 们 选择 安装 目录 为 
C:\Program Files\Java\jdk1.7.0 。 

配置 环境 变量 

安装 完成 后 ， 右 击 "我 的 电脑 "， 点 击 "属性 " ; 

2 .选择 "高 级 "选项 卡 ， 点 击 "环境 变量 " ; 

然后 就 会 出 现 如 下 图 所 示 的 画 


一 人 


TutorialsPoint Java 技术 教程 
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在 "系统 变量 "中 设置 3 项 属性 ，JAVA_HOME,PATH,CLASSPATH( 大 小 写 无 所 谓 ), 若 
已 存在 则 点 击 " 编 辑 "， 不 存在 则 点 击 " 新 建 "。 











XiaoKang 的 用 户 变量 (U) 
值 


96USERPROFILE%\AppData\Local\Temp 








新 建 (N)… 编辑 (E)..…. 删除 (D) 














AMDAPPSDKRO... C:\Program Files (x86)\AMD APP\ 


CLASSPATH 496)AVA HOME?9&MibWools.jar;926JAVA H... 
ComSpec C:\Windows\system32\cmd.exe 
FP NO HOST CH.. NO 








新 建 (W)... 编辑 中.… 删除 (D 























iat 


fala 


py 
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量 名 : JAVA_HOME 


Java 开 发 环境 配置 780 


e 变量 值 : C:\Program Files\Java\jdk1.7.0 
/这 里 是 你 JDK 的 安装 路 径 ， 可 以 更 换 


e 变量 名 : CLASSPATH 
。 变量 值 : .;:%JAVA_HOME%\lib\dt.jar;:%JAVA_HOME%\lib\tools.jar; /记得 前 面 
有 个 ". " 


e 变量 名 : Path 
e 变量 值 : YJAVA_HOME%\bin;%JAVA_HOME%\jre\bin; 
这 是 java 的 环境 配置 ， 配 置 完成 后 直接 启动 eclipse， 它 会 自动 完成 java 环 境 的 配 


o 


[uf 


A AJDKz A XM 
1. "开始 "->;" 运 行 "， 键 人 "cmd" 


2、 键 入 命令 "java -version"，"java"，"javac" 几 个 命令 ， 出 现 画 面 ， 说 明 环 境 变 量 
配置 成 功 ; 


: Wsers \Riaokang> java 
用 法 : java [-options] class [args...] 
《执行 类 > 
a: m rtg -jar jarfile [args...1 
; x 4 
执行 jar 文件 > 


使 用 32 RE 《如 果 可 用 > 
= 64 WARRE QRAD 


-server pi 7G T "server" UM 


-hotspot "server" UM AES] [已 过 时 1 
eae EF 


server. 


-cp《 目 录 和 zip/^jar 文件 的 类 搜索 TM [ro 
-classpath <B Fn zips jar SiE p em 索 路 径 
| l= ge 
和 ZIP 档案 E 用 于 搜索 类 文件 。 
—-D<name >= <value> T 
设 
-verbose [:classigc ij 





Linux, UNIX, Solaris, FreeBSD:z£ 3 Z Se 


环境 变量 PATH 应 该 设 定 为 指向 Java 二 进 制 文件 安装 的 位 置 。 如 果 设 置 遇 到 困难 ， 
请 参考 shell 文 档 。 


例如 ， 假 设 你 使 用 bash 作 为 shell， 你 可 以 把 下 面 的 内 容 添加 到 你 的 .bashrc 文 件 结 
尾 : export PATH=/path/to/java:$PATH 


流行 JAVA 开发 工具 


正 所 谓 工 欲 善 其 事 必 先 利 其 器 ， 我 们 在 开发 java 语 言 过 程 中 同样 需要 依 款 不 错 的 开 
发 工具 ， 目 前 市 场 上 的 IDE 很 多 ， 本 文 为 大 家 推荐 一 下 几 款 java 开 发 工具 : 


e Notepad++ : Notepad++ 是 在 微软 视窗 环境 之 下 的 一 个 免费 的 代码 编辑 器 ， 下 
载 地 址 : http://notepad-plus-plus.org/ 

eNetbeans: 开 源 免费 的 java IDE， 下 载 地 址 : 
http://www.netbeans.org/index.html 

e Eclipse: 另 一 个 免费 开源 的 java IDE， 下 载 地 址 : http://www.eclipse.org/ 


Java 基 础 语法 


一 个 Java 程 序 可 以 认为 是 一 系列 对 象 的 集合 ， 而 这 些 对 象 通过 调用 彼此 的 方法 来 协 
同 工 作 。 下 面 简要 介绍 下 类 、 对 象 、 方 法 和 实例 变量 的 概念 。 


e 对 象 : 对 象 是 类 的 一 个 实例 ， 有 状态 和 行为 。 例 如 ， 一 条 狗 是 一 个 对 象 ， 它 的 
状态 有 : 颜色 、 名 字 、 品 种 ; 行为 有 : BEB. MU. EE, 

e X : 类 是 一 个 模板 ， 它 描述 一 类 对 象 的 行为 和 状态 。 

e 方法 : 方法 就 是 行为 ， 一 个 类 可 以 有 很 多 方法 。 逮 辑 运算 、 数 据 修改 以 及 所 有 
动作 都 是 在 方法 中 完成 的 。 

e 实例 变量 : 每 个 对 象 都 有 独特 的 实例 变量 ， 对 象 的 状态 由 这 些 实例 变量 的 值 决 
定 。 


第 一 个 Java 程 序 
下 面 看 一 个 简单 的 Java 程 序 ， 它 将 打印 字符 串 Hello World 


public class MyFirstJavaProgram { 
/* 第 一 个 Java 程 序 . 
* 它 将 打印 字符 串 Hello world 
M 
public static void main(String []args) { 
System.out.println("Hello World"); // 打印 Hello World 
} 


下 面 将 逐步 介绍 如 何 保存 、 编 译 以 及 运行 这 个 程序 : 


打开 Notepad， 把 上 面 的 代码 添加 进去 ; 

把 文件 名 保存 为 : MyFirstJavaProgram.java ; 

打开 cmd 命 令 窗 口 ， 进 入 目标 文件 所 在 的 位 置 ， 假 设 是 CA 

在 命令 行 窗口 键入 人 javac MyFirstJavaProgram.java 按 下 enter 键 编译 代码 。 如 
det cmd 命 令 提 示 符 会 进入 下 一 行 。 (假设 环境 变量 都 设置 好 
T3. 

e 再 键入 java MyFirstJavaProgram 按 下 Enter 键 就 可 以 运行 程序 了 


你 将 会 在 窗口 看 到 Hello World 


C : > javac MyFirstJavaProgram.java 
C : > java MyFirstJavaProgram 
Hello World 


基本 语法 


编写 Java 程 序 时 ， 应 注意 以 下 几 点 : 


e 大 小 写 敏 感 : Java 是 大 小 写 敏感 的 ， 这 就 意味 着 标识 符 Hello 与 hello 是 不 同 
的 。 

e 类 名 : 对 于 所 有 的 类 来 说 ， 类 名 的 首 字母 应 该 大 写 。 如 果 类 名 由 若干 单词 组 
成 ， 那 么 每 个 单词 的 首 字 母 应 该 大 写 ， 例 如 MyFirstJavaClass 。 

e 方法 名 : 所 有 的 方法 名 都 应 该 以 小 写字 母 开头 。 如 果 方 法 名 含有 若干 单词 ， 则 

后 面 的 每 个 单词 首 字母 大 写 。 

源 文件 名 : 源 文件 名 必须 和 类 名 相同 。 当 保存 文件 的 时 候 ， 你 应 该 使 用 类 名 作 

为 文件 名 保存 (切记 Java 是 大 小 写 敏感 的 ) ， 文 件 名 的 后 级 为 .java。 (HRM 

件 名 和 类 名 不 相同 则 会 导致 编译 错误 ) 。 

。 主 方法 入 口 : 所 有 的 Java 程序 由 public static void main(String args[]) 方 法 
开始 执行 。 


Java 标 识 符 


Java 所 有 的 组 成 部 分 都 需要 名 字 。 类 名 、 变 量 名 以 及 方法 名 都 被 称 为 标识 符 。 
关于 Java 标 识 符 ， 有 以 下 几 点 需要 注意 : 
e 27 的 标识 符 都 应 该 以 字母 (A-Z 或 者 a-z) ,美元 符 ($) 、 或 者 下 划 线 (_) F 
VEN 
首 字 符 之 后 可 以 是 任何 字符 的 组 合 
关键 字 不 能 用 作 标 识 符 
标识 符 是 大 小 写 敏 感 的 


合法 标识 符 举 例 : age、$salary、_value、_ 1 value 
非法 标识 符 举 例 : 123abc、-salary 


Java 修 饰 符 
像 其 他 语言 一 样 ，Java 可 以 使 用 修饰 符 来 修饰 类 中 方法 和 属性 。 主 要 有 两 类 修饰 
符 : 
e 可 访问 修饰 符 : default, public , protected, private 
e 不 可 访问 修饰 符 : final, abstract, strictfp 
在 后 面 的 章节 中 我 们 会 深入 讨论 Java 修 饰 符 。 


Java = 


Java 中 主要 有 如 下 几 种 类 型 的 变量 
e 局 部 变量 
e 类 变量 (静态 变量 ) 


e RAZE (GEARS) 


Java 数 组 

数组 是 储存 在 堆 上 的 对 象 ， 可 以 保存 多 个 同类 型 变量 。 在 后 面 的 章节 中 ， 我 们 将 会 
学 到 如 何 声 明 、 构 造 以 及 初始 化 一 个 数组 。 

Java 枚 举 


Java 5.0 引 入 了 枚 举 ， 枚 举 限制 变量 只 能 是 预先 设 定好 的 值 。 使 用 枚 举 可 以 减少 代 
码 中 的 bug。 


例如 ， 我 们 为 果汁 店 设计 一 个 程序 ， 它 将 限制 果汁 为 小 杯 、 中 杯 、 大 杯 。 这 就 意味 
着 它 不 允许 顾客 点 除了 这 三 种 尺寸 外 的 果汁 。 
实例 


class FreshJuice { 
enum FreshJuiceSize( SMALL, MEDUIM, LARGE } 
FreshJuiceSize size; 


public class FreshJuiceTest { 
public static void main(String args[]){ 
FreshJuice juice = new FreshJuice(); 
juice.size - FreshJuice. FreshJuiceSize.MEDUIM ; 


注意 : 枚 举 可 以 单独 声明 或 者 声明 在 类 里 面 。 方 法 、 变 量 、 构 造 范 数 也 可 以 在 枚 举 
中 定义 。 


Java 天 键 字 
下 面 列 出 了 Java 保 留 字 。 这 些 保留 字 不 能 用 于 常量 、 变 量 、 和 任何 标识 符 的 名 称 。 
关键 字 描述 
abstract 抽象 方法 ， 抽 象 类 的 修饰 符 
assert 断言 条 件 是 否 满足 
boolean 布尔 数据 类 型 
break 跳出 循环 或 者 label 代 码 段 


byte 8-bit 有 符号 数据 类 型 


case 
catch 
char 
class 
const 
continue 
default 
do 
double 
else 
enum 


extends 


final 


finally 


float 

for 

goto 

if 
implements 
import 
instanceof 
int 
interface 
long 
native 
new 
package 


private 


switch 语 句 的 一 个 条 件 

和 try 搭 配 扑 捉 异 常 信息 
16-bit Unicode 字 符 数 据 类 型 
定义 类 

未 使 用 

不 执行 循环 体 剩余 部 分 
switch 语 句 中 的 默认 分 支 
循环 语句 ， 循 环 体 至 少 会 执行 一 次 
64-bit 双 精度 浮 点 数 

if 条 件 不 成 立时 执行 的 分 支 
枚 举 类 型 


表示 一 个 关 是 另 一 个 类 的 子 类 


表示 一 个 值 在 初始 化 之 后 就 不 能 再 改变 了 表示 方法 不 能 被 重 


写 ， 或 者 一 个 类 不 能 有 子 类 


为 了 完成 执行 的 代码 而 设计 的 ， 主 要 是 为 了 程序 的 健壮 性 和 完 


整 性 ， 无 论 有 没有 异常 发 生 都 执行 代码 。 
32-bit 单 精度 浮 点 数 

for 循 环 语句 

未 使 用 

条 件 语句 

表示 一 个 类 实现 了 接口 

导入 类 

测试 一 个 对 象 是 否 是 某 个 类 的 实例 
32 位 整 型 数 

接口 ， 一 种 抽象 的 类 型 ， 仅 有 方法 和 常量 的 定义 
64 位 整 型 数 

表示 方法 用 非 java 代 码 实现 

分 配 新 的 类 实例 

一 系列 相关 类 组 成 一 个 包 

表示 私有 字段 ， 或 者 方法 等 ， 只 能 从 类 内 部 访问 


protected 表示 字段 只 能 通过 类 或 者 其 子 类 访问 子 类 或 者 在 同一 个 包 内 的 
其 他 类 

public 表示 共有 属性 或 者 方法 

return 方法 返回 值 

short 16 位 数字 

static 表示 在 类 级 别 定 义 ， 所 有 实例 共享 的 

strictfp 浮 点 数 比 较 使 用 严格 的 规则 

super 表示 基 类 

switch 选择 语句 


synchronized 


this 


表示 同一 时 间 只 能 由 一 个 线程 访问 的 代码 块 
表示 调用 当前 实例 RSA 3 — T MIR 


throw 抛 出 异常 
throws 定义 方法 可 能 抛 出 的 异常 
transient 修饰 不 要 序列 化 的 字段 
wy 表示 代码 块 要 做 异常 处 理 或 者 和 finally 配 合 表示 是 否 抛 出 异常 
都 执行 finally 中 的 代码 
void 标记 方法 不 返回 任何 值 
volatile 标记 字段 可 能 会 被 多 个 线程 同时 访问 ， 而 不 做 同步 
while while% 
Javajt # 


类 似 于 C/C++，Java 也 支持 单行 以 及 多 行 注释 。 注 释 中 的 字符 将 被 Java 编 译 器 忽 
Re. 


public class MyFirstJavaProgram{ 

/* 这 是 第 一 个 Java 程 序 

* 它 将 打印 Hello World 

* 这 是 一 个 多 行 注释 的 示例 

2A 

public static void main(String []largs){ 
// 这 是 单行 注释 的 示例 
/* 这 个 也 是 单行 注释 的 示例 */ 
System.out.println("Hello World"); 

} 
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空白 行 ， 或 者 有 注释 的 的 行 ，Java 编 译 器 都 会 忽略 掉 。 


ATEN 
在 Java 中 ， 一 个 类 可 以 由 其 他 类 派生 。 如 果 你 要 创建 一 个 类 ， 而 且 已 经 存在 一 个 类 
具有 你 所 需要 的 属性 或 方法 ， 那 么 你 可 以 将 新 创建 的 关 继 承 该 类 。 


利用 继承 的 方法 ， 可 以 重用 已 存在 类 的 方法 和 属性 ， 而 不 用 重 写 这 些 代码 。 被 继承 
的 类 称 为 超 类 (superclass) ， 派 生 类 称 为 子 类 (subclass) 。 


接口 


在 Java 中 ， 接 口 可 理解 为 对 象 间 相互 通信 的 协议 。 接 口 在 继承 中 扮演 着 很 重要 的 角 


接口 只 定义 派生 要 用 到 的 方法 ， 但 是 方法 的 具体 实现 完全 取决 于 派生 类 。 
下 一 节 介绍 Java 编 程 中 的 类 和 对 象 。 之 后 你 将 会 对 Java 中 的 类 和 对 象 有 更 清楚 的 认 


Ro 


Java 对 象 和 类 


Java 作 为 一 种 面向 对 象 语言 。 支 持 以 下 基本 概念 : 


方 ; 
消息 解析 


本 节 我 们 重点 研究 对 象 和 类 的 概念 。 
e 对 象 : 对 象 是 类 的 一 个 实例 ， 有 状态 和 行为 。 例 如 ， 一 条 狗 是 一 个 对 象 ， 它 的 


状态 有 : 颜色 、 名 字 、 品 种 ; 行为 有 : BEB n. EE, 
e 类 : 类 是 一 个 模板 ， 它 描述 一 类 对 象 的 行为 和 状态 。 


Java 中 的 对 象 

现在 让 我 们 深入 了 解 什 么 是 对 象 。 看 看 周围 真实 的 世界 ， 会 发 现 身 边 有 很 多 对 象 ， 
车 ， 狗 ， 人 等 等 。 所 有 这 些 对 象 都 有 自己 的 状态 和 行为 。 

拿 一 条 狗 来 举例 ， 它 的 状态 有 : BF. GH. Me, TAA: 叫 、 摇 尾巴 和 跑 。 
对 比 现实 对 象 和 软件 对 象 ， 它 们 之 间 十 分 相似 。 

软件 对 象 也 有 状态 和 行为 。 软 件 对 象 的 状态 就 是 属性 ， 行 为 通过 方法 体现 。 

在 软件 开发 中 ， 方 法 操作 对 象 内 部 状态 的 改变 ， 对 象 的 相互 调用 也 是 通过 方法 来 完 


o 
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Java 中 的 类 


类 可 以 看 成 是 创建 Java 对 象 的 模板 。 
通过 下 面 一 个 简单 的 类 来 理解 下 Java 中 类 的 定义 : 


public class Dog{ 
String breed; 
int age; 
String color; 
void barking(){ 
j 


void hungry(){ 
} 


void sleeping(){ 
j 


一 个 类 可 以 包含 以 下 类 型 变量 : 


e 局 部 变量 : 在 方法 、 构 造 方法 或 者 语句 块 中 定义 的 变量 被 称 为 局 部 变量 。 变 量 
声明 和 初始 化 都 是 在 方法 中 ， 方 法 结束 后 ， 变 量 就 会 自动 销毁 。 

e 成 员 变 量 : 成 员 变 量 是 定义 在 类 中 ， 方 法 体 之 外 的 变量 。 
的 时 候 实 例 化 。 成 员 变 量 可 以 被 类 中 方法 、 构造 方法 和 特定 类 的 语句 块 访问 。 

e 类 变量 : 类 变量 也 声明 在 类 中 ， 方 法 体 之 外 ， B e 型 。 


一 个 类 可 以 拥有 多 个 方法 ， 在 上 面 的 例子 中 : barking()、hungry() 和 sleeping() 都 是 
Dog 类 的 方法 。 


SHE N 
构造 方法 
每 个 类 都 有 构造 方法 。 如 果 没 有 显 式 地 为 类 定义 构造 方法 ，Java 编 译 器 将 会 为 该 类 
提供 一 个 默认 构造 方法 。 


在 创建 一 个 对 象 的 时 人 息 ， 至 少 要 调用 一 个 构造 方法 。 构 造 方法 的 名 称 必须 与 类 同 
名 ， 一 个 类 可 以 有 多 个 构造 方法 。 


下 面 是 一 个 构造 方法 示例 : 


public class Puppy{ 
public Puppy(){ 
} 


public Puppy(String name){ 
// 这 个 构造 器 仅 有 一 个 参数 : name 
} 
} 


创建 对 象 


对 象 是 根据 类 创建 的 。 在 Java 中 ， 使 用 关键 字 new 来 创建 一 个 新 的 对 象 。 创 建 对 象 
需要 以 下 三 步 : 
。 声 明 : 声明 一 个 对 象 ， 包 括 对 象 名 称 和 对 象 关 型 。 


e 实例 化 : 使 用 关键 字 new 来 创建 一 个 对 象 。 
e 初始 化 : 使 用 new 创 建 对 象 时 ， 会 调用 构造 方法 初始 化 对 象 。 


下 面 是 一 个 创建 对 象 的 例子 : 


public class Puppy{ 
public Puppy(String name) { 
// 这 个 构造 器 仅 有 一 个 参数 : name 
System.out.println("Passed Name is :" + name ); 


} 


public static void main(String []args){ 
// 下 面 的 语句 将 创建 一 个 Puppy 对 象 
Puppy myPuppy = new Puppy( "tommy" ); 


编译 并 运行 上 面 的 程序 ， 会 打印 出 下 面 的 结果 : 


Passed Name is :tommy 


访问 实例 变量 和 方法 
通过 已 创建 的 对 象 来 访问 成 员 变 量 和 成 员 方法 ， 如 下 所 示 : 


/* 实例 化 对 象 */ 
ObjectReference = new Constructor(); 
/* 访问 其 中 的 变量 */ 
ObjectReference.variableName; 

/* 访问 类 中 的 方法 */ 
ObjectReference.MethodName(); 


实例 
下 面 的 例子 展示 如 何 访问 实例 变量 和 调用 成 员 方法 : 


public class Puppy{ 
int puppyAge; 
public Puppy(String name) { 
// 这 个 构造 器 仅 有 一 个 参数 : name 
System.out.println("Passed Name is :" + name ); 


j 


public void setAge( int age ){ 
puppyAge - age; 


public int getAge( ){ 
System.out.println("Puppy's age is :" + puppyAge ); 
return puppyAge; 

} 


public static void main(String []Jargs){ 
/* 创建 对 象 */ 
Puppy myPuppy = new Puppy( "tommy" ); 
/* 通过 方法 来 设 定 age */ 
myPuppy.setAge( 2 ); 
/* 调用 另 一 个 方法 获取 age */ 
myPuppy.getAge( ); 
/* 你 也 可 以 像 下 面 这 样 访问 成 员 变 量 */ 
System.out.println("Variable Value :" + myPuppy.puppyAge ); 


Sp. S 
编译 并 运行 上 面 的 程序 ， 产 生 如 下 结果 : 


Passed Name is :tommy 
Puppy's age is :2 
Variable Value :2 


源 文 件 声明 规则 


在 本 节 的 最 后 部 分 ， 我 们 将 学 习 源 文件 的 声明 规则 。 当 在 一 个 源 文件 中 定义 多 个 
类 ， 并 且 还 有 import 语 句 和 package 语 句 时 ， 要 特别 注意 这 些 规则 。 


e 一 个 源 文件 中 只 能 有 一 个 public 类 

e 一 个 源 文件 可 以 有 多 个 非 public 类 

e. 源 文件 的 名 称 应 该 和 public 类 的 类 名 保持 一 致 。 例 如 : 源 文件 中 public 类 的 类 名 
是 Employee， 那 么 源 文 件 上 应 该 命名 为 Employee.java。 

e 如 果 一 个 类 定义 在 某 个 包 中 ， 那么 package 语 句 应 该 在 源 文件 的 首 行 。 

e 如 果 源 文件 包含 import 语 句 ， 那 么 应 该 放 在 package 语 句 和 类 定义 之 间 。 如 果 
没有 package 语 句 ， 那 么 import 语 句 应 该 在 源 文件 中 最 前 面 。 

e import 语 句 和 package 语 句 对 源 文 件 中 定义 的 所 有 类 都 有 效 。 在 同一 源 文件 


中 ， 不 能 给 不 同 的 类 不 同 的 包 声 明 。 


SET 司 级 别 ， 并 且 类 也 分 不 同 的 类 型 : 抽象 类 和 final 类 等 。 这 些 将 在 访问 
控制 章节 介绍 。 


除了 上 面 提 到 的 几 种 类 型 ，Java 还 有 一 些 特 殊 的 类 ， 如 : ARK, BAH, 


Java 包 


包 主 要 用 来 对 类 和 接口 进行 分 类 。 当 开发 Java 程 序 时 ， 可 能 编写 成 百 上 二 的 类 ， 
此 很 有 必要 对 类 和 接口 进行 分 类 。 


Import 语 名 


在 Java 中 ， 如 果 给 出 一 个 完整 的 限定 名 ， 包 括 包 名 、 类 名 ， 那 么 Java 编 译 器 就 可 以 
T Import 语 句 就 是 用 来 提供 一 个 合理 的 路 径 ， 使 得 编 
译 器 可 以 找到 某 个 


例如 ， 下 面 的 命令 行将 会 命令 编译 器 载 人 java_installatiomjavayio 路 径 下 的 所 有 类 


import java.io.*; 


一 个 简单 的 例子 


在 该 例子 中 ， 我 们 创建 两 个 类 : Employee 和 EmployeeTest。 
首先 打开 文本 编辑 器 ， 把 下 面 的 代码 粘贴 进去 。 注 意 将 文件 保存 为 


Employee.java. 


Employee 类 有 四 个 成 员 变 量 : name、age、designation 和 salary。 该 类 显 式 声明 了 
一 个 构造 方法 ， 该 方法 只 有 一 个 参数 。 


import java.io.*; 
public class Employee( 
String name; 
int age; 
String designation; 
double salary; 
// Employee 类 的 构造 器 
public Employee(String name) { 
this.name = name; 


} 

// 设置 age 的 值 

public void empAge(int empAge) { 
age = empAge; 


} 

/* 设置 designation 的 值 */ 

public void empDesignation(String empDesig) { 
designation = empDesig; 

} 

/* 设置 salary 的 值 */ 

public void empSalary(double empSalary) { 
salary = empSalary; 


} 

/* 打印 信息 */ 

public void printEmployee(){ 
System.out.println("Name:"- name ); 
System.out.println("Age:" + age ); 
System.out.println("Designation:" + designation ); 
System.out.println("Salary:" + salary); 


程序 都 是 从 main 方 法 开始 执行 。 为 了 能 运行 这 个 程序 ， 必 须 包 含 main 方 法 并 且 创 建 
一 个 实例 对 象 。 


下 面 给 出 EmployeeTest 类 ， 该 类 实例 化 2 个 Employee 类 的 实例 ， 并 调用 方法 设置 变 
量 的 值 。 


将 下 面 的 代码 保存 在 EmployeeTest.java 文 件 中 。 


import java.io.*; 
public class EmployeeTest{ 


public static void main(String args[]){ 
/* 使 用 构造 器 创建 两 个 对 象 */ 

Employee empone = new Employee("James Smith"); 

Employee empTwo = new Employee("Mary Anne"); 

// 调用 这 两 个 对 象 的 成 员 方法 

empOne.empAge(26); 

empOne.empDesignation("Senior Software Engineer"); 

empOne.empSalary(1000); 

empOne.printEmployee(); 


empTwo.empAge(21); 
empTwo.empDesignation("Software Engineer"); 
empTwo.empSalary(500); 
empTwo.printEmployee(); 


编译 这 两 个 文件 并 且 运 行 EmployeeTest 类 ， 可 以 看 到 如 下 结果 : 


C :> javac Employee. java 

C :> vi EmployeeTest.java 

C :> javac EmployeeTest.java 
C :> java EmployeeTest 


Name:James Smith 

Age :26 

Designation:Senior Software Engineer 
Salary:1000.0 

Name:Mary Anne 

Age: 21 

Designation:Software Engineer 
Salary:500.0 


Java 基 本 数据 类 型 


变 S 量 就 是 申请 | J 存 来 和 仔 储 值 。 也 就 是 说 ， 当 创 建 变量 的 时 候 ， 需要 在 ts 请 2 
间 。 建 需要 在 内 存 中 申 诸 空 
A ma RRR EN 
型 数据 。 


因此 ， 通 过 定义 不 同类 型 的 变量 ， 可 以 在 内 存 中 储存 整数 、 小 数 或 者 字符 。 
Java 的 两 大 数据 类 型 : 


。 内 置 数 据 类 型 
。 引用 数据 类 型 


Ae as xB 


Java 语 言 提供 了 八 种 基本 类 型 。 六 种 数字 类 型 〈 四 个 整数 型 ， 两 个 浮 点 型 ) ， 一 种 
字符 类 型 ， 还 有 一 种 布尔 型 。 


byte : 


byte 数 据 类 型 是 8 位 、 有 符号 的 ， 以 二 进 制 补 码 表示 的 整数 ; 

最 小 值 是 -128 (-2^7) ; 

最 大 值 是 127 (247-1) 

默认 值 是 0 ; 

byte 类 型 用 在 大 型 数组 中 节约 空间 ， 主 要 代替 整数 ， 因 为 byte 变 量 占用 的 空间 
只 有 int 类 型 的 四 分 之 一 ; 

e 例子 : byte a = 100, byte b = -50。 


short : 


short 数 据 类 型 是 16 位 、 有 符号 的 以 二 进 制 补 码 表示 的 整数 
最 小 值 是 -32768 (-2^15) ; 

最 大 值 是 32767 (2^15-1) ; 

Short 数据 类 型 也 可 以 像 byte 那 样 节省 空间 。 一 个 short 变 量 是 int 型 变量 所 占 空 
间 的 二 分 之 一 ; 

e 默认 值 是 0 ; 

e 例子 : short s = 1000，short r = -20000。 


int : 


int 数 据 类 型 是 32 位 、 有 符号 的 以 二 进 制 补 码 表示 的 整数 ; 
最 小 值 是 -2,147,483,648 (-2^31) ; 

最 大 值 是 2,147,485,647 (2431 - 1) 

一 般 地 整 型 变量 默认 为 int 类 型 ; 

默认 值 是 0 ; 


e 例子 : int a = 100000, int b = -200000, 
long : 


e。 long 数 据 类 型 是 64 位 、 有 符号 的 以 二 进 制 补 码 表示 的 整数 ; 
e 最 小 值 是 -9,223,372,036,854,775,808 (-2^63) ; 

最 大 值 是 9,223,372,036,854,775,807 (2^63 -1) ; 

这 种 类 型 主要 使 用 在 需要 比较 大 整数 的 系统 上 ; 
默认 值 是 OL ; 

例子 : long a = 100000L，int b = -200000L。 


float : 


e float 数 据 类 型 是 单 精度 、32 人 位、 符合 IEEE 754 标 准 的 浮 点 数 ; 
float 在 储存 大 型 浮 点 数组 的 时 候 可 节省 内 存 空 间 ; 
默认 值 是 0.0f ; 

浮 点 数 不 能 用 来 表示 精确 的 值 ， 如 货币 ; 

例子 : float f1 = 234.5f。 


double : 


double 数 据 类 型 是 双 精 度 、64 位 、 符 合 IEEE 754 标 准 的 浮 点 数 ; 
浮 点 数 的 默认 类 型 为 double 类 型 ; 

double 类 型 同样 不 能 表示 精确 的 值 ， 如 货币 ; 

默认 值 是 0.0f ; 

例子 : double d1 = 123.4。 


boolean : 


e boolean 数 据 类 型 表示 一 位 的 信息 ; 

e 只 有 两 个 取 值 : true 和 false ; 

e 这 种 类 型 只 作为 一 种 标志 来 记录 true/false 情 况 ; 
e 默认 值 是 false ; 

e 例子 : boolean one = true. 


e char 类 型 是 一 个 单一 的 16 位 Unicode 字 符 ; 
e 最 小 值 是 \u0000”( 即 为 0) ; 

e 最 大 值 是 \uffff ( 即 为 65,535) ; 

e char 数 据 类 型 可 以 储存 任何 字符 ; 

e 例子 : char letter = ‘A’. 


实例 


对 于 数值 类 型 的 基本 类 型 的 取 值 范围 ， 我 们 无 需 强制 去 记忆 ， 因 为 它们 的 值 都 已 经 
以 常量 的 形式 定义 在 对 应 的 包装 类 中 了 。 请 看 下 面 的 例子 : 


public class PrimitiveTypeTest { 
public static void main(String[] args) { 


// byte 


System.out. 
System.out. 
System.out. 
System.out. 
System.out. 


// short 


System.out. 
System.out. 
System.out. 
System.out. 
System.out. 


// int 


System.out. 
System.out. 
System.out. 
System.out. 
System.out. 


// long 
System.out 


System.out 


// float 


System.out. 
System.out. 
.printlLn(" 最 小 值 : Float.MIN VALUE-" + Float.MIN V^ 


System.out 


System.out. 
System.out. 


// double 


System.out. 
.println("&X3 : java.lang.Double"); 


System.out 


System.out. 
System.out. 
.println(); 


System.out 


// char 
System.out 


println(" 基 本 类 型 : byte 二 进 制 位 数 :" + Byte.SIZE); 
println(" 包 装 类 : java.lang.Byte"); 
println(" 最 小 值 : Byte.MIN_VALUE="_+ Byte.MIN VALL 
println(" 最 大 值 : Byte .MAX_VALUE=" + Byte.MAX_VALL 
println(); 


println(" 基 本 类 型 : short 二 进 制 位 数 :" + Short.SIZE 
println(" 包 装 类 : java.lang.Short"); 
println(" 最 小 值 : Short.MIN_VALUE="_ + Short .MIN_VA 
println(" 最 大 值 : Short .MAX_VALUE=" + Short.MAX_VA 
println(); 


println(" 基 本 类 型 : int 二 进 制 位 数 :" + Integer.SIZE 
println(" 包 装 类 : java.lang.Integer"); 
println(" 最 小 值 : Integer.MIN VALUE-" + Integer .MI 
println(" 最 大 值 : Integer.MAX VALUE-" + Integer .MA 
println(); 


:println(" 基 本 类 型 : long 二 进 制 位 数 :" + Long.SIZE); 
System.out. 
System.out. 
.println(" 最 大 值 : Long. MAX VALUE-" + Long.MAX VALL 
System.out. 


println("&XX : java.lang.Long"); 
printlLn(" 最 小 值 : Long.MIN_VALUE="_ + Long.MIN_VALL 


println(); 

printlin(" 基 本 类 型 : float 二 进 制 位 数 :" + Float.SIZE 
println(" 包 装 类 : java.lang.Float"); 
println(" 最 大 值 : Float .MAX_VALUE=" + Float.MAX_VA 
println(); 

println(" 基 本 类 型 : double 二 进 制 位 数 :" + Double .SI 


printLn(" 最 小 值 : Double.MIN_VALUE=" + Double.MIN_ 
println(" 最 大 值 : Double.MAX VALUE-" + Double.MAX_ 


.println(" 基 本 类 型 : char 二 进 制 位 数 :" + Character.S 
System.out. 


println("&X : java.lang.Character"); 


// 以 数值 形式 而 不 是 字符 形式 将 Character .MIN_VALUE 输 出 到 控制 台 


System.out. 


printLn(" 最 小 值 : Character .MIN_VALUE=" 


+ (int) Character.MIN VALUE); 
// 以 数值 形式 而 不 是 字符 形式 将 Character .MAX_VALUE 输 出 到 控制 台 


System.out. 


println(" 最 大 值 : Character .MAX_VALUE=" 


+ (int) Character .MAX_VALUE); 


«| = 








编译 以 上 代码 输出 结果 如 下 所 示 : 


基本 类 型 : byte 二 进 制 位 数 : 8 
包装 类 : java.lang.Byte 

最 小 值 : Byte .MIN_VALUE=-128 
最 大 值 : Byte.MAX_VALUE=127 


基本 类 型 : short 二 进 制 位 数 : 16 
包装 类 : java.lang.Short 

最 小 值 : Short.MIN VALUE--32768 
最 大 值 : Short.MAX_VALUE=32767 


基本 类 型 : int 二 进 制 位 数 : 32 

包装 类 : java.lang.Integer 

最 小 值 : Integer .MIN_VALUE=-2147483648 
最 大 值 : Integer .MAX_VALUE=2147483647 


基本 类 型 : long 二 进 制 位 数 : 64 

包装 类 : java.lang.Long 

最 小 值 : Long.MIN_VALUE=-9223372036854775808 
最 大 值 : Long.MAX VALUE-9223372036854775807 


基本 类 型 : float 二 进 制 位 数 : 32 

包装 类 : java.lang.Float 

最 小 值 : Float.MIN_VALUE=1.4E-45 

最 大 值 : Float .MAX_VALUE=3 .4028235E38 


基本 类 型 : double 二 进 制 位 数 : 64 

包装 类 : java.lang.Double 

最 小 值 : Double.MIN VALUE-4.9E-324 

最 大 值 : Double.MAX_VALUE=1.7976931348623157E308 


基本 类 型 : char 二 进 制 位 数 : 16 

包装 类 : java.lang.Character 

最 小 值 : character.MIN VALUE-0 

最 大 值 : Character .MAX_VALUE=65535 


Float 和 Double 的 最 小 值 和 最 大 值 都 是 以 科学 记 数 法 的 形式 输出 的 ， 结 尾 的 "E+ 数 
字 " 表 示 E 之 前 的 数字 要 乘 以 10 的 多 少 倍 。 比 如 3.14E3 就 是 3.14x1000=3140， 
3.14E-3 就 是 3.14/1000=0.00314。 


实际 上 ，JAVA 中 还 存在 另外 一 种 基本 类 型 void， 它 也 有 对 应 的 包装 类 
java.lang.Void， 不 过 我 们 无 法 直接 对 它们 进行 操作 。 


引用 类 型 
。 引 用 类 型 变量 由 类 的 构造 丽 数 创建 ， 可 以 使 用 它们 访问 所 引用 的 对 象 。 这 些 变 


量 在 声明 时 被 指定 为 一 个 特定 的 类 型 ， 比 如 Employee、Pubby 等 。 变 量 一 旦 声 
明 后 ， 类 型 就 不 能 被 改变 了 。 

对 象 、 数 组 都 是 引用 数据 类 型 。 

所 有 引用 类 型 的 默认 值 都 是 null。 

一 个 引用 变量 可 以 用 来 引用 和 与 任何 与 之 兼容 的 类 型 。 

例子 : Animal animal = new Animal("giraffe"), 


量 就 是 一 个 固定 值 。 它 们 不 需要 计算 ， 直 接 代表 相应 的 值 。 
量 指 不 能 改变 的 量 。 在 Java 中 用 final 标 志 ， 声 明 方 式 和 变量 类 似 : 


final double PI = 3.1415927; 
虽然 常量 名 也 可 以 用 小 写 ， 但 为 了 便于 识别 ， 通 常 使 用 大 写字 母 表 示 常 量 。 
字面 量 可 以 赋 给 任何 内 置 类 型 的 变量 。 例 如 : 


byte a 
char a 


68; 
A! 


byte、int、long、 和 short 都 可 以 用 十 进 制 、16 进 制 以 及 8 进 制 的 方式 来 表示 。 
当 使 用 常量 的 时 候 ， 前 级 o 表 明 是 8 进 制 ， 而 前 级 0x 代 表 16 进 制 。 例 如 : 


int decimal = 100; 
int octal = 0144; 
int hexa = 0x64; 


和 其 他 语言 一 样 ，Java 的 字符 串 常 量 也 是 包含 在 两 个 引号 之 间 的 字符 序列 。 下 面 是 
字符 串 型 字面 量 的 例子 : 


"Hello World" 
"two\nlines" 
"\"This is in quotes\"" 


字符 串 常量 和 字符 常量 都 可 以 包含 任何 Unicode 字 符 。 例 如 : 


char a = '\u0001'; 
String a = "\u0001"; 


Java 语 言 支 持 一 些 特殊 的 转 义 字 符 序 列 。 


\n 换行 (0x0a) 

\r 回 车 (Ox0d) 

\f 换 页 符 (0x0c) 

\b 退 格 (0x08) 

\s 空格 (0x20) 

\t 制 表 符 

M 双 引 号 

单 引号 

\ 反 斜 杠 

\ddd 八进制 字符 (ddd) 
\UXXXX 16:# till Unicode F tF (xxxx) 


这 一 节 讲 解 了 Java 的 基本 数据 类 型 。 下 一 节 将 探讨 不 同 的 变量 类 型 以 及 它们 的 用 


N 
ILo 


Java % eg % Æ! 
ftJavai& Er, MANERA AER, SERS ORAM SCOOT : 


type identifier [ = value][, identifier [= value] ...] ; 


格式 说 明 : type 为 Java 数 据 类 型 。identifier 是 变量 名 。 可 以 使 用 去 号 隔 开 来 声明 多 
个 同类 型 变量 。 


以 下 列 出 了 一 些 变量 的 声明 实例 。 注 意 有 些 包 含 了 初始 化 过 程 。 


quta bc: // 声明 三 个 int 型 整数 : a、 b. c. 
int d = 3, e, f = 5; // dd 声明 三 个 整数 并 赋予 初 值 。 
byte z = 22; // 声明 并 初始 化 z。 

double pi = 3.14159; // 声明 了 pi。 

chan Xx = xs // 变量 x 的 值 是 字符 'x' 


Java 语 言 支持 的 变量 类 型 有 : 


e 局 部 变量 
e 成 员 变 量 


e 类 变量 


Java 局 部 变量 


e 局 部 变量 声明 在 方法 、 构 造 方 法 或 者 语句 块 中 ; 

局 部 变量 在 方法 、 构 造 方法 、 或 者 语句 块 被 执行 的 时 候 创 建 ， 当 它们 执行 完成 
后 ， 变量 将 会 被 销毁 ; 

访问 修饰 符 不 能 用 于 局 部 变量 ; 

局 部 变量 只 在 声明 它 的 方法 、 构 造 方 法 或 者 语句 块 中 可 见 

局 部 变量 是 在 栈 上 分 配 的 。 

局 部 变量 没有 默认 值 ， 所 以 局 部 变量 量 被 声明 后 ， 必 须 经 过 初始 化 ， 才 可 以 使 
用 。 


实例 1 


在 以 下 实例 中 age 是 一 个 局 部 变量 。 定 义 在 pubAge() 方 法 中 ， 它 的 作用 域 就 限制 在 
这 个 方法 中 。 


public class Test{ 
public void pupAge(){ 
int age = 0; 
age = age + 7; 
System.out.println("Puppy age is " * age); 
j 


public static void main(String args[]){ 
Test test = new Test(); 


test.pupAge(); 
j 
j 


以 上 实例 编译 运行 结果 如 下 : 


Puppy age is: 7 


实例 2 


在 下 面 的 例子 中 age 变量 没有 初始 化 ， 所 以 在 编译 时 出 错 。 


public class Test{ 
public void pupAge(){ 
int age; 
age = age + 7; 
System.out.println("Puppy age is " * age); 
} 


public static void main(String args[]){ 
Test test = new Test(); 


test.pupAge(); 
} 
} 


以 上 实例 编译 运行 结果 如 下 : 


Test.java:4:variable number might not have been initialized 
age = age + 7; 

^ 
1 error 


e 实例 变量 声明 在 一 个 类 中 ， 但 在 方法 、 构 造 方 法 和 语句 块 之 外 ; 


e 当 一 个 对 象 被 实例 化 之 后 ， 每 个 实例 变量 的 值 就 跟着 确定 ; 

e 实例 变量 在 对 象 创建 的 时 候 创 建 ， 在 对 象 被 销毁 的 时 候 销 毁 ; 

e 实例 变量 的 值 应 该 至 少 被 一 个 方法 、 构 造 方法 或 者 语句 块 引用 ， 使 得 外 部 能 够 
通过 这 些 方 式 获取 实例 变量 信息 ; 

。 实例 变量 可 以 声明 在 使 用 前 或 者 使 用 后 ; 

e 访问 修饰 符 可 以 修饰 实例 变量 ; 

e 实例 变量 对 于 类 中 的 方法 、 构 造 方法 或 者 语句 块 是 可 见 的 。 一 般 情 况 下 应 该 把 
实例 变量 设 为 私有 。 通 过 使 用 访问 修饰 符 可 以 使 实例 变量 对 子 类 可 见 ; 

e 实例 变量 具有 默认 值 。 数 值 型 变量 的 默认 值 是 0， 布 尔 型 变量 的 默认 值 是 
false， 引 用 类 型 变量 的 默认 值 是 null。 变 量 的 值 可 以 在 声明 时 指定 ， 也 可 以 在 
构造 方法 中 指定 ; 

e 实例 变量 可 以 直接 通过 变量 名 访问 。 但 在 静态 方法 以 及 其 他 类 中 ， 就 应 该 使 用 
完全 限定 名 : ObejectReference.VariableName。 


实例 : 


import java.io.*; 
public class Employeef{ 
// 这 个 成 员 变 量 对 子 类 可 见 
public String name; 
// 私有 变量 ， 仅 在 该 类 可 见 
private double salary; 
// 在 构造 器 中 对 name 赋 值 
public Employee (String empName) { 
name = empName; 


} 

// 设 定 salary 的 值 

public void setSalary(double empSal){ 
salary = empSal; 


} 

// 打印 信息 

public void printEmp(){ 
System.out.println("name : " + name ); 
System.out.println("salary :" + salary); 


j 


public static void main(String args[]){ 
Employee empOne = new Employee("Ransika"); 
empOne.setSalary(1000) ; 
empOne.printEmp(); 
j 
j 


以 上 实例 编译 运行 结果 如 下 : 


name : Ransika 
salary :1000.0 


» 


Ese (静态 变量 ) 


类 变量 也 称 为 静态 变量 ， 在 类 中 以 static 关 键 字 声明 ， 但 必须 在 方法 构造 方法 和 
语句 块 之 外 。 


° 无 论 一 个 类 创建 了 多 少 个 对 象 类 只 拥有 类 变量 的 一 份 拷贝 。 
e 静态 变量 除了 被 声明 为 常量 外 很 少 使 用 。 常量 是 指 声明 为 publc/private，final 


和 static 类 型 的 变量 。 常 量 初始 化 后 不 可 改变 。 
RS CMATEM ATA, GAMER RM, estate Re 


静 太 变量 在 程序 开始 时 创建 在 程序 结束 时 销毁 。 

与 实例 变量 具有 相似 的 可 见 性 。 但 为 了 对 类 的 使 用 者 可 见 ， 大 多 数 静 态 变量 声 
明 为 public 类 型 。 

默认 值 和 实例 变量 相似 。 数 值 型 变量 默认 值 是 0， 布 尔 型 默认 值 是 false， 引 用 

类 型 默认 全 是 null。 变 量 的 值 可 以 在 声明 的 时 候 指定 ， 也 可 以 在 构造 方法 中 指 

定 。 此 外 ， 静 态 变量 还 可 以 在 静态 语句 块 中 初始 化 。 

静态 变量 可 以 通过 : ClassName.VariableName 的 方式 访问 。 

类 变量 被 声明 为 public static final 类 型 时 ， 类 变量 名 称 必 须 使 用 大 写字 母 。 如 果 
SS N E 其 命名 方式 与 实例 变量 以 及 局 部 变量 的 命名 

方式 一 至 


实例 : 


import java.io.*; 
public class Employee( 


j 


//salary 是 静态 的 私有 变量 
private static double salary; 
// DEPARTMENT 是 一 个 常量 
public static final String DEPARTMENT = "Development "; 
public static void main(String args[]){ 

salary = 1000; 

System.out.println(DEPARTMENT+"average salary:"+salary); 
} 


以 上 实例 编译 运行 结果 如 下 : 


Development average salary:1000 


注意 : 如 果 其 他 类 想 要 访问 该 变量 ， 可 以 这 样 访问 : Employee. DEPARTMENT, 
本 章节 中 我 们 学 习 了 Java 的 变量 类 型 ， 下 一 章节 中 我 们 将 介绍 Java 修 饰 符 的 使 用 。 


Javal tis FF 


Java 语 言 提 供 了 很 多 修饰 符 ， 主 要 分 为 以 下 两 类 : 


e 访问 修饰 符 
e 非 访 问 修饰 符 


修饰 符 用 来 定义 类 、 方 法 或 者 变量 ， 通 常 放 在 语句 的 最 前 端 。 我 们 通过 下 面 的 例子 
来 说 明 : 
public class className { 
OA 


j 

private boolean myFlag; 

static final double weeks = 9.5; 

protected static final int BOXWIDTH - 42; 

public static void main(String[] arguments) { 
// 方法 体 

} 


访问 控制 修饰 符 

Java 中 ， 可 以 使 用 访问 控制 符 来 保护 对 类 、 变 量 、 方 法 和 构造 方法 的 访问 。Java 支 
持 4 种 不 同 的 访问 权限 。 

默认 的 ， 也 称 为 default， 在 同一 包 内 可 见 ， 不 使 用 任何 修饰 符 。 

私有 的 ， 以 private 修 饰 符 指定 ， 在 同一 类 内 可 见 。 

共有 的 ， 以 public 修 饰 符 指定 ， 对 所 有 类 可 见 。 

受 保 折 的 ， 以 protected 修 饰 符 指定 ， 对 同一 包 内 的 类 和 所 有 子 类 可 见 。 


默认 访问 修饰 答 - 不 使 用 任何 关键 字 


使 用 默认 访问 修饰 符 声 明 的 变量 和 方法 ， 对 同一 个 包 内 的 类 是 可 见 的 。 接 口 里 的 变 
量 都 隐 式 声明 为 public static final, 而 接口 里 的 方法 默认 情况 下 访问 权限 为 public。 


实例 : 


如 下 例 所 示 ， 变 量 和 方法 的 声明 可 以 不 使 用 任何 修饰 符 。 


String version = "1.5.1"; 
boolean processOrder() { 
return true; 


私有 访问 修饰 符 -private 


私有 访问 修饰 符 是 最 严格 的 访问 级 别 ， 所 以 被 声明 为 private 的 方法 、 变 量 和 构造 方 
法 只 能 被 所 属 类 访问 ， 并 且 类 和 接口 不 EA 4A 7j private, 


声明 为 私有 访问 类 型 的 变量 只 能 通过 类 中 公共 的 getter 方 法 被 外 部 类 访问 。 
Private 访 问 修饰 符 的 使 用 主要 用 来 隐藏 类 的 实现 细节 和 保护 类 的 数据 。 
下 面 的 类 使 用 了 私有 访问 修饰 符 : 
public class Logger { 
private String format; 
public String getFormat() { 


return this.format; 


public void setFormat(String format) { 
this.format = format; 


} 
} 


实例 中 ，Logger 类 中 的 format 变 量 为 私有 变量 ， 所 以 其 他 类 不 能 直接 得 到 和 设置 该 
变量 的 值 。 为 了 使 其 他 类 能 够 操作 该 变量 ， 定 义 了 两 个 public 方 法 : getFormat() 
(返回 format 的 值 ) 和 setFormat(String) (设置 format 的 值 ) 

公有 访问 修饰 符 -public 

被 声明 为 public 的 类 、 方法、 构造 方法 和 接口 能 够 被 任何 其 他 类 访问 。 


如 果 几 个 相互 访问 的 public 类 分 布 在 不 用 的 包 中 ， 则 需要 导入 相应 public 类 所 在 的 
包 。 由 于 类 的 继承 性 ， 类 所 有 的 公有 方法 和 变量 都 能 被 其 子 类 继承 。 


以 下 图 数 使 用 了 公有 访问 控制 : 


public static void main(String[] arguments) { 
Saari 
j 


Java 程 序 的 main() 方法 必须 设置 成 公有 的 ， 否 则 ，Java 解 释 器 将 不 能 运行 该 类 。 


受 保 护 的 访问 修饰 符 -protected 


被 声明 为 protected 的 变量 、 方 法 和 构造 器 能 被 同一 个 包 中 的 任何 其 他 类 访问 ， 也 能 
够 被 不 同 包 中 的 子 类 访问 。 


Protected 访 问 修饰 符 不 能 修饰 类 和 接口 ， 方 法 和 成 员 变 量 能 够 声明 为 protected,， 
但 是 接口 的 成 员 变 量 和 成 员 方 法 不 能 声明 为 protected。 


类 能 访问 Protected 修 饰 符 声明 的 方法 和 变量 ， 这 样 就 能 保 扩 不 相关 的 类 使 用 这 些 
方法 和 变量 。 


下 面 的 父 类 使 用 了 protected 访 问 修饰 符 ， 子 类 重 载 了 父 类 的 openSpeaker() 方 法 。 

class AudioPlayer { 

protected boolean openSpeaker(Speaker sp) { 

// 实现 细节 

} 
} 
class StreamingAudioPlayer { 

boolean openSpeaker(Speaker sp) { 


// 实现 细节 
} 

} 
如 果 把 openSpeaker() 方 法 声明 为 private， 那 么 除了 AudioPlayer 之 外 的 类 将 不 能 访 
问 该 方法 。 如 果 把 openSpeaker() 声 明 为 public， 那 么 所 有 的 类 都 能 够 访问 该 方法 。 
如 果 我 们 只 想 让 该 方法 对 其 所 在 类 的 子 类 可 见 ， 则 将 该 方法 声明 为 protected。 
访问 控制 和 继承 
请 注意 以 下 方法 继承 的 规则 : 

e 父 类 中 声明 为 public 的 方法 在 子 类 中 也 必须 为 public。 


e 父 类 中 声明 为 protected 的 方法 在 子 类 中 要 么 声明 为 protected， 要 么 声明 为 
public。 不 能 声明 为 private。 


e 父 类 中 默认 修饰 符 声 明 的 方法 ， 能 够 在 子 类 中 声明 为 private。 
e 父 类 中 声明 为 private 的 方法 ， 不 能 够 被 继承 。 


非 访 问 修饰 符 


为 了 实现 一 些 其 他 的 功能 ，Java 也 提供 了 许多 非 访问 修饰 符 。 
static 修 饰 符 ， 用 来 创建 类 方法 和 类 变量 。 


Final 修 饰 符 ， 用 来 修饰 类 、 方 法 和 变量 ，final 修 饰 的 类 不 能 够 被 继承 ， 修 饰 的 方法 
不 能 被 继承 类 重新 定义 ， 修 饰 的 变量 为 常量 ， 是 不 可 修改 的 。 


Abstract 修 饰 符 ， 用 来 创建 抽象 类 和 抽象 方法 。 
Synchronized 和 volatile 修 饰 符 ， 主 要 用 于 线程 的 编程 。 


Static 修 饰 符 


e 静态 变量 
Static 关 键 字 用 来 声明 独立 于 对 象 的 静态 变量 ， 无 论 一 个 类 实例 化 多 少 对 象 ， 
它 的 静态 变量 只 有 一 份 拷贝 。 静态 变量 也 被 成 为 类 变量 。 局 部 变量 能 被 声明 为 
static 交 量 。 


e 静态 方法 : 


Static 关 键 字 用 来 声明 独立 于 对 象 的 静态 方法 。 静 态 方法 不 能 使 用 类 的 非 静 态 
变量 。 静 态 方法 从 参数 列表 得 到 数据 ， 然 后 计算 这 些 数据 。 


对 类 变量 和 方法 的 访问 可 以 直接 使 用 classname.variablename 和 
classname.methodname 的 方式 访问 。 


如 下 例 所 示 ，static 修 饰 符 用 来 创建 类 方法 和 类 变量 。 


public class InstanceCounter { 
private static int numInstances = 0; 
protected static int getCount() { 
return numInstances; 


} 

private static void addInstance() { 
numInstances++; 

} 


InstanceCounter() { 
InstanceCounter.addInstance(); 
j 


public static void main(String[] arguments) { 
System.out.println("Starting with " + 
InstanceCounter.getCount() + " instances"); 
for (int i = 0; i < 500; ++i){ 
new InstanceCounter(); 


System.out.println("Created " + 
InstanceCounter.getCount() + " instances"); 
j 
j 


以 上 实例 运行 编辑 结果 如 下 : 


Started with 0 instances 
Created 500 instances 


Final +4 f 
Final & : 


Final 变 量 能 被 显 式 地 初始 化 并 且 只 能 初始 化 一 次 。 被 声明 为 final 的 对 象 的 引用 不 能 
指向 不 同 的 对 象 。 但 是 final 对 象 里 的 数据 可 以 被 改变 。 也 就 是 说 final 对 象 的 引用 不 
能 改变 ， 但 是 里 面 的 值 可 以 改变 。 


Final 修 饰 符 通常 和 static 修 饰 符 一 起 使 用 来 创建 类 常量 。 
实例 : 
public class Test{ 
final int value = 10; 
// 下 面 是 声明 常量 的 实例 
public static final int BOXWIDTH = 6; 
static final String TITLE = "Manager"; 
public void changeValue()( 
value = 12; // 将 输出 一 个 错误 


} 
} 


Final 方 法 
类 中 的 Final 方 法 可 以 被 子 类 继承 ， 但 是 不 能 被 子 类 修改 。 


声明 final 方 法 的 主要 目的 是 防止 该 方法 的 内 容 被 修改 。 
如 下 所 示 ， 使 用 final 修 饰 符 声 明 方 法 。 


public class Test{ 
public final void changeName(){ 


// 方法 体 
} 
} 
Final 类 


Final 类 不 能 被 继承 ， 没 有 类 能 够 继承 final 类 的 任何 特性 。 


实例 : 


public final class Test { 
// 类 体 
j 


Abstract / f 
抽象 类 : 
抽象 关 不 能 用 来 实例 化 对 象 ， 声 明 抽象 类 的 唯一 目的 是 为 了 将 来 对 该 类 进行 扩充 。 


一 个 类 不 能 同时 被 abstract 和 final 修 饰 。 如 果 一 个 类 包含 抽象 方法 ， 那 么 该 类 一 定 要 
声明 为 抽象 类 ， 否 则 将 出 现 编译 错误 。 
抽象 类 可 以 包含 抽象 方法 和 非 抽 象 方法 。 
实例 : 
abstract class Caravan{ 
private double price; 
private String model; 
private String year; 


public abstract void goFast(); // 抽 象 方法 
public abstract void changeColor(); 


抽象 方法 


抽象 方法 是 一 种 没有 任何 实现 的 方法 ， 该 方法 的 的 具体 实现 由 子 类 提供 。 抽 象 方法 
不 能 被 声明 成 final 和 strict。 


任何 继承 抽象 类 的 子 类 必须 实现 父 类 的 所 有 抽象 方法 ， 除 非 该 子 类 也 是 抽象 类 。 


如 果 一 个 类 包含 知 干 个 抽象 方法 ， 那 么 该 类 必须 声明 为 抽象 类 。 抽 象 类 可 以 不 包含 
抽象 方法 。 


抽象 方法 的 声明 以 分 号 结尾 ， 例 如 : public abstract sample(); 


实例 : 


public abstract class SuperClass{ 
abstract void m(); // 抽 象 方法 


} 
class SubClass extends SuperClasst 
// 实 现 抽 象 方法 
void m(){ 
} 


Synchronized 修 饰 符 


Synchronized 关 键 字 声 明 的 方法 同一 时 间 只 能 被 一 个 线程 访问 。Synchronized 修 饰 
符 可 以 应 用 于 四 个 访问 修饰 符 。 
实例 : 


public synchronized void showDetails(){ 


Transient/Z / 4 
序列 化 的 对 象 包含 被 transient 修 饰 的 实例 变量 时 ，java 虚 拟 机 (JVM) 跳 过 该 特定 的 变 


EA 


Bo 
该 修饰 符 包 含 在 定义 变量 的 语句 中 ， 用 来 预 处 理 类 和 变量 的 数据 类 型 。 
实例 : 


public transient int limit = 55; // will not persist 
public int b; // will persist 


volatile 修 饰 符 

Volatile 修 饰 的 成 员 变量 在 每 次 被 线程 访问 时 ， 都 强迫 从 共享 内 存 中 重读 该 成 员 变 量 
的 值 。 而 且 ， 当 成 员 变量 发 生变 化 时 ， 强 迫 线 程 将 变化 值 回 写 到 共享 内 存 。 这 样 在 
任何 时 刻 ， 两 个 不 同 的 线程 总 是 看 到 某 个 成 员 变量 的 同一 个 值 。 一 个 volatile 对 象 引 
用 可 能 是 null。 


实例 : 


public class MyRunnable implements Runnable 


{ 
private volatile boolean active; 
public void run() 
{ 
active = true; 
while (active) // line 1 
// 代码 
} 
public void stop() 
{ 
active = false; // line 2 
} 
} 


一 般 地 ， 在 一 个 线程 中 调用 run() 方 法 ， 在 另 一 个 线程 中 调用 stop() 方 法 。 如 果 line 1 
中 的 active 位 于 缓冲 区 的 值 被 使 用 ， 那 么 当 把 line 2 中 的 active 设 置 成 false 时 ， 循 环 
也 不 会 停止 。 


Javaiz AF 


计算 机 的 最 基本 用 途 之 一 就 是 执行 数学 运算 ， 作 为 一 门 计算 机 语言 ，Java 也 提供 了 
一 套 丰 富 的 运算 符 来 操纵 变量 。 我 们 可 以 把 运算 符 分 成 以 下 几 组 : 


e 算术 运算 符 
e 关系 运算 符 
e 位 运算 符 
逻辑 运算 符 
赋值 运算 符 
其 他 运算 符 


算术 运算 符 


算术 运算 符 用 在 数学 表达 式 中 ， 它 们 的 作用 和 在 数学 中 的 作用 一 样 。 下 表 列 出 了 所 
有 的 算术 运算 符 。 


表格 中 的 实例 假设 整数 变量 A 的 值 为 10， 变 量 B 的 值 为 20 : 


操作 符 描述 例子 
+ 加 法 - 相 加 运算 符 两 侧 的 值 A+B 等 于 30 
减法 - 左 操 作 数 减 去 右 操作 数 A 一 B 等 于 -10 
乘法 - 相 乘 操作 符 两 侧 的 值 A* B 等 于 200 
/ 除法 - 左 操作 数 除 以 右 操作 数 B/AS&T2 
% 取 模 - 右 操作 数 除 左 操作 数 的 余数 B%A 等 于 0 
Lus Eg - 操作 数 的 值 增加 1 4 
自 减 - 操作 数 的 值 减少 1 B - -等 于 19 
实例 


下 面 的 简单 示例 程序 演示 了 算术 运算 符 。 复 制 并 粘贴 下 面 的 Java 程 序 并 保存 为 
Testjava 文 件 ， 然 后 编译 并 运行 这 个 程序 : 


public class Test { 


public static void main(String args[]) { 


int a 
int b 
int c 
int d 


system. 
System. 
system. 
system. 
system. 
System. 
System. 


System. 


} 
} 

以 上 实例 编译 运行 
a+b = 30 
a - b= -10 
a * b = 200 
ber, sae? 
b%a=0 
c%a=5 
att = 10 
b-- = il 
d++ = 25 
++d =E 


10; 


out. 


关系 运算 符 


下 表 为 Java 支 持 的 关系 运算 符 
表格 中 的 实例 整数 变量 A 的 值 为 10， 变 量 B 的 值 为 20 : 


.println("a 
.println("a 
.println("a 
.printJln("b / 
.println("b 
.println("c 
.println("ac- 


26 
% 


println("b-- 
// Check the difference 
System.out.printin("d++ 
System.out.println("--«d 


结果 如 下 : 


vo D700 


(a++) ); 
(ass) 
in d++ and ++d 

aan tte) J 
"+ (++d) ); 


二 十 十 十 十 十 十 十 


Hai 


Es 


检查 如 果 两 个 操作 数 的 值 是 否 相 等 ， 如 果 相 等 则 条 
件 为 真 。 


检查 如 果 两 个 操作 数 的 值 是 否 相等 ， 如 果 值 不 相等 


则 条 件 为 真 。 

y 检查 左 操作 数 的 值 是 否 大 于 右 操作 数 的 值 ， 如 果 是 
那么 条 件 为 真 。 

S 检查 左 操作 数 的 值 是 否 小 于 右 操作 数 的 值 ， 如 果 是 
那么 条 件 为 真 。 

、- ”检查 左 操作 数 的 值 是 否 大 于 或 等 于 右 操作 数 的 值 ， 
如 果 是 那么 条 件 为 真 。 

-- ”检查 左 操作 数 的 值 是 否 小 于 或 等 于 右 操作 数 的 值 ， 
如 果 是 那么 条 件 为 真 。 

实例 


例子 
(A==B) 为 假 
( 非 真 )。 
(A=!B) 为 
(A>B) 非 
真 。 
(A<B) 为 
(A>=B) 为 
Bi. 
(A<=B) 为 


下 面 的 简单 示例 程序 演示 了 关系 运算 符 。 复 制 并 粘贴 下 面 的 Java 程 序 并 保存 为 
Test.java 文 件 ， 然 后 编译 并 运行 这 个 程序 : 


pu 


以 上 


Too M9 MD 


blic class Test { 


public static void main(String args[]) { 
int a = 10; 
int b = 20; 


System.out.println("a == b = " + (a == b) ); 
System.out.println("a != b = " + (a != b) ); 
System.out.printin("a > b=" + (a> b) ); 
System.out.println("a« b=" + (a <b) ); 


System.out.println("b >= a 
System.out.println("b «- a 


} 

实例 编译 运行 结果 如 下 : 
== b = false 

I- b = true 

> b = false 

« b = true 

>= a = true 

<= a = false 


"+ (b >= a) ); 
"+ (b <= a) ); 


位 运算 符 


Java 定 义 了 位 运算 符 ， 应 用 于 整数 类 型 (int)， 长 整 型 (long)， 短 整 型 (short)， 字 符 型 


(char)， 和 字 节 型 (byte) 等 类 型 。 


位 运算 符 作 用 在 所 有 的 位 上 ， 并 且 按 位 运算 。 假 设 a = 60， 和 b = 13; 它 们 的 二 进 制 
格式 表示 将 如 下 : 


0011 1100 
0000 1101 
= 0000 1100 

B = 0011 1101 
= 0011 0001 
1100 0011 


下 表 列 出 了 位 运算 符 的 基本 运算 ,假设 整数 变量 A 的 值 为 60 和 变量 B 的 值 为 13 : 


<< 
>> 


>>> 


实例 


描 


学 


按 位 与 操作 符 ， 当 且 仅 当 两 个 操作 数 的 某 一 位 都 非 
0 时 候 结果 的 该 位 才 为 1。 


按 位 或 操作 符 ， 只 要 两 个 操作 数 的 某 一 位 有 一 个 非 
0 时 候 结果 的 该 位 就 为 1。 


按 位 异 或 操作 符 ， 两 个 操作 数 的 某 一 位 不 相同 时 候 
结果 的 该 位 就 为 1。 


按 位 补 运算 符 翻转 操作 数 的 每 一 位 。 
按 位 左 移 运 算 符 。 左 操作 数 按 位 左 移 右 操作 数 指定 
的 位 数 。 


按 位 右 移 运算 符 。 左 操作 数 按 位 右 移 右 操作 数 指定 
的 位 数 。 


按 位 右 移 补 堆 操 作 符 。 左 操作 数 的 值 按 右 操 作 数 指 
定 的 位 数 右 移 ， 移 动 得 到 的 空位 以 需 填 充 。 


例子 


(A&B) ， 得 到 
12， 即 0000 
1100 


(A|B) 得 到 
61， 即 0011 
1101 


(A^B) 得 到 
49， 即 0011 
0001 

(?A) 得 到 -60， 
即 1100 0011 


A << 2 得 到 240， 
即 1111 0000 


A >> 2 得 到 15 即 
1111 


A>>>2 得 到 15 即 
0000 1111 


下 面 的 简单 示例 程序 演示 了 位 运算 符 。 复 制 并 粘贴 下 面 的 Java 程 序 并 保存 为 
Test.java 文 件 ， 然 后 编译 并 运行 这 个 程序 : 


public class Test { 
public static void main(String args[]) { 


int a = 60; /* 60 = 0011 1100 */ 

int b = 13; /* 13 = 0000 1101 */ 

int c = 0; 

c-a&b; /* 12 - 0000 1100 */ 
System.out.printin("a& b=" +c ); 

c =a | b; /* 61 = 0011 1101 */ 
System.out.println("a | b= "+c ); 

c =a^ b; /* 49 = 0011 0001 */ 
System.out.printin("a ^ b=" +c ); 

(p sas /*-61 = 1100 0011 */ 
System.out.println("-a = "+c ); 

C= < 2 /* 240 = 1111 0000 */ 
System.out.println("a << 2- "+c ); 
Cc =a >> 2; Jo 2h Ges Ad 5 
System.out.printin("a >> 2 =" +c ); 
C =a >>> 2; /* 215 = 0000 1111 */ 
System.out.println("a >>> 2 =" +c ); 


以 上 实例 编译 运行 结果 如 下 : 


逻辑 运算 符 


下 表 列 出 了 逮 辑 运算 符 的 基本 运算 ， 假 设 布 尔 变量 A 为 真 ， 变 量 B 为 假 


VE 描述 例子 
符 
&& 称 为 逻辑 与 运算 符 。 当 且 仅 当 两 个 操作 数 都 为 真 ， 条 件 才 (A && 
为 真 。 B) 为 假 。 
T 称 为 逻辑 或 操作 符 。 如 果 任 何 两 个 操作 数 任 何 一 个 为 真 ， (A || B) 
条 件 为 真 。 为 真 。 
i 称 为 逻辑 非 运 算 符 。 用 来 反 转 操作 数 的 逻辑 状态 。 如 果 条 ! (A && 
件 为 true， 则 逻辑 非 运 算 符 将 得 到 false。 B) 为 真 。 
实例 


下 面 的 简单 示例 程序 演示 了 逻辑 运算 符 。 复 制 并 粘贴 下 面 的 Java 程 序 并 保存 为 
Test.java 文 件 ， 然 后 编译 并 运行 这 个 程序 : 


public class Test { 
public static void main(String args[]) { 
boolean a = true; 
boolean b = false; 


System.out.println("a && b = " + (a&&b)); 
System.out.println("a || b=" + (a||b) ); 
System.out.println("!(a && b) = " + !(a && b)); 
} 
} 


以 上 实例 编译 运行 结果 如 下 : 


= false 
= true 
b) = true 


赋值 运算 符 


下 面 是 Java 语 言 支 持 的 赋值 运算 符 : 


<<= 


>>= 


实例 


描 


学 


简单 的 赋值 运算 符 ， 将 右 操 作 数 的 值 赋 给 左 
侧 操作 数 


加 和 赋值 操作 符 ， 它 把 左 操作 数 和 右 操 作 数 
相 加 赋值 给 左 操作 数 


减 和 赋值 操作 符 ， 它 把 左 操作 数 和 右 操作 数 
相 减 赋值 给 左 操作 数 


乘 和 赋值 操作 符 ， 它 把 左 操作 数 和 右 操 作 数 
相 乘 赋值 给 左 操作 数 


除 和 赋值 操作 符 ， 它 把 左 操作 数 和 右 操 作 数 
相 除 赋值 给 左 操作 数 


取 模 和 赋值 操作 符 ， 它 把 左 操作 数 和 右 操 作 
效 取 模 后 赋值 给 左 操作 数 


左 移 位 赋值 运算 符 
右 移 位 赋值 运算 符 


按 位 与 赋值 运算 符 


按 位 异 或 赋值 操作 符 
按 位 或 赋值 操作 符 


例子 
C = A + BHHEA + B 得 
FIAJ RAC 
C += A 等 价 于 C = C+ 
A 


C -= A 等 价 于 C= C -人 A 
C = A 等 价 于 C= CA 


C /= A 等 价 于 C= C/A 
C %= A 等 价 于 C= C 
%A 

C < = 2 等 价 于 C=C 


<<2 


C >>= 2 等 价 于 C= C 


>>? 


C &= 2590 FC = C& 
2 


C ^- 2984 FC = C ^2 
C |= 24MFC=C|2 


面 的 简单 示例 程序 演示 了 赋值 运算 符 。 复 制 并 粘贴 下 面 的 Java 程 序 并 保存 为 
Test.java 文 件 ， 然 后 编译 并 运行 这 个 程序 : 


public class Test { 


public static void main(String 
10; 


int a 
int b 
int c 
C a b; 
System.out 
Cc *- a8 ; 

System. 
c --a; 
System. 
C *=-a 7 
System. 
a 10; 
C ili 
c/a; 


20 
0; 


System.out. 


a 
C 
c %= 


10; 
257 
a; 


System.out. 


c <<= 2 ; 


System.out. 


c >> 2; 


System.out. 


(922—520 
System. 
c &-a ; 
System. 
C AS ER 
System. 
c |= a3 

System.out 


out. 


out. 


out. 


out. 


out. 


out. 


, 


.println("c 
println("c 
println("c 


println("c 


println("c 


println("c 
println("c 
println("c 
println("c 
println("c 
println("c 


.println("c 


以 上 实例 编译 运行 结果 如 下 : 


000000000000 


+ b = 30 
a = 40 
a = 30 
a = 300 
a 1 
a =5 

2 = 20 

2=5 

2x 

a =0 

a - 10 
- 10 


args[]) 1 
Sea bee UNE 
sey ee es ie 
ee EC We 
nier E " + C ys 
je cU Ee 
ee ey = jy 
Sez c cc 
>>=28 zo cpu 
>>= a =" +c); 
&=2 ="+C ); 
A= a tC 
人 


条 件 运 算 符 (X) 


条 件 运算 符 也 被 称 为 三 元 运算 符 。 该 运算 符 有 3 个 操作 数 ， 并 且 需 要 判断 布尔 表达 
式 的 值 。 该 运算 符 的 主要 是 决定 哪个 值 应 该 赋值 给 变量 。 


variable x = (expression) ? value if true : value if false 


实例 


public class Test { 
public static void main(String args[]){ 
int a , b; 


a = 10; 
b = (a == 1) ? 20: 30; 
System.out.println( "Value of b is: "+ b ); 
b = (a == 10) ? 20: 30; 
System.out.println( "Value of b is: "+b ); 


} 
} 


以 上 实例 编译 运行 结果 如 下 : 


Value of b is : 30 
Value of b is : 20 


instanceOf 运算 符 


六 和 算 符 用 于 操作 对 象 实例， 检查 该 对 象 是 否 是 一 个 特定 类 型 ( 关 关 型 或 接口 
型 o 


instanceof 运 算 符 使 用 格式 如 下 : 


( Object reference variable ) instanceOf (class/interface type) 


如 果 运 算 符 左 侧 变 量 所 指 的 对 象 ， 是 操作 符 右 侧 类 或 接口 (class/interface) 的 一 个 对 
象 ， 那 么 结果 为 真 。 


下 面 是 一 个 例子 : 


String name = 'James'; 
boolean result = name instanceof String; // 由 于 name 是 Strine 类 型 ， 所 上 


«| mE 








如 果 被 比较 的 对 象 兼容 于 右 侧 类 型 ,该 运算 符 仍 然 返 回 true。 
看 下 面 的 例子 : 


class Vehicle {} 


public class Car extends Vehicle { 
public static void main(String args[]){ 
Vehicle a = new Car(); 
boolean result = a instanceof Car; 
System.out.println( result); 


} 
} 


以 上 实例 编译 运行 结果 如 下 : 


true 


Java 运 算 符 优先 级 


当 多 个 运算 符 出 现在 一 个 表达 式 中 ， 谁 先 谁 后 呢 ? 这 就 涉及 到 运算 符 的 优先 级 别 的 
ea i Et 


o 


例如 ， (143) + (342) “2， 这 个 表达 式 如 果 按 加 号 最 优先 计算 ， 答 案 就 是 18， 
如 果 按 照 乘 号 最 优先 ， 答 案 则 是 14。 


再 如 ，x =7 + 3 2; 这 里 x 得 到 13， 而 不 是 20， 因 为 乘法 运算 符 比 加 法 运算 符 有 较 高 
的 优先 级 ， 所 以 先 计算 3 2 得 到 6， 然 后 再 加 7。 


下 表 中 具有 最 高 优先 级 的 运算 符 在 的 表 的 最 上 面 ， 最 低 优先 级 的 在 表 的 底部 。 


向 | 


操作 符 天 联 性 


OU . (点 操作 符 ) 左 到 右 
++-17 nee 
“1% 左 到 右 
du ABA 
>> >>> << ARMA 
>> << 左 到 右 
=== ABA 
& ABA 
A ABA 
ABA 
&& ABA 
2 za 
mpm c c EUUE ce E a MAEI 
NE = E 
ABA 


Java 循 环 结构 - for, while 及 do...while 

顺序 结构 的 程序 语句 只 能 被 执行 一 次 。 如 果 您 想 要 同样 的 操作 执行 多 次 ,， 就 需要 使 
用 循环 结构 。 

Java 中 有 三 种 主要 的 循环 结构 : 


e While 循环 
e do...while 循 环 
e for 循 环 


在 Java5 中 引入 了 一 种 主要 用 于 数组 的 增强 型 for 循 环 。 
while 循 环 
while 是 最 基本 的 循环 ， 它 的 结构 为 : 
while( 布尔 表达 式 ) { 
// 循 环 内 容 
} 
只 要 布尔 表达 式 为 true， 循 环 体会 一 直 执 行 下 去 。 


实例 


public class Test { 
public static void main(String args[]) { 
int x = 10; 


while( x < 20 ) { 
System.out.print("value of x: "+x ); 
X++; 


System.out.print("\n"); 
} 
} 
} 


以 上 实例 编译 运行 结果 如 下 : 


value of x : 10 
value of x : 11 
value of x : 12 
value of x : 13 
value of x : 14 
value of x : 15 
value of x : 16 
value of x : 17 
value of x : 18 
value of x : 19 
do...while 循 环 


对 于 while 语 句 而 言 ， 如 果 不 满足 条 件 ， 则 不 能 进入 循环 。 但 有 时 候 我 们 需要 即使 不 
满足 条 件 ， 也 至 少 执行 一 次 。 


do...while 循 环 和 while 循 环 相 似 ， 不 同 的 是 ，do...while 循 环 至 少 会 执行 一 次 。 


do { 
// 代 码 语句 
}while( 布 尔 表 达 式 ) ， 


注意 : 布尔 表达 式 在 循环 体 的 后 面 ， 所 以 语句 块 在 检测 布尔 表达 式 之 前 已 经 执行 
f. 如 果 布 尔 表达 式 的 值 为 true， 则 语句 块 一 直 执 行 ， 直 到 布尔 表达 式 的 值 为 
false。 


实例 


public class Test { 


public static void main(String args[]){ 
int x = 10; 


dof 
System.out.print("value of x: "+x ); 
X++; 
System.out.print("\n"); 
}while( x < 20 ); 
} 
} 


以 上 实例 编译 运行 结果 如 下 : 


value of x : 10 
value of x : 11 
value of x : 12 
value of x : 13 
value of x : 14 
value of x : 15 
value of x : 16 
value of x : 17 
value of x : 18 
value of x : 19 
for 循 环 


虽然 所 有 循环 结构 都 可 以 用 while 或 者 do...while 表 示 ， 但 Java 提 供 了 另 一 种 语句 
一 一 for 循环， 使 一 些 循环 结构 变 得 更 加 简单 。 


for 循 环 执行 的 次 数 是 在 执行 前 就 确定 的 。 语 法 格式 如 下 


for (初始 化 ; 布尔 表达 式 ) 更 新 ) { 
// 代 码 语句 
} 


关于 for 循 环 有 以 下 几 点 说 明 : 
e 最 先 执行 初始 化 步骤 。 可 以 声明 并 初始 化 一 个 或 多 个 循环 控制 变量 ， 也 可 以 是 


空 语句 。 

e 然后 ， 检 测 布尔 表 达 式 的 值 。 如 果 为 true， 循 环 体 被 执行 。 如 果 为 false， 循 环 
终止 ， 开 始 执行 循环 体 后 面 的 语句 。 

e 执行 一 次 循环 后 ， 更 新 循环 控制 变量 。 

e 再 次 检测 布尔 表达 式 。 循 环 执行 上 面 的 过 程 。 


实例 


public class Test { 
public static void main(String args[]) { 


for(int x = 10; x < 20; x = x*1) { 
System.out.print("value of x: "+x ); 
System.out.print("\n"); 
j 
j 
j 


以 上 实例 编译 运行 结果 如 下 : 


value of x : 10 
value of x : 11 
value of x : 12 
value of x : 13 
value of x : 14 
value of x : 15 
value of x : 16 
value of x : 17 
value of x : 18 
value of x : 19 
Java 增 强 for 循 环 


Java5 引 入 了 一 种 主要 用 于 数组 的 增强 型 for 循 环 。 
Java 增 强 for 循 环 语法 格式 如 下 : 


for( 声 明 语 句 : 表达 式 ) 


// 代 码 句 子 
} 


声明 语句 : 声明 新 的 局 部 变量 ， 该 变量 的 类 型 必须 和 数组 元 素 的 类 型 匹配 。 其 作用 
域 限定 在 循环 语句 块 ， 其 值 与 此 时 数组 元 素 的 值 相 等 。 


表达 式 : 表达 式 是 要 访问 的 数组 名 ， 或 者 是 返回 值 为 数组 的 方法 。 
实例 


public class Test { 


public static void main(String args[]){ 
int [] numbers = {10, 20, 30, 40, 50}; 


for(int x : numbers ){ 
System.out.print( x ); 
System.out.print(","); 

} 

System.out.print("\n"); 

String [] names ={"James", "Larry", "Tom", "Lacy"}; 

for( String name : names ) { 
System.out.print( name ); 
System.out.print(","); 

} 

} 


以 上 实例 编译 运行 结果 如 下 : 


10, 20, 30, 40, 50, 
James, Larry, Tom, Lacy, 


break 关 键 字 


break 主 要 用 在 循环 语句 或 者 switch 语 句 中 ， 用 来 跳出 整个 语句 块 。 
break 跳 出 最 里 层 的 循环 ， 并 且 继 续 执 行 该 循环 下 面 的 语句 。 


语法 
break 的 用 法 很 简单 ， 就 是 循环 结构 中 的 一 条 语句 : 


break; 


实例 


public class Test { 


public static void main(String args[]) { 
int [] numbers = {10, 20, 30, 40, 50}; 


for(int x : numbers ) { 
if( x == 30 ) ( 
break; 


n 
System.out.print( x ); 
System.out.print("\n"); 


以 上 实例 编译 运行 结果 如 下 : 


10 
20 


continue 关 键 字 


continue3& FH F EA fa £r: Tel 2a A. VE ik EP XEAUBER: EU BOR 9: 8535 


o 


在 for 循 环 中 ，continue 语 句 使 程序 立即 跳 转 到 更 新 语句 。 
在 while 或 者 do...while 循 环 中 ， 程 序 立即 跳 转 到 布尔 表达 式 的 判断 语句 。 


语法 
continue 就 是 循环 体 中 一 条 简单 的 语句 : 


continue; 


实例 


public class Test { 


public static void main(String args[]) { 
int [] numbers = {10, 20, 30, 40, 50}; 


for(int x : numbers ) { 
if( x == 30 ) { 
continue; 
} 
System.out.print( x ); 
System.out.print("\n"); 


以 上 实例 编译 运行 结果 如 下 : 


Java 分 支 结构 if...else/switch 


顺序 结构 只 能 顺序 执行 ， 不 能 进行 判断 和 选择 ， 因 此 需要 分 支 结 构 。 
Java 两 种 分 支 结 构 : 


e if 语句 
e Switch 语句 


if 语句 
一 个 if 语句 包含 一 个 布尔 表达 式 和 一 条 或 多 条 语句。 
语法 
lf 语句 的 用 语法 如 下 : 
if( 布 尔 表达 式 ) 


// 如 果 布 尔 表达 式 为 true 将 执行 的 语句 
} 


如 果 布 尔 表 达 式 的 值 为 true， 则 执行 if 语 句 中 的 代码 块 。 否 则 执行 |f 语 句 块 后 面 的 代 
码 。 


public class Test { 


public static void main(String args[]){ 
int x = 10; 


if( x < 20 ){ 
System.out.print("%z if #8"); 
} 
} 
} 


以 上 代码 编译 运行 结果 如 下 : 


if...else;z 4) 


if 语句 后 面 可 以 跟 else 话 句 ， 当 if 语句 的 布尔 表达 式 值 为 false 时 ，else 语 句 块 会 被 执 
行 。 
语法 
if...else 的 用 法 如 下 : 
if( 布 尔 表 达 式 ){ 
// 如 果 布 尔 表 达 式 的 值 为 true 
selse{ 


// 如 果 布 尔 表 达 式 的 值 为 false 
} 


实例 


public class Test { 


public static void main(String args[]){ 
int x = 30; 
if( x < 20 ){ 
System.out.print(" 这 是 if #48"); 
selse{ 
System.out.print("3xz& else j44)"); 
} 


} 
} 


以 上 代码 编译 运行 结果 如 下 : 


这 是 else 语句 


if...else if...elsej= 4) 


if 语句 后 面 可 以 跟 elseif...else 语 句 ， 这 种 语句 可 以 检测 到 多 种 可 能 的 情况 。 
使 用 if，else if，else 语 句 的 时 候 ， 需 要 注意 下 面 几 点 : 

e if 语句 至 多 有 1 个 else 语 句 ，else 语 名 在 所 有 的 elseif 语 名 之后。 

e lf 语句 可 以 有 若干 个 elseif 语 句 ， 它 们 必须 在 else 语 句 之 前 。 


e 一 旦 其 中 一 个 else if 语 句 检 测 为 ttue， 其 他 的 else if 以 及 else 语 句 都 将 跳 过 执 
行 。 


if...else 语 法 格式 如 下 : 


if( 布 尔 表达 式 1){ 

// 如 果 布 尔 表 达 式 1 的 值 为 true 执 行 代码 
yelse if( 布 尔 表达 式 2){ 

// 如 果 布 尔 表 达 式 2 的 值 为 true 执 行 代码 
yelse if( 布 尔 表达 式 3){ 

// 如 果 布 尔 表达 式 3 的 值 为 true 执 行 代码 
jelse { 

// 如 果 以 上 布尔 表达 式 都 不 为 true 执 行 代码 
} 


实例 


public class Test { 


public static void main(String args[]){ 
int x = 30; 


if( x == 10 ){ 
System.out.print("Value of X is 10"); 
jelse if( x == 20 ){ 
System.out.print("Value of X is 20"); 
selse if( x == 30 ){ 
System.out.print("Value of X is 30"); 
selse{ 
System.out.print("This is else statement"); 
j 
j 
j 


以 上 代码 编译 运行 结果 如 下 : 


Value of X is 30 


PE WNif...elsejz 4) 


使 用 谋 套 的 if-else 语 句 是 合法 的 。 也 就 是 说 你 可 以 在 另 一 个 if 或 者 elseif 语 句 中 使 用 if 
或 者 elseif 语 句 。 


语法 


岩 套 的 if...else 语 法 格式 如 下 : 


if( 布 尔 表 达 式 1){ 
//// 如 果 布 尔 表 达 式 1 的 值 为 true 执 行 代 码 
if( 布 尔 表达 式 2){ 
//// 如 果 布 尔 表 达 式 2 的 值 为 true 执 行 代码 
} 


} 
你 可 以 像 if 38.8] — RE else if...else. 
实例 


public class Test { 


public static void main(String args[]){ 
int x 30; 
int y 10; 


if( x == 30 ){ 
if( y == 10 ){ 
System.out.print("X = 30 and Y = 10"); 
} 


j 
} 


以 上 代码 编译 运行 结果 如 下 : 


X = 30 and Y = 10 


switch;z 4) 
switch 语 名 判断 一 个 变量 与 一 系列 值 中 某 个 值 是 否 相等 ， 每 个 值 称 为 一 个 分 支 。 
语法 


switch 语 法 格式 如 下 : 


switch(expression) { 
case value : 
// 语 名 
break; // 可 选 
case value : 
// 语 名 
break; // 可 选 
// 你 可 以 有 任意 数量 的 case 语 名 
default : // 可 选 
// 语 名 


switch 语 句 有 如 下 规则 : 


e Switch 语句 中 的 变量 类 型 只 能 为 byte、short、int 或 者 char。 
e Switch 语句 可 以 拥有 多 个 case 语 句 。 每 个 case 后 面 跟 一 个 要 比较 的 值 和 冒号 。 
e case 语 句 中 的 值 的 数据 类 型 必须 与 变量 的 数据 类 型 相同 ， 而 且 只 能 是 常量 或 者 


e 当 变 量 的 值 与 case 语 名 的 值 相 等 时 ， 那 么 case 语 名 之 后 的 语句 开始 执行 ， 直 到 
break 话 句 出 现 才 会 跳出 Switch 语句。3 

e 当 遇 到 break 语 句 时 ，Sswitch 语 名 终止 。 程 序 跳 转 到 switch 语 句 后 面 的 语句 执 
行 。case 语 句 不 必须 要 包 仿 break 语句。 如 果 没 有 break 语 句 出 现 ， 程 序 会 继续 
执行 下 一 条 case 语 句 ， 直 到 出 现 break 语 句 。 

e Switch 语句 可 以 包含 一 个 default 分 支 ， 该 分 支 必须 是 switch 语 句 的 最 后 一 个 分 
支 。default 在 没有 case 语 名 的 值 和 变量 值 相等 的 时 候 执 行 。default 分 支 不 需要 
breaki& 4]. 


实例 


public class Test { 


public static void main(String args[]){ 
//char grade = args[0].charAt(0); 
char grade = 'C'; 


switch(grade) 


case 'A' 
System.out.println("Excellent!"); 
break; 

case 'B' 

case 'C' 

System.out.println("Well done"); 
break; 

case 'D' 

System.out.println("You passed"); 

case 'F' : 

System.out.println("Better try again"); 
break; 

default 
System.out.println("Invalid grade"); 

} 


System.out.println("Your grade is " + grade); 


以 上 代码 编译 运行 结果 如 下 : 


$ java Test 

Well done 

Your grade isa C 
$ 


Java Number # 


一 般 地 ， 当 需要 使 用 数字 的 时 候 ， 我 们 通常 使 用 内 置 数据 类 型 ， 如 : byte, int, 
long、double 等 。 


实例 


int i = 5000; 
float gpa = 13.65; 
byte mask Oxaf; 


然而 ， 在 实际 开发 过 程 中 ， 我 们 经 常会 遇 到 需要 使 用 对 象 ， 而 不 是 内 和 置 数据 类 型 的 
情形 。 为 了 解决 这 个 问题 ，Java 语 说 为 每 一 个 内 置 数 据 类 型 提供 了 对 应 的 包装 类 。 


所 有 的 包装 类 (Integer. Long. Byte. Double, Float, Short) 都 是 抽象 类 
Number 的 子 类 。 







这 种 由 编译 器 特别 支持 的 包装 称 为 装 箱 ， 所 以 当 内 置 数据 类 型 被 当 作 对 象 使 用 的 时 
候 ， 编 译 器 会 把 内 置 类 型 装 箱 为 包装 类 。 相 似 的 ， 编 译 器 也 可 以 把 一 个 对 象 拆 箱 为 
内 和 置 类 型 。Number 类 属于 java.lang 包 。 


下 面 是 一 个 装 箱 与 拆 箱 的 例子 : 





public class Test{ 


public static void main(String args[]){ 
Integer x = 5; // boxes int to an Integer object 
x= X+ 10; // unboxes the Integer to a int 
System.out.println(x); 
j 
} 


以 上 实例 编译 运行 结果 如 下 : 


15 


当 x 被 赋 为 整 型 值 时 ， 由 于 x 是 一 个 对 象 ， 所 以 编译 器 要 对 Xx 进行 装 箱 。 然 后 ， 为 了 
使 x 能 进行 加 运算 ， 所 以 要 对 x 进行 拆 箱 。 


Number 类 的 成 员 方 法 
下 面 的 表 中 列 出 的 是 Number 类 的 方法 : 


方法 
xxxValue() 
compare To() 
equals() 
valueOf() 
toString() 
parselnt() 
abs() 
ceil() 
floor() 
rint() 
round() 
min() 
max() 
exp() 
log() 
pow() 
sqrt() 
sin() 
cos() 
tan() 
asin() 
acos() 
atan() 
atan2() 
toDegrees() 
toRadians() 


random() 


描述 
将 number 对 象 转换 为 Xxx 数据 类 型 的 值 并 返回 。 
将 number 对 象 与 参数 比较 。 
判断 number 对 象 是 否 与 参数 相等 。 
返回 一 个 Integer 对 象 指定 的 内 置 数 据 类 型 
以 字符 串 形式 返回 值 。 
将 字符 串 解 析 为 int 类 型 。 
返回 参数 的 绝对 值 。 
对 整形 变量 向 左 取 整 ， 返 回 类 型 为 double 型 。 
对 整 型 变量 向 右 取 整 。 返 回 类 型 为 double 类 型 。 
返回 与 参数 最 接近 的 整数 。 返 回 类 型 为 double。 
返回 一 个 最 接近 的 int、long 型 值 。 
返回 两 个 参数 中 的 最 小 值 。 
返回 两 个 参数 中 的 最 大 值 。 
返回 自然 数 底数 e 的 参数 次 方 。 
返回 参数 的 自然 数 底数 的 对 数值 。 
返回 第 一 个 参数 的 第 二 个 参数 次 方 。 
求 参 数 的 算术 平方 根 。 
求 指定 double 类 型 参数 的 正弦 值 。 
求 指定 double 类 型 参数 的 余弦 值 。 
求 指定 double 类 型 参数 的 正切 值 。 
求 指定 double 类 型 参数 的 反正 弦 值 。 
求 指定 double 类 型 参数 的 反 余 弦 值 。 
求 指定 double 类 型 参数 的 反正 切 值 。 


将 笛 卡 尔 坐标 转换 为 极 坐标 ， 并 返回 极 坐标 的 角度 值 。 


将 参数 转化 为 角度 。 
将 角度 转换 为 弧度 。 
返回 一 个 随机 数 。 


Java Character # 
使 用 字符 时 ， 我 们 通常 使 用 的 是 内 置 数据 类 型 char。 


实例 


char ch = 'a'; 


// Unicode for uppercase Greek omega character 
char uniChar = 'Nu039A'; 


// 字符 数组 
char[] charArray ={ 'a', 'b', 'c', 'd', 'e' }; 


然而 ， 在 实际 开发 过 程 中 ， 我 们 经 常会 遇 到 需要 使 用 对 象 ， 而 不 是 内 置 数 据 类 型 的 
情况 。 为 了 解决 这 个 问题 ，Java 语 盲 为 内 置 数 据 类 型 char 提 供 了 包装 类 Character 
米 

Character 类 提供 了 一 系列 方法 来 操纵 字符 。 你 可 以 使 用 Character 的 构造 方法 创建 
一 个 Character 类 对 象 ， 例 如 : 


Character ch = new Character('a'); 


在 某 些 情况 下 ，Java 编 译 器 会 自动 创建 一 个 Character 对 象 。 


例如 ， 将 一 个 char 类 型 的 参数 传递 给 需要 一 个 Character 类 型 参数 的 方法 时 ， 那 么 编 
译 器 会 自动 地 将 char 类 型 参数 转换 为 Character 对 象 。 这 种 特征 称 为 装 箱 ， 反 过 来 
称 为 拆 箱 。 


实例 


// Here following primitive char 'a' 
// is boxed into the Character object ch 
Character ch - 'a'; 


// Here primitive 'x' is boxed for method test, 


// return is unboxed to char 'c' 
char c = test('x'); 


转 义 序列 


前 面 有 反 斜 枉 (\) 的 字符 代表 转 义 字符 ， 它 对 编译 器 来 说 是 有 特殊 含义 的 。 
下 面 列表 展示 了 Java 的 转 义 序列 : 


转 义 序列 描述 
\t 在 文中 该 处 插入 一 个 tab 键 
\b 在 文中 该 处 插入 一 个 后 退 键 
\n 在 文中 该 处 换行 
\r 在 文中 该 处 插入 回 车 
\f 在 文中 该 处 插入 换 页 符 
\' 在 文中 该 处 插入 单 引 号 
i 在 文中 该 处 插入 双 引 号 
\ 在 文中 该 处 插入 反 斜 杠 
实例 


当 打 印 语句 直到 一 个 转 义 序列 时 ， 编 译 器 可 以 正确 地 对 其 进行 解释 。 


public class Test { 


public static void main(String args[]) { 
System.out.println("She said \"Hello!\" to me."); 


以 上 实例 编译 运行 结果 如 下 : 


She said "Hello!" to me. 


Character 方法 


下 面 是 Character 类 的 方法 : 


方法 

isLetter() 
isDigit() 
isWhitespace() 
isUpperCase() 
isLowerCase() 
toUpperCase() 
toLowerCase() 


toString() 


Br 
EH 


是 否 是 一 个 字母 

是 否 是 一 个 数字 字符 

是 否 一 个 空格 

是 否 是 大 写字 峡 

是 否 是 小 写字 母 

指定 字母 的 大 写 形 式 

指定 字母 的 小 写 形 式 

返回 字符 的 字符 串 形 式 ， 字 符 串 的 长 度 仅 为 1 


对 于 方法 的 完整 列表 ， 请 参 


考 的 java.lang.Character API 规 范 。 


Java String # 


字符 串 广泛 应 用 在 Java 编 程 中 ， 在 Java 中 字符 串 属于 对 象 ，Java 提 供 了 String 类 来 
创建 和 操作 字符 串 。 


创建 字符 串 
创建 字符 串 最 简单 的 方式 如 下 


String greeting = "Hello world!"; 


在 代码 中 遇 到 字符 串 常 量 时 ， 这 里 的 值 是 "Hello worldI"， 编 译 器 会 使 用 该 值 创建 一 
个 String 对 象 。 


和 其 它 对 象 一 样 ， 可 以 使 用 关键 字 和 构造 方法 来 创建 String 对 象 。 
String 类 有 11 种 构造 方法 ， 这 些 方 法 提供 不 同 的 参数 来 初始 化 字符 串 ， 上 比如 提供 一 
个 字符 数组 参数 : 
public class StringDemo{ 
public static void main(String args[]){ 

chapbenelloAnnayecc me Mer mI tu 

String helloString - new String(helloArray); 

System.out.println( helloString ); 


} 
} 


以 上 实例 编译 运行 结果 如 下 : 


hello. 


注意 :String 类 是 不 可 改变 的 ， 所 以 你 一 旦 创建 了 String 对 象 ， 那 它 的 值 就 无 法 改变 
了 。 如 果 需 要 对 字符 串 做 很 多 修改 ， 那 么 应 该 选择 使 用 StringBuffer & 
StringBuilder 类 。 


字符 串 长 度 


用 于 获取 有 关 对 象 的 信息 的 方法 称 为 访问 器 方法 。 
String 类 的 一 个 访问 器 方法 是 length() 方 法 ， 它 返回 字符 串 对 象 包 含 的 字符 数 。 


下 面 的 代码 执行 后 ，len 变 量 等 于 17: 


public class StringDemo { 


public static void main(String args[]) { 


String palindrome = "Dot saw I was Tod"; 
int len = palindrome.length(); 
System.out.println( "String Length is : " + len ); 


} 
} 


以 上 实例 编译 运行 结果 如 下 : 


String Length is : 17 


连接 字符 串 
String 类 提供 了 连接 两 个 字符 串 的 方法 : 
stringi.concat(string2); 
返回 string2 连 接 string1 的 新 字符 串 。 也 可 以 对 字符 串 常 量 使 用 concat() 方 法 ， 如 : 


"My name is ".concat("Zara"); 


更 常用 的 是 使 用 '+' 操 作 符 来 连接 字符 串 ， 如 : 


"Hello, n + n world" + n 1 n 


结果 如 下 : 


"Hello, world!" 


下 面 是 一 个 例子 : 


public class StringDemo { 
public static void main(String args[]) { 
String string1 = "Saw I was "; 
System.out.println("Dot " + stringi + "Tod"); 


} 
} 
以 上 实例 编译 运行 结果 如 下 : 


Dot saw I was Tod 


创建 格式 化 字符 串 


我 们 知道 输出 格式 化 数字 可 以 使 用 printf() 和 format() 方 法 。String 类 使 用 静态 方法 
format() 返 回 一 个 String 对 象 而 不 是 PrintStream 对 象 。 


String 类 的 静态 方法 format() 能 用 来 创建 可 复 用 的 格式 化 字符 串 ， 而 不 仅仅 是 用 于 一 
次 打印 输出 。 如 下 所 示 : 


System.out.printf("The value of the float variable is " + 
"9f, while the value of the integer " + 
"variable is %d, and the string " + 
"is 90s", floatVar, intVar, stringVar); 


(th AY pax HS 


String fs; 

fs = String.format("The value of the float variable is " + 
"€f, while the value of the integer " + 
"variable is %d, and the string " + 
"is 96s", floatVar, intVar, stringVar); 

System.out.println(fs); 


String 方法 


下 面 是 String 类 支持 的 方法 ， 更 多 详细 ， 参 看 Java API 文 档 : 


方法 描述 
char charAt(int index) 返回 指定 索引 人 多 的 char 值 。 
int compareTo(Object o) 把 这 个 字符 串 和 另 一 个 对 象 比 较 。 


int compareTo(String anotherString) ， 按 字典 顺序 比较 两 个 字符 串 。 


int compare TolgnoreCase(String 
str) 


String concat(String str) 


boolean contentEquals(StringBuffer 
sb) 


static String copyValueOf(char[] 
data) 


static String copyValueOf(char[] 
data, int offset, int count) 


boolean endsWith(String suffix) 
boolean equals(Object anObject) 


boolean equalslgnoreCase(String 
anotherString) 


byte[] getBytes() 
byte[] getBytes(String 
charsetName) 


void getChars(int srcBegin, int 
srcEnd, char[] dst, int dstBegin) 


int hashCode() 


int indexOf(int ch) 


int indexOf(int ch, int fromIndex) 


int indexOf(String str) 


int indexOf(String str, int fromIndex) 
String intern() 


int lastlndexOf(int ch) 


int lastIndexOf(int ch, int fromIndex) 


按 字 典 顺 序 比 较 两 个 字符 串 ， 不 考虑 大 
JE, 

将 指定 字符 串 连 接 到 此 字符 串 的 结尾 。 
当 且 入 当 字 符 串 与 指定 的 StringButter 有 
相同 顺序 的 字符 时 候 返 回 真 。 

返回 指定 数组 中 表示 该 字符 序列 的 
String。 

返回 指定 数组 中 表示 该 字符 序列 的 
String。 

测试 此 字符 串 是 否 以 指定 的 后 级 结束 。 
将 此 字符 串 与 指定 的 对 象 比较 。 

将 此 String 与 另 一 个 String 比较 ， 不 
考虑 大 小 写 。 


使 用 平台 的 默认 字符 集 将 此 String 编码 
为 byte 序列 ， 并 将 结果 存储 到 一 个 新 
的 byte 数组 中 。 


使 用 指定 的 字符 集 将 此 String 编码 为 
byte 序列 ， 并 将 结果 存储 到 一 个 新 的 
byte 数组 中 。 

将 字符 从 此 字符 串 复 制 到 目标 字符 数 
组 。 


返回 此 字符 串 的 哈 希 码 。 


返回 指定 字符 在 此 字符 串 中 第 一 次 出 现 
处 的 索引 。 


返回 在 此 字符 串 中 第 一 次 出 现 指定 字符 
处 的 索引 ， 从 指定 的 索引 开始 搜索 。 


返回 指定 子 字 符 串 在 此 字符 串 中 第 一 次 
出 现 处 的 索引 。 


返回 指定 子 字 符 串 在 此 字符 串 中 第 一 次 
出 现 处 的 索引 ， 从 指定 的 索引 开始 。 
返回 字符 串 对 象 的 规范 化 表示 形式 。 
返回 指定 字符 在 此 字符 串 中 最 后 一 次 出 
现 处 的 索引 。 


返回 指定 字符 在 此 字符 串 中 最 后 一 次 出 
现 处 的 索引 ， 从 指定 的 索引 处 开始 进行 
反 向 搜索 。 


int lastIndexOf(String str) 


int lastlIndexOf(String str, int 
fromindex) 


int length() 
boolean matches(String regex) 


boolean regionMatches(boolean 
ignoreCase, int toffset, String other, 
int ooffset, int len) 


boolean regionMatches(int toffset, 
String other, int ooffset, int len) 


String replace(char oldChar, char 
newChar) 


String replaceAll(String regex, 
String replacement) 


String replaceFirst(String regex, 
String replacement) 


String[] split(String regex) 


String[] split(String regex, int limit) 


boolean startsWith(String prefix) 


boolean startsWith(String prefix, int 
toffset) 


CharSequence subSequence(int 
beginIndex, int endlIndex) 


String substring(int beginIndex) 


String substring(int beginIndex, int 
endindex) 


char[] toCharArray() 


String toLowerCase() 


返回 指定 子 字 符 串 在 此 字符 串 中 最 右边 
出 现 处 的 索引 。 


返回 指定 子 字 符 串 在 此 字符 串 中 最 后 一 
次 出 现 处 的 索引 ， 从 指定 的 索引 开始 反 
向 搜索 。 


返回 此 字符 串 的 长 度 。 
告知 此 字符 串 是 否 匹配 给 定 的 正则 表达 


工 vo 


测试 两 个 字符 串 区 域 是 否 相等 。 


测试 两 个 字符 串 区 域 是 否 相等 。 


返回 一 个 新 的 字符 串 ， 它 是 通过 用 
newChar 替换 此 字符 串 中 出 现 的 所 有 
oldChar 得 到 的 。 

使 用 给 定 的 replacement 蔡 换 此 字符 串 
所 有 匹配 给 定 的 正则 表达 式 的 子 字符 
FR, 

使 用 给 定 的 replacement 蔡 换 此 字符 串 
匹配 给 定 的 正则 表达 式 的 第 一 个 子 字符 
FR, 


根据 给 定 正 则 表达 式 的 匹配 拆 分 此 字符 


o 


| i 
符 串 。 


测试 此 字符 串 是 否 以 指定 的 前 级 开始 。 


测试 此 字符 串 从 指定 索引 开始 的 子 字符 
串 是 否 以 指定 前 级 开始 。 


返回 一 个 新 的 字符 序列 ， 
ate 


返回 一 个 新 的 字符 串 ， 
一 个 子 字符 串 。 


返回 一 个 新 字符 串 ， 
个 子 宇 符 串 。 


将 此 字符 串 转 换 为 一 个 新 的 字符 数组 。 
使 用 默认 语言 环境 的 规则 将 此 String 中 


它 是 此 序列 的 


它 是 此 字符 串 的 


它 是 此 字符 串 的 一 


String toLowerCase() 


String toLowerCase(Locale locale) 


String toString() 


String toUpperCase() 


String toUpperCase(Locale locale) 


String trim() 


static String valueOf(primitive data 
type x) 


的 所 有 字符 都 转换 为 小 写 。 

使 用 给 定 Locale 的 规则 将 此 String 中 
的 所 有 字符 都 转换 为 小 写 。 

返回 此 对 象 本 身 ( 它 已 经 是 一 个 字符 
E | ) o 

使 用 默认 语言 环境 的 规则 将 此 String 中 
的 所 有 字符 都 转换 为 大 写 。 

使 用 给 定 Locale 的 规则 将 此 String 中 
的 所 有 字符 都 转换 为 大 写 。 

返回 字符 串 的 副本 ， 和 忽略 前 导 空白 和 尾 
部 空白 。 

返回 给 定 data type 类 型 x 参数 的 字符 串 
表示 形式 。 


Java StringBuffer#] StringBuilder 3: 


当 对 字符 串 进 行 修改 的 时 候 ， 需 要 使 用 StringBuffer 和 StringBuilder 类 。 


和 String 类 不 同 的 是 ，StringBuffer 和 StringBuilder 类 的 对 象 能 够 被 多 次 的 修改 ， 并 
且 不 产生 新 的 未 使 用 对 象 。 


StringBuilder 类 在 Java 5 中 被 提出 ， 它 和 StringBuffer 之 间 的 最 大 不 同 在 于 
StringBuilder 的 方法 不 是 线程 安全 的 (不 能 同步 访问 ) 。 


由 于 StringBuilder 相 较 于 StringBuffer 有 速度 优势 ， 所 以 多 数 情况 下 建议 使 用 
StringBuilder 类 。 然 而 在 应 用 程序 要 求 线程 安全 的 情况 下 ， 则 必须 使 用 StringBuffer 


实例 


public class Test{ 


public static void main(String args[]){ 
StringBuffer sBuffer = new StringBuffer(" test"); 
sBuffer.append(" String Buffer"); 
System.ou.println(sBuffer); 


以 上 实例 编译 运行 结果 如 下 : 


test String Buffer 


StringBuffer 方法 


以 下 是 StringBuffer 类 支持 的 主要 方法 : 


方法 描述 


Ae a a 将 指定 的 字符 串 追 加 到 此 字符 序列 。 
public StringBuffer IRR ERR 
AE 将 此 字符 序列 用 其 反 转 形式 取代 。 


D 7 ee TIM 移 除 此 序列 的 子 字符 趟 中 的 字符 。 


public insert(int offset, inti) ”将 int 参数 的 字符 串 表 示 形 式 插入 此 序列 中 。 


replace(int start, int end, 使 用 给 定 String 中 的 字符 替换 此 序列 的 子 字 
String str) 符 串 中 的 字符 。 


下 面 的 列表 里 的 方法 和 String 类 的 方法 类 似 : 


方法 
int capacity() 
char charAt(int index) 


void ensureCapacity(int 
minimumCapacity) 


void getChars(int srcBegin, int 
srcEnd, char[] dst, int dstBegin) 


int indexOf(String str) 


int indexOf(String str, int 
fromindex) 


int lastlIndexOf(String str) 


int lastlndexOf(String str, int 
fromindex) 

int length() 

void setCharAt(int index, char ch) 
void setLength(int newLength) 
CharSequence subSequence(int 
start, int end) 


String substring(int start) 


String substring(int start, int end) 


String toString() 


描述 
返回 当前 容量 。 
此 序列 中 指定 索引 人 多 的 char 值 。 
确保 容量 至 少 等 于 指定 的 最 小 值 。 


将 字符 从 此 序列 复制 到 目标 字符 数组 
dst 


返回 第 一 次 出 现 的 指定 子 字 符 串 在 该 字符 
串 中 的 索引 。 


从 指定 的 索引 多 开始， 返回 第 一 次 出 现 的 
指定 子 字符 串 在 该 字符 串 中 的 索引 。 


返回 最 右边 出 现 的 指定 子 字符 串 在 此 字符 
串 中 的 索引 。 


返回 最 后 一 次 出 现 的 指定 
符 串 中 的 索引 。 


ROKE (字符 数 ) 。 
将 给 定 索引 久 的 字符 设置 为 ch. 


子 字 符 串 在 此 字 


设置 字符 序列 的 长 度 。 

返回 一 个 新 的 字符 序列 ， 该 字符 序列 是 此 
序列 的 子 序 列 。 

返回 一 个 新 的 string ， 它 包含 此 字符 
序列 当前 所 包含 的 字符 子 序列 。 
返回 一 个 新 的 String ， 它 包含 此 序列 


当前 所 包含 的 字符 子 序列 。 
返回 此 序列 中 数据 的 字符 串 表 示 形 式 。 


Java 数组 

数组 对 于 每 一 门 编辑 应 语言 来 说 都 是 重要 的 数据 结构 之 一 ， 当 然 不 同 语 言 对 数组 的 
实现 及 义理 也 不 尽 相同 。 

Java 语 言 中 提供 的 数组 是 用 来 存储 固定 大 小 的 同类 型 元 素 。 


你 可 以 声明 一 个 数组 变量 ， 如 numbers[100] 来 代替 直接 声明 100 个 独立 变量 
numberO, number1, .... number99, 


本 教程 将 为 大 家 介绍 Java 数 组 的 声明 、 创 建 和 初始 化 ， 并 给 出 其 对 应 的 代码 。 


声明 数组 变量 

首先 必须 声明 数组 变量 ， 才 能 在 程序 中 使 用 数组 。 下 面 是 声明 数组 变量 的 语法 : 
dataType[] arrayRefVar; // 首选 的 方法 
或 


dataType arrayRefVar[]; // 效果 相同 ， 但 不 是 首选 方法 


注意 : 建议 使 用 dataTypef[] arrayRefVar 的 声明 风格 声明 数组 变量 。 dataType 
arrayRefVar[] 风格 是 来 自 C/C++ 语言 ， 在 Java 中 采用 是 为 了 让 C/C++ 程序 园 能 
够 快速 理解 java 语 言 。 


实例 


下 面 是 这 两 种 语法 的 代码 示例 : 


double[] myList; // 首选 的 方法 
" 
double myList[]; // 效果 相同 ， 但 不 是 首选 方法 


创建 数组 
Java 语 言 使 用 new 操 作 符 来 创建 数组 ， 语 法 如 下 : 


arrayRefVar = new dataType[arraySize]; 


上 面 的 语法 语句 做 了 两 件 事 : 


e 一 、 使 用 dataType[arraySize] 创 建 了 一 个 数组 。 
e 二 、 把 新 创建 的 数组 的 引用 赋值 给 变量 arrayRefVar。 


数组 变量 的 声明 ， 和 创建 数组 可 以 用 一 条 语句 完成 ， 如 下 所 示 : 


dataType[] arrayRefVar = new dataType[arraySize]; 


另外 ， 你 还 可 以 使 用 如 下 的 方式 创建 数组 。 


dataType[] arrayRefVar = (valueO, valued, ..., valuek}; 


数组 的 元 素 是 通过 索引 访问 的 。 数 组 索引 从 0 开始 ， 所 以 索引 值 从 0 到 
arrayRefVar.length-1。 


实例 


下 面 的 语句 首先 声明 了 一 个 数组 变量 myList， 接 着 创建 了 一 个 包含 10 个 double 类 型 
元 素 的 数组 ， 并 且 把 它 的 引用 赋值 给 myList 变 量 。 


double[] myList = new double[10]; 
下 面 的 图 片 描绘 了 数组 myList。 这 里 myList 数 组 里 有 10 个 double 元 素 ， 它 的 下 标 从 
0 到 9。 


myList | reference : 
? myList|0| 
| myList|1] 


Array reference myList[2] 
variable myList[3] 
myList|4| 
Array element al > myList[5] 

index 5 i 
myList[6] 
myList|7] 


myList|9] 11123 





处 理 数组 


数组 的 元 素 类 型 和 数组 的 大 小 都 是 确定 的 ， 所 以 当 处 理 数组 元 素 时 候 ， 我 们 通常 使 
用 基本 循环 或 者 foreach 循 环 。 


示例 


该 实例 完整 地 展示 了 如 何 创建 、 初 始 化 和 操纵 数组 : 


public class TestArray { 


public static void main(String[] args) { 
double[] myList = {1.9, 2.9, 3.4, 3.5}; 


// 打印 所 有 数组 元 素 
for (int i = 0; i < myList.length; i++) { 
System.out.println(myList[i] + " "); 


} 

// 计算 所 有 元 素 的 总 和 

double total = 0; 

for (int i = 0; i < myList.length; i++) { 
total += myList[i]; 

} 

System.out.println("Total is " + total); 

// 查找 最 大 元 素 

double max = myList[0]; 

for (int i = 1; i < myList.length; i++) { 
if (myList[i] > max) max = myList[i]; 

} 


System.out.println("Max is " + max); 


以 上 实例 编译 运行 结果 如 下 : 


0 A O oO 


ab- 
Dx 
3. 
3. 
Total is 11.7 
Max is 3.5 


foreach{ 34 


JDK 1.5 引进 了 一 种 新 的 循环 类 型 ， 被 称 为 foreach 循 环 或 者 加 强 型 循环 ， 它 能 在 不 
使 用 下 标的 情况 下 通 历 数组 。 


示例 


该 实例 用 来 显示 数组 myList 中 的 所 有 元 素 : 


public class TestArray { 


public static void main(String[] args) { 
double[] myList = {1.9, 2.9, 3.4, 3.5}; 


// 打印 所 有 数组 元 素 
for (double element: myList) { 
System.out.println(element); 
j 
j 
} 


以 上 实例 编译 运行 结果 如 下 : 


BATE ABMS 


数组 可 以 作为 参数 传递 给 方法 。 例 如 ， 下 面 的 例子 就 是 一 个 打印 int 数 组 中 元 素 的 方 


法 。 


public static void printArray(int[] array) { 
for (int i = 0; i < array.length; i++) { 
System.out.print(array[i] + " "); 
} 
} 


下 面 例子 调用 printArray 方 法 打印 出 3，1，2，6，4 和 2 : 


printArray(new int[]{3, 1, 2, 6, 4, 2}); 


效 组 作为 画 数 的 返回 值 


public static int[] reverse(int[] list) { 
int[] result = new int[list.length]; 


for (int i = 0, j = result.length - 1; i < list.length; i++, j--. 
result[j] = list[i]; 


return result; 





f 





以 上 实例 中 result 数 组 作为 函数 的 返回 值 。 


Arrays 类 
java.util.Arrays 类 能 方便 地 操作 数组 ， 它 提供 的 所 有 方法 都 是 静态 的 。 具 有 以 下 功 


能 : 

给 数组 赋值 : 通过 全 方法 。 

对 数组 排序 : 通过 sort 方 法 , 按 升序 。 

比较 数组 : 通过 equals 广 法 比较 数组 中 元 素 值 是 否 相等 。 

oe 通过 binarySearch 方 法 能 对 排序 好 的 数组 进行 二 分 查找 法 操 


具体 说 明 请 查看 下 表 : 
方法 说 明 
M 用 二 分 查找 算法 在 给 定数 组 中 搜索 给 定 值 的 对 象 
pan a (Byte ,Int,double 等 )。 数 组 在 调用 前 必须 排序 好 的 。 
ry J 如 果 查 找 值 包含 在 数组 中 ， 则 返回 搜索 键 的 索引 ; 
a, Object key) 否则 返回 (-( 插 入 点 ) - 1)。 


如 果 两 个 指定 的 long 型 数组 彼此 相等 ， 则 返回 
true。 如果 两 个 数组 包含 相同 数量 的 元 素 ， 并 且 两 个 
public static boolean 数组 中 的 所 有 相应 元 素 对 都 是 相等 的 ， 则 认为 这 两 
equals(long[] a, long] ”个 数组 是 相等 的 。 换 句 话 说 ， 如 果 两 个 数组 以 相同 
a2) 顺序 包含 相同 的 元 素 ， 则 两 个 数组 是 相等 的 。 同 样 
的 方法 适用 于 所 有 的 其 他 基本 数据 类 型 (Byte, 
short，Int 等 ) 。 


将 指定 的 int 值 分 配给 指定 int 型 数组 指定 范围 中 的 


public static void pagan E afar = ^ 
bp 每 个 元 素 。 同 样 的 方法 适用 于 所 有 的 其 他 基本 数据 
fill(int[] a, int val) 类 型 (Byte, short, Int&) 。 

TT 对 指定 对 象 数组 根据 其 元 素 的 自然 顺序 进行 升序 排 
PRONE SN. vog 列 。 同 样 的 方法 适用 于 所 有 的 其 他 基本 数据 类 型 


sort(Object[] a) (Byte，short，Int 等 ) 。 


Java 日 期 时 间 


java.util 包 提供 了 Date 类 来 封装 当前 的 日 期 和 时 间 。 Date 类 提供 两 个 构造 画 数 来 实 
例 化 Date 对 象 。 


第 一 个 构造 本 数 使 用 当前 日 期 和 时 间 来 初始 化 对 象 。 


Date( ) 


AS A3 ERSURE IACTA AU, 208 3808 M 97051 H 1 E EE B URP LC 


Date(long millisec) 


Date 对 象 创建 以 后 ， 可 以 调用 下 面 的 方法 。 


方法 


boolean after(Date 
date) 


boolean 
before(Date date) 


Object clone( ) 

int 
compareTo(Date 
date) 

int 
compareTo(Object 
obj) 


boolean 
equals(Object 
date) 


long getTime( ) 


int hashCode( ) 


void setTime(long 
time) 


String toString( ) 


描述 


若 当 调用 此 方法 的 Date 对 象 在 
则 返回 false。 


若 当 调用 此 方法 的 Date 对 象 在 指 
则 返回 false。 


返回 此 对 象 的 副本 。 


比较 当 调 用 此 方法 的 Date 对 象 和 指 定 日 期 。 两 者 相等 时 
候 返 回 0。 调 用 对 象 在 指定 日 期 之 前 则 返回 负数 。 调 用 对 
象 在 指定 日 期 之 后 则 返回 正 数 。 


旨 定 日 期 之 后 返回 true, 否 


定 日 期 之 前 返回 true, 否 


若 obj 是 Date 类 型 则 操作 等 同 于 compareTo(Date) 。 否 则 
它 抛 出 ClassCastException。 


当 调 用 此 方法 的 Date 对 象 和 指定 日 期 相等 时 候 返 回 true， 
4 m1) [false, 


返回 自 1970 £1 H 1 HA 00:00:00 GMT 以 来 此 Date 
XR ABUSE 
返回 此 对 象 的 哈 希 码 值 。 


用 自 1970 年 1 月 1 日 00:00:00 GMT 以 后 time 窒 秒 数 设置 
时 间 和 日 期 。 


转换 Date 对 象 为 String 表 示 形 式 ， 并 返回 该 字符 串 。 


获取 当前 日 期 时 间 


Java 中 获取 当前 日 期 和 时 间 很 简单 ， 使 用 Date 对 象 的 toString() 方 法 来 打印 当前 日 
期 和 时 间 ， 如 下 所 示 : 


import java.util.Date; 
public class DateDemo { 
public static void main(String args[]) { 
// 初始 化 Date 对 象 


Date date = new Date(); 


// 使 用 tostring() 画 数 显示 日 期 时 间 
System.out.println(date.toString()); 


以 上 实例 编译 运行 结果 如 下 : 


Mon May 04 09:51:52 CDT 2013 


日 期 比较 


Java 使 用 以 下 三 种 方法 来 比较 两 个 日 期 : 


e 使 用 getTime( ) 方法 获取 两 个 日 期 〈 自 1970 年 1 月 1 日 经 历 的 微妙 数值 ) ， 然 后 
比较 这 两 个 值 。 

e 使 用 方法 before()，after() 和 equals()。 例 如 ， 一 个 月 的 12 号 比 18 号 早 ， 则 new 
Date(99, 2, 12).before(new Date (99, 2, 18)) 返 回 true。 

e 使 用 compareTo() 方 法 ， 它 是 由 Comparable 接 口 定 义 的 ，Date 类 实现 了 这 个 接 


o 


使 用 SimpleDateFormat 格 式 化 日 期 


SimpleDateFormat 是 一 个 以 语言 环境 敏感 的 方式 来 格式 化 和 分 析 日 期 的 类 。 
SimpleDateFormat 人 允许 你 选择 任何 用 户 自 定义 日 期 时 间 格 式 来 运行 。 例 如 : 


import java.util.*; 
import java.text.*; 


public class DateDemo { 
public static void main(String args[]) { 


Date dNow = new Date( ); 
SimpleDateFormat ft = 
new SimpleDateFormat ("E yyyy.MM.dd 'at' hh:mm:ss a zzz"); 


System.out.println("Current Date: " + ft.format(dNow)); 


以 上 实例 编译 运行 结果 如 下 : 


Current Date: Sun 2004.07.18 at 04:14:09 PM PDT 


简单 的 DateFormat 格 式 化 编码 


时 间 模 式 字符 串 用 来 指定 时 间 格 式 。 在 此 模式 中 ， 所 有 的 ASCII 字 母 被 保留 为 模式 
字母 ， 定 义 如 下 : 


字母 描述 示例 
G 纪元 标记 AD 
y 四 位 年 份 2001 
M 月 份 July or 07 
d 一 个 月 的 日 期 10 
h A.MJPM. (1~12) 格 式 小 时 12 
H 一 天 中 的 小 时 (0~23) 22 
m 分 钟 数 30 
S 秒 数 55 
S 微妙 数 234 
E 星期 几 Tuesday 
D 一 年 中 的 日 子 360 
F 一 个 月 中 第 几 周 的 周 几 2 (second Wed. in July) 
w 一 年 中 第 几 周 40 
W 一 个 月 中 第 几 周 1 
a A.M./PM. 标记 PM 
k 一 天 中 的 小 时 (1~24) 24 
K A.MJPM. (0~11) 格 式 小 时 10 
Z 时 区 Eastern Standard Time 
i 文字 定 界 符 Delimiter 
单 引 号 
使 用 printf 格 式 化 日 期 


printf 方 法 可 以 很 轻松 地 格式 化 时 间 和 日 期 。 使 用 两 个 字母 格式 ， 它 以 t 开 头 并 且 以 
下 面 表格 中 的 一 个 字母 结尾 。 例 如 : 


import java.util.Date; 
public class DateDemo { 
public static void main(String args[]) { 
// 初始 化 Date 对 象 


Date date = new Date(); 


// 使 用 toString() 显 示 日 期 和 时 间 
String str = String.format("Current Date/Time : %tc", date ); 


System.out.printf(str); 


| 
以 上 实例 编译 运行 结果 如 下 : 

Current Date/Time : Sat Dec 15 16:37:57 MST 2012 

如 果 你 需要 重复 提供 日 期 ， 那 么 利用 这 种 方式 来 格式 化 它 的 每 一 部 分 就 有 点 复杂 


了 。 因 此 ， 可 以 利用 一 个 格式 化 字符 串 指出 要 被 格式 化 的 参数 的 索引 。 
索引 必须 紧 跟 在 % 后 面 ， 而 且 必 须 以 $ 结 束 。 例 如 : 


import java.util.Date; 
public class DateDemo { 
public static void main(String args[]) { 
// 初始 化 Date 对 象 
Date date = new Date(); 
// 使 用 toString() 显 示 日 期 和 时 间 


System.out.printf("%1$s %2$tB %2$td, %2$tY", 
"Due date:", date); 


以 上 实例 编译 运行 结果 如 下 : 


Due date: February 09, 2004 


或 者 ， 你 可 以 使 用 < 标志 。 它 表明 先前 被 格式 化 的 参数 要 被 再 次 使 用 。 例 如 : 


import java.util.Date; 
public class DateDemo { 
public static void main(String args[]) { 
// 初始 化 Date 对 象 
Date date = new Date(); 
// 显示 格式 化 时 间 


System.out.printf("%s %tB %<te, %<tY", 
"Due date:", date); 


以 上 实例 编译 运行 结果 如 下 : 


Due date: February 09, 2004 


日 期 和 时 间 转 换 字 符 


描述 例子 
R 完整 的 日 期 和 时 间 2005 29 04 09:51:52 CDT 
F ISO 8601 格式 日 期 2004-02-09 
D U.S. 格式 日 期 (月 /日 /年 ) 02/09/2004 
T 24 小 时 时 间 18:05:19 
r 12 小 时 时 间 06:05:19 pm 
R 24 小 时 时 间 ， 不 包含 秒 18:05 
Y 4 位 年 份 (包含 前 导 0) 2004 
y 年 份 后 2 位 (包含 前 导 0) 04 
C 年 份 前 2 位 (包含 前 导 0) 20 
B 月 份 全 称 February 
b 月 份 简称 Feb 
n 2 位 月 份 (包含 前 导 0) 02 


d 2 位 日 子 (包含 前 导 0) 03 


e 2 位 日 子 (不 包含 前 导 0) 9 





A 星期 全 称 Monday 

a 星期 简称 Mon 

j 3 位 年 份 (包含 前 导 0) 069 

H 2 位 小 时 (包含 前 导 0), 00 到 23 18 

k 2 位 小 时 (不 包含 前 导 0), 0 到 23 18 

| 2 位 小 时 (包含 前 导 0), 01 到 12 06 

| 2 位 小 时 (不 包含 前 导 0), 1 到 12 6 

M 2 位 分 钟 (包含 前 导 0) 05 

S 2 位 秒 数 (包含 前 导 0) 19 

L 3 位 毫秒 (包含 前 导 0) 047 

N 9 位 纳 秒 (包含 前 导 0) 047000000 
P 大 写 上 下 午 标志 PM 

p 小 写 上 下 午 标志 pm 

z 从 GMT 的 RFC 822 数 字 偏 移 -0800 

Z 时 区 PST 
1970-01-01 00:00:00 GMT 的 秒 4078884319 
Q i 1970-01-01 00:00:00 GMTÉSZÉ | 4078884319047 


还 有 其 他 有 用 的 日 期 和 时 间 相 关 的 类 。 对 于 更 多 的 细节 ， 你 可 以 参考 到 Java 标 准 文 
档 


o 


解析 字符 串 为 时 间 


SimpleDateFormat 类 有 一 些 附 加 的 方法 ， 特 别 是 parse()， 它 试图 按照 给 定 的 
SimpleDateFormat 对 象 的 格式 化 存储 来 解析 字符 串 。 例 如 : 


import java.util.*; 
import java.text.*; 


public class DateDemo { 


public static void main(String args[]) { 
SimpleDateFormat ft = new SimpleDateFormat ("yyyy-MM-dd"); 


String input = args.length == 0 ? "1818-11-11" : args[0]; 
System.out.print(input + " Parses as "); 


Date t; 


try { 
t = ft.parse(input); 
System.out.printin(t); 
} catch (ParseException e) { 
System.out.println("Unparseable using " + ft); 
} 


以 上 实例 编译 运行 结果 如 下 : 


$ java DateDemo 

1818-11-11 Parses as Wed Nov 11 00:00:00 GMT 1818 
$ java DateDemo 2007-12-01 

2007-12-01 Parses as Sat Dec 01 00:00:00 GMT 2007 


Java 休眠 (sleep) 


你 可 以 让 程序 休眠 一 富 秒 的 时 间或 者 到 您 的 计算 机 的 寿命 长 的 任意 段 时 间 。 例 如 ， 
下 面 的 程序 会 休眠 10 秒 : 


import java.util.*; 


public class SleepDemo { 
public static void main(String args[]) { 

try { 
System.out.println(new Date( ) + "\n"); 
Thread.sleep(5*60*10); 
System.out.println(new Date( ) + "\n"); 

} catch (Exception e) { 
System.out.println("Got an exception!"); 

j 


以 上 实例 编译 运行 结果 如 下 : 
Sun May 03 18:04:41 GMT 2009 


Sun May 03 18:04:51 GMT 2009 


测量 时 间 
下 面 的 一 个 例子 表明 如 何 测量 时 间 间 隔 〈 以 毫秒 为 单位 ) 


import java.util.*; 
public class DiffDemo { 


public static void main(String args[]) { 
try { 
long start = System.currentTimeMillis( ); 
System.out.println(new Date( ) + "\n"); 
Thread.sleep(5*60*10); 
System.out.println(new Date( ) + "\n"); 
long end - System.currentTimeMillis( ); 
long diff - end - start; 
System.out.println("Difference is : " + diff); 
} catch (Exception e) { 
System.out.println("Got an exception!"); 
j 
j 
j 


以 上 实例 编译 运行 结果 如 下 : 
Sun May 03 18:16:51 GMT 2009 


Sun May 03 18:16:57 GMT 2009 


Difference is : 5993 


Calendar # 


我 们 现在 已 经 能 够 格式 化 并 创建 一 个 日 期 对 象 了 ， 但 是 我 们 如 何 才能 设置 和 获取 日 
期 数据 的 特定 部 分 呢 ， 上 比如 说 小 时 ， 日 ， 或 者 分 钟 ? 我 们 又 如 何在 日 期 的 这 些 部 分 
加 上 或 者 减 去 值 呢 ? 答案 是 使 用 Calendar X, 


Calendar 类 的 功能 要 上 比 Date 类 强大 很 多 ， 而 且 在 实现 方式 上 也 比 Date 类 要 复杂 一 


此 
—o 


Calendar 类 是 一 个 抽象 类 ， 在 实际 使 用 时 实现 特定 的 子 类 的 对 象 ， 创 建 对 象 的 过 程 
对 程序 员 来 说 是 透明 的 ， 只 需要 使 用 getlnstance 方 法 创建 即 可 。 


创建 一 个 代表 系统 当前 日 期 的 Calendar 对 象 


Calendar c = Calendar .getInstance();// 上 默认 是 当前 日 期 


创建 一 个 指定 日 期 的 Calendar 对 象 


使 用 Calendar 类 代表 特定 的 时 间 ， 需 要 首先 创建 一 个 Calendar 的 对 象 ， 然 后 再 设 定 
该 对 象 中 的 年 月 日 参数 来 完成 。 


// 创 建 一 个 代表 2009 年 6 月 12 日 的 Calendar 对 象 
Calendar c1 = Calendar.getInstance(); 
ci.set(2009, 6 - 1, 12); 


Calendar 类 中 用 一 下 这 些 常 量 表示 不 同 的 意义 ，jdk 内 的 很 多 类 其 实 都 是 采用 的 这 种 
思想 


JOVO 


常量 描述 
Calendar.YEAR 年 份 
Calendar.MONTH 月 份 
Calendar.DATE 日 期 
Calendar.DAY_OF_MONTH 日 期 ， 和 上 面 的 字段 意义 完全 相同 
Calendar.HOUR 12 小 时 制 的 小 时 
Calendar.HOUR_OF_DAY 24 小 时 制 的 小 时 
Calendar.MINUTE 分 钟 
Calendar.SECOND 秒 
Calendar.DAY_OF_WEEK 星期 几 


Calendar 类 对 象 信 息 的 设置 
Set 设 置 
如 : 


Calendar c1 = Calendar.getInstance(); 


调用 : 


public final void set(int year,int month,int date) 


ci.set(2009, 6 - 1，12);// 把 Calendar 对 象 c1 的 年 月 日 分 别 设 这 为 : 2009. 6, : 


«| = 








利用 字段 类 型 设置 


如 果 只 设 定 某 个 字段 ， 例 如 日 期 的 值 ， 则 可 以 使 用 如 下 set 方 法 : 
public void set(int field,int value) 

把 c1 对 象 代表 的 日 期 设置 为 10 号 ， 其 它 所 有 的 数值 会 被 重新 计算 
ci.set(Calendar.DATE,10); 


把 c1 对 象 代表 的 年 份 设置 为 2008 年 ， 其 他 的 所 有 数值 会 被 重新 计算 


c1.set(Calendar.YEAR, 2008); 


其 他 字段 属性 set 的 意义 以 此 类 推 
Add 设 置 


Calendar c1 = Calendar.getInstance(); 


把 c1 对 象 的 日 期 加 上 10， 也 就 是 c1 所 表 的 日 期 的 10 天 后 的 日 期 ， 其 它 所 有 的 数值 会 
被 重新 计算 


c1.add(Calendar.DATE, 10); 


把 c1 对 象 的 日 期 加 上 10， 也 就 是 c1 所 表 的 日 期 的 10 天 前 的 日 期 ， 其 它 所 有 的 数值 会 
被 重新 计算 


«pre»ci.add(Calendar.DATE, -10); 


其 他 字段 属性 的 add 的 意义 以 此 类 推 
Calendar 类 对 象 信 息 的 获得 


vege c1 = Calendar .getInstance(); 
/ 获得 年 份 
in year = c1.get(Calendar.YEAR); 
/ 获得 月 份 
1 month = ci.get(Calendar.MONTH) + 1; 
// 获得 日 期 
a date = c1.get(Calendar.DATE); 


/ 获得 小 时 

in hour = ci.get(Calendar.HOUR OF DAY); 
/ 获得 分 钟 

in minute = ci.get(Calendar.MINUTE); 
/ 获得 秒 


second = ci.get(Calendar.SECOND); 
// 获得 星期 几 (注意 (这 个 与 DBate 类 是 不 同 的 ) : 1 代表 星期 日 、2 代 表 星 期 1、3 代 表 星 
int day = c1.get(Calendar .DAY_OF_WEEK); 


EE) 





GregorianCalendar 类 


Calendar 类 实现 了 公历 日 历 ，GregorianCalendar 是 Calendar 类 的 一 个 具体 实现 。 


Calendar 的 getlnstance () 方法 返回 一 个 默认 用 当前 的 语言 环境 和 时 区 初始 化 的 
GregorianCalendar 对 象 。GregorianCalendar 定 义 了 两 个 字段 : AD 和 BC。 这 些 代 
表 公 历 定 义 的 两 个 时 代 。 


下 面 列 出 GregorianCalendar 对 象 的 几 个 构造 方法 : 


HIE HR 


GregorianCalendar() 


GregorianCalendar(int year, int 
month, int date) 


GregorianCalendar(int year, int 
month, int date, int hour, int 
minute) 


GregorianCalendar(int year, int 
month, int date, int hour, int 
minute, int second) 


GregorianCalendar(Locale 
aLocale) 


GregorianCalendar(TimeZone 
zone) 


GregorianCalendar(TimeZone 
zone, Locale aLocale) 


说 明 
在 具有 默认 语言 环境 的 默认 时 区 内 使 用 
当前 时 间 构 造 一 个 默认 的 
GregorianCalendar。 
在 具有 默认 语言 环境 的 默认 时 区 内 构造 
一 个 带 有 给 定 日 期 设置 的 
GregorianCalendar 
为 具有 默认 语言 环境 的 默认 时 区 构造 一 
个 具有 给 定 日 期 和 时 间 设 置 的 
GregorianCalendar。 
为 具有 默认 语言 环境 的 默认 时 区 构造 一 
个 具有 给 定 日 期 和 时 间 设 置 的 
GregorianCalendar。 
在 具有 给 定语 言 环境 的 默认 时 区 内 构造 
一 个 基于 当前 时 间 的 
GregorianCalendar。 
在 具有 默认 语言 环境 的 给 定时 区 内 构造 
一 个 基于 当前 时 间 的 
GregorianCalendar。 
在 具有 给 定语 言 环境 的 给 定时 区 内 构造 
一 个 基于 当前 时 间 的 
GregorianCalendar。 


这 里 是 GregorianCalendar 类 提供 的 一 些 有 用 的 方法 列表 : 


方法 
void add(int field, int amount) 
protected void computeFields() 


protected void computeTime() 


boolean equals(Object obj) 


int get(int field) 
int getActualMaximum(int field) 


int getActualMinimum(int field) 


int getGreatestMinimum(int field) 


说 明 
根据 日 历 规则 ， 将 指定 的 《有 符号 的 ) 
时 间 量 添加 到 给 定 的 日 历 字段 中 。 
转换 UTC 窗 秒 值 为 时 间 域 值 


覆盖 Calendar ， 转 换 时 间 域 值 为 UTC 
sed 


比较 此 GregorianCalendar 与 指定 的 
Object。 


获取 指定 字段 的 时 间 值 
返回 当前 日 期 ， 给 定 字 段 的 最 大 值 
返回 当前 日 期 ， 给 定 字段 的 最 小 值 


返回 此 GregorianCalendar 实例 给 定 日 
历 字段 的 最 高 的 最 小 值 。 


Date getGregorianChange() 


int getLeastMaximumy(int field) 


int getMaximum(int field) 


Date getTime() 

long getTimelnMillis() 
TimeZone getTimeZone() 
int getMinimum(int field) 
int hashCode() 


boolean isLeapYear(int year) 
void roll(int field, boolean up) 


void set(int field, int value) 


void set(int year, int month, int 
date) 


void set(int year, int month, int 
date, int hour, int minute) 


void set(int year, int month, int 
date, int hour, int minute, int 
second) 


void setGregorianChange(Date 
date) 


void setTime(Date date) 


void setTimelnMillis(long millis) 


void setTimeZone(TimeZone 
value) 


String toString() 


实例 


天 得 格 里 高 利 历 的 更 改 日 期 。 


返回 此 GregorianCalendar 实例 给 定 日 
历 字 段 的 最 低 的 最 大 值 


返回 此 GregorianCalendar 实例 的 给 定 
日 历 字段 的 最 大 值 。 


获取 日 历 当前 时 间 。 

获取 用 长 整 型 表示 的 日 历 的 当前 时 间 
获取 时 区 。 

返回 给 定 字段 的 最 小 值 。 

重 写 hashCode. 

确定 给 定 的 年 份 是 否 为 头 年 。 


在 给 定 的 时 间 字 段 上 添加 或 减 去 (上 / 
F) 单个 时 间 单 元 ， 不 更 改 更 大 的 字 


段 。 


用 给 定 的 值 设置 时 间 字段 。 


ex 


设置 年 、 月 、 日 的 值 。 
设置 年 、 月 、 日 、 小 时 、 分 钟 的 值 。 


设置 年 、 月 、 日 、 小 时 、 分 钟 、 秒 的 
值 。 


设置 GregorianCalendar 的 更 改 日 期 。 


用 给 定 的 日 期 设置 Calendar 的 当前 时 
间 。 


用 给 定 的 long 型 毫秒 数 设 置 Calendar 的 
当前 时 间 。 


用 给 定时 区 值 设置 当前 时 区 。 


返回 代表 日 万 的 字符 串 。 


import java.util.*; 
public class GregorianCalendarDemo { 


public static void main(String args[]) { 
String months[] = { 
"Jan", "Feb", "Mar", "Apr", 
"May", "Jun", T uu. "Aug", 
"Sep", TOCE' 4 "Nov", "Dec"; 


int year; 

// 初始 化 Gregorian B% 
// 使 用 当前 时 间 和 日 期 

// 默认 为 本 地 时 间 和 时 区 
GregorianCalendar gcalendar = new GregorianCalendar(); 
// 显示 当前 时 间 和 日 期 的 信息 
System.out.print("Date: "); 


System.out.print(months[gcalendar.get(Calendar.MONTH)]); 
System.out.print(" " + gcalendar.get(Calendar.DATE) + " "); 
System.out.println(year - gcalendar.get(Calendar.YEAR)); 


System.out.print("Time: "); 
System.out.print(gcalendar.get(Calendar.HOUR) + ":"); 


System.out.print(gcalendar.get(Calendar.MINUTE) -* ":"); 


System.out.println(gcalendar.get(Calendar.SECOND)); 


// 测试 当前 年 份 是 否 为 兰 年 
if(gcalendar.isLeapYear(year)) { 
System,out,.printlLn(" 当 前 年 份 是 头 年 ") ， 


else { 
System.out.printlLn(" 当 前 年 份 不 是 头 年 " ) ; 
} 


SSS ee 


以 上 实例 编译 运行 结果 如 下 : 


Date: Apr 22 2009 
Time: 11:25:27 
当前 年 份 不 是 头 年 


关于 Calender 类 的 完整 列表 ， 你 可 以 参考 标准 的 Java 文 档 。 


Java iE my) Fe ik Th 


正则 表达 式 定 义 了 字符 串 的 模式 。 
正则 表达 式 可 以 用 来 搜索 、 编 辑 或 处 理 文本 。 
正则 表达 式 并 不 仅 限于 某 一 种 语言， 但 是 在 每 种 语言 中 有 细微 的 差别 。 
Java 正 则 表达 式 和 Per| 的 是 最 为 相似 的 。 
java.util.regex 包 主要 包括 以 下 三 个 类 : 

e Pattern# : 


pattern 对 象 是 一 个 正则 表达 式 的 编译 表示 。Pattern 类 没有 公共 构造 方法 。 要 创 
建 一 个 Pattern 对 象 ， 你 必须 首先 调用 其 公共 静态 编译 方法 ， 它 返回 一 个 
Pattern 对 象 。 该 方法 接受 一 个 正则 表达 式 作为 它 的 第 一 个 参数 。 


e Matcher 类 : 


Matcher 对 象 是 对 输入 字符 串 进 行 解释 和 匹配 操作 的 引擎 。 与 Pattern 类 一 样 ， 
Matcher 也 没有 公共 构造 方法 。 你 需要 调用 Pattern 对 象 的 matcher 方 法 来 获得 
一 个 Matcher 对 象 。 


PatternSyntaxException : 


PatternSyntaxException 是 一 个 非 强 制 异常 类 ， 它 表示 一 个 正则 表达 式 模 式 中 
的 语法 错误 。 


捕获 组 

捕获 组 是 把 多 个 字符 当 一 个 单独 单元 进行 处 理 的 方法 ， 它 通过 对 括号 内 的 字符 分 组 
来 创建 。 

例如 ， 正 则 表达 式 (dog) 创建 了 单一 分 组 ， 组 里 包含 "d"，"o"， 和 "g"。 


捕获 组 是 通过 从 左 至 右 计算 其 开 括号 来 编号 。 例 如 ， 在 表达 式 〈 (A) 
(B (C) ) ) ， 有 四 个 这 样 的 组 : 


e ((A)(B(C))) 
e (A) 

e (B(C)) 

e (C) 


可 以 通过 调用 matcher 对 象 的 groupCount 方 法 来 查看 表达 式 有 多 少 个 分 组 。 
groupCount 方 法 返回 一 个 int 值 ， 表 示 matcher 对 象 当 前 有 多 个 捕获 组 。 


还 有 一 个 特殊 的 组 (480) ， 它 总 是 代表 整个 表达 式 。 该 组 不 包括 在 groupCount 的 
返回 值 中 。 


实例 
下 面 的 例子 说 明 如 何 从 一 个 给 定 的 字符 串 中 找到 数字 串 : 


import java.util.regex.Matcher; 
import java.util.regex.Pattern; 


public class RegexMatches 


{ 
public static void main( String args[] ){ 
// 按 指 定 模式 在 字符 串 查 找 
String line = "This order was placed for QT3000! OK?"; 
String pattern = "(.*)(\\d+)(.*)"; 
// 创建 Pattern 对 象 
Pattern r = Pattern.compile(pattern); 
// 现在 创建 matcher 对 象 
Matcher m = r.matcher(line); 
if (m.find( )) { 
System.out.println("Found value: " + m.group(0) ); 
System.out.println("Found value: " + m.group(1) ); 
System.out.println("Found value: " + m.group(2) ); 
} else { 
System.out.println("NO MATCH"); 
} 
} 
} 


以 上 实例 编译 运行 结果 如 下 : 


Found value: This order was placed for QT3000! OK? 
Found value: This order was placed for QT300 
Found value: 0 


正则 表达 式 语 法 


字符 说 明 
将 下 一 字符 标记 为 特殊 字符 、 文 本 、 反 向 引用 或 八进制 转 义 符 。 
\ 例如 ， "nm" 匹 配 字符 "n"。 An" 匹 配 换行 符 。 序列 六 匹配 \"， "(" 匹 配 " 
("o 
A 匹配 输入 字符 串 开始 的 位 置 。 如 果 设 置 了 RegExp 对 象 的 
Multiline BM, ^ 还 会 与 \n" 或 \r" 之 后 的 位 置 匹 配 。 


(pattern) 


(?:pattern) 


(? 
=pattern) 


(?!pattern) 


匹配 输入 字符 串 结尾 的 位 置 。 如 果 设 置 了 RegExp 对 象 的 
Multiline 属性 ，$ 还 会 与 \n" 或 \r" 之 前 的 位 置 匹 配 。 


需 次 或 多 次 匹配 前 面 的 字符 或 子 表 达 式 。 例 如 ，zo 匹 
配 z" 和 "zo0"。 等 效 于 {0,}。 


一 次 或 多 次 匹配 前 面 的 字符 或 子 表达 式 。 例 
如 ，"zo+" 与 "Zo" 和 "zoo" 匹 配 ， 但 与 "z" 不 匹配 。+ SMF {1,}。 


需 次 或 一 次 匹配 前 面 的 字符 或 子 表达 式 。 例 如 ，"do(es)?" 匹 
配 "do" 或 "does" 中 的 "do"。? 等 效 于 {0,1}. 


n 是 非 负 整数 。 正 好 匹配 次 。 例 如 ，"o{2}" 与 "Bob" 中 的 "o" 不 匹 
配 ， 但 与 "food" 中 的 两 个 "o" 匹 配 。 


n 是 非 负 整 数 。 至 少 匹 配 n 次 。 例 如 ，"of2,》 不 匹配 "Bob" 中 
的 "0"， 而 匹配 "foooood" 中 的 所 有 0。"o{1,}" 等 效 
于 "o+"。 "op ES TOT 


MA n 是 非 负 整数 ， 其 中 nem. LAZY ne, Sam. 
例如 ，"o{f1,3?#" 匹 配 "fooooood" 中 的 头 三 个 o。'o{f0,1} 等 效 于 
'0?', XEX : 您 不 能 将 空格 插入 逗号 和 数字 之 间 。 


当 此 字符 紧 随 任何 其 他 限定 符 C. +. 7. (nk (nk (mp 之 后 
时 ， 匹 配 模式 是 " 非 贪 心 的 "。" 非 贪心 的 "模式 匹配 搜索 到 的 、 尽 可 
能 短 的 字符 串 ， 而 默认 的 "贪心 的 "模式 匹配 搜索 到 的 、 尽 可 能 长 的 
字符 串 。 例 如 ， 在 字符 串 "oooo" 中 ，"o+?" 只 匹配 单个 "o"， 

而 "o+" 匹 配 所 有 "o"。 


匹配 除 "\n" 之 外 的 任何 单个 字符 。 若 要 匹配 包括 \n" 在 内 的 任意 字 
符 ， 请 使 用 诸如 "fs\S]" 之 类 的 模式 。 


匹配 pattern 并 捕获 该 匹配 的 子 表达 式 。 可 以 使 用 $0...$9 属性 从 
结果 "匹配 "集合 中 检索 捕获 的 匹配 。 若 要 匹配 括号 字符 ( )， 请 使 
用 "(" 或 者 ")"。 

匹配 pattern 但 不 捕获 该 匹配 的 子 表达 式 ， 即 它 是 一 个 非 捕获 匹 
配 ， 不 存储 供 以 后 使 用 的 匹配 。 这 对 于 用 "or" 字 符 (|) 组 合 模式 部 
件 的 情况 很 有 用 。 例 如 ，'industr(?:ylies) 是 比 'industrylindustries' 
更 经 济 的 表达 式 。 


执行 正 向 预测 先行 搜索 的 子 表达 式 ， 该 表达 式 匹 配 多 于 匹配 
pattern 的 字符 串 的 起 始点 的 字符 串 。 它 是 一 个 非 捕获 匹配 ， 即 不 
获 供 以 后 使 用 的 匹配 。 例 如 ，'Windows (?-95|98|NT|2000)' 
匹配 "Windows 2000" 中 的 "Windows"， 但 不 匹配 "Windows 3.1" 中 
的 "Windows"。 预 测 先行 不 占用 字符 ， 即 发 生 匹配 后 ， 下 一 匹配 
的 搜索 紧 随 上 一 匹配 之 后 ， 而 不 是 在 组 成 预测 先行 的 字符 后 。 


执行 反 向 预测 先行 搜索 的 子 表达 式 ， 该 表达 式 匹 配 不 处 于 匹配 
pattern 的 字符 串 的 起 始点 的 搜索 字符 串 。 它 是 一 个 非 捕 获 匹 配 ， 
即 不 能 捕获 供 以 后 使 用 的 匹配 。 例 如 ，'Windows 
(?!95|98INTI20007 匹配 "Windows 3.1" 中 的 "Windows"， 但 不 匹 


配 "Windows 2000" 中 的 "Windows"。 预 测 先行 不 占用 字符 ， 即 发 
生 匹 配 后 ， 下 一 匹配 的 搜索 紧 随 上 一 匹配 之 后 ， 而 不 是 在 组 成 预 
测 先行 的 字符 后 。 


匹配 x eX y. 例如 ，'zlfood' 匹配 "z" 或 "food"。'(zlf)ood' Pt 
配 "zood" 或 "food"。 


字符 集 。 匹 配 包含 的 任 一 字符 。 例 如 ，"[abc]" 匹 配 "plain" 中 
的 "a"。 


反 向 字符 集 。 匹 配 未 包含 的 任何 字符 。 例 如 ，"abc" 匹 配 "plain" 中 


BUDE 


字符 范围 。 匹 配 指定 范 围 内 的 任何 字符 。 例 如 ，"[a-z]" 匹 
配 "a" 到 "z" 范 围 内 的 任何 小 写字 母 。 


反 向 范围 字符 。 匹 配 不 在 指定 的 范围 内 的 任何 字符 。 例 如 ，"[^a- 
z]" 匹 配 任何 不 在 "a" 到 "z" 范 围 内 的 任何 字符 。 


匹配 一 个 字 边 界 ， 即 字 与 空格 间 的 位 置 。 例 如 ，"er\b" 匹 
配 "never" 中 的 "er"， 但 不 匹配 "verb" 中 的 "er"。 


非 字 边 界 匹 配 。"er\B" 匹 配 "verb" 中 的 "er"， 但 不 匹配 "never" 中 
的 "er"。 


匹配 x 指示 的 控制 字符 。 例 如 ，\cM 匹配 Control-M 或 回 车 符 。xX 
J A-Z 或 a-z 之 间 。 如 果 不 是 这 样 ， 则 假定 c 就 是 "c" 字 
符 本 身 。 


数字 字符 匹配 。 等 效 于 [0-9]. 


非 数字 字符 匹配 。 等 效 于 0-9。 

换 页 符 匹 配 。 等 效 于 \x0c 和 cL. 
换行 符 匹 配 。 等 效 于 \x0a 和 \cJ。 

匹配 一 个 回 车 符 。 等 效 于 \x0d 和 \cM。 


匹配 任何 空白 字符 ， 包 括 空 格 、 制 表 符 、 换 页 符 等 。 与 [Vn] 
等 效 。 


匹配 任何 非 空白 字符 。 和 与 [^ Wn] 等 效 。 

制 表 符 匹 配 。 与 X09 和 \cl 等 效 。 

垂直 制 表 符 匹 配 。 和 与 wOb 和 \cK 等 效 。 
匹配 任何 字 类 字符 ， 包 括 下 划 线 。 与 "[A-Za-z0-9_]" 等 效 。 
与 任何 非 单词 字符 匹配 。 与 "[^A-Za-z0-9 ]" 等 效 。 


匹配 n， 此 处 的 n 是 一 个 十 六 进 制 转 义 码 。 十 六 进 制 转 义 码 必须 
正好 是 两 位 数 关 。 例 如 ，"\x41" 匹 配 "A"。"x041" 与 "\x04"&"1" 等 
效 。 人 允许 在 正则 表达 式 中 使 用 ASCII 代码 。 


匹配 num， 此 处 的 num 是 一 个 正 整数 。 到 捕获 匹配 的 反 向 引用 。 
= 例如 ，"(. 和 1" 匹配 两 个 连续 的 相同 字符 。 


标识 一 个 八进制 转 义 码 或 反 向 引用 。 如 果 n 前 面 至 少 有 _n 个 捕 
n 获 子 表 达 式 ， 那 么 n 是 反 向 引用 。 否 则 ， 如 果 n 是 八进制 数 (0- 
7)， 那 么 n 是 八进制 转 义 码 。 


标识 一 个 八进制 转 义 码 或 反 向 引用 。 如 果 nm 前 面 至 少 有 _nm 
个 捕获 子 表达 式 ， 那 么 nm 是 反 向 引用 。 如 果 nn 前 面 至 少 有 


nm. _n 个 捕获 ， 则 n 是 反 向 引用 ， 后 面 跟 有 字符 m。 如 果 两 种 前 面 的 
情况 都 不 存在 ， 则 nm 匹配 八进制 值 _hnm， 其 中 n Alm 是 八 进 
制 数字 (0-7)。 
T 当 n 是 八进制 数 (0-3), m 和 /是 八进制 数 (0-7) 时 ， 匹 配 八 进 制 
转 义 码 nml. 
"Um Ein, BA n 是 以 四 位 十 六 进 制 数 表示 的 Unicode 字符 。 例 
如 ，\u00A9 匹配 版 权 符 号 (?)。 
Mather 3: 8575 ;& 
索引 方法 
索引 方法 提供 了 有 用 的 索引 值 ， 精 确 表明 输入 字符 串 中 在 哪 能 找到 匹配 : 
方法 说 明 
public int start() 返回 以 前 匹配 的 初始 索引 。 
public int 返回 在 以 前 的 匹配 操作 期 间 ， 由 给 定 组 所 捕获 的 子 序 列 的 


start(int group) 初始 索引 
public int end() 返回 最 后 匹配 字符 之 后 的 偏 移 量 。 


public int end(int ”返回 在 以 前 的 匹配 操作 期 间 ， 由 给 定 组 所 捕获 子 序列 的 最 
group) 后 字符 之 后 的 偏 移 量 。 


研究 方法 


研究 方法 用 来 检查 输入 字符 串 并 返回 一 个 布尔 值 ， 表 示 是 否 找到 该 模式 : 


方法 说 明 


public 尝试 料 从 区 域 开 头 开 
boolean 始 的 输入 序列 与 该 模 
lookingAt() KEE. 


public 尝试 查找 与 该 模式 匹 

boolean 配 的 输入 序列 的 下 一 

find() 个 子 序列 。 

Be 重 置 此 匹配 器 ， 然 后 尝试 查找 匹配 该 模 
find(i ) 式 、 从 指定 索引 开始 的 输入 序列 的 下 一 
ind(int 个 子 序列 

start Pa a 

public 尝试 料 整个 区 域 与 模 

matches() 式 匹 配 。 
替换 方法 
蔡 换 方法 是 替换 输入 字符 串 里 文本 的 方法 : 

方法 说 明 


public Matcher 
appendReplacement(StringBuffer “实现 非 终端 添加 和 蔡 换 步骤 。 
sb, String replacement) 


public StringBuffer S IER 2E age 
appendTail(StringBuffer sb) 头 HLA 端 添加 和 替换 步 TR o 


public String replaceAll(String 蔡 换 模式 与 给 定 蔡 换 字符 串 相 匹配 的 输 


replacement) 入 序列 的 每 个 子 序 列 。 
public String replaceFirst(String 替换 模式 与 给 定 蔡 换 字符 串 匹 配 的 输入 
replacement) 序列 的 第 一 个 子 序 列 。 

返回 指定 字符 串 的 字面 替换 字符 串 。 这 
public static String 个 方法 返回 一 个 字符 串 ， 就 像 传 递 给 
quoteReplacement(String s) Matcher 类 的 appendReplacement 方法 


一 个 字面 字符 串 一 样 工 作 。 


start 和 end 方法 
下 面 是 一 个 对 单词 "cat" 出 现在 输入 字符 串 中 出 现 次 数 进 行 计 数 的 例子 : 


import java.util.regex.Matcher; 
import java.util.regex.Pattern; 


public class RegexMatches 
{ 
private static final String REGEX 
private static final String INPUT 
"cat cat cat cattie cat"; 


"\\bcat\\b"; 


public static void main( String args[] ){ 
Pattern p Pattern.compile(REGEX); 
Matcher m = p.matcher(INPUT); // 获取 matcher 对 象 
int count 0; 


while(m.find()) { 
count++; 
System.out.println("Match number "+count); 
System.out.println("start(): "+m.start()); 
System.out.println("end(): "+m.end()); 

} 

} 
} 


以 上 实例 编译 运行 结果 如 下 : 


Match number 1 
start(): 0 
end(): 3 

Match number 2 
start(): 4 
end(): 7 

Match number 3 
start(): B 
end(): 11 
Match number 4 
start(): 19 
end(): 22 


可 以 看 到 这 个 例子 是 使 用 单词 边界 ， 以 确保 字母 "c" "a" "t" 并 非 仅 是 一 个 较 长 的 词 
的 子 串 。 它 也 提供 了 一 些 关 于 输入 字符 串 中 匹配 发 生 位 置 的 有 用 信息 。 


Start 方 法 返回 在 以 前 的 匹配 操作 期 间 ， 由 给 定 组 所 捕获 的 子 序列 的 初始 索引 ，end 
方法 最 后 一 个 匹配 字符 的 索引 加 1。 


matches 和 lookingAt 方法 


matches 和 lookingAt 方法 都 用 来 尝试 匹配 一 个 输入 序列 模式 。 它 们 的 不 同 是 
matcher 要 求 整 个 序列 都 匹配 ， 而 lookingAt 不 要 求 。 


这 两 个 方法 经 党 在 输入 字符 串 的 开始 使 用 。 
我 们 通过 下 面 这 个 例子 ， 来 解释 这 个 功能 : 


import java. 
import java. 


util.regex.Matcher; 
util.regex.Pattern; 


public class RegexMatches 


static final String REGEX 
static final String INPUT 
static Pattern pattern; 
static Matcher matcher; 


"foo" i 
"fooooooooooooooooo"; 


public static void main( String args[] ){ 
pattern - Pattern.compile(REGEX); 
matcher = pattern.matcher(INPUT); 


System.out.println("Current REGEX is: "+REGEX); 
System.out.println("Current INPUT is: "+INPUT); 


System.out.println("lookingAt(): "+matcher.lookingAt()); 
System.out.println("matches(): "+matcher.matches()); 


{ . 
private 
private 
private 
private 

} 

} 


以 上 实例 编译 运行 结果 如 下 : 


Current REGEX is: foo 
Current INPUT is: foo000000000000000 


lookingAt(): 


true 


matches(): false 


replaceFirst 和 replaceAll 方法 


replaceFirst 和 replaceAll 方法 用 来 替换 匹配 正则 表达 式 的 文本 。 不 同 的 是 ， 
replaceFirst 替换 首次 匹配 ，replaceAll 替换 所 有 匹配 。 


下 面 的 例子 来 解释 这 个 功能 : 


import java.util.regex.Matcher; 
import java.util.regex.Pattern; 


public class RegexMatches 


{ 
private static String REGEX = "dog"; 
private static String INPUT = "The dog says meow. " + 
"All dogs say meow."; 
private static String REPLACE = "cat"; 
public static void main(String[] args) { 
Pattern p = Pattern.compile(REGEX) ; 
// get a matcher object 
Matcher m = p.matcher(INPUT); 
INPUT = m.replaceAll( REPLACE) ; 
System.out.println( INPUT) ; 
j 
j 


以 上 实例 编译 运行 结果 如 下 : 


The cat says meow. All cats say meow. 


appendReplacement 和 appendTail 方法 


Matcher 类 也 提供 了 appendReplacement 和 appendTail 方法 用 于 文本 替换 : 
看 下 面 的 例子 来 解释 这 个 功能 : 


import java.util.regex.Matcher; 
import java.util.regex.Pattern; 


public class RegexMatches 
{ 
private static String REGEX rar bles 
private static String INPUT "aabfooaabfooabfoob"; 
private static String REPLACE = "-"; 
public static void EPIS EU args) 1 
Pattern p - Pattern.compile(REGEX); 
获取 matcher 对 象 
Matcher m = p.matcher(INPUT); 
StringBuffer sb = new StringBuffer(); 
while(m.find()){ 
m.appendReplacement (sb, REPLACE) ; 


m.appendTail(sb); 
System.out.println(sb.toString()); 


以 上 实例 编译 运行 结果 如 下 : 


-foo-foo-foo- 


* 
s, 


PatternSyntaxException 类 的 方法 


PatternSyntaxException 是 一 个 非 强 制 异常 类 ， 它 指示 一 个 正则 表达 式 模 式 中 的 语 
法 错误 。 


PatternSyntaxException 类 提供 了 下 面 的 方法 来 帮助 我 们 查看 发 生 了 什么 错误 。 


方法 说 明 
etes c Ben 获取 错误 的 描述 。 
ns 获取 错误 的 索引 。 
PotPatemQ 获取 错误 的 正则 表达 式 模式 。 
public Sting ”返回 多 行 字符 串 ， 包 含 语法 错误 及 其 索引 的 描述 、 错 误 的 


getMessage() 正则 表达 式 模 式 和 模式 中 错误 索引 的 可 视 化 指示 。 


Java 方法 


在 前 面 几 个 章节 中 我 们 经 常 使 用 到 System.out.printIn()， 那 么 它 是 什么 呢 ? 


println() 是 一 个 方法 (Method)， 而 System 是 系统 类 (Class)，out 是 标准 输出 对 象 
(Object)。 这 人 句 话 的 用 法 是 调用 系统 类 System 中 的 标准 输出 对 象 out 中 的 方法 
println()。 


那么 什么 是 方法 呢 ? 

Java 方 法 是 语句 的 集合 ， 它 们 在 一 起 执行 一 个 功能 。 
e 方法 是 解决 一 类 问题 的 步骤 的 有 序 组 合 

e 方法 包含 于 类 或 对 象 中 

e 方法 在 程序 中 被 创建 ， 在 其 他 地 方 被 引用 
方法 的 定义 


一 般 情 况 下 ， 定 义 一 个 方法 包含 以 下 语法 : 


修饰 符 返回 值 类 型 方法 名 (参数 类 型 参数 名 ){ 


方法 体 


return 返回 值 ， 


方法 包含 一 个 方法 头 和 一 个 方法 体 。 下 面 是 一 个 方法 的 所 有 部 分 : 


Bie : 修饰 符 ， 这 是 可 选 的 ， 告 诉 编译 器 如 何 调用 该 方法 。 定 义 了 该 方法 的 
访问 类 型 。 

返回 值 类 型 : 方法 可 能 会 返回 值 。returnValueType 是 方法 返回 值 的 数据 类 
型 。 有 些 方 法 执行 所 需 的 操作 ， 但 没有 返回 值 。 在 这 种 情况 下 ， 
returnValueType 是 关键 字 void。 


e 方法 名 : 是 方法 的 实际 名 称 。 方 法 名 和 参数 表 共 同 构成 方法 签名 。 


参数 类 型 : 参数 像 是 一 个 占 位 符 。 当 方法 被 调用 时 ， 传 递 值 给 人 参数。 这 个 值 被 
称 为 实 参 或 变量 。 参 数列 表 是 指 方法 的 参数 类 型 、 顺 序 和 参数 的 个 数 。 参 数 是 
可 选 的 ， 方 法 可 以 不 包含 任何 参数 。 

方法 体 : 方法 体 包含 具体 的 语句 ， 定 义 该 方法 的 功能 。 


Define a method 





modifier return value type method name formal parameters 


T 
ris en static int eae nus, int num2) { 
uà | J 


| “int result; a 
method 


body parameter list 


if (numl > num2) 
result = numl; 
else 


return value 
result = num2; 


Lreturn result pa 


} 











如 : 
public static int age(int birthday){...} 
参数 可 以 有 多 个 : 
static float interest(float principal, int year){...} 
注意 : 在 一 些 其 它 语言 中 方法 指 过 程 和 函数 。 返回 非 void 类 型 返回 值 的 方法 称 


为 函数 ; 一 个 返回 void 类 类 型 返回 值 的 方法 叫做 过 m 


实例 
下 面 的 方法 包含 2 个 参数 num1 和 num2， 它 返回 这 两 个 参数 的 最 大 值 。 


/** 返回 两 个 整 型 变量 数据 的 较 大 值 */ 
public static int max(int numi, int num2) { 
int result; 
if (numi » num2) 
result - numi; 
else 
result - num2; 


return result; 


方法 调用 
Java 支 持 两 种 调用 方法 的 方式 ， 根 据 方法 是 否 返 回 值 来 选择 。 


当 程序 调用 一 个 方法 时 ， 程 序 的 控制 权 交 给 了 被 调用 的 方法 。 当 被 调用 方法 的 返回 


语句 执行 或 者 到 达 方 法 体 闭 括号 时 候 交 还 控制 权 给 程序 。 
当 方 法 返回 一 个 值 的 时 候 ， 方 法 调用 通常 被 当做 一 个 值 。 例 如 


int larger = max(30, 40); 


如 果 方 法 返回 值 是 void， 方 法 调用 一 定 是 一 条 语句 。 例 如 ， 方 法 println 返 回 void。 下 
面 的 调用 是 个 语句 : 


System.out.println("Welcome to Java!"); 


示例 
下 面 的 例子 演示 了 如 何 定义 一 个 方法 ， 以 及 如 何 调 用 它 : 


public class TestMax { 
PE BEG ea of 
public static void main(String[] args) { 


Ln ae 5 
int j = 2; 
int k = max(i, j); 


System.out.println("The maximum between " + i + 
W and n + j + W is W + k) : 
j 


/** 返回 两 个 整数 变量 较 大 的 值 */ 
public static int max(int numi, int num2) { 
int result; 
if (numi » num2) 
result - numi; 
else 
result - num2; 


return result; 
} 
以 上 实例 编译 运行 结果 如 下 : 


The maximum between 5 and 2 is 5 


这 个 程序 包含 main 方 法 和 max 方 法 。Main 方 法 是 被 JVM 调 用 的 ， 除 此 之 外 ，main 方 
法 和 其 它 方法 没什么 区 别 。 


main 方 法 的 头 部 是 不 变 的 ， 如 例子 所 示 ， 带 修饰 符 public 和 static, 返 回 void 类 型 值 ， 
方法 名 字 是 main, 此 外 带 个 一 个 String[] 类 型 参数 。String[] 表 明 参 数 是 字符 串 数 组 。 


void KiF 


本 节 说 明 如 何 声明 和 调用 一 个 void 方法 。 
下 面 的 例子 声明 了 一 个 名 为 printGrade 的 方法 ， 并 且 调 用 它 来 打印 给 定 的 分 数 。 


示例 


public class TestVoidMethod { 
public static void main(String[] args) { 


printGrade(78.5); 
J 


public static void printGrade(double score) ( 
if (score >= 90.0) { 
System.out.println('A'); 


else if (score >= 80.0) { 
System.out.println('B'); 


else if (score »- 70.0) ( 
System.out.println('C'); 


else if (score »- 60.0) ( 
System.out.println('D'); 


else ( 
System.out.println('F'); 
j 
j 
j 


以 上 实例 编译 运行 结果 如 下 : 
C 


这 里 printGrade 方 法 是 一 个 void 类 型 方法 ， 它 不 返回 值 。 


一 个 void 方法 的 调用 一 定 是 一 个 语句 。 所 以 ， 它 被 在 main 方 法 第 三 行 以 语句 形式 调 
用 。 就 像 任何 以 分 号 结束 的 语句 一 样 。 


通过 值 传递 参数 
调用 一 个 方法 时 候 需要 提供 参数 ， 你 必须 按照 参数 列表 指定 的 顺序 提供 。 
例如 ， 下 面 的 方法 连续 n 次 打印 一 个 消息 : 


public static void nPrintln(String message, int n) { 
for (int i = 0; i < n; i++) 
System.out.println(message); 


示例 
下 面 的 例子 演示 按 值 传 递 的 效果 。 
该 程序 创建 一 个 方法 ， 该 方法 用 于 交换 两 个 变量 。 


public class TestPassByValue { 


public static void main(String[] args) { 
int numi = 1; 
int num2 - 2; 


System.out.println("Before swap method, numi is " + 
numi + " and num2 is " + num2); 


// 调用 swap 方 法 

swap(numi, num2); 

System.out.println("After swap method, numi is " + 
numi + " and num2 is " + num2); 


j 

/** 交换 两 个 变量 的 方法 */ 

public static void swap(int ni, int n2) { 
System.out.println("NtInside the swap method"); 
System.out.println("NtNtBefore swapping ni is " + n1 

Pa Nees. cbr 

// 交换 ni 5 n2 的 值 
int temp = n1; 

ni = n2; 

n2 = temp; 

System.out.println("NtNtAfter swapping ní is " + ni 

Jos ul qoaa Rao 


以 上 实例 编译 运行 结果 如 下 : 


Before swap method, numi is 1 and num2 is 2 
Inside the swap method 
Before swapping ni is 1 n2 is 2 
After swapping ni is 2 n2 is 1 
After swap method, numi is 1 and num2 is 2 


传递 两 个 参数 调用 swap 方 法 。 有 趣 的 是 ， 方 法 被 调用 后 ， 实 参 的 值 并 没有 改变 。 


方法 的 重 载 
上 面 使 用 的 max 方 法 仅仅 适用 于 int 型 数据 。 但 如 果 你 想得到 两 个 浮 点 类 型 数据 的 最 
大 值 呢 ? 
解决 方法 是 创建 另 一 个 有 相同 名 字 但 参数 不 同 的 方法 ， 如 下 面 代 码 所 示 : 
public static double max(double numi, double num2) { 
if (numi > num2) 
return numi; 


else 
return num2; 


如 果 你 调用 max 方 法 时 传递 的 是 int 型 参数 ， 则 int 型 参数 的 max 方 法 就 会 被 调用 ; 
如 果 传 递 的 事 double 型 参数 ， 则 double 类 型 的 max 方 法 体会 被 调用 ， 这 叫做 方法 重 
载 ; 


就 是 说 一 个 类 的 两 个 方法 拥有 相同 的 名 字 ， 但 是 有 不 同 的 参数 列表 。 
Java 编 译 器 根据 方法 签名 判断 哪个 方法 应 该 被 调用 。 
方法 重 载 可 以 让 程序 更 清晰 易 读 。 执 行 密切 相关 任务 的 方法 应 该 使 用 相同 的 名 字 。 


重 载 的 方法 必须 拥有 不 同 的 参数 列表 。 你 不 能 仅仅 依据 修饰 符 或 者 返回 类 型 的 不 同 
来 重 载 方法 。 


变量 作用 城 


变量 的 范围 是 程序 中 该 变量 可 以 被 引用 的 部 分 。 

方法 内 定义 的 变量 被 称 为 局 部 变量 。 

局 部 变量 的 作用 范围 从 声明 开始 ， 直 到 包含 它 的 块 结束 。 

局 部 变量 必须 声明 才 可 以 使 用 。 

方法 的 参数 范围 涵盖 整个 方法 。 参 数 实际 上 是 一 个 局 部 变量 。 

for 循 环 的 初始 化 部 分 声明 的 变量 ， 其 作用 范围 在 整个 循环 。 

但 循环 体内 声明 的 变量 其 适用 范围 是 从 它 声 明 到 循环 体 结 束 。 它 包含 如 下 所 示 的 变 


量 声明 


public static void methodl() { 


for (int 7 = 1; i < 10; i++) { 


The scope of 7 . 
int j; 


The scope of j 
; A 
} 
你 可 以 在 一 个 方法 里 ， 不 同 的 非 府 套 块 中 多 次 声明 一 个 具有 相同 的 名 称 局 部 变量 ， 
但 你 不 能 在 腐 套 块 内 两 次 声明 局 部 变量 。 


命令 行 参数 的 使 用 


有 时 候 你 希望 运行 一 个 程序 时 候 再 传递 给 它 消息 。 这 要 靠 传递 命令 行 参 数 给 main() 
函数 实现 。 


命令 行 参数 是 在 执行 程序 时 候 紧 跟 在 程序 名 字 后 面 的 信息 。 
实例 
下 面 的 程序 打印 所 有 的 命令 行 参数 : 


public class CommandLine { 


public static void main(String args[]){ 
for(int 1=0; i«args.length; i++){ 
System.out.println("args[" + i * "]: "+ 
args[i]); 


如 下 所 示 ， 运 行 这 个 程序 : 


java CommandLine this is a command line 200 -100 


args[0]: this 
args[1]: is 
args[2]: a 
args[3]: command 
args[4]: line 
args[5]: 200 
args[6]: -100 


构造 方法 


当 一 个 对 象 被 创建 时 候 ， 构 造 方法 用 来 初始 化 该 对 象 。 构 造 方法 和 它 所 在 类 的 名 字 
相同 ， 但 构造 方法 没有 返回 值 。 
通常 会 使 用 构造 方法 给 一 个 类 的 实例 变量 赋 初 值 ， 或 者 执行 其 它 必 要 的 步骤 来 创建 


一 个 完整 的 对 象 。 


不 管 你 与 否 自 定义 构造 方法 ， 所 有 的 类 都 有 构造 方法 ， 因 为 Java 自 动 提供 了 一 个 默 
认 构 造 方 法 ， 它 把 所 有 成 员 初始 化 为 0。 


一 且 你 定义 了 自己 的 构造 方法 ， 默 认 构 造 方法 就 会 失效 。 


实例 
下 面 是 一 个 使 用 构造 方法 的 例子 : 


// 一 个 简单 的 构造 事 数 
class MyClass { 
ai) pay cs 


// VA FEAR 
MyClass() ( 
X = 10; 
j 
} 


你 可 以 像 下 面 这 样 调用 构造 方法 来 初始 化 一 个 对 象 : 


public class ConsDemo { 


public static void main(String args[]) { 
MyClass ti = new MyClass(); 
MyClass t2 = new MyClass(); 
System.out.println(t1.x + " " + t2.x); 


大 多 时 候 需 要 一 个 有 参数 的 构造 方法 。 


实例 
下 面 是 一 个 使 用 构造 方法 的 例子 
// 一 个 简单 的 构造 图 数 
class MyClass { 
nt Xe 
// SAB eae 
MyClass(int i ) { 


xz 0] 
} 


} 


你 可 以 像 下 面 这 样 调用 构造 方法 来 初始 化 一 个 对 象 : 


public class ConsDemo { 
public static void main(String args[]) { 
MyClass ti = new MyClass( 10 ); 


MyClass t2 = new MyClass( 20 ); 
System.out.println(ti.x + " "+ t2.x); 


JDK 1.5 开始 ，Java 支 持 传 递 同类 型 的 可 变 参 数 给 一 个 方法 。 
方法 的 可 变 参 数 的 声明 如 下 所 示 : 


typeName... parameterName 


在 方法 声明 中 ， 在 指定 参数 类 型 后 i 


一 个 方法 中 只 能 指定 一 个 可 变 参 数 ， 它 必须 是 方法 的 最 后 一 个 参数 。 任 何 普通 的 参 
数 必须 在 它 之 前 声明 。 


实例 


public class VarargsDemo { 


} 


public static void main(String args[]) { 
// 调用 可 变 参 数 的 方法 
printMax(34, 3, 3, 2, 56.5); 
printMax(new double[]{1, 2, 3}); 

} 


public static void printMax( double... numbers) { 
if (numbers.length == 0) { 
System.out.println("No argument passed"); 
return; 


} 
double result = numbers[0]; 


for (int i = 1; i < numbers.length; i++) 
if (numbers[i] > result) 
result = numbers[i]; 
System.out.println("The max value is " + result); 


j 


以 上 实例 编译 运行 结果 如 下 : 


The max value is 56.5 
The max value is 3.0 


finalize() 方法 


Java 人 允许 定义 这 样 的 方法 ， 它 在 对 象 被 垃圾 收集 器 析 构 (回收 ) 之 前 调用 ， 这 个 方法 
叫做 finalize( )， 它 用 来 清除 回收 对 象 。 


例如 ， 


你 可 以 使 用 finalize() 来 确保 一 个 对 象 打开 的 文件 被 关闭 了 。 


在 finalize() 方 法 里 ， 你 必须 指定 在 对 象 销毁 时 候 要 执行 的 操作 。 
finalize() 一 般 格式 是 : 


protected void finalize() 


} 


// 在 这 里 终结 代码 


关键 字 protected 是 一 个 限定 符 ， 它 确保 finalize() 方法 不 会 被 该 类 以 外 的 代码 调用 。 


当然 ，Java 的 内 存 回收 可 以 由 JVM 来 自动 完成 。 如 果 你 手动 使 用 ， 则 可 以 使 用 上 面 
的 方法 。 


实例 


public class FinalizationDemo { 
public static void main(String[] args) { 
Cake c1 = new Cake(1); 
Cake c2 = new Cake(2); 
Cake c3 = new Cake(3); 


c2 = c3 = null; 
System.gc(); // 调 用 Java 垃 圾 收集 器 


} 


class Cake extends Object { 
private int id; 
public Cake(int id) { 
this.id = id; 
System.out.println("Cake Object " + id + "is created"); 


} 


protected void finalize() throws java.lang.Throwable { 
super.finalize(); 
System.out.println("Cake Object " + id + "is disposed"); 


Aoo Bil 
运行 以 上 代码 ， 输 出 结果 如 下 : 


C:\1>java FinalizationDemo 
Cake Object 1is created 
Cake Object 2is created 
Cake Object 3is created 
Cake Object 3is disposed 
Cake Object 2is disposed 


Java 流 (Stream)、 文 件 (File) 和 IO 

Java.io 包 几乎 包含 了 所 有 操作 输入 、 输 出 需要 的 类 。 所 有 这 些 流 类 代表 了 输入 源 和 
输出 目标 。 

Java.io 包 中 的 流 支持 很 多 种 格式 ， 上 比如 : 基本 类 型 、 对 象 、 本 地 化 字符 集 等 等 。 


一 个 流 可 以 理解 为 一 个 数据 的 序列 。 输 入 流 表 示 从 一 个 源 读 取 数据 ， 输 出 流 表示 向 
一 个 目标 写 数据 。 


Java 为 /0 提供 了 强大 的 而 灵活 的 支持 ， 使 其 更 广泛 地 应 用 到 文件 传输 和 网 络 编程 


o 


但 本 节 讲 述 最 基本 的 和 流 与 MO 相关 的 功能 。 我 们 将 通过 一 个 个 例子 来 学 习 这 些 功 


4b 
Abo 


读 取 控制 台 输 入 
Java 的 控制 台 输 入 由 Sysem.in 完 成 。 


为 了 获得 一 个 绑 定 到 控制 台 的 字符 流 ， 你 可 以 把 System.in 包 装 在 一 个 
BufferedReader 对 象 中 来 创建 一 个 字符 流 。 


下 面 是 创建 BufferedReader 的 基本 语法 : 


BufferedReader br = new BufferedReader (new 
InputStreamReader(System.in)); 


BufferedReader 对 象 创建 后 ， 我 们 便 可 以 使 用 read() 方 法 从 控制 台 读 取 一 个 字符 ， 
或 者 用 readLine() 方 法 读 取 一 个 字符 串 。 


从 控制 台 读 取 多 字符 输入 
从 BufferedReader 对 象 读 取 一 个 字符 要 使 用 read() 方 法 ， 它 的 语法 如 下 : 


int read( ) throws IOException 


每 次 调用 read() 方 法 ， 它 从 输入 流 读 取 一 个 字符 并 把 该 字符 作为 整数 值 返回 。 当 流 
结束 的 时 候 返 回 -1。 该 方法 抛 出 IOException。 


下 面 的 程序 示范 了 用 read() 方 法 从 控制 台 不 断 读 取 字符 直到 用 户 输入 "q"。 


// 使 用 BufferedReader 在 控制 台 读 取 字 符 
import java.io.*; 


public class BRRead { 
public static void main(String args[]) throws IOException 


{ 
char c; 
// 使 用 System.in 创建 BufferedReader 
BufferedReader br = new BufferedReader (new 
InputStreamReader(System.in)); 
System.out.println("Enter characters, 'q' to quit."); 
// 读 取 字 符 
do { 
c = (char) br.read(); 
System.out.println(c); 
} while(c !- 'q'); 
j 


以 上 实例 编译 运行 结果 如 下 : 


Enter characters, 'q' to quit. 
123abcq 
1 


200980 nN 


从 控制 台 读 取 字 符 串 


从 标准 输入 读 取 一 个 字符 串 需要 使 用 BufferedReader 的 readLine() 方 法 。 
它 的 一 般 格 式 是 : 


String readLine( ) throws IOException 


下 面 的 程序 读 取 和 显示 字符 行 直 到 你 输入 了 单词 "end"。 


// 使 用 BufferedReader 在 控制 台 读 取 字 符 
import java.io.*; 
public class BRReadLines { 
public static void main(String args[]) throws IOException 


{ 
// 使 用 System.in 创建 BufferedReader 
BufferedReader br = new BufferedReader(new 
InputStreamReader(System.in)); 
String str; 
System.out.println("Enter lines of text."); 
System.out.println("Enter 'end' to quit."); 
do { 
str - br.readLine(); 
System.out.println(str); 
} while(!str.equals("end")); 
j 


以 上 实例 编译 运行 结果 如 下 : 


Enter lines of text. 
Enter 'end' to quit. 
This is line one 
This is line one 
This is line two 
This is line two 
end 

end 


控制 台 输 出 


在 此 前 已 经 介绍 过 ， 控 制 台 的 输出 由 print( ) 和 println( ) 完 成 。 这 些 方法 都 由 类 
PrintStream 定义 ，System.out 是 该 类 对 象 的 一 个 引用 。 


PrintStream 继承 了 OutputStream 类 ， 并 且 实 现 了 方法 write()。 这 样 ，write() 也 可 以 
用 来 往 控 制 台 写 操 作 。 
PrintStream 定义 write() 的 最 简单 格式 如 下 所 示 : 


void write(int byteval) 


该 方法 将 byteval 的 低 八 位 字 节 写 到 流 中 。 


实例 


下 面 的 例子 用 write() 把 字符 "A" 和 紧 跟着 的 换行 符 输出 到 屏幕 : 


import java.io.*; 
// 演示 System.out.write(). 
public class WriteDemo { 
public static void main(String args[]) ( 
int b; 
b= 'A'; 
System.out.write(b); 
System.out.write('\n'); 


运行 以 上 实例 在 输出 窗口 输出 "A" 字 符 


A 
注意 : write() 方 法 不 经 常 使 用 ， 因 为 print() 和 printIn() 方 法 用 起 来 更 为 方便 。 


读 写 文件 


如 前 所 述 ， 一 个 流 被 定义 为 一 个 数据 序列 。 输 入 流 用 于 从 源 读 取 数 据 ， 输 出 流 用 于 
向 目标 写 数据 。 
下 图 是 一 个 描述 输入 流 和 输出 流 的 类 层次 图 。 
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下 面 将 要 讨论 的 两 个 重要 的 流 是 FilelnputStream flFileOutputStream : 


FilelnputStream 


该 流 用 于 从 文件 读 取 数 据 ， 它 的 对 象 可 以 用 关键 字 new 来 创建 。 
有 多 种 构造 方法 可 用 来 创建 对 象 。 


可 以 使 用 字符 串 类 型 的 文件 名 来 创建 一 个 输入 流 对 象 来 读 取 文 件 : 


InputStream f = new FileInputStream("C:/java/hello"); 


也 可 以 使 用 一 个 文件 对 象 来 创建 一 个 输入 流 对 象 来 读 取 文 件 。 我 们 首先 得 使 用 File() 
方法 来 创建 一 个 文件 对 象 : 


File f = new File("C:/java/hello"); 
InputStream f = new FileInputStream(f); 


创建 了 InputStream 对 象 ， 就 可 以 使 用 下 面 的 方法 来 读 取 流 或 者 进行 其 他 的 流 操 
f 


o 


方法 mm 
public void close() 关闭 此 文件 输入 流 并 释放 与 此 流 有 关 的 所 有 采 统 资 
N . NAT 
lOException{} im. WüHIOExceptions? 8$, 
Se Reece 这 个 方法 清除 与 该 文件 的 连接 。 确 保 在 不 再 引用 文件 


finalize()throws 


Ay 流 JT 3E 其 > : 异常 。 
IOException {} 输入 流 时 调用 其 close 755. HWIOException s 


public int read(int 这 个 方法 从 InputStream 对 象 读 取 指 定 字 节 的 数据 。 返 
r)throws 回 为 整数 值 。 返 回 下 一 字 节 数据 ， 如 果 已 经 到 结尾 则 
lOException() 返回 -1。 

public int 


这 个 方法 从 输入 流 读 取 r.length 长 度 的 字 节 。 返 回 污 取 


read(byte[] r) throws E i asa 
lIOException{} 的 字 节 数 。 如 果 是 文件 结尾 则 返回 ile 


public int available() ， 返回 下 一 次 对 此 输入 流 调用 的 方法 可 以 不 受阻 塞 地 从 


throws ese Hy Agee BIG] NBR 
IOException{} 此 输入 流 读 取 的 字 节 数 。 jx [n] | 整数 值 。 


除了 InputStream 外 ， 还 有 一 些 其 他 的 输入 流 ， 更 多 的 细节 参考 下 面 链接 : 


e ByteArraylnputStream 
e DatalnputStream 


FileOutputStream 


该 类 用 来 创建 一 个 文件 并 向 文件 中 写 数 据 。 
如 果 该 流 在 打开 文件 进行 输出 前 ， 目 标 文件 不 存在 ， 那 么 该 流 会 创建 该 文件 。 
有 两 个 构造 方法 可 以 用 来 创建 FileOutputStream 对 象 。 


使 用 字符 串 类 型 的 文件 名 来 创建 一 个 输出 流 对 象 : 

OutputStream f = new FileOutputStream("C:/java/hello") 
也 可 以 使 用 一 个 文件 对 象 来 创建 一 个 输出 流 来 写 文 件 。 我 们 首先 得 使 用 File() 方 法 来 
创建 一 个 文件 对 象 : 


File f = new File("C:/java/hello"); 
OutputStream f = new FileOutputStream(f); 


创建 OutputStream 对 象 完成 后 ， 就 可 以 使 用 下 面 的 方法 来 写 入 流 或 者 进行 其 他 的 
流 操作 。 
序号 方法 及 描述 


public void close() 关闭 此 文件 输入 流 并 释放 与 此 流 有 关 的 所 有 系统 资 
throws lOException() ， 源 。 抛 出 IOException 异 常 。 


protected void 这 个 方法 清除 与 该 文件 的 连接 。 确 保 在 不 再 引用 文件 
finalize()throws 输入 流 时 调用 其 close Aik. WütlOExceptionse 
IOException {} EM 

public void write(int 

w)throws 这 个 方法 把 指定 的 字 节 写 到 输出 流 中 。 
lOException() 

public void 把 指定 数组 中 w.length 长 度 的 字 节 写 到 OutputStream 
write(byte[] w) 中 。 


除了 OutputStream 外 ， 还 有 一 些 其 他 的 输出 流 ， 更 多 的 细节 参考 下 面 链接 : 


e ByteArrayOutputStream 
e DataOutputStream 


实例 


下 面 是 一 个 演示 InputStream 和 OutputStream 用 法 的 例子 : 


import java.io.*; 
public class fileStreamTest{ 
public static void main(String args[]){ 


try{ 
byte bWrite [] = {11,21,3,40,5}; 
OutputStream os = new FileOutputStream("test.txt"); 
for(int x=0; x < bwrite.length ; x++){ 
os.write( bWrite[x] ); // writes the bytes 


os.close(); 


InputStream is = new FileInputStream("test.txt"); 
int size = is.available(); 


for(int i=0; i< size; I++){ 
System.out.print((char)is.read() +" "); 


is.close(); 
jcatch(IOException e){ 
System.out.print("Exception"); 
j 
j 
j 


上 面 的 程序 首先 创建 文件 test.txt， 并 把 给 定 的 数字 以 二 进 制 形式 写 进 该 文件 ， 同 时 
输出 到 控制 台 上 。 
以 上 代码 由 于 是 二 进 制导 入 ， 可 能 存在 乱码 ， 你 可 以 使 用 以 下 代码 实例 来 解决 乱码 


问题 : 


// 文 件 名 :fileStreamTest2.java 
import java.io.*; 


public class fileStreamTest2{ 
public static void main(String[] args) throws IOException { 


File f - new File("a.txt"); 
FileOutputStream fop - new FileOutputStream(f); 
// 构建 FileOutputStream 对 象 , 文件 不 存在 会 自动 新 建 


OutputStreamwriter writer = new OutputStreamWriter(fop, "U 
// 构建 0utputStreamwriter 对 象 , 参数 可 以 指定 编码 ,默认 为 操作 系统 默认 ; 


writer.append(" 中 文 输入 " ) ， 
// 写 入 到 缓冲 区 


writer.append("\r\n"); 
// 换 行 


writer.append("English"); 
// 刷新 缓存 冲 , 写 入 到 文件 , 如 果 下 面 已 经 没有 写 入 的 内 容 了 ， 直接 close 也 会 2 


writer.close(); 
// 关 闭 写 入 流 , 同时 会 把 缓冲 区 内 容 写 入 文件 ,所 以 上 面 的 注释 掉 


fop.close(); 
// 天 闭 输 出 流 , 释放 系统 资源 


FileInputStream fip = new FileInputStream(f); 
// 构建 FileInputStream 对 象 


InputStreamReader reader = new InputStreamReader(fip, "UTF. 
// 构建 InputStreamReader 对 象 , 编码 与 守 入 相同 


StringBuffer sb = new StringBuffer(); 

while (reader.ready()) { 
sb.append((char) reader.read()); 
// 转 成 char 加 到 StringBuffer 对 象 中 

} 

System.out.println(sb.toString()); 

reader.close(); 

// 关闭 读 取 流 


fip.close(); 
// 关闭 输入 流 ,释放 系统 资源 








文件 和 1O 


还 有 一 些 关 于 文件 和 |/O 的 类 ， 我 们 也 需要 知道 : 


e File Class(#) 
e FileReader Class( X) 
e FileWriter Class( X) 


Java 中 的 目录 


创建 目录 : 
File 类 中 有 两 个 方法 可 以 用 来 创建 文件 夹 : 


e mkdir( ) 方 法 创建 一 个 文件 夹 ， 成 功 则 返回 true， 失 败 则 返回 false。 失 败 表 明 
File 对 象 指定 的 路 径 已 经 存在 ， 或 者 由 于 整个 路 径 还 不 存在 ， 该 文件 夹 不 能 被 
创建 。 

e mkdirs() 方 法 创建 一 个 文件 夹 和 它 的 所 有 父 文件 夹 。 


下 面 的 例子 创建 "/tmp/user/java/bin" 文 件 夹 : 


import java.io.File; 
public class CreateDir { 
public static void main(String args[]) { 
String dirname = "/tmp/user/java/bin"; 
File d = new File(dirname); 


// 现在 创建 目录 
d.mkdirs(); 


编译 并 执行 上 面 代 码 来 创建 目录 "tmp/useWijava/bin"。 


注意 : Java 在 UNIX 和 Windows 自 动 按 约 定 分 辨 文件 路 径 分 隅 符 。 如 果 你 在 
Windows 版 本 的 Java 中 使 用 分 隔 符 (/) ， 路 径 依 然 能 够 被 正确 解析 。 


读 取 目录 
一 个 目录 其 实 就 是 一 个 File 对 象 ， 它 包含 其 他 文件 和 文件 夹 。 
如 果 创 建 一 个 File 对 象 并 且 它 是 一 个 目录 ， 那 么 调用 isDirectory( ) 方 法 会 返回 true。 


可 以 通过 调用 该 对 象 上 的 list() 方 法 ， 来 提取 它 包含 的 文件 和 文件 夹 的 列表 。 
下 面 展示 的 例子 说 明 如 何 使 用 list() 方 法 来 检查 一 个 文件 夹 中 包含 的 内 容 : 


import java.io.File; 


public class DirList { 
public static void main(String args[]) { 
String dirname = "/tmp"; 
File f1 = new File(dirname) ; 
if (fi.isDirectory()) { 
System.out.println( "Directory of " + dirname); 
String s[] = f1.list(); 
for (int i-0; i < s.length; i++) ( 
File f = new File(dirname + "/" + s[i]); 
if (f.isDirectory()) { 
System.out.println(s[i] + " is a directory"); 
} else { 
System.out.println(s[i] + " is a file"); 
j 
} 


} else { 
System.out.println(dirname + " is not a directory"); 


以 上 实例 编译 运行 结果 如 下 : 


Directory of /tmp 

bin is a directory 

lib is a directory 
demo is a directory 
test.txt is a file 
README is a file 
index.html is a file 
include is a directory 


Java 异常 义理 

异常 是 程序 中 的 一 些 错误 ， 但 并 不 是 所 有 的 错误 都 是 异常 ， 并 且 错 误 有 时 候 是 可 以 
避免 的 。 

比如 说 ， 你 的 代码 少 了 一 个 分 号 ， 那 么 运行 出 来 结果 是 提示 是 错误 
java.lang.Error ; 如 果 你 用 System.out.println(11/0)， 那 么 你 是 因为 你 用 0 做 了 除 
数 ， 会 抛 出 java.lang.ArithmeticException 的 异常 。 

异常 发 生 的 原因 有 很 多 ， 通 常 包含 以 下 几 大 类 : 


e。 用 户 输 入 了 非法 数据 。 

e. 要 打开 的 文件 不 存在 。 

e 网 络 通信 时 连接 中 断 ， 或 者 JVM 内 存 渝 出 。 

这 些 异 常 有 的 是 因为 用 户 错 误 引 起 ， 有 的 是 程序 错误 引起 的 ， 还 有 其 它 一 些 是 因为 
物理 错误 引起 的 。- 
要 理解 Java 异 常 处 理 是 如 何 工 作 的 ， 你 需要 掌握 以 下 三 种 类 型 的 异常 : 

e 检查 性 异常 : 最 具 代 表 的 检查 性 异常 是 用 户 错误 或 问题 引起 的 异常 ， 这 是 程序 
员 无 法 预见 的 。 例 如 要 打开 一 个 不 存在 文件 时 ， 一 个 异常 就 发 生 了 ， 这 些 异 常 
在 编译 时 不 能 被 简单 地 忽略 。 

e 运行 时 异常 : 运行 时 异常 是 可 能 被 程序 员 避 免 的 异常 。 与 检查 性 异常 相反 ， 运 
行 时 异常 可 以 在 编译 时 被 忽略 。 

e 错误 : 错误 不 是 异常 ， 而 是 脱离 程序 员 控制 的 问题 。 错 误 在 代码 中 通常 被 忽 
略 。 例 如 ， 当 栈 渝 出 时 ， 一 个 错误 就 发 生 了 ， 它 们 在 编译 也 检查 不 到 的 。 


Exception 类 的 层次 


所 有 的 异常 类 是 从 java.lang.Exception 类 继承 的 子 类 。 


Exception 类 是 Throwable 类 的 子 类 。 除 了 Exception 类 外 ，Throwable 还 有 一 个 子 类 
Error 。 


Java 程 序 通 常 不 捕获 错误 。 错 误 一 般 发 生 在 严重 故障 时 ， 它 们 在 Java 程 序 处 理 的 范 
HZ. 


Error 用 来 指示 运行 时 环境 发 生 的 错误 。 
例如 ，JVM 内 存 浴 出 。 一 般 地 ， 程 序 不 会 从 错误 中 恢复 。 


异常 类 有 两 个 主要 的 子 类 : IOException 类 和 RuntimeException 类 。 








| see eption | 


在 Java 内 置 类 中 ( 接 下 来 会 说 明 )， 有 大 部 分 常用 检查 性 和 非 检 查 性 异常 。 





Java 内 置 异 常 类 


Java 语言 定义 了 一 些 异常 类 在 java.lang 标 准 包 中 。 


标准 运行 时 异常 类 的 子 类 是 最 常见 的 异常 类 。 由 于 java.lang 包 是 默认 加 载 到 所 有 的 
Java 程 序 的 ， 所 以 大 部 分 从 运行 时 异常 类 继承 而 来 的 异常 都 可 以 直接 使 用 。 


Java 根 据 各 个 类 库 也 定义 了 一 些 其 他 的 有 异常， 下面 的 表 中 列 出 了 Java 的 非 检 查 性 异 
常 。 


pun 
Ba 


ArithmeticException 


ArrayIndexOutOfBoundsException 


ArrayStoreException 


ClassCastException 


IllegalArgumentException 


IllegalMonitorStateException 


IllegalStateException 


IllegalThreadStateException 


IndexOutOfBoundsException 


NegativeArraySizeException 


NullPointerException 


NumberFormatException 


SecurityException 


StringlIndexOutOfBoundsException 


UnsupportedOperationException 


描述 


当 出 现 异常 的 运算 条 件 时 ， 抛 出 此 民 
常 。 例 如 ， 一 个 整数 " 除 以 零 "时 ， 抛 出 此 
类 的 一 个 实例 。 


用 非法 索引 访问 数组 时 抛 出 的 异常 。 如 
果 索 引 为 负 或 大 于 等 于 数组 大 小 ， 则 该 
索引 为 非法 索引 。 


试图 将 错误 类 型 的 对 象 存储 到 一 个 对 象 
数组 时 抛 出 的 异常 。 


当 试 图 将 对 象 强制 转换 为 不 是 实例 的 子 
Xm, Heu. 


抛 出 的 异常 表明 向 方法 传递 了 一 个 不 合 
法 或 不 正确 的 参数 。 


抛 出 的 异常 表明 某 一 线程 已 经 试图 等 待 
对 象 的 监视 器 ， 或 者 试图 通知 其 他 正在 
等 待 对 象 的 监视 器 而 本 身 没有 指定 监视 
器 的 线程 。 

在 非法 或 不 适当 的 时 间 调 用 方法 时 产生 
的 信号 。 换 名 话说， 即 Java 环境 或 
Java 应 用 程序 没有 人 处 于 请 求 操 作 所 要 求 
的 适当 状态 下 。 


线程 没有 处 于 请 求 操 作 所 要 求 的 适当 状 
态 时 抛 出 的 异常 。 

指示 某 排序 素 引 (例如 对 数组 、 字 符 串 
或 向 量 的 排序 ) 超出 范围 时 抛 出 。 

如 果 应 用 程序 试图 创建 大 小 为 负 的 数 
组 ， 则 抛 出 该 异常 。 

当 应 用 程序 试图 在 需要 对 象 的 地 方 使 用 
null 时 ， 抛 出 该 异常 

当 应 用 程序 试图 将 字符 串 转 换 成 一 种 数 
值 类 型 ， 但 该 字符 串 不 能 转换 为 适当 格 
式 时 ， 抛 出 该 异常 。 

由 安全 管理 器 抛 出 的 异常 ， 指 示 存 在 安 
全 侵犯 。 

此 异常 由 String 方法 抛 出 ， 指 示 索 引 
或 者 为 负 ， 或 者 超出 字符 串 的 大 小 。 


当 不 支持 请 求 的 操作 时 ， 抛 出 该 异常 。 


下 面 的 表 中 列 出 了 Java 定 义 在 java.lang 包 中 的 检查 性 异常 类 。 


ClassNotFoundException 


描述 


应 用 程序 试图 加 载 类 时 ， 找 不 到 相应 的 类 ， 抛 
出 该 异常 。 


当 调 用 Object 类 中 的 clone 方法 克隆 对 


一 


CloneNotSupportedException ， 象 ， 但 该 对 象 的 类 无 法 实现 Cloneable 接 


IllegalAccessException 


InstantiationException 


InterruptedException 


NoSuchFieldException 
NoSuchMethodException 


异常 方法 


下 面 的 列表 是 Throwable 类 的 主要 方法 : 


public Throwable 


方法 


public String 
getMessage() 


getCause() 


public String 


toString() 


public void 
printStackTrace() 


public 


StackTraceElement [] 
getStackTrace() 


public Throwable 
filllnStackTrace() 


捕 


大 En 
FF rm 


口 时 ， 抛 出 该 异常 。 
拒绝 访问 一 个 类 的 时 候 ， 抛 出 该 异常 。 


当 试 图 使 用 class 类 中 的 newInstance 

方法 创建 一 个 类 的 实例 ， 而 指定 的 类 对 象 因 为 
是 一 个 接口 或 是 一 个 抽象 类 而 无 法 实例 化 时 ， 
抛 出 该 异常 。 


一 个 线程 被 另 一 个 线程 中 断 ， 抛 出 该 异常 。 
请 求 的 变量 不 存在 
请 求 的 方法 不 存在 


说 明 
返回 关于 发 生 的 异常 的 详细 信息 。 这 个 消息 在 
Throwable 类 的 构造 画 数 中 初始 化 了 。 


返回 一 个 Throwable 对 象 代表 异常 原因 。 


使 用 getMessage() 的 结果 返回 类 的 串 级 名 字 。 


打印 toString() 结 果 和 栈 层 次 到 System.err， 即 错误 


输出 流 。 


返回 一 个 包含 堆栈 层次 的 数组 。 下 标 为 0 的 元 素 代表 
栈 顶 ， 最 后 一 个 元 素 代表 方法 调用 堆栈 的 栈 底 。 


用 当前 的 调用 栈 层 次 填充 Throwable 对 象 栈 层 次 ， 
添加 到 栈 层 次 任何 先前 信息 中 。 


使 用 try 和 catch 关 键 字 可 以 捕获 异常 。try/catch 代 码 块 放 在 异常 可 能 发 生 的 地 方 。 
try/catch 代 码 块 中 的 代码 称 为 保护 代码 ， 使 用 try/catch 的 语法 如 下 : 


try 


// 程序 代码 
jcatch(ExceptionName e1) 


//Catch 34 
} 


Catch 语 句 包含 要 捕获 异常 类 型 的 声明 。 当 保护 代码 块 中 发 生 一 个 异常 时 ，try 后 面 
的 catch 块 就 会 被 检查 。 

如 果 发 生 的 异常 包含 在 catch 块 中 ， 异 常会 被 传递 到 该 catch 块 ， 这 和 传递 一 个 参数 
到 方法 是 一 样 。 

实例 

下 面 的 例子 中 声明 有 两 个 元 素 的 一 个 数组 ， 当 代码 试图 访问 数组 的 第 三 个 元 素 的 时 


候 就 会 抛 出 一 个 异常 。 


// 文件 名 : ExcepTest.java 
import java.io.*; 
public class ExcepTest{ 


public static void main(String args[]){ 


tryt 
int a[] = new int[2]; 
System.out.println("Access element three :" + a[3]); 
jcatch(ArrayIndexOutOfBoundsException e){ 
System.out.println("Exception thrown :" + e); 
j 


System.out.println("Out of the block"); 


} 
} 


以 上 代码 编译 运行 输出 结果 如 下 : 


Exception thrown :java.lang.ArrayIndexOutOfBoundsException: 3 
Out of the block 


多 重 捕获 块 


一 个 try 代 码 块 后 面 跟随 多 个 catch 代 码 块 的 情况 就 叫 多 重 捕获 。 


多 重 捕获 块 的 语法 如 下 所 示 : 


try{ 
// 程序 代码 

}catch (异常 类 型 1 异常 的 变量 名 1){ 
// 程序 代码 

}catch (异常 类 型 2 异常 的 变量 名 2 ){ 
// 程序 代码 

}catch( 异 常 类 型 2 异常 的 变量 名 2 ){ 
// 程序 代码 

n 


上 面 的 代码 段 包 含 了 3 个 catch 块 。 

可 以 在 ry 语 名 后面 添加 任意 数量 的 catch 块 。 

如 果 保 护 代 码 中 发 生 异 常 ， 异 常 被 抛 给 第 一 个 catch 块 。 

如 果 抛 出 异常 的 数据 类 型 与 ExceptionType1 匹 配 ， 它 在 这 里 就 会 被 捕获 。 
如 果 不 匹配 ， 它 会 被 传递 给 第 二 个 catch 块 。 

如 此 ， 直 到 异常 被 捕获 或 者 通过 所 有 的 catch 块 。 


实例 
该 实例 展示 了 怎么 使 用 多 重 try/catch。 


try 
{ 
file = new FileInputStream( fileName) ; 
x = (byte) file.read(); 
}catch(IOException i) 
{ 
i.printStackTrace(); 
return -1; 
jcatch(FileNotFoundException f) //Not valid! 


{ 
f.printStackTrace(); 
return -1; 
j 
throws/throw 关 键 字 : 


如 果 一 个 方法 没有 捕获 一 个 检查 性 有 异常， 那么 该 方法 必须 使 用 throws 关键 字 来 声 
明 。throws 关 键 字 放 在 方法 签名 的 尾部 。 


也 可 以 使 用 throw 关 键 字 抛 出 一 个 异常 ， 无 论 它 是 新 实例 化 的 还 是 刚 捕获 到 的 。 


下 面 方法 的 声明 抛 出 一 个 RemoteException 异 常 : 


import java.io.*; 
public class className 


{ 
public void deposit(double amount) throws RemoteException 
// Method implementation 
throw new RemoteException(); 
} 
//Remainder of class definition 
} 


一 个 方法 可 以 声明 抛 出 多 个 异常 ， 多 个 异常 之 间 用 逗号 隔 开 。 


例如 ， 下 面 的 方法 声明 抛 出 RemoteException 和 InsufficientFundsException : 


import java.io.*; 
public class className 


public void withdraw(double amount) throws RemoteException, 
InsufficientFundsException 


// Method implementation 


//Remainder of class definition 


finally ££ + 


finally 关 键 字 用 来 创建 在 try 代 码 块 后 面 执行 的 代码 块 。 

无 论 是 否 发 生 异 常 ，finally 代 码 块 中 的 代码 总 会 被 执行 。 

在 finally 代 码 块 中 ， 可 以 运行 清理 类 型 等 收尾 善后 性 质 的 语句 。 
finally 代 码 块 出 现在 catch 代 码 块 最 后 ， 语 法 如 下 : 


try{ 
// 程序 代码 


}catch( 异 常 类 型 1 异常 的 变量 名 1){ 
// 程序 代码 
}catch( 异 常 类 型 2 异常 的 变量 名 2 ){ 


// 程序 代码 
}finally{ 

// 程序 代码 
} 


实例 


public class ExcepTest{ 


public static void main(String args[]){ 
int a[] = new int[2]; 


tryt 
System.out.println("Access element three :" + a[3]); 
jcatch(ArrayIndexOutOfBoundsException e){ 
System.out.println("Exception thrown :" + e); 
} 
finally{ 
a[0] = 6; 
System.out.println("First element value: " +a[0]); 
System.out.println("The finally statement is executed"); 
} 


E a) 
以 上 实例 编译 运行 结果 如 下 : 


Exception thrown :java.lang.ArrayIndexOutOfBoundsException: 3 
First element value: 6 
The finally statement is executed 


注意 下 面 事项 : 


catch 不 能 独立 于 try 存 在 。 

在 try/catch 后 面 添加 finally 块 并 非 强 制 性 要 求 的 。 
try 代 码 后 不 能 既 没 catch 块 也 没 finally 块 。 

try, catch, finally 块 之 间 不 能 添加 任何 代码 。 


声明 自 定 义 异 常 
在 Java 中 你 可 以 自 定义 异常 。 编 写 自己 的 异常 类 时 需要 记 住 下 面 的 几 点 。 


e 所 有 异常 都 必须 是 Throwable 的 子 类 
e 如果 希望 写 一 则 需 要 继承 Exception 类 。 
e 如 果 你 想 写 一 个 运行 时 异常 类 ， 那 么 需要 继承 RuntimeException 类 。 


可 以 像 下 面 这 样 定义 自己 的 异常 


class MyException extends Exception{ 


} 


下 面 的 InsufficientFundsException 类 是 用 户 定 义 的 异常 类 ， 它 继承 自 Exception。 
一 个 异常 类 和 其 它 任 何 类 一 样 ， 包 含有 变量 和 方法 。 


实例 


// 文件 名 InsufficientFundsException.java 
import java.io.* 


public class InsufficientFundsException extends Exception 


{ 


private double amount; 
public InsufficientFundsException(double amount) 


( 


this.amount - amount; 


public double getAmount() 
{ 


} 


return amount; 


} 


为 了 展示 如 何 使 用 我 们 自 定义 的 异常 类 ， 


在 下 面 的 CheckingAccount 类 中 包含 一 个 withdraw() 方 法 抛 出 一 
InsufficientFundsException 异 常 。 


// 文件 名 称 CheckingAccount. java 
import java.io.*; 


public class CheckingAccount 


{ 
private double balance; 
private int number; 
public CheckingAccount(int number) 
{ 
this.number = number; 
public void deposit(double amount) 
{ 
balance += amount; 
public void withdraw(double amount) throws 
InsufficientFundsException 
{ 
if (amount <= balance) 
{ 
balance -= amount; 
} 
else 
double needs = amount - balance; 
throw new InsufficientFundsException(needs); 
} 
public double getBalance() 
{ 
return balance; 
public int getNumber() 
{ 
return number; 
} 
} 


下 面 的 BankDemo 程 序 示范 了 如 何 调用 CheckingAccount 类 的 deposit() 和 
withdraw() 方 法 。 


// 文 件 名 称 BankDemo. java 
public class BankDemo 


{ 
public static void main(String [] args) 
{ 
CheckingAccount c = new CheckingAccount(101); 
System.out.println("Depositing $500..."); 
c.deposit(500.00); 
try 
{ 
System.out.println("\nwithdrawing $100..."); 
c.withdraw(100.00); 
System.out.println("\nwithdrawing $600..."); 
c.withdraw(600.00); 
}catch(InsufficientFundsException e) 
{ 
System.out.println("Sorry, but you are short $" 
+ e.getAmount()); 
e.printStackTrace(); 
} 
} 
} 


编译 上 面 三 个 文件 ， 并 运行 程序 BankDemo， 得 到 结果 如 下 所 示 : 


Depositing $500... 
Withdrawing $100... 


Withdrawing $600... 
Sorry, but you are short $200.0 
InsufficientFundsException 


at CheckingAccount.withdraw(CheckingAccount.java:25) 
at BankDemo.main(BankDemo. java:13) 


BHR 
在 Java 中 定义 了 两 种 类 型 的 异常 和 错误 。 


e JVM(Java** Rz bL) ses : * 由 JVM 抛 出 的 异常 或 错误 。 例 如 : 
NullPointerException š, ArraylndexOutOfBoundsException # , 
ClassCastException 3: , 


e 程序 级 异常 : 由 程序 或 者 API 程 序 抛 出 的 异常 。 例 如 legalArgumentException 
à, IllegalStateException 3X: , 


Java 面向 对 象 


Java 继承 
继承 是 java 面 向 对 象 编程 技术 的 一 块 基石 ， 因为 它 人 允许 创建 分 等 级 层次 的 类 。 继 承 
可 以 理解 为 一 个 对 象 从 另 一 个 对 象 获 取 属 性 的 过 程 。 
如 果 类 人 A 是 类 B 的 父 类 ， 而 类 B 是 类 C 的 父 类 ， 我 们 也 称 C 是 A 的 子 类 ， 类 C 是 从 类 A 
继承 而 来 的 。 在 Java 中 ， 类 的 继承 是 单一 继承 ， 也 就 是 说 ， 一 个 子 类 只 能 拥有 一 个 
继承 中 最 常 使 用 的 两 个 关键 字 是 extends 和 implements。 
这 两 个 关键 字 的 使 用 决定 了 一 个 对 象 和 另 一 个 对 象 是 否 是 IS-A( 是 一 个 ) 关 系 。 

过 使 用 这 两 个 关键 字 ， 我 们 能 实现 一 个 对 象 获取 另 一 个 对 象 的 属性 。 


所 有 Java 的 类 均 是 由 java.lang.Object 类 继承 而 来 的 ， 所 以 Object 是 所 有 类 的 祖先 
类 ， 而 除了 Object 外 ， 所 有 类 必须 有 一 个 父 类 。 


通过 过 extends 关 键 字 可 以 申明 一 个 类 是 继承 另外 一 个 类 而 来 的 ， 一 般 形 式 如 下 : 
// A.java 
public class A { 
private int i; 
protected int j; 


public void func() { 


} 
} 


// B.java 
public class B extends A { 
j 


以 上 的 代码 片段 说 明 ，B 由 A 继 承 而 来 的 ，B 是 A 的 子 类 。 而 A 是 Object 的 子 类 ， 这 里 
可 以 不 显示 地 声明 。 

作为 子 类 ，B 的 实例 拥有 A 所 有 的 成 员 变 量 ， 但 对 于 private 的 成 员 变量 B 却 没有 访问 
权限 ， 这 保障 了 A 的 封装 性 。 


IS-AX 3% 


IS-A 就 是 说 :一 个 对 象 是 另 一 个 对 象 的 一 个 分 类 。 
下 面 是 使 用 关键 字 extends 实 现 继 承 。 


public class Animalf{ 


j 


public class Mammal extends Animalf{ 


} 


public class Reptile extends Animal{ 


j 


public class Dog extends Mammal{ 


j 


基于 上 面 的 例子 ， 以 下 说 法 是 正确 的 : 


Animal 类 是 Mammal 类 的 父 类 。 

Animal 类 是 Reptile 类 的 父 类 。 

Mammal 类 和 Reptile 类 是 Animal 类 的 子 类 。 

Dog 类 既是 Mammal 类 的 子 类 又 是 Animal 类 的 子 类 。 


分 析 以 上 示例 中 的 IS-A 关 系 ， 如 下 : 


e Mammal IS-A Animal 
e Reptile IS-A Animal 
e Dog IS-A Mammal 


因此 : Dog IS-A Animal 
通过 使 用 关键 字 extends， 子 类 可 以 继承 父 类 的 除 private 属 性 外 所 有 的 属性 。 
我 们 通过 使 用 instanceof 操作 符 ， 能 够 确定 Mammal IS-A Animal 


实例 


public class Dog extends Mammal{ 
public static void main(String args[]){ 
Animal a = new Animal(); 
Mammal m = new Mammal(); 
Dog d = new Dog(); 
System.out.println(m instanceof Animal); 


System.out.println(d instanceof Mammal); 
System.out.println(d instanceof Animal); 


以 上 实例 编译 运行 结果 如 下 : 


true 
true 
true 


介绍 完 extends 关 键 字 之 后 ， 我 们 再 来 看 下 implements 关 键 字 是 怎样 使 用 来 表示 


IS-A 关 系 。 
Implements 关 键 字 使 用 在 类 继承 接口 的 情况 下 ， 这 种 情况 不 能 使 用 关键 
字 extends。 


实例 


public interface Animal {} 


public class Mammal implements Animal{ 


} 


public class Dog extends Mammal{ 


} 


instanceof 关键 字 


可 以 使 用 instanceof 运算 符 来 检验 Mammal 和 dog 对 象 是 否 是 Animal 类 的 一 个 实 


例 。 


interface Animal{} 
class Mammal implements Animal{} 


public class Dog extends Mammal{ 
public static void main(String args[]){ 


Mammal m = new Mammal(); 
Dog d = new Dog(); 


System.out.println(m instanceof Animal); 


System.out.println(d instanceof Mammal); 
System.out.println(d instanceof Animal); 


以 上 实例 编译 运行 结果 如 下 : 


true 
true 
true 


HAS-A 关系 
HAS-A 代 表 类 和 它 的 成 员 之 间 的 从 属 关系 。 这 有 助 于 代码 的 重用 和 减少 代码 的 错 


例子 


public class Vehicle{} 

public class Speed{} 

public class Van extends Vehicle( 
private Speed sp; 

j 


Van 类 和 Speed 类 是 HAS-A 关 系 (Van 有 一 个 Speed)， 这 样 就 不 用 将 Speed 类 的 全 部 
代码 粘贴 到 Van 类 中 了 ， 并 且 Speed 类 也 可 以 重复 利用 于 多 个 应 用 程序 。 


在 面向 对 象 特性 中 ， 用 户 不 必 担 心 类 的 内 部 怎样 实现 。 


Van 类 将 实现 的 细节 对 用 户 隐 藏 起 来 ， 因 此 ， 用 户 只 需要 知道 怎样 调用 Van 类 来 完 
成 某 一 功能 ， 而 不 必 知 道 Van 类 是 自己 来 做 还 是 调用 其 他 类 来 做 这 些 工 作 。 


Java 只 支持 单 继 承 ， 也 就 是 说 ， 一 个 类 不 能 继承 多 个 类 。 
下 面 的 做 法 是 不 合法 的 : 


public class extends Animal, Mammal{} 


Java 只 支持 单 继承 〈 继 承 基 本 类 和 抽象 类 ) ， 但 是 我 们 可 以 用 接口 来 实现 (多 继承 
接口 来 实现 ) ,脚本 结构 如 : 


public class Apple extends Fruit implements Fruiti, Fruit2{} 


一 般 我 们 继承 基本 类 和 抽象 类 用 extends 关 键 字 ， 实 现 接 口 类 的 继承 用 implements 
关键 字 。 


Java =5(Override)5 = (Overload) 


= & (Override) 


重 写 是 子 类 对 父 类 的 允许 访问 的 方法 的 实现 过 程 进行 重新 编写 ! 返回 值 和 形 参 都 不 
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重 写 的 好 你 在 于 子 类 可 以 根据 需要 ， 定 义 特定 于 自己 的 行为 。 

也 就 是 说 子 类 能 够 根据 需要 实现 父 类 的 方法 。 

在 面向 对 象 原则 里 ， 重 写意 味 着 可 以 重 写 任 何 现 有 方法 。 实 例如 下 : 


class Animal{ 


public void move(){ 
System,out.println(" 动 物 可 以 移动 " ) ; 
} 


} 
class Dog extends Animal{ 


public void move(){ 
System.out .println(" 狗 可 以 跑 和 走 " ) ; 
} 


} 
public class TestDog{ 
public static void main(String args[]){ 
Animal a = new Animal(); // Animal 对 象 
Animal b = new Dog(); // Dog 对 象 
a.move();// 执行 Animal 类 的 方法 


b.move();//4kfr Dog 类 的 方法 


以 上 实例 编译 运行 结果 如 下 : 


动物 可 以 移动 
狗 可 以 跑 和 走 


在 上 面 的 例子 中 可 以 看 到 ， 尽 管 b 属 于 Animal 类 型 ， 但 是 它 运 行 的 是 Dog 类 的 move 


法 。 


这 是 由 于 在 编译 阶段 ， 只 是 检查 参数 的 引用 类 型 。 
然而 在 运行 时 ，Java 虚 拟 机 (JVM) 指 定 对 象 的 类 型 并 且 运 行 该 对 象 的 方法 。 


因此 在 上 面 的 例子 中 ， 之 所 以 能 编译 成 功 ， 是 因为 Animal 类 中 存在 move 方 法 ， 然 
而 运行 时 ， 运 行 的 是 特定 对 象 的 方法 。 


思考 以 下 例子 : 


class Animal( 


public void move(){ 
System.out.println(" 动 物 可 以 移动 " ) ; 
j 


j 
class Dog extends Animal{ 


public void move(){ 
System.out .println(" 狗 可 以 跑 和 走 " ) ; 


j 

public void bark(){ 
System.out.println( "Jay LARK AL") ; 

} 


} 
public class TestDog{ 
public static void main(String args[]){ 


Animal a = new Animal(); // Animal 对 象 
Animal b = new Dog(); // Dog 对 象 


a.move();// 执行 Animal 类 的 方法 
b.move();// 执 行 Dog 类 的 方法 
b.bark(); 


以 上 实例 编译 运行 结果 如 下 : 


TestDog.java:30: cannot find symbol 
symbol : method bark() 
location: class Animal 

b.bark(); 

^ 


该 程序 将 抛 出 一 个 编译 错误 ， 因 为 b 的 引用 类 型 Animal 没 有 bark 方 法 。 


方 写 重 守 的 规则 


参数 列表 必须 完全 与 被 重 写 方法 的 相同 ; 

返回 类 型 必须 完全 与 被 重 写 方法 的 返回 类 型 相同 ; 

e. 访问 权限 不 能 比 父 类 中 被 重 写 的 方法 的 访问 权限 更 高 。 例 如 : 如 果 父 类 的 一 个 

方法 被 声明 为 public， 那 么 在 子 类 中 重 写 该 方法 就 不 能 声明 为 protected。 

父 类 的 成 员 方 法 只 能 被 它 的 子 类 重 写 。 

声明 为 final 的 方法 不 能 被 重 写 。 

声明 为 static 的 方法 不 能 被 重 写 ， 但 是 能 够 被 再 次 声明 。 

如 果 一 个 方法 不 能 被 继承 ， 那 么 该 方法 不 能 被 重 写 。 

子 类 和 父 类 在 同一 个 包 中 ， 那 么 子 类 可 以 重 写 父 类 所 有 方法 ， 除 了 声明 为 

private 和 final 的 方法 。 

e 子 类 和 父 类 不 在 同一 个 包 中 ， 那 么 子 类 只 能 够 重 写 父 类 的 声明 为 public 和 
protected 的 非 final 方 法 。 

e 重 写 的 方法 能 够 抛 出 任何 非 强制 异常 ， 无 论 被 重 写 的 方法 是 否 抛 出 异常 。 但 
是 ， 重 写 的 方法 不 能 抛 出 新 的 强制 性 异常 ， 或 者 比 被 重 写 方 法 声明 的 更 广泛 的 

强制 性 有 异常， 反之 则 可 以 。 

构造 方法 不 能 被 重 写 。 

e 如 果 不 能 继承 一 个 方法 ， 则 不 能 重 写 这 个 方法 。 


Super 关 键 宇 的 使 用 
当 需 要 在 子 类 中 调用 父 类 的 被 重 写 方法 时 ， 要 使 用 super 关 键 字 。 


class Animal{ 


public void move(){ 
System.out.println("z HIDE zb); 
} 
} 


class Dog extends Animal{ 
public void move(){ 
super.move(); // 应 用 Super 类 的 方法 
System.out .println(" 狗 可 以 跑 和 走 " ) 


} 
} 


public class TestDog{ 
public static void main(String args[]){ 


Animal b = new Dog(); / 
b.move(); // 执 行 Dog 类 的 方法 


以 上 实例 编译 运行 结果 如 下 : 


动物 可 以 移动 
狗 可 以 跑 和 走 


= (Overload) 
= S (overloading) 是 在 一 个 类 里 面 ， 方 法 名 字 相 同 ， 而 参数 不 同 。 返 回 类 型 呢 ? 可 
以 相同 也 可 以 不 同 。 
每 个 重 载 的 方法 〈 或 者 构造 本 数 ) 都 必须 有 一 个 独一无二 的 参数 类 型 列表 。 
Res A MENA 
重 载 规则 

e 被 重 载 的 方法 必须 改变 参数 列表 ; 

e 被 重 载 的 方法 可 以 改变 返回 类 型 ; 

e 被 重 载 的 方法 可 以 改变 访问 修饰 符 ; 


e 被 重 载 的 方法 可 以 声明 新 的 或 更 广 的 检查 异常 ; 
。 方法 能 够 在 同一 个 类 中 或 者 在 一 个 子 类 中 被 重 载 。 


实例 


public class Overloading { 


public int test(){ 
System.out.printin("test1"); 
return 1; 


} 


public void test(int a){ 
System.out.println("test2"); 


} 


// 以 下 两 个 参数 类 型 顺序 不 同 

public String test(int a,String s){ 
System.out.println("test3"); 
return "returntest3"; 


j 


public String test(String s,int a){ 
System.out.println("test4"); 
return "returntest4"; 


j 


public static void main(String[] args){ 
Overloading o - new Overloading(); 
System.out.println(o.test()); 
o.test(1); 
System.out.println(o.test(1,"test3")); 
System.out.println(o.test("test4",1)); 


e 5 Ee BI S 


区 别 点 BRAK 重 写 方法 

参数 列表 必须 修改 一定 不 能 修改 

返回 类 型 ” 可 以 修改 ”一定 不 能 修改 

异常 可 以 修改 。 可 以 减少 或 删除 ， 一 定 不 能 抛 出 新 的 或 者 更 广 的 异常 
访问 可 以 修改 ”一定 不 能 做 更 严格 的 限制 (可 以 降低 限制 ) 


Java 多 太 


多 态 是 同一 个 行为 具有 多 个 不 同 表 现形 式 或 形态 的 能 力 。 

多 态 性 是 对 象 多 种 表现 形式 的 体现 。 

比如 我 们 说 "宠物 "这 个 对 象 ， 它 就 有 很 多 不 同 的 表达 或 实现 ， 比 如 有 小 猫 、 小 狗 、 
蜥 蝎 等 等 。 那 么 我 到 完 物 店 说 "请 给 我 一 只 完 物 "， 服 务 员 给 我 小 猫 、 小 狗 或 者 蜥 蝎 
都 可 以 ， 我 们 就 说 "宠物 "这 个 对 象 就 具备 多 态 性 。 

接 下 来 让 我 们 通过 实例 来 了 解 Java 的 多 态 。 


例子 


public interface Vegetarian{} 
public class Animal{} 
public class Deer extends Animal implements Vegetarian{} 


因为 Deer 类 具有 多 重 继承 ， 所 以 它 具 有 多 态 性 。 以 上 实例 解析 如 下 : 


一 个 Deer IS-A (是 一 个 ) Animal 
一 个 Deer IS-A (是 一 个 ) Vegetarian 
一 个 Deer IS-A (是 一 个 ) Deer 
一 个 Deer IS-A (是 一 个 ) Object 


在 Java 中 ， 所 有 的 对 象 都 具有 多 态 性 ， 因 为 任何 对 象 都 能 通过 IS-A 测 试 的 类 型 和 
Object 类 。 


访问 一 个 对 象 的 唯一 方法 就 是 通过 引用 型 变量 。 
引用 型 变量 只 能 有 一 种 类 型 ， 一 有 旦 被 声明 ， 引 用 型 变量 的 类 型 就 不 能 被 改变 了 。 


引用 型 变量 不 仅 能 够 被 重 置 为 其 他 对 象 ， 前 提 是 这 些 对 象 没有 被 声明 为 final。 还 可 
以 引用 和 它 类 型 相同 的 或 者 相 兼 容 的 对 象 。 它 可 以 声明 为 类 类 型 或 者 接口 类 型 。 


当 我 们 将 引用 型 变量 应 用 于 Deer 对 象 的 引用 时 ， 下 面 的 声明 是 合法 的 : 


Deer d = new Deer(); 
Animal a = d; 
Vegetarian v = d; 
Object o = d; 


所 有 的 引用 型 变量 d,a,v,o 都 指向 堆 中 相同 的 Deer 对 象 。 


虚 方法 


我 们 将 介绍 在 Java 中 ， 当 设计 类 时 ， 被 重 载 的 方法 的 行为 怎样 影响 多 态 
我 们 已 经 讨论 了 方法 的 重 载 ， 也 就 是 子 类 能 够 重 载 父 类 的 方法 。 


当 子 类 对 象 调 用 重 载 的 方法 时 ， 调 用 的 是 子 类 的 方法 ， 而 不 是 父 类 中 被 重 载 的 方 
法 。 


要 想 调 用 父 类 中 被 重 载 的 方法 ， 则 必须 使 用 关键 字 super。 


/* 文件 名 : Employee.java */ 
public class Employee 
{ 
private String name; 
private String address; 
private int number; 
public Employee(String name, String address, int number) 
{ 
System.out.println( "Constructing an Employee"); 
this.name = name; 
this.address = address; 
this.number = number; 


public void mailCheck() 
{ 


System.out.println("Mailing a check to " + this.name 
+ " " + this.address); 


} 
public String toString() 


{ 


} 
public String getName() 


D 


j 
public String getAddress() 


i 


return name + " " + address + " " + number; 


return name; 


return address; 


public void setAddress(String newAddress) 
{ 


j 
public int getNumber() 


D 


return number; 


j 


address - newAddress; 


假设 下 面 的 类 继承 Employee 类 : 


/* 文件 名 : Salary.java */ 
public class Salary extends Employee 


{ 
private double salary; //Annual salary 
public Salary(String name, String address, int number, double 
salary) 
{ 
super (name, address, number); 
setSalary(salary); 
public void mailCheck() 
1 
System.out.println("Within mailCheck of Salary class "); 
System.out.println("Mailing check to " + getName() 
+ " with salary " + salary); 
public double getSalary() 
{ 
return salary; 
public void setSalary(double newSalary) 
{ 
if(newSalary >= 0.0) 
{ 
salary = newSalary; 
} 
} 
public double computePay() 
{ 
System.out.println("Computing salary pay for " + getName()); 
return salary/52; 
} 
} 


二 © I 
现在 我 们 仔细 阅读 下 面 的 代码 ， 党 试 给 出 它 的 输出 结果 : 


/* 文件 名 : VirtualDemo.java */ 
public class VirtualDemo 


{ 
public static void main(String [] args) 
{ 
Salary s = new Salary("Mohd Mohtashim", "Ambehta, UP", 3, 36( 
Employee e = new Salary("John Adams", "Boston, MA", 2, 2400.( 
System.out.println("Call mailCheck using Salary reference --' 
s.mailCheck(); 
System.out.println("Nn Call mailCheck using Employee referenc 
e.mailCheck(); 
} 
} 





以 上 实例 编译 运行 结果 如 下 : 


Constructing an Employee 

Constructing an Employee 

Call mailCheck using Salary reference -- 

Within mailCheck of Salary class 

Mailing check to Mohd Mohtashim with salary 3600.0 


Call mailCheck using Employee reference- - 
Within mailCheck of Salary class 
Mailing check to John Adams with salary 2400.0 


例子 中 ， 我 们 实例 化 了 两 个 Salary 对 象 。 一 个 使 用 Salary 引 用 s， 另 一 个 使 用 
Employee 引 用 。 


编译 时 ， 编 译 器 检查 到 mailCheck() 方 法 在 Salary 类 中 的 声明 。 

在 调用 s.mailCheck() 时 ，Java 虚 拟 机 (JVM) 调 用 Salary 类 的 mailCheck() 方 法 。 
因为 e 是 Employee 的 引用 ， 所 以 调用 e 的 mailCheck() 方 法 则 有 完全 不 同 的 结果 。 
当 编 译 器 检查 e.mailCheck() 方 法 时 ， 编 译 器 检查 到 Employee 类 中 的 mailCheck() 方 


` 
N 
ILo 


在 编译 的 时 候 ， 编 译 器 使 用 Employee 类 中 的 mailCheck() 方 法 验证 该 语句 ， 但 是 在 
运行 的 时 候 ，Java 虚 拟 机 (JVM) 调 用 的 是 Salary 类 中 的 mailCheck() 方 法 。 


该 行为 被 称 为 虚拟 方法 调用 ， 该 方法 被 称 为 虚拟 方法 。 


Java 中 所 有 的 方法 都 能 以 这 种 方式 表现 ， 借 此 ， 重 写 的 方法 能 在 运行 时 调用 ， 不 管 
编译 的 时 候 源 代码 中 引用 变量 是 什么 数据 类 型 。 


Java 抽象 类 


在 面向 对 象 的 概念 中 ， 所 有 的 对 象 都 是 通过 类 来 描绘 的 ， 但 是 反 过 来 ， 并 不 是 所 有 
的 类 都 是 用 来 描绘 对 象 的 ， 如 果 一 个 类 中 没有 包含 足够 的 信息 来 描绘 一 个 具体 的 对 
象 ， 这 样 的 类 就 是 抽象 类 。 


抽象 类 除了 不 能 实例 化 对 象 之 外 ， 类 的 其 它 功能 依然 存在 ， 成 员 变 量 、 成 员 方 法 和 
构造 方法 的 访问 方式 和 普通 类 一 样 。 


由 于 抽象 类 不 能 实例 化 对 象 ， 所 以 抽象 类 必须 被 继承 ， 才 能 被 使 用 。 也 是 因为 这 个 
原因 ， 通 常 在 设计 阶段 决定 要 不 要 设计 抽象 类 。 


父 类 包含 了 子 类 集合 的 常见 的 方法 ， 但 是 由 于 父 类 本 身 是 抽象 的 ， 所 以 不 能 使 用 这 
些 方 法 。 


抽象 类 


在 Java 语 言 中 使 用 abstract class 来 定义 抽象 类 。 如 下 实例 : 


/* 文件 名 : Employee.java */ 
public abstract class Employee 
{ 
private String name; 
private String address; 
private int number; 
public Employee(String name, String address, int number) 
{ 
System.out.println( "Constructing an Employee"); 
this.name = name; 
this.address = address; 
this.number = number; 


} 
public double computePay() 
{ 


System.out.println("Inside Employee computePay"); 
return 0.0; 


public void mailCheck() 
{ 


System.out.println("Mailing a check to " + this.name 
+ " "+ this.address); 


} 
public String toString() 


i 


j 
public String getName() 


i 


j 
public String getAddress() 


i 


return name + " " + address + " " + number; 


return name; 


return address; 


public void setAddress(String newAddress) 


D 


j 
public int getNumber() 


i 


return number; 


} 


address = newAddress; 
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liZEmployeeXRRATARE, RE AERX, HECHAAITHKA A 
个 成 员 方 法 和 1 个 构造 方法 。 现在 如 果 你 尝试 如 下 的 例子 : 


è 
~H 


/* 文件 名 : AbstractDemo.java */ 
public class AbstractDemo 


{ 
public static void main(String [] args) 
/* 以 下 是 不 允许 的 ， 会 引发 错误 */ 
Employee e = new Employee("George W.", "Houston, TX", 43); 
System.out.printin("\n Call mailCheck using Employee referenc 
e.mailCheck(); 
j 
j 





当 你 尝试 编译 AbstractDemo 类 时 ， 会 产生 如 下 错误 : 


Employee.java:46: Employee is abstract; cannot be instantiated 
Employee e = new Employee("George W.", "Houston, TX", 43); 
^ 


1 error 


继承 抽象 类 


我 们 能 通过 一 般 的 方法 继承 Employee 类 : 


/* 文件 名 : Salary.java */ 
public class Salary extends Employee 


{ 
private double salary; //Annual salary 
public Salary(String name, String address, int number, double 
salary) 
{ 
super (name, address, number); 
setSalary(salary); 
public void mailCheck() 
1 
System.out.println("Within mailCheck of Salary class "); 
System.out.println("Mailing check to " + getName() 
+ " with salary " + salary); 
public double getSalary() 
{ 
return salary; 
public void setSalary(double newSalary) 
{ 
if(newSalary >= 0.0) 
{ 
salary = newSalary; 
} 
} 
public double computePay() 
{ 
System.out.println("Computing salary pay for " + getName()); 
return salary/52; 
} 
} 


二 il 


尽管 我 们 不 能 实例 化 一 个 Employee 类 的 对 象 ， 但 是 如 果 我 们 实例 化 一 个 Salary 类 对 
象 ， 该 对 象 将 从 Employee 类 继承 3 个 成 员 变 量 和 7 个 成 员 方法 。 


/* 文件 名 : AbstractDemo.java */ 
public class AbstractDemo 


{ 
public static void main(String [] args) 
{ 
Salary s = new Salary("Mohd Mohtashim", "Ambehta, UP", 3, 36( 
Employee e = new Salary("John Adams", "Boston, MA", 2, 2400.( 
System.out.println("Call mailCheck using Salary reference --' 
s.mailCheck(); 
System.out.println("Nn Call mailCheck using Employee referenc 
e.mailCheck(); 
} 
} 





Constructing an Employee 

Constructing an Employee 

Call mailCheck using Salary reference -- 

Within mailCheck of Salary class 

Mailing check to Mohd Mohtashim with salary 3600.0 


Call mailCheck using Employee reference- - 
Within mailCheck of Salary class 
Mailing check to John Adams with salary 2400. 


抽象 方法 
如 果 你 想 设计 这 样 一 个 类 ， 该 类 包含 一 个 特别 的 成 员 方法 ， 该 方法 的 具体 实现 由 它 
的 子 类 确定 ， 那 么 你 可 以 在 父 关 中 声明 该 方法 为 抽象 方法 。 


Abstract 关 键 字 同样 可 以 用 来 声明 抽象 方法 ， 抽 象 方法 只 包含 一 个 方法 名 ， 而 没有 
方法 体 。 


抽象 方法 没有 定义 ， 方 法 名 后 面 直接 跟 一 个 分 号 ， 而 不 是 花 括 号 。 


public abstract class Employee 


{ 


private String name; 
private String address; 
private int number; 


public abstract double computePay(); 


// 其 余 代码 


声明 抽象 方法 会 造成 以 下 两 个 结果 : 


e 如 果 一 个 类 包含 抽象 方法 ， 那 么 该 类 必须 是 抽象 类 。 

e 任何 子 类 必须 重 写 父 类 的 抽象 方法 ， 或 者 声明 自身 为 抽象 类 。 

继承 抽象 方法 的 子 类 必须 重 载 该 方法 。 否 则 ， 该 子 类 也 必须 声明 为 抽象 类 。 最 终 ， 
必须 有 子 类 实现 该 抽象 方法 ， 否 则 ， 从 最 初 的 父 类 到 最 终 的 子 类 都 不 能 用 来 实例 化 
对 象 。 


如 果 Salary 类 继承 了 Employee 类 ， 那 么 它 必须 实现 computePay() 方 法 : 


/* 文件 名 : Salary.java */ 
public class Salary extends Employee 


private double salary; // Annual salary 


public double computePay( ) 


1 
System.out.println("Computing salary pay for " + getName( )); 
return salary/52; 


j 


// 其 余 代码 
j 


二 | 


java 封装 

在 面向 对 象 程式 设计 方法 中 ， 封 装 (英语 : Encapsulation) =f, PSH RIER 
式 接 口 的 实 作 细节 部 份 包装 、 隐 藏 起 来 的 方法 。 

封装 可 以 被 认为 是 一 个 保护 屏障 ， 防 止 该 类 的 代码 和 数据 被 外 部 类 定义 的 代码 随机 
访问 。 

要 访问 该 类 的 代码 和 数据 ， 必 须 通 过 严格 的 接口 控制 。 


封装 最 主要 的 功能 在 于 我 们 能 修改 自己 的 实现 代码 ， 而 不 用 修改 那些 调用 我 们 代码 
的 程序 片段 。 


适当 的 封装 可 以 让 程式 码 更 容易 理解 与 维护 ， 也 加 强 了 程式 码 的 安全 性 。 


实例 
让 我 们 来 看 一 个 java 封 装 类 的 例子 : 
/* 文件 名 : EncapTest.java */ 
public class EncapTest{ 
private String name; 
private String idNum; 


private int age; 


public int getAge(){ 
return age; 
} 


public String getName(){ 
return name; 
j 


public String getIdNum(){ 
return idNum; 
j 


public void setAge( int newAge){ 
age - newAge; 


j 


public void setName(String newName) { 
name = newName; 


j 


public void setIdNum( String newId)( 
idNum - newId; 
} 
} 


以 上 实例 中 public 方 法 是 外 部 类 访问 该 类 成 员 变 量 的 人口 。 

通常 情况 下 ， 这 些 方法 被 称 为 getter 和 setter 方 法 。 

因此 ， 任 何 要 访问 类 中 私有 成 员 变 量 的 类 都 要 通过 这 些 getter 和 setter 方 法 。 
通过 如 下 的 例子 说 明 EncapTest 类 的 变量 怎样 被 访问 : 


/* F 文 件 名 : RunEncap.java */ 
public class RunEncap{ 


public static void main(String args[]){ 
EncapTest encap = new EncapTest(); 
encap.setName("James"); 
encap.setAge(20); 
encap.setIdNum("12343ms"); 


System.out.print("Name : " + encap.getName()+ 
" Age : "+ encap.getAge()); 


以 上 代码 编译 运行 结果 如 下 : 


Name : James Age : 20 


Java 接口 


接口 (RX: Interface) ， 在 JAVA 编程 语言 中 是 一 个 抽象 类 型 ， 是 抽象 方法 的 集 
合 ， 接 口 通常 以 interface 来 声明 。 一 个 类 通过 继承 接口 的 方式 ， 从 而 来 继承 接口 的 
抽象 方法 。 


接口 并 不 是 类 ， 编 写 接口 的 方式 和 类 很 相似 ， 但 是 它们 属于 不 同 的 概念 。 类 描述 对 
象 的 属性 和 方法 。 接 口 则 包含 类 要 实现 的 方法 。 


除非 实现 接口 的 类 是 抽象 类 ， 否 则 该 类 要 定义 接口 中 的 所 有 方法 。 


接口 无 法 被 实例 化 ， 但 是 可 以 被 实现 。 一 个 实现 接口 的 类 ， 必 须 实现 接口 内 所 描述 
的 所 有 方法 ， 否 则 就 必须 声明 为 抽象 类 。 另 外， 在 Java 中 ， 接 口 类 型 可 用 来 声明 一 
个 变量 ， 他 们 可 以 成 为 一 个 空 指针 ， 或 是 被 绑 定 在 一 个 以 此 接口 实现 的 对 象 。 


接口 与 类 相似 点 : 


。 一 个 接口 可 以 有 多 个 方法 。 

e 接口 文件 保存 在 .java 结 尾 的 文件 中 ， 文 件 名 使 用 接口 名 。 

e 接口 的 字 节 码 文件 保存 在 .class 结 尾 的 文件 中 。 

e 接口 相应 的 字 节 码 文件 必须 在 与 包 名 称 相 匹配 的 目录 结构 中 。 


接口 与 类 的 区 别 : 


e 接口 不 能 用 于 实例 化 对 象 。 

e 接口 没有 构造 方法 。 

e 接口 中 所 有 的 方法 必须 是 抽象 方法 。 

e 接口 不 能 包含 成 员 变 量 ， 除 了 static 和 final 变 量 。 
e 接口 不 是 被 类 继承 了 ， 而 是 要 被 类 实现 。 

e 接口 支持 多 重 继 承 。 


接口 的 声明 
接口 的 声明 语法 格式 如 下 : 


[可 见 度 ] interface 接口 名 称 [extends 其 他 的 类 名 ] { 
// 声明 变量 
// 抽象 方法 


Interface 关 键 字 用 来 声明 一 个 接口 。 下 面 是 接口 声明 的 一 个 简单 例子 。 


/* 文件 名 : NameOfInterface.java */ 

import java.lang.*; 

// 引 入 包 

public interface NameOfInterface 
// 任 何 类 型 final, static 字段 
// 抽 象 方法 

} 


接口 有 以 下 特性 : 


e 接口 是 隐 式 抽象 的 ， 当 声明 一 个 接口 的 时 候 ， 不 必 使 用 abstract 关 键 字 。 
e 接口 中 每 一 个 方法 也 是 隐 式 抽象 的 ， 声 明 时 同样 不 需要 abstract 关 键 子 。 
。 接口 中 的 方法 都 是 公有 的 。 


实例 
/* 文件 名 : Animal.java */ 
interface Animal { 
public void eat(); 


public void travel(); 


} 


接口 的 实现 


当 类 实现 接口 的 时 候 ， 类 要 实现 接口 中 所 有 的 方法 。 人 否则 ， 类 必须 声明 为 抽象 的 


类 使 用 implements 关 键 字 实现 接口 。 在 类 声明 中 ，Implements 关 键 字 放 在 class 声 
明 后 面 。 


实现 一 个 接口 的 语法 ， 可 以 使 用 这 个 公式 : 


. implements 接口 名 称 [， 其 他 接口 ， 其 他 接口 ...，...] ... 


实例 


/* 文件 名 : MammalInt.java */ 
public class Mammallnt implements Animal{ 


public void eat(){ 
System.out.println("Mammal eats"); 


public void travel()( 
System.out.println("Mammal travels"); 


public int noOfLegs(){ 
return 0; 


public static void main(String args[]){ 
MammalInt m = new MammalInt(); 
m.eat(); 
m.travel(); 


以 上 实例 编译 运行 结果 如 下 : 


Mammal eats 
Mammal travels 


重 写 接口 中 声明 的 方法 时 ， 需 要 注意 以 下 规则 : 


e 类 在 实现 接口 的 方法 时 ， 不 能 抛 出 强制 性 异常 ， 只 能 在 接口 中 ， 或 者 继承 接口 
的 抽象 类 中 抛 出 该 强制 性 异常 。 
e 类 在 重 写 方 法 时 要 保持 一 致 的 方法 名 ， 并 且 应 该 保持 相同 或 者 相 兼 容 的 返回 值 
类 型 。 
e 如 果实 现 接口 的 类 是 抽象 类 ， 那 么 就 没 必要 实现 该 接口 的 方法 。 
在 实现 接口 的 时 候 ， 也 要 注意 一 些 规则 : 
e 一 个 类 可 以 同时 实现 多 个 接口 。 


e 一 个 类 只 能 继承 一 个 类 ， 但 是 能 实现 多 个 接口 。 


e 一 个 接口 能 继承 另 一 个 接口 ， 这 和 类 之 间 的 继承 比较 相似 。 


接口 的 继承 


一 个 接口 能 继承 另 一 个 接口 ， 和 类 之 间 的 继承 方式 比较 相似 。 接 口 的 继承 使 用 
extends 关 键 字 ， 子 接口 继承 父 接口 的 方法 。 


下 面 的 Sports 接 口 被 Hockey 和 Football 接 口 继承 : 


// 文件 名 : Sports.java 
public interface Sports 


{ 
public void setHomeTeam(String name); 
public void setVisitingTeam(String name); 


j 


// 文件 名 : Football.java 
public interface Football extends Sports 


{ 
public void homeTeamScored(int points); 
public void visitingTeamScored(int points); 
public void endOfQuarter(int quarter); 

} 


// 文件 名 : Hockey.java 
public interface Hockey extends Sports 


{ 
public void homeGoalScored(); 
public void visitingGoalScored(); 
public void endOfPeriod(int period); 
public void overtimePeriod(int ot); 
} 


Hockey 接 口 自己 声明 了 四 个 方法 ， 从 Sports 接 口 继 承 了 两 个 方法 ， 这 样 ， 实 现 
Hockey 接 口 的 类 需要 实现 六 个 方法 。 


相似 的 ， 实 现 Football 接 口 的 类 需要 实现 五 个 方法 ， 其 中 两 个 来 自 于 Sports 接 口 。 
接口 的 多 重 继承 


在 Java 中 ， 类 的 多 重 继承 是 不 合法 ， 但 接口 允许 多 重 继承 ，。 


在 接口 的 多 重 继承 中 extends 关 键 字 只 需要 使 用 一 次 ， 在 其 后 跟着 继承 接口 。 如 下 
所 示 : 


public interface Hockey extends Sports, Event 


以 上 的 程序 片段 是 合法 定义 的 子 接 口 ， 与 类 不 同 的 是 ， 接 口 允许 多 重 继承 ， 而 
Sports 及 Event 可 能 定义 或 是 继承 相同 的 方法 


标记 接口 
最 常用 的 继承 接口 是 没有 包含 任何 方法 的 接口 。 


标识 接口 是 没有 任何 方法 和 属性 的 接口 . 它 仅 仅 表 明 它 的 类 属于 一 个 特定 的 类 型 , 供 
其 他 代码 来 测试 允许 做 一 些 事情 。 


标识 接口 作用 : 简单 形象 的 说 就 是 给 某 个 对 象 打 个 标 GETER) ， 使 对 象 拥有 某 个 
或 某 些 特权 。 


例如 : java.awt.event 包 中 的 MouseListener 接 口 继承 的 java.util.EventListener 接 口 
定义 如 下 : 


package java.util; 
public interface EventListener 


{} 


没有 任何 方法 的 接口 被 称 为 标记 接口 。 标 记 接 口 主要 用 于 以 下 两 种 目的 : 
。 建立 一 个 公共 的 父 接口 : 


正如 EventListener 接 口 ， 这 是 由 几 十 个 其 他 接口 扩展 的 Java API， 你 可 以 使 用 
一 个 标记 接口 来 建立 一 组 接口 的 父 接 口 。 例 如 : 当 一 个 接口 继承 了 
EventListener 接 口 ，Java 虚 拟 机 (JVM) 就 知道 该 接口 将 要 被 用 于 一 个 事件 的 代 
理 方 案 。 


。 向 一 个 类 添加 数据 类 型 : 


这 种 情况 是 标记 接口 最 初 的 目的 ， 实 现 标记 接口 的 类 不 需要 定义 任何 接口 方法 
(因为 标记 接口 根本 就 没有 方法 )， 但 是 该 类 通过 多 态 性 变 成 一 个 接口 类 型 。 


Java @ (package) 


为 了 更 好 地 组 织 类 ，Java 提 供 了 包机 制 ， 用 于 区 别 类 名 的 命名 空间 。 
包 的 作用 


e 1 把 功能 相似 或 相关 的 类 或 接口 组 织 在 同一 个 包 中 ， 方 便 类 的 查找 和 使 用 。 

e 2 如 同文 件 均一 样 ， 包 也 采用 了 树 形 目录 的 存储 方式 。 同 一 个 包 中 的 类 名 字 是 
不 同 的 ， 不 同 的 包 中 的 类 的 名 字 是 可 以 相同 的 ， 当 同时 调用 两 个 不 同 包 中 相同 
类 名 的 类 时 ， 应 该 加 上 包 名 加 以 区 别 。 因 此 ， c Uu A 

e 3 包 也 限定 了 访问 权限 ， 拥 有 包 访 问 权 限 的 类 才能 访问 某 个 包 中 的 类 


Java 使 用 包 (package) 这 种 机 制 是 为 了 防止 命名 冲突 ， 访 问 控制 ， 提 供 搜索 和 定 
位 类 (class) 、 接 口 、 枚 举 (enumerations) 和 注释 (annotation) S, 


包 语 句 的 语法 格式 为 : 
package pkg1[. pkg2[. pkg3...]]; 


例如 ,一 个 Something.java MHF CHAR 


package net.java.util 
public class Something{ 


} 


那么 它 的 路 径 应 该 是 net/java/Something.java 这 样 保存 的 。 package( 包 ) 的 作用 是 
把 不 同 的 java 程 序 分 类 保存 ， 更 方便 的 被 其 他 java 程 序 调用 。 


一 个 包 (package) 可 以 定义 为 一 组 相互 联系 的 类 型 (类 、 接 口 、 枚 举 和 注释 ) , 
为 这 些 类 型 提供 访问 保护 和 命名 空间 管理 的 功能 。 


以 下 是 一 些 Java 中 的 包 : 


e java.lang- 打 包 基 础 的 类 
e java.io- 包 含 输入 输出 功能 的 函数 


开发 者 可 以 自己 把 一 组 类 和 接口 等 打包 ， 并 定义 自己 的 package。 而 且 在 实际 开发 
中 这 样 做 是 值得 提 侧 的 ， 当 你 自己 完成 类 的 实现 之 后 ， 闻 相关 的 类 分 组 ， 可 以 让 其 
他 的 编程 者 更 容易 地 确定 哪些 类 、 接 口 、 枚 举 和 注释 等 是 相关 的 。 


由 于 package 创 建 了 新 的 命名 空间 (namespace) ， 所 以 不 会 跟 其 他 package 中 的 
任何 名 字 产 生命 名 冲突 。 使 用 包 这 种 机 制 ， 更 容易 实现 访问 控制 ， 并 且 让 定位 相关 
类 更 加 简单 。 


ea 


创建 package 的 时 候 ， 你 需要 为 这 个 package 取 一 个 合适 的 名 字 。 之 后 ， 如 果 其 他 
的 一 个 源 文件 包含 了 这 个 包 提 供 的 类 、 接 口 、 枚 举 或 者 注释 类 型 的 时 候 ， 都 必须 将 
这 个 package 的 声明 放 在 这 个 源 文件 的 开头 。 

包 声 明 应 该 在 源 文件 的 第 一 行 ， 每 个 源 文件 只 能 有 一 个 包 声 明 ， 这 个 文件 中 的 每 个 
类 型 都 应 用 于 它 。 

如 果 一 个 源 文件 中 没有 使 用 包 声 明 ， 那 么 其 中 的 类 ， 男 数 ， 榴 举 ， 注 释 等 将 被 放 在 
一 个 无 名 的 包 (unnamed package) 中 。 


F 


让 我 们 来 看 一 个 例子 ， 这 个 例子 创建 了 一 个 叫做 animals 的 包 。 通 常 使 用 小 写 的 字 
母 来 命名 避免 与 类 、 接 口 名 字 的 冲突 。 


在 animals 包 中 加 入 一 个 接口 (interface) 


/* 文件 名 : Animal.java */ 
package animals; 


interface Animal { 
public void eat(); 
public void travel(); 


j 


接 下 来 ， 在 同一 个 包 中 加 入 该 接口 的 实现 : 


package animals; 


/* 文件 名 : MammalInt.java */ 
public class MammalInt implements Animal{ 


public void eat(){ 


System.out.println("Mammal eats"); 
j 


public void travel(){ 
System.out.println("Mammal travels"); 


j 

public int noOfLegs(){ 
return 0; 

j 


public static void main(String args[]){ 
MammalInt m = new MammalInt(); 
m.eat(); 
m.travel(); 


$ mkdir animals 

$ cp Animal.class MammalInt.class animals 
$ java animals/MammalInt 

Mammal eats 

Mammal travel 


import £4 + 


为 了 能 够 使 用 某 一 个 包 的 成 员 ， 我 们 需要 在 Java 程序 中 明确 导入 该 包 。 使 
用 "import" 语 句 可 完成 此 功能 。 


在 java 源 文 件 中 import 语句 应 位 于 package 语句 之 后 ， 所 有 类 的 定义 之 前 ， 可 以 
没有 ， 也 可 以 有 多 条 ， 其 语法 格式 为 : 


import package1[.packagez2...].(classname|*); 


如 果 在 一 个 包 中 ， 一 个 类 想 要 使 用 本 包 中 的 另 一 个 类 ， 那 么 该 包 名 可 以 省 略 。 


例子 


下 面 的 payroll 包 已 经 包含 了 Employee 类 ， 接 下 来 向 payroll 包 中 添加 一 个 Boss 类 。 
Boss 类 引用 Employee 类 的 时 候 可 以 不 用 使 用 payroll 前 级 ，Boss 类 的 实例 如 下 。 


package payroll; 
public class Boss 
public void payEmployee(Employee e) 


e.mailCheck(); 


如 果 Boss 类 不 在 payroll 包 中 又 会 怎样 ?Boss 类 必须 使 用 下 面 几 种 方法 之 一 来 引用 其 
他 包 中 的 类 


使 用 类 全 名 摘 述 ， 例 如 : 


payroll.Employee 


用 import 关 键 字 引入 ， 使 用 通配符 *" 


import payroll.*; 


使 用 import 关 键 字 引入 Employee 类 


import payroll.Employee; 


ss at 
六 局 : 


类 文件 中 可 以 包含 任意 数量 的 import 声 明 。import 声 明 必 须 在 包 声 明之 后 ， 类 声明 
之 前 。 


package 的 目录 结构 


类 放 在 包 中 会 有 两 种 主要 的 结果 : 


e 包 名 成 为 类 名 的 一 部 分 ， 正 如 我 们 前 面 讨 论 的 一 样 。 
e 包 名 必须 和 与 相应 的 字 节 码 所 在 的 目录 结构 相 吻 合 。 


下 面 是 管理 你 自己 java 中 文件 的 一 种 简单 方式 : 


将 类 、 接 口 等 类 型 的 源码 放 在 一 个 文本 中 ， 这 个 文件 的 名 字 就 是 这 个 类 型 的 名 字 ， 
并 以 .java 作为 扩展 名 。 例 如 : 


// 文件 名 : Car.java 
package vehicle; 


public class Car { 
// 类 实现 
} 


接 下 来 ， 把 源 文件 放 在 一 个 目录 中 ， 这 个 目录 要 对 应 类 所 在 包 的 名 字 。 


....\wehicle\Car.java 


现在 ， 正 确 的 类 名 和 路 径 将 会 是 如 下 样子 : 
e 类 名 -> vehicle.Car 
e 路 径 名 -> vehicle\Carjava (in windows) 


通常 ， 一 个 公司 使 用 它 互 联网 域名 的 颠倒 形式 来 作为 它 的 包 名 .例如 : 互联 网 域名 是 
apple.com， 所 有 的 包 名 都 以 com.apple 开 头 。 包 名 中 的 每 一 个 部 分 对 应 一 个 子 目 
录 。 


例如 : 这 个 公司 有 一 个 com.apple.computers 的 包 ， 这 个 包 包 含 一 个 叫做 Delljava 的 
源 文件 ， 那 么 相应 的 ， 应 该 有 如 下 面 的 一 连 串 子 目 录 : 


....\com\apple\computers\Dell. java 


编译 的 时 候 ， 编 译 器 为 包 中 定义 的 每 个 类 、 接 口 等 类 型 各 创建 一 个 不 同 的 输出 文 
件 ， 输 出 文件 的 名 字 就 是 这 个 类 型 的 名 字 ， 并 加 上 .class 作 为 扩展 后 级 。 例如 : 


// 文件 名 : Dell.java 


package com.apple.computers; 
public class Dell{ 


class Ups{ 


} 


现在 ， 我 们 用 -d 选 项 来 编译 这 个 文件 ， 如 下 : 


$javac -d . Dell.java 


这 样 会 像 下 面 这 样 放置 编译 了 的 文件 : 


.NcomNappleNcomputersNDell.class.NcomNappleNcomputersNUps.class 


你 可 以 像 下 面 这 样 来 导入 所 有 \com\apple\computers\ FE LAK, HOS : 


import com.apple.computers.*; 


编译 之 后 的 .class 文 件 应 该 和 .java 源 文件 一 样 ， 它 们 放置 的 目录 应 该 跟 包 的 名 字 对 
应 起 来 。 但 是 ， 并 不 要 求 .class 文 件 的 路 径 跟 相应 的 .java 的 路 径 一 样 。 你 可 以 分 开 
来 安排 源码 和 类 的 目录 。 


<path-one>\sources\com\apple\computers\Dell.java 
<path-two>\classes\com\apple\computers\Dell.class 


这 样 ， 你 可 以 将 你 的 类 目录 分 享 给 其 他 的 编程 人 员 ， 而 不 用 透露 自己 的 源码 。 用 这 
人 (JVM) 可 以 找到 你 程序 中 使 
用 的 所 有 类 型 。 


类 目录 的 绝对 路 径 叫 做 class path。 设 置 在 系统 变量 CLASSPATH 中 。 编 译 器 和 java 
虚拟 机 通过 将 package 名 字 加 到 class path 后 来 构造 .class 文 件 的 路 径 。 


«path- two>\classes 是 class path，package 名 字 是 com.apple.computers, 而 编译 器 
和 JVM 会 在 <path-two>\classes\comvapple\compters 中 找 .class 文 件 。 


一 个 class path 可 能 会 包含 好 几 个 路 径 。 多 路 径 应 该 用 分 隅 符 分 开 。 默 认 情 况 下 ， 
编译 器 和 JVM 查 找 当 前 目录 。JAR 文 件 按 包含 Java 平 台 相关 的 类 ， 所 以 他 们 的 目录 
默认 放 在 了 class path 中 。 


设置 CLASSPATH 杀 统 交 旦 


用 下 面 的 命 合 显 示 当 前 的 CLASSPATH 交 量 : 


e Windows 平 台 (DOS 命令 行 下 ) -> C:\> set CLASSPATH 
e UNIX 平 台 (Bourne shell F) -> 96 echo $CLASSPATH 


删除 当前 CLASSPATH 变 量 内 容 : 


e Windows 平 台 (DOS 命令 行 下 ) -> C:\> set CLASSPATH= 
e UNIX 平台 (Bourne shell F) -> 96 unset CLASSPATH; export CLASSPATH 


i& a CLASSPATH & 8: 


e Windows 平 台 (DOS 4347 F) -> set 
CLASSPATH=C:\users\jack\java\classes 


e UNIX 平 台 (Bourne shell F) -> % CLASSPATH=/home/jack/java/classes; 
export CLASSPATH 


Java 高 级 教程 


Java 数据 结构 


Java 工 具 包 提供 了 强大 的 数据 结构 。 在 Java 中 的 数据 结构 主要 包括 以 下 几 种 接口 和 


3K 
大 。 


e。 枚 举 (Enumeration) 
e 位 集合 (BitSet) 

e 向 量 (Vector) 

e jx (Stack) 

e 字典 (Dictionary) 

e 18% (Hashtable) 
e [&lt (Properties) 


以 上 这 些 类 是 传统 遗留 的 ， 在 Java2 中 引入 了 一 种 新 的 框架 -集合 框架 (Collection)， 
我 们 后 面 再 讨论 。 


枚 举 (Enumeration) 


枚 举 (Enumeration) 接口 虽然 它 本 身 不 属于 数据 结构 ,但 它 在 其 他 数据 结构 的 范畴 
2: MU (The Enumeration) 接口 定义 了 一 种 从 数据 结构 中 取 回 连续 元 


例如 ， 枚 举 定义 了 一 个 叫 nextElement 的 方法 ， 该 方法 用 来 得 到 一 个 包含 多 元 素 的 
数据 结构 的 下 一 个 元 素 。 


关于 枚 举 接口 的 更 多 信息 ， 请 参见 枚 举 (Enumeration) 。 


位 集合 (BitSet) 


位 集合 类 实现 了 一 组 可 以 单独 设置 和 清除 的 位 或 标志 。 


该 类 在 处 理 一 组 布尔 值 的 时 候 非 常 有 用 ， 你 只 需要 给 每 个 值 赋值 一 "位 "， 然 后 对 位 
进行 适当 的 设置 或 清除 ， 就 可 以 对 布尔 值 进行 操作 了 。 


关于 该 类 的 更 多 信息 ， 请 参见 位 集合 (BitSet) 。 


向 量 (Vector) 


向 量 (Vector) 类 和 传统 数组 非常 相似 ， 但 是 Vector 的 大 小 能 根据 需要 动态 的 变 


和 数组 一 样 ，Vector 对 象 的 元 素 也 能 通过 索引 访问 。 


使 用 Vector 类 最 主要 的 好 处 就 是 在 创建 对 象 的 时 候 不 必 给 对 象 指 定 大 小 ， 它 的 大 小 
会 根据 需要 动态 的 变化 。 


关于 该 类 的 更 多 信息 ， 请 参见 向 量 (Vector) 


栈 (Stack) 


# (Stack) 实现 了 一 个 后 进 先 出 (LIFO) 的 数据 结构 。 


你 可 以 把 栈 理 解 为 对 象 的 垂直 分 布 的 栈 ， 当 你 添加 一 个 新 元 素 时 ， 就 将 新 元 素 放 在 
其 他 元 素 的 顶部 。 


oe 就 从 栈 顶 取 一 个 元 素 。 换 名 话说， 最 后 进 栈 的 元 素 最 先 
取出 。 


关于 该 类 的 更 多 信息 ， 请 参见 栈 (Stack) 。 


字典 (Dictionary) 


字典 (Dictionary) 类 是 一 个 抽象 类 ， 它 定义 了 键 映射 到 值 的 数据 结构 。 


当 你 想 要 通过 特定 的 键 而 不 是 整数 索引 来 访问 数据 的 时 候 ， 这 时 候 应 该 使 用 
Dictionary。 


由 于 Dictionary 类 是 抽象 类 ， 所 以 它 只 提供 了 键 映 射 到 值 的 数据 结构 ， 而 没有 提供 
特定 的 实现 。 


关于 该 类 的 更 多 信息 ， 请 参见 字典 〈 Dictionary) 。 


哈 希 表 (Hashtable) 


Hashtable 类 提供 了 一 种 在 用 户 定 义 键 结构 的 基础 上 来 组 织 数 据 的 手段 。 


例如 ， 在 地 址 列表 的 哈 希 表 中 ， 你 可 以 根据 邮政 编码 作为 键 来 存储 和 排序 数据 ， 而 
是 通过 人 的 名 字 。 


哈 希 表 键 的 具体 含义 完全 取决 于 哈 希 表 的 使 用 情景 和 它 包 含 的 数据 。 
关于 该 类 的 更 多 信息 ， 请 参见 哈 希 表 (HashTable) 。 


属性 (Properties) 
Properties 继承 于 Hashtable.Properties 类 表示 了 一 个 持久 的 属性 集 .属性 列表 中 每 
个 键 及 其 对 应 值 都 是 一 个 字符 串 。 


Properties 类 被 许多 Java 类 人 使用。 例如， 在 获取 环境 变量 时 它 就 作为 
System.getProperties() 方 法 的 返回 值 。 


关于 该 类 的 更 多 信息 ， 请 参见 属性 (Properties) 。 


Java Enumeration## O 


Enumeration 接 口中 定义 了 一 些 方法 ， 这 些 方法 可 以 枚 举 (一 次 获得 一 个 ) 对 
象 集合 中 的 元 素 。 


这 种 传统 接口 已 被 迭代 器 取代 ， 虽 然 Enumeration 还 未 被 遗弃 ， 但 在 现代 代码 中 已 
经 被 很 少 使 用 了 。 尽 管 如 此 ， 它 还 是 使 用 在 诸如 Vector 和 Properties 这 些 传统 类 所 定 
义 的 方法 中 ， 除 此 之 外 ， 还 用 在 一 些 API 类 ， 并 且 在 应 用 程序 中 也 广泛 被 使 用 。 下 
表 总 结 了 一 些 Enumeration 声 明 的 方法 : 


方法 描述 
VA PIS () ”测试 此 枚 举 是 否 包含 更 多 的 元 素 。 
Object 如 果 此 枚 举 对 象 至 少 还 有 一 个 可 提供 的 元 素 ， 则 返回 
nextElement( ) 此 枚 举 的 下 一 个 元 素 。 


实例 
以 下 实例 演示 了 Enumeration 的 使 用 : 


import java.util.Vector; 
import java.util.Enumeration; 


public class EnumerationTester { 


public static void main(String args[]) { 
Enumeration days; 
Vector dayNames = new Vector(); 
dayNames.add("Sunday"); 
dayNames.add("Monday"); 
dayNames .add("Tuesday"); 
dayNames.add("Wednesday"); 
dayNames.add("Thursday"); 
dayNames.add("Friday"); 
dayNames.add("Saturday"); 
days - dayNames.elements(); 
while (days.hasMoreElements())( 

System.out.println(days.nextElement()); 

i 


} 
} 


以 上 实例 编译 运行 结果 如 下 : 


Sunday 
Monday 
Tuesday 
Wednesday 
Thursday 
Friday 
Saturday 


Java Bitset X: 


—^rBitset 3: 6| E — PHIR 3: ZI BUB RR. BitSetr Zia Ai Aag 
加 。 这 和 位 向 量 (vector of bits) 比较 类 似 。 


这 是 一 个 传统 的 类 ， 但 它 在 Java 2 中 被 完全 重新 设计 。 
BitSet 定 义 了 两 个 构造 方法 。 
第 一 个 构造 方法 创建 一 个 默认 的 对 象 : 


BitSet() 


第 二 个 方法 允许 用 户 指定 初始 大 小 。 所 有 位 初始 化 为 0。 


BitSet(int size) 


BitSet 中 实现 了 Cloneable 接 口中 定义 的 方法 如 下 表 所 列 : 


方法 
void and(BitSet bitSet) 


void andNot(BitSet 
bitSet) 


int cardinality( ) 
void clear( ) 
void clear(int index) 


void clear(int 
startIndex, int 
endindex) 


Object clone( ) 


boolean equals(Object 
bitSet) 


void flip(int index) 


void flip(int startlndex, 
int endIndex) 


boolean get(int index) 


BitSet get(int 


对 此 目标 位 set 和 参数 位 set 执行 逻辑 与 操作 。 


清除 此 BitSet 中 所 有 的 位 ， 其 相应 的 位 在 指定 的 
BitSet 中 已 设置 。 


返回 此 BitSet 中 设置 为 true 的 位 数 。 
将 此 BitSet 中 的 所 有 位 设置 为 false。 
将 索引 指定 处 的 位 设置 为 false, 


将 指定 的 fromindex (包括 ) 到 指定 的 tolndex (不 
包括 ) 范围 内 的 位 设置 为 false。 


复制 此 BitSet， 生 成 一 个 与 之 相等 的 新 BitSet。 
将 此 对 象 与 指定 的 对 象 进行 比较 。 


将 指定 索引 处 的 位 设置 为 其 当前 值 的 补 码 。 


将 指定 的 fromindex (包括 ) 到 指定 的 tolndex (不 
包括 ) 范围 内 的 每 个 位 设置 为 其 当前 值 的 补 码 。 


返回 指定 索引 处 的 位 值 。 
返回 一 个 新 的 BitSet， 它 由 此 BitSet 中 从 


startlndex, int 
endindex) 


int hashCode( ) 


boolean 
intersects(BitSet 
bitSet) 


boolean isEmpty( ) 


int length( ) 
int nextClearBit(int 
startlndex) 


int nextSetBit(int 
startIndex) 


void or(BitSet bitSet) 
void set(int index) 


void set(int index, 
boolean v) 


void set(int startIndex, 


int endIndex) 


void set(int startIndex, 


int endindex, boolean 
v) 


int size( ) 
String toString( ) 
void xor(BitSet bitSet) 


实例 


fromlndex (包括 ) 到 tolndex (不 包括 ) 范围 内 的 位 
组 成 。 


返回 此 位 set 的 哈 希 码 值 。 


如 果 指 定 的 BitSet 中 有 设置 为 true 的 位 ， 并 且 在 此 
BitSet 中 也 将 其 设置 为 true， 则 返回 ture, 


如 果 此 BitSet 中 没有 包含 任何 设置 为 true 的 位 ， 则 
返回 ture. 


返回 此 BitSet 的 "逻辑 大 小 " : BitSet 中 最 高 设置 位 的 
索引 加 1。 


返回 第 一 个 设置 为 false 的 位 的 索引 ， 这 发 生 在 指定 
的 起 始 索引 或 之 后 的 索引 上 。 


返回 第 一 个 设置 为 true 的 位 的 索引 ， 这 发 生 在 指定 
的 起 始 索引 或 之 后 的 索引 上 。 


对 此 位 set 和 位 set 参数 执行 逻辑 或 操作 。 
将 指定 索引 处 的 位 设置 为 true。 
将 指定 索引 处 的 位 设置 为 指定 的 值 。 


将 指定 的 fromindex (包括 ) 到 指定 的 tolndex (不 
包括 ) 范围 内 的 位 设置 为 true。 


将 指定 的 fromindex (包括 ) 到 指定 的 tolndex (不 
包括 ) 范围 内 的 位 设置 为 指定 的 值 。 

返回 此 BitSet 表示 位 值 时 实际 使 用 空间 的 位 数 。 
返回 此 位 set 的 字符 串 表 示 形 式 。 

对 此 位 set 和 位 set 参数 执行 逻辑 异 或 操作 。 


下 面 的 程序 说 明 这 个 数据 结构 支持 的 几 个 方法 : 


import java.util.BitSet; 
public class BitSetDemo { 


public static void main(String args[]) { 
BitSet bits1 = new BitSet(16); 
BitSet bits2 = new BitSet(16); 


// set some bits 
for(int i-0; 1<16; i++) { 

if((i%2) == 0) bitsi.set(i); 

if((i%5) != 0) bits2.set(i); 
j 
System.out.println("Initial pattern in bitsi: "); 
System.out.println(bits1); 
System.out.printin("\nInitial pattern in bits2: "); 
System.out.println(bits2); 


// AND bits 

bits2.and(bits1); 
System.out.println("Nnbits2 AND bitsi: "); 
System.out.println(bits2); 


// OR bits 

bits2.or(bits1); 
System.out.println("Nnbits2 OR bitsi: "); 
System.out.println(bits2); 


// XOR bits 

bits2.xor(bits1); 
System.out.println("Nnbits2 XOR bits1: "); 
System.out.println(bits2); 


以 上 实例 编译 运行 结果 如 下 : 


Initial pattern in bits: 
[0:52 4-26: .6,. 10). a2, 14) 


Initial pattern in bits2: 
jdn eq A Or m Sr Oy iiy taraen 


bits2 AND bits1: 
Ae e apa TA 


bits2 OR bits1: 
{0, 2, 4, 0, 8, 10, 12, 14} 


bits2 XOR bitsi: 
1 


Java Vector # 


Vector 类 实现 了 一 个 动态 数组 。 和 ArrayList 和 相似 ， 但 是 两 者 是 不 同 的 : 


e Vector 是 同步 访问 的 。 
e Vector 包含 了 许多 传统 的 方法 ， 这 些 方法 不 属于 集合 框架 。 


Vector 主要 用 在 事先 不 知道 数组 的 大 小 ， 或 者 只 是 需要 一 个 可 以 改变 大 小 的 数组 的 
情况 。 

Vector 类 支持 4 种 构造 方法 。 

第 一 种 构造 方法 创建 一 个 默认 的 向 量 ， 默 认 大 小 为 10 : 


Vector() 
第 二 种 构造 方法 创建 指定 大 小 的 向 量 。 
Vector(int size) 


第 三 种 构造 方法 创建 指定 大 小 的 向 量 ， 并 且 增 量 用 incr 指 定 . 增 量 表示 向 量 每 次 增加 
的 元 素数 目 。 


Vector(int size,int incr) 


第 四 中 构造 方法 创建 一 个 包含 集合 c 元 素 的 向 量 : 


Vector(Collection c) 


除了 从 父 类 继承 的 方法 外 Vector 还 定义 了 以 下 方法 : 


方法 描述 
ya ade (ntinde 在 此 向 量 的 指定 位 置 插入 指定 的 元 素 。 


Object element) 
boolean add(Object o) ”将 指定 元 素 添加 到 此 向 量 的 末尾 。 
将 指定 Collection 中 的 所 有 元 素 添加 到 此 


SiGe 向 量 的 未 尾 ， 按 照 指定 collection 的 迭代 
ooleeven, 器 所 返回 的 顺序 添加 这 些 元 素 。 
boolean addAll(int 在 指定 位 置 将 指定 Collection 中 的 所 有 元 


index, Collection c) 素 插 入 到 此 向 量 中 。 


void 
addElement(Object 
obj) 

int capacity() 

void clear() 

Object clone() 


boolean 
contains(Object elem) 


boolean 
containsAll(Collection 
c) 


void copylnto(Object[] 
anArray) 


Object elementAt(int 
index) 


Enumeration 
elements() 


void 
ensureCapacity(int 
minCapacity) 

boolean equals(Object 
o) 

Object firstElement() 


Object get(int index) 
int hashCode() 


int indexOf(Object 
elem) 


int indexOf(Object 
elem, int index) 


void 
insertElementAt(Object 
obj, int index) 


boolean isEmpty() 


将 指定 的 组 件 添 加 到 此 向 量 的 末尾 ， 将 其 
大 小 增加 1。 

返回 此 向 量 的 当前 容量 。 

从 此 向 量 中 移 除 所 有 元 素 。 
返回 向 量 的 一 个 副本 。 

如 果 此 向 量 包 含 指定 的 元 素 ， 则 返回 


true。 


如 果 此 向 量 包 含 指定 Collection 中 的 所 有 
元 素 ， 则 返回 true. 


将 此 向 量 的 组 件 复制 到 指定 的 数组 中 。 
返回 指定 索引 处 的 组 件 。 


返回 此 向 量 的 组 件 的 枚 举 。 


比较 指定 对 象 与 此 向 量 的 相等 性 。 


返回 此 向 量 的 第 一 个 组 件 ( 位 于 索引 0) 
返回 向 量 中 指定 位 置 的 元 素 。 
返回 此 向 量 的 哈 希 码 值 。 


返回 此 向 量 中 第 一 次 出 现 的 指定 元 素 的 索 
引 ， 如 果 此 向 量 不 包含 该 元 素 ， 则 返回 
-1。 


返回 此 向 量 中 第 一 次 出 现 的 指定 元 素 的 索 
5|, M index 你 正 向 搜索 ， 如 果 未 找到 该 
JUR, 则 返回 -1。 


将 指定 对 象 作为 此 向 量 中 的 组 件 插入 到 指 
定 的 index A^, 


测试 此 向 量 是 否 不 包含 组 件 。 


Object lastElement() 


int lastlndexOf(Object 
elem) 


int lastlndexOf(Object 
elem, int index) 


Object remove(int 
index) 


boolean 
remove(Object o) 


boolean 
removeAll(Collection c) 


void 
removeAllElements() 


boolean 
removeElement(Object 
obj) 

void 
removeElementAt(int 
index) 


protected void 
removeRange(int 
fromindex, int tolndex) 


boolean 
retainAll(Collection c) 


Object set(int index, 
Object element) 

void 
setElementAt(Object 
obj, int index) 

void setSize(int 
newSize) 


int size() 


List subList(int 
fromindex, int tolndex) 


返回 此 向 量 的 最 后 一 个 组 件 。 


返回 此 向 量 中 最 后 一 次 出 现 的 指定 元 素 的 
索引 ; 如 果 此 向 量 不 包含 该 元 素 ， 则 返回 
<1。 

返回 此 向 量 中 最 后 一 次 出 现 的 指定 元 素 的 
51, M index 外道 向 搜索 ， 如 果 未 找到 
该 元 素 ， 则 退回 -1。 


移 除 此 向 量 中 指定 位 置 的 元 素 。 


移 除 此 向 量 中 指定 元 素 的 第 一 个 匹配 项 ， 
如 果 向 量 不 包含 该 元 素 ， 则 元 素 保持 不 
变 。 

从 此 向 量 中 移 除 包含 在 指定 Collection 中 
的 所 有 元 素 。 


从 此 向 量 中 移 除 全 部 组 件 ， 并 将 其 大 小 设 


从 此 向 量 中 移 除 变量 的 第 一 个 〈 索 引 最 小 
的 ) 匹配 项 。 


MIRI ERIR AIF. 


从 此 List 中 移 除 其 素 引 位 于 
fromlndex (包括 ) 与 tolndex (不 包括 ) 
之 间 的 所 有 元 素 。 


在 此 向 量 中 人 太保 留 包 含 在 指定 Collection 
中 的 元 素 。 


用 指定 的 元 素 蔡 欣 此 向 量 中 指定 位 置 外 的 
ILFRo 


将 此 向 量 指定 index 处 的 组 件 设 置 为 指定 
的 对 象 。 


设置 此 向 量 的 大 小 。 


返回 此 向 量 中 的 组 件数 。 


返回 此 List 的 部 分 视图 ， 元 素 范 围 为 从 
fromindex (包括 ) 到 tolndex (KA 
H) 。 


Object[] toArray() 


Object[] 
toArray(Object[] a) 


String toString() 


void trimToSize() 


实例 


返回 一 个 数组 ， 包 含 此 向 量 中 以 恰当 顺序 
存放 的 所 有 元 素 。 

返回 一 个 数组 ， 包 含 此 向 量 中 以 恰当 顺序 
存放 的 所 有 元 素 ; 返回 数组 的 运行 时 类 型 
为 指定 数组 的 类 型 。 

返回 此 向 量 的 字符 串 表 示 形 式 ， 其 中 包含 
每 个 元 素 的 String 表示 形式 。 


对 此 向 量 的 容量 进行 微调 ， 使 其 等 于 向 量 
的 当前 大 小 。 


下 面 的 程序 说 明 这 个 集合 所 支持 的 几 种 方法 : 


import java.util.*; 
public class VectorDemo { 


public static void main(String args[]) { 
// initial size is 3, increment is 2 
Vector v = new Vector(3, 2); 
System.out.println("Initial size: " + v.size()); 
System.out.println("Initial capacity: " + 
v.capacity()); 
v.addElement(new Integer(1)); 
v.addElement(new Integer(2)); 
v.addElement(new Integer(3)); 
v.addElement(new Integer(4)); 
System.out.println("Capacity after four additions: " + 

v.capacity()); 


v.addElement(new Double(5.45)); 
System.out.println("Current capacity: " + 
v.capacity()); 
v.addElement(new Double(6.08)); 
v.addElement(new Integer(7)); 
System.out.println("Current capacity: " + 
v.capacity()); 
v.addElement(new Float(9.4)); 
v.addElement(new Integer(10)); 
System.out.println("Current capacity: " + 
v.capacity()); 
v.addElement(new Integer(11)); 
v.addElement(new Integer(12)); 
System.out.println("First element: " + 
(Integer)v.firstElement()); 
System.out.println("Last element: " + 
(Integer)v.lastElement()); 
if(v.contains(new Integer(3))) 
System.out.println("Vector contains 3."); 
// enumerate the elements in the vector. 
Enumeration vEnum = v.elements(); 
System.out.println("NnElements in vector:"); 
while(vEnum.hasMoreElements()) 
System.out.print(vEnum.nextElement() + " "); 
System.out.println(); 


以 上 实例 编译 运行 结果 如 下 : 


Initial size: 0 

Initial capacity: 3 

Capacity after four additions: 5 
Current capacity: 5 

Current capacity: 7 

Current capacity: 9 

First element: 1 

Last element: 12 

Vector contains 3. 


Elements in vector: 
123 4 5.45 6.08 7 9.4 10 11 12 


Java Stack # 

栈 是 Vector 的 一 个 子 类 ， 它 实现 了 一 个 标准 的 后 进 先 出 的 栈 。 

堆栈 只 定义 了 默认 构造 本 数 ， 用 来 创建 一 个 空 栈 。 堆栈 除了 包括 由 Vector 定义 的 所 
有 方法 ， 也 定义 了 自己 的 一 些 方法 。 


Stack() 


除了 由 Vector 定义 的 所 有 方法 ， 自 己 也 定义 了 一 些 方法 : 


方法 描述 
boolean empty() 测试 堆栈 是 否 为 空 。 
Object peek( ) 查看 堆栈 顶部 的 对 象 ， 但 不 从 堆栈 中 移 除 它 。 
Object pop( ) d eee ae ene eee 
Object push(Object ; 
element) 30 75 EATER AGB. 
int search(Object ‘ ,出 的 们 NW a 
lement 返回 对 象 在 堆栈 中 的 位 置 ， 以 1 为 基数 。 
实例 
头 


下 面 的 程序 说 明 这 个 集合 所 支持 的 几 种 方法 


import java.util.*; 
public class StackDemo { 


static void showpush(Stack st, int a) { 
st.push(new Integer(a)); 
System.out.println("push(" + a+ ")"); 
System.out.println("stack: " + st); 


} 


static void showpop(Stack st) { 
System.out.print("pop -> "); 
Integer a = (Integer) st.pop(); 
System.out.printin(a); 
System.out.println("stack: " + st); 


} 


public static void main(String args[]) { 
Stack st = new Stack(); 
System.out.println("stack: " + st); 
showpush(st, 42); 
showpush(st, 66); 
showpush(st, 99); 
showpop(st); 
showpop(st); 
showpop(st); 
try { 
showpop(st); 
} catch (EmptyStackException e) { 
System.out.println("empty stack"); 
} 


以 上 实例 编译 运行 结果 如 下 : 


stack: [ ] 
push(42) 

stack: [42] 
push(66) 

stack: [42, 66] 
push(99) 

stack: [42, 66, 99] 
pop -> 99 

stack: [42, 66] 
pop -> 66 

stack: [42] 

pop -> 42 

stack: [ ] 

pop -> empty stack 
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Java Dictionary # 


Dictionary 类 是 一 个 抽象 类 ， 用 来 存储 键 / 值 对 ， 作 用 和 Map 类 相似 。 


给 出 键 和 值 ， 你 就 可 以 将 值 存 储 在 Dictionary 对 象 中 。 一 旦 该 值 被 存储 ， 就 可 以 通 
过 它 的 键 来 获取 它 。 所 以 和 Map 一 样 ， Dictionary 也 可 以 作为 一 个 键 / 值 对 列表 。 


Dictionary 定 义 的 抽象 方法 如 下 表 所 示 : 


方法 描述 
Enumeration elements( ) 返回 此 dictionary 中 值 的 枚 举 。 
Object get(Object key) 返回 此 dictionary 中 该 键 所 映射 到 的 值 。 
boolearn isEmptyl) 人 dictionary 是 否 不 存在 从 键 到 值 的 映 
Enumeration keys( ) 返回 此 dictionary 中 的 键 的 榴 举 。 
Object put(Object key, Object ”将 指定 key 映射 到 此 dictionary 中 指定 
value) value。 
Ob ect remove(Objectkey) a 中 移 除 key (及 其 相应 的 
int size( ) as dictionary PAA (不 同 键 ) 的 数 


Dictionary 类 已 经 过 时 了 。 在 实际 开发 中 ， 你 可 以 实现 Map 接 口 来 获取 键 / 值 的 存储 
功能 。 


Java Hashtable 接口 


Hashtable 是 原始 的 java.util 的 一 部 分 ， 是 一 个 Dictionary 具 体 的 实现 。 


然而 ，Java 2 重 构 的 Hashtable 实 现 了 Map 接 口 ， 因 此 ，Hashtable 现 在 集成 到 了 集 
合 框架 中 。 它 和 HashMap 类 很 相似 ， 但 是 它 支 持 同 步 。 


像 HashMap 一 样 ，Hashtable 在 哈 希 表 中 存储 键 / 值 对 。 当 使 用 一 个 哈 希 表 ， 要 指定 
用 作 键 的 对 象 ， 以 及 要 链接 到 该 键 的 值 。 


然后 ， 该 键 经 过 哈 希 义理 ， 所 得 到 的 散 列 码 被 用 作 存 储 在 该 表 中 值 的 索引 。 
Hashtable 定 义 了 四 个 构造 方法 。 第 一 个 是 默认 构造 方法 : 


Hashtable() 


98 — T MDS ES OE EA AMG a : 


Hashtable(int size) 


AS Sale a Kee, MEA) MAR, HAÑ fillRatiois ERTL, 
填充 比例 必须 介 于 0.0 和 1.0 之 间 ， 它 决定 了 哈 希 表 在 重新 调整 大 小 之 前 的 充满 程 


E: 


Hashtable(int size,float fillRatio) 


第 四 个 构造 方法 创建 了 一 个 以 M 中 元 素 为 初始 化 元 素 的 哈 希 表 。 
哈 希 表 的 容量 被 设置 为 M 的 两 倍 。 


Hashtable(Map m) 


Hashtable 中 除了 从 Map 接 口中 定义 的 方法 外 ， 还 定义 了 以 下 方法 : 


方法 
void clear( ) 
Object clone( ) 


boolean 
contains(Object 
value) 


boolean 
containsKey(Object 
key) 


boolean 
containsValue(Object 
value) 


Enumeration 
elements( ) 


Object get(Object 
key) 


boolean isEmpty( ) 
Enumeration keys( ) 


Object put(Object 
key, Object value) 


void rehash( ) 


Object 
remove(Object key) 


int size( ) 


String toString( ) 


实例 
下 面 的 程序 说 明 


描述 
将 此 哈 希 表 清 空 ， 使 其 不 包含 任何 键 。 
创建 此 哈 希 表 的 浅 表 副本 。 


测试 此 映射 表 中 是 否 存在 与 指定 值 关联 的 键 。 


测试 指定 对 象 是 否 为 此 哈 希 表 中 的 键 。 


如 果 此 Hashtable 将 一 个 或 多 个 键 映射 到 此 值 ， 则 返 
回 true. 


回 此 哈 希 表 中 的 值 的 枚 举 。 


返回 指定 键 所 映射 到 的 值 ， 如 果 此 映射 不 包含 此 键 的 
映射 ， 则 返回 null. 更 确切 地 讲 ， 如 果 此 映射 包含 满 
Æ (key.equals(k)) 的 从 键 k 到 值 v 的 映射 ， 则 此 方 
法 返回 v ; GR, RE null, 


测试 此 哈 希 表 是 否 没有 键 映射 到 值 。 
返回 此 哈 希 表 中 的 键 的 枚 举 。 
将 指定 key 映射 到 此 哈 希 表 中 的 指定 value. 


增加 此 哈 希 表 的 容量 并 在 内 部 对 其 进 
有 效 地 容纳 和 访问 其 元 素 。 


行 重组 ， 以 便 更 


从 哈 希 表 中 移 除 该 键 及 其 相应 的 值 。 


返回 此 哈 希 表 中 的 键 的 数量 。 


返回 此 Hashtable 对 象 的 字符 串 表 示 形 式 ， 其 形式 为 
ASCII #4 "," (到 号 加 空格 ) 分 隔 开 的 、 插 在 括号 
中 的 一 组 条 目 。 


这 个 数据 结构 支持 的 几 个 方法 : 


import java.util.*; 
public class HashTableDemo { 


public static void main(String args[]) { 
// Create a hash map 
Hashtable balance = new Hashtable(); 
Enumeration names; 
String str; 
double bal; 


balance.put("Zara", new Double(3434.34)); 
balance.put("Mahnaz", new Double(123.22)); 
balance.put("Ayan", new Double(1378.00)); 
balance.put("Daisy", new Double(99.22)); 

balance.put("Qadir", new Double(-19.08)); 


// Show all balances in hash table. 
names = balance.keys(); 
while(names.hasMoreElements()) { 
str = (String) names.nextElement(); 
System.out.println(str +": " + 
balance.get(str)); 
} 
System.out.println(); 
// Deposit 1,000 into Zara's account 
bal = ((Double)balance.get("Zara")).doubleValue(); 
balance.put("Zara", new Double(bal+1000) ); 
System.out.println("Zara's new balance: " + 
balance.get("Zara")); 


以 上 实例 编译 运行 结果 如 下 : 


Qadir: -19.08 
Zara: 3434.34 
Mahnaz: 123.22 
Daisy: 99.22 
Ayan: 1378.0 


Zara's new balance: 4434.34 


Java Properties 接口 


Properties 继承 于 Hashtable. 表 示 一 个 持久 的 属性 集 . 属 性 列表 中 每 个 键 及 其 对 应 值 
都 是 一 个 字符 串 。 


Properties 类 被 许多 Java 类 人 使用。 例如， 在 获取 环境 变量 时 它 就 作为 
System.getProperties() 方 法 的 返回 值 。 


Properties 定义 如 下 实例 变量 .这 个 变量 持 有 一 个 Properties 对 象 相关 的 默认 属性 列 


o 


Properties defaults; 


Properties 3: XE 3L T AS MISA. 第 一 个 构造 方法 没有 默认 值 。 


Properties() 


第 二 个 构造 方法 使 用 propDefault 作为 默认 值 。 两 种 情况 下 ， 属 性 列表 都 为 空 : 


Properties(Properties propDefault ) 


除了 从 Hashtable 中 所 定义 的 方法 ，Properties 定 义 了 以 下 方法 : 


方法 


String 
getProperty(String 
key) 


String 
getProperty(String 
key, String 
defaultProperty) 


void list(PrintStream 
streamOut) 


void list(PrintWriter 
streamOut) 


void 
load(InputStream 
streamlin) throws 
IOException 


Enumeration 
propertyNames( ) 


Object 
setProperty(String 
key, String value) 


void 
store(OutputStream 


streamOut, String 
description) 


实例 


学 


描 


用 指定 的 键 在 此 属性 列表 中 搜索 属性 。 


用 指定 的 键 在 属性 列表 中 搜索 属性 。 


将 属性 列表 输出 到 指定 的 输出 流 。 


将 属性 列表 输出 到 指定 的 输出 流 。 


从 输入 流 中 读 取 属性 列表 〈 键 和 元 素 对 ) 。 


按 简单 的 面向 行 的 格式 从 输入 字符 流 中 读 取 属性 列表 
( 键 和 元 素 对 ) 。 


调用 Hashtable 的 方法 put。 


以 适合 使 用 load(lnputStream) 方 法 加 载 到 
Properties 表 中 的 格式 ， 将 此 Properties 表 中 的 属性 
列表 ( 键 和 元 素 对 ) 写 入 输出 流 。 


下 面 的 程序 说 明 这 个 数据 结构 支持 的 几 个 方法 : 


import java.util.*; 
public class PropDemo { 


public static void main(String args[]) { 
Properties capitals = new Properties(); 
Set states; 
String str; 


capitals.put("Illinois", "Springfield"); 
capitals.put("Missouri", "Jefferson City"); 
capitals.put("Washington", "Olympia"); 
capitals.put("California", "Sacramento"); 
capitals.put("Indiana", "Indianapolis"); 


// Show all states and capitals in hashtable. 
states - capitals.keySet(); // get set-view of keys 
Iterator itr - states.iterator(); 
while(itr.hasNext()) (1 

str - (String) itr.next(); 

System.out.println("The capital of " + 

str + " 1s " + capitals.getProperty(str) + "."); 

j 
System.out.println(); 


// look for state not in list -- specify default 
str - capitals.getProperty("Florida", "Not Found"); 
System.out.println("The capital of Florida is " 

+ str + MEE 


以 上 实例 编译 运行 结果 如 下 : 


The capital of Missouri is Jefferson City. 
The capital of Illinois is Springfield. 
The capital of Indiana is Indianapolis. 
The capital of California is Sacramento. 
The capital of Washington is Olympia. 


The capital of Florida is Not Found. 


Java 集合 框架 


早 在 Java 2 中 之 前 ，Java 就 提供 了 特 设 类 。 比 如 : Dictionary, Vector, Stack, 和 
Properties 这 些 类 用 来 存储 和 操作 对 象 组 。 


虽然 这 些 类 都 非常 有 用 ， 但 是 它们 缺少 一 个 核心 的 ， 统 一 的 主题 。 由 于 这 个 原因 ， 
使 用 Vector 类 的 方式 和 使 用 Properties 类 的 方式 有 着 很 大 不 同 。 


集合 框架 被 设计 成 要 满足 以 下 几 个 目标 。 
e 该 框架 必须 是 高 性 能 的 。 基 本 集合 (MABE, BR, Bd, AR) 的 实现 也 


必须 是 高 效 的 。 
该 框架 允许 不 同类 型 的 集合 ， 以 类 似 的 方式 工作 ， 具 有 高 度 的 互 操作 性 。 
e 对 一 个 集合 的 扩展 和 适应 必须 是 简单 的 。 


为 此 ， 整 个 集合 框架 就 围绕 一 组 标准 接口 而 设计 。 你 可 以 直接 使 用 这 些 接口 的 标准 
实现 ， 诸 如 : LinkedList, HashSet, 和 TreeSet 等 , 除 此 之 外 你 也 可 以 通过 这 些 接口 
实现 自己 的 集合 。 


集合 框架 是 一 个 用 来 代表 和 操纵 集合 的 统一 架构。 所 有 的 集合 框 染 都 包含 如 下 内 


谷 : 


e HO: 是 代表 集合 的 抽象 数据 类 型 。 接 口 允许 集合 独立 操纵 其 代表 的 细节 。 在 
面向 对 象 的 语言 ， 接 口 通常 形成 一 个 层次 。 

e 实现 (类 ) : 是 集合 接口 的 具体 实现 。 从 本 质 上 讲 ， 它 们 是 可 重复 使 用 的 数据 
结构 。 

e 算法 : 是 实现 集合 接口 的 对 象 里 的 方法 执行 的 一 些 有 用 的 计算 ， 例 如 : 搜索 和 
排序 。 这 些 算 法 被 称 为 多 态 ， 那 是 因为 相同 的 方法 可 以 在 相似 的 接口 上 有 着 不 
同 的 实现 。 


除了 集合 ， 该 框架 也 定义 了 几 个 Map 接 口 和 类 。Map 里 存储 的 是 键 / 值 对 。 尽 管 Map 
不 是 collections， 但 是 它们 完全 整合 在 集合 中 。 


集合 接口 


集合 框架 定义 了 一 些 接口 。 本 节 提 供 了 每 个 接口 的 概述 : 


接口 


描述 


Collection 接口 允许 你 使 用 一 组 对 象 ， 是 Collection 层 次 结构 的 根 接口 。 
List 接口 继承 于 Collection 和 一 个 List 实 例 存 储 一 个 有 序 集合 的 元 
Set 继承 于 Collection， 是 一 个 不 包含 重复 元 素 的 集合 。 
SortedSet 继承 于 Set 保 存 有 序 的 集合 
Map 将 唯一 的 键 映射 到 值 。 
MEDIEN, 描述 在 一 个 Map 中 的 一 个 元 素 (Gai) 。 是 一 个 Map 的 内 部 
SortedMap EELE ual tn 升序 排列 。 
Se S) i a E Ru T 
集合 类 
Java 提 供 了 一 套 实现 了 Collection 接 口 的 标准 集合 类 。 其 中 一 些 是 具体 类 ， 这 些 类 


可 以 直接 拿 来 使 用 ， 而 另外 一 些 是 抽象 类 ， 提 供 了 接口 的 部 分 实现 。 
标准 集合 类 汇总 于 下 表 : 


AbstractCollection 


AbstractList 


AbstractSequentialList 


LinkedList 
ArrayList 


AbstractSet 
HashSet 


LinkedHashSet 


TreeSet 


AbstractMap 
HashMap 
TreeMap 
WeakHashMap 


LinkedHashMap 


IdentityHashMap 


描述 
实现 了 大 部 分 的 集合 接口 。 


继承 于 AbstractCollection 并 且 实 现 了 大 部 分 List 接 
[5]5 


继承 于 AbstractList ， 提 供 了 对 数据 元 素 的 链 式 访 
问 而 不 是 随机 访问 。 


继承 于 AbstractSequentialList， 实 现 了 一 个 链表 。 
通过 继承 AbstractList， 实 现 动 态 数 组 。 


继承 于 AbstractCollection 并 且 实 现 了 大 部 分 Set 接 
[s]? 


继承 了 AbstractSet， 并 且 使 用 一 个 哈 希 表 。 


具有 可 预知 迭代 顺序 的 Set 接口 的 哈 希 表 和 链接 
列表 实现 。 


继承 于 AbstractSet， 使 用 元 素 的 自然 顺序 对 元 素 进 
行 排序 . 


实现 了 大 部 分 的 Map 接 口 。 
继承 了 HashMap， 并 且 使 用 一 个 哈 希 表 。 
继承 了 AbstractMap， 并 且 使 用 一 颗 树 。 
继承 AbstractMap 类 ， 使 用 弱 密 钥 的 哈 希 表 。 


继承 于 HashMap， 使 用 元 素 的 自然 顺序 对 元 素 进 行 
排序 . 


继承 AbstractMap 类 ， 上 比较 文档 时 使 用 引用 相等 。 


在 前 面 的 教程 中 已 经 讨论 通过 java.util 包 中 定义 的 类 ， 如 下 所 示 : 


类 描述 


Vedior Vector 类 实现 了 一 个 动态 数组 。 和 ArrayList 和 相似 ， 但 是 两 者 是 不 


同 的 。 
Stack 栈 是 Vector 的 一 个 子 类 ， 它 实现 了 一 个 标准 的 后 进 先 出 的 栈 。 
Dictionary p dy ces RDUM] 用 来 存储 键 / 值 对 ， 作 用 和 Map 类 相 
Hashtable D DS ein ie 是 一 个 Dictionary 具 体 的 实 
Properties Properties 继承 于 Hashtable. 表 示 一 个 持久 的 属性 集 . 属 性 列表 中 
每 个 键 及 其 对 应 值 都 是 一 个 字符 串 。 
BitSet 一 个 Bitset 类 创建 一 种 特殊 类 型 的 数组 来 保存 位 值 。BitSet 中 数组 


大 小 会 随 需 要 增加 。 


一 个 Bitset 关 创建 一 种 特殊 类 型 的 数组 来 保存 位 值 。BitSet 中 数组 大 小 会 随 需要 去 
加 。 


集合 算法 
集合 框架 定义 了 几 种 算法 ， 可 用 于 集合 和 了 映射。 这些 算法 被 定义 为 集合 类 的 静态 方 
法 。 


在 党 斌 比较 不 兼容 的 类 型 时 ， 一 些 方法 能 够 抛 出 ClassCastException 异 常 。 当 试图 
修改 一 个 不 可 修改 的 集合 时 ， 抛 出 UnsupportedOperationException 异 常 。 


合 定义 三 个 静态 的 变量 : EMPTY_SET EMPTY_LIST，EMPTY_MAP 的 。 这 些 
变量 都 不 可 改变 。 


算法 描述 
Collection Algorithms 这 里 是 一 个 列表 中 的 所 有 算法 实现 。 
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通常 情况 下 ， 你 会 希望 盐 历 一 个 集合 中 的 元 素 。 例 如 ， 显 示 集 合 中 的 每 个 元 素 。 


做 到 这 一 点 最 简单 的 方法 是 采用 一 个 迭代 器 ， 它 是 一 个 对 象 ， 实 现 了 lterator 接口 
或 Listlterator 接 口 。 


迭代 器 ， 使 你 能 够 通过 循环 来 得 到 或 删除 集合 的 元 素 。Listlterator 继 承 了 |lterator,， 
以 允许 双向 通 历 列表 和 修改 元 素 。 


这 里 通过 实例 列 出 lterator 和 listlterator 接 口 提供 的 所 有 方法 。 


迭代 器 方法 描述 
使 用 Java lterator 


如 何 使 用 比较 器 
TreeSet 和 TreeMap 的 按照 排序 顺序 来 存储 元 素 . 然而 ， 这 是 通过 比较 器 来 精确 定义 
按照 什么 祥 的 排序 顺序 。 
这 个 接口 可 以 让 我 们 以 不 同 的 方式 来 排序 一 个 集合 。 
比较 器 方法 描述 
使 用 Java Comparator 这 里 通过 实例 列 出 Comparator 接 口 提供 的 所 有 方法 
总 结 


A 
Java 集 合 框架 为 程序 员 提 供 了 预先 包装 的 数据 结构 和 算法 来 操纵 他 们 。 


集合 是 一 个 对 象 ， 可 容纳 其 他 对 象 的 引用 。 集 合 接口 声明 对 每 一 种 类 型 的 集合 可 以 
执行 的 操作 。 


集合 框架 的 类 和 接口 均 在 java.util 包 中 。 


Java 泛 型 


如 果 我 们 只 写 一 个 排序 方法 ， 就 能 够 对 整形 数组 、 字 符 串 数组 甚至 支持 排序 的 任何 
a a 这 该 多 好 啊 。 


Java 泛 型 方法 和 泛 型 类 支持 程序 员 使 用 一 个 方法 指定 一 组 相关 方法 ， 或 者 使 用 一 
类 指定 一 组 相关 的 类 型 。 


Java 泛 型 (generics) 是 JDK 5 中 引入 的 一 个 新 特性 , 泛 型 提供 了 编译 时 类 型 安全 检 
测 机 制 ， 该 机 制 允 许 程 序 员 在 编译 时 检测 到 非法 的 类 型 。 


使 用 Java 泛 型 的 概念 ， 我 们 可 以 写 一 个 泛 型 方法 来 对 一 个 对 象 数组 排序 。 然 后 ， 调 
用 该 泛 弄 方法 来 对 整 旭 数组 、 浮 点 数 数组 、 字符 串 数组 等 进行 排序 。 


泛 型 方法 


你 可 以 写 一 个 泛 型 方法 ， 该 方法 在 调用 时 可 以 接收 不 同类 型 的 参数 。 根 据 传递 给 泛 
型 方法 的 参数 类 型 ， 编 译 器 适当 地 处 理 每 一 个 方法 调用 。 


下 面 是 定义 泛 型 方法 的 规则 : 


e 所 有 泛 型 方法 声明 都 有 一 个 类 型 参数 声明 部 分 (由 尖 括 号 分 隔 ) ， 该 类 型 参数 
声明 部 分 在 方法 返回 类 型 之 前 (在 下 面 例子 中 的 <E>) 。 

e 每 一 个 类 型 参数 声明 部 分 包含 一 个 或 多 个 类 型 参数 ， 参数 间 用 去 号 隔 开 。 
泛 型 参数 ， 也 被 称 为 一 个 类 型 变量 ， eee ih 
uro 能 被 用 来 声明 返回 值 类 型 ， 并 且 能 作为 泛 型 方法 得 到 的 实际 参数 类 型 

rpm 
e 泛 型 方法 方法 体 的 声明 和 其 他 方法 一 样 。 注 意 类 型 参数 只 和 E 代 表 引 用 型 类 型 ， 
不 能 是 原始 类 型 ( 像 int,double,char 的 等 ) 。 


实例 
下 面 的 例子 演示 了 如 何 使 用 泛 型 方法 打印 不 同 字符 串 的 元 素 : 


public class GenericMethodTest 


// 泛 型 方法 printArray 
public static « E > void printArray( E[] inputArray ) 


j 


// 输出 数组 元 素 


for ( E element : inputArray ){ 
System.out.printf( "%s ", element ); 
} 


System.out.println(); 


public static void main( String args[] ) 


( 


// 创建 不 同类 型 数组 : Integer, Double 和 Character 
Integer[] intArray = { 1, 2, 3, 4, 5 }; 

Double[] doubleArray = { 1.1, 2.2, 3.3, 4.4 Y; 
Character[] charArray = { 'H', 'E', 'L', 'L', 'O' Y; 


System.out.println( "Array integerArray contains:" ); 
printArray( intArray ); // 传递 一 个 整 型 数组 


System.out.println( "\nArray doubleArray contains:" ); 
printArray( doubleArray ); // 传递 一 个 双 精 度 型 数组 


System.out.println( "\nArray characterArray contains:" ); 
printArray( charArray ); // 传递 一 个 字符 型 型 数组 


ES 全 
编译 以 上 代码 ， 运 行 结果 如 下 所 示 : 


integerArray contains: 
456 


doubleArray contains: 
.2 3.3 4.4 


characterArray contains: 
L O 


有 界 的 类 型 参数 : 


能 有 时 候 ， 你 会 想 限制 那些 被 允许 传递 到 一 个 类 型 参数 的 类 型 种 类 范围 。 例如 ， 
ir: ER SA ASKED AER SIE S Number Number? KHL, AMESA 
类 型 参数 的 自 的 - 


要 声明 一 个 有 界 的 类 型 参数 ， 首 先 列 出 类 型 参数 的 名 称 ， 后 跟 extends 关 键 字 ， 最 
后 紧 跟 它 的 上 界 。 


实例 


下 面 的 例子 演示 了 "extends" 如 何 使 用 在 一 般 意义 上 的 意思 "extends" (类 ) 或 
者 "implements" (接口 ) 。 该 例子 中 的 泛 型 方法 返回 三 个 可 比较 对 象 的 最 大 值 。 


public class MaximumTest 


{ 
// 比较 三 个 值 并 返回 最 大 值 
public static «T extends Comparable<T>> T maximum(T x, T y, T z. 


{ 
T max = x; // 假设 x 是 初始 最 大 值 
if ( y.compareTo( max ) > © ){ 
max = y; //y 更 大 


if ( z.compareTo( max ) > © ){ 
max = z; // 现在 z 更 大 
} 


return max; // 返回 最 大 对 象 
public static void main( String args[] ) 


{ 
System.out.printf( "Max of %d, %d and %d is %d\n\n", 


3, 4, 5, maximum( 3, 4, 5 ) ); 


System.out.printf( "Maxm of %.1f,%.1f and 96.1f is %.1f\n\n", 
6.6, 8.8, 7.7, maximum( 6.6, 8.8, 7.7 ) ); 


System.out.printf( "Max of %s, %S and %s is %s\n","pear", 
"apple", "orange", maximum( "pear", "apple", "orange" ) ), 


} 
Aoo | 
编译 以 上 代码 ， 运 行 结果 如 下 所 示 : 


Maximum of 3, 4 and 5 is 5 
Maximum of 6.6, 8.8 and 7.7 is 8.8 


Maximum of pear, apple and orange is pear 


泛 型 类 


泛 型 类 的 声明 和 非 泛 型 类 的 声明 类 似 ， 除 了 在 类 名 后 面 添加 了 类 型 参数 声明 部 分 。 


和 泛 型 方法 一 样 ， 泛 型 类 的 类 型 参数 声明 部 分 也 包含 一 个 或 多 个 类 型 参数 ， 参 数 间 
用 吉 号 隅 开 。 一 个 泛 型 参数 ， 也 被 称 为 一 个 类 型 变量 ， 是 用 于 指定 一 个 泛 型 类 型 名 
称 的 标识 符 。 因 为 他 们 接受 一 个 或 多 个 参数 ， 这 些 类 被 称 为 参数 化 的 类 或 参数 化 的 


x Bl, 


实例 
如 下 实例 演示 了 我 们 如 何 定义 一 个 泛 型 类 : 
public class Box<T> { 
private T t; 
public void add(T t) ( 


this.t = t; 
} 


public T get() { 
return t; 


} 


public static void main(String[] args) { 
Box<Integer> integerBox = new Box<Integer>(); 
Box<String> stringBox = new Box<String>(); 


integerBox.add(new Integer(10)); 
stringBox.add(new String("Hello World")); 


System.out.printf("Integer Value :%d\n\n", integerBox.get()); 
System.out.printf("String Value :%s\n", stringBox.get()); 


QT 
编译 以 上 代码 ， 运 行 结果 如 下 所 示 : 
Integer Value :10 


String Value :Hello World 


Java 序 列 化 


Java 提供 了 一 种 对 象 序列 化 的 机 制 ， 该 机 制 中 ， 一 个 对 象 可 以 被 表示 为 一 个 字 节 序 
列 ， 该 字 节 序列 包括 该 对 象 的 数据 、 有 关 对 象 的 类 型 的 信息 和 存储 在 对 象 中 数据 的 


x Bl, 


将 序列 化 对 象 写 和 人 文件 之 后 ， 可 以 从 文件 中 读 取 出 来 ， 并 且 对 它 进行 反 序 列 化 ， 也 
就 是 说 ， 对 和 象 的 类 型 信息 、 对 象 的 数据 ， 还 有 对 象 中 的 数据 类 型 可 以 用 来 在 内 存 中 
新 建 对 象 。 


整个 过 程 都 是 Java 虚 拟 机 (JVM) 独立 的 ， 也 就 是 说 ， 在 一 个 平台 上 序列 化 的 对 象 
可 以 在 另 一 个 完全 不 同 的 平台 上 反 序 列 化 该 对 象 。 


X ObjectInputStream 和 ObjectOutputStream 是 高 层次 的 数据 流 ， 它 们 包含 序列 化 
和 反 序 列 化 对 象 的 方法 。 


ObjectOutputStream 类 包含 很 多 写 方 法 来 写 各 种 数据 类 型 ， 但 是 一 个 特别 的 方法 例 
外 : 


public final void writeObject(Object x) throws IOException 


上 面 的 方法 序列 化 一 个 对 象 ， 并 将 它 发 送 到 输出 流 。 相 似 的 ObjectlnputStream 类 
包含 如 下 反 序 列 化 一 个 对 象 的 方法 : 


public final Object readObject() throws IOException, 
ClassNotFoundException 


该 方法 从 流 中 取出 下 一 个 对 象 ， 并 将 对 象 反 序列 化 。 它 的 返回 值 为 Object， 因 此 ， 
你 需要 将 它 转换 成 合适 的 数据 类 型 。 


为 了 演示 序列 化 在 Java 中 是 怎样 工作 的 ， 我 将 使 用 之 前 教程 中 提 到 的 Employee 
类 ， 假 设 我 们 定义 了 如 下 的 Employee 类 ， 该 类 实现 了 Serializable 接口 。 


public class Employee implements java.io.Serializable 


public String name; 
public String address; 
public transient int SSN; 
public int number; 

public void mailCheck() 


System.out.println("Mailing a check to " + name 
+ " "+ address); 


Hanes 须 是 可 序列 化 的 。 如 果 有 一 个 属性 不 是 可 序列 化 的 ， 则 该 属性 必 


如 果 你 想 知 道 一 个 Java 标 准 类 是 否 是 可 序列 化 的 ， 请 查看 该 类 的 文档 。 检 验 一 
的 实例 是 否 能 序列 化 十 分 简 答 ， 只 需要 查看 该 类 有 没有 实现 java.io.Serializable 接 
口 。 


序列 化 对 象 
ObjectOutputStream 类 用 来 序列 化 一 个 对 象 ， 如 下 的 SerializeDemo 例 子 实例 化 了 
一 个 Employee 对 象 ， 并 将 该 对 象 序列 化 到 一 个 文件 中 。 


该 程序 执行 后 ， 就 创建 了 一 个 名 为 employee.ser 文 件 。 该 程序 没有 任何 输出 ， 但 是 
你 可 以 通过 代码 研读 来 理解 程序 的 作用 。 


注意 : 当 序 列 化 一 个 对 象 到 文件 时 ， 按照 Java 的 标准 约定 是 给 文件 一 个 .ser 扩 展 


o 


I 


import java.io.* 
public class SerializeDemo 


public static void main(String [] args) 
{ 
Employee e = new Employee(); 
e.name = "Reyan Ali"; 
e.address = "Phokka Kuan, Ambehta Peer"; 
e.SSN = 11122333; 
e.number - 101; 
try 
{ 
FileOutputStream fileOut = 
new FileOutputStream("/tmp/employee.ser"); 
ObjectOutputStream out = new ObjectOutputStream(fileOut); 
out.writeObject(e); 
out.close(); 
fileOut.close(); 
System.out.printf("Serialized data is saved in /tmp/emplo 
jcatch(IOException i) 
{ 


i.printStackTrace(); 








反 序 列 化 对 象 


下 面 的 DeserializeDemo 程 序 反 序列 化 在 SerializeDemo 程 序 中 创建 Employee 对 
象 。 


import java.io.*; 
public class DeserializeDemo 


{ 
public static void main(String [] args) 
{ 

Employee e = null; 

try 

{ 
FileInputStream fileIn = new FileInputStream("/tmp/employ: 
ObjectInputStream in = new ObjectInputStream(fileIn); 
e = (Employee) in.readObject(); 
in.close(); 
fileIn.close(); 

}catch(IOException i) 

1 
i.printStackTrace(); 
return; 

}catch(ClassNotFoundException c) 

1 
System.out.println("Employee class not found"); 
c.printStackTrace(); 
return; 

} 

System.out.println("Deserialized Employee..."); 

System.out.println("Name: " + e.name); 

System.out.println("Address: " + e.address); 

System.out.println( "SSN: " + e.SSN); 

System.out.println("Number: " + e.number); 

} 
} 





以 上 程序 编译 运行 结果 如 下 所 示 : 


Deserialized Employee... 

Name: Reyan Ali 

Address:Phokka Kuan, Ambehta Peer 
SSN: 0 

Number:101 


这 里 要 注意 以 下 要 点 : 


readObject() 方法 中 的 try/catch 代 码 块 尝试 捕获 ClassNotFoundExceptions? 8$, xt 
于 JVM 可 以 反 序列 化 对 象 ， 它 必须 是 能 够 找到 字 节 码 的 类 。 如 果 JVM 在 反 序列 化 对 
象 的 过 程 中 找 不 到 该 类 ， 则 抛 出 一 个 ClassNotFoundException 异 常 。 


注意 ，readObject() 方 法 的 返回 值 被 转化 成 Employee 引 用 。 


当 对 象 被 序列 化 时 ， 属 性 SSN 的 值 为 111222333， 但 是 因为 该 属性 是 短暂 的 ， 该 值 
没有 被 发 送 到 输出 流 。 所 以 反 序 列 化 后 Employee 对 象 的 SSN 属 性 为 0。 


Java 网 络 编程 


s (计算 机 ) 的 程序 ， 这 些 设 备 都 通过 网 络 连接 起 


java.net 包 中 J2SE 的 API 包 含有 类 和 接口 ， 它 们 提供 低层 次 的 通信 细节 。 你 可 以 直 
接 使 用 这 些 类 和 接口 ， 来 专注 于 解决 问题 ， 而 不 用 关注 通信 细节 。 


java.net 包 中 提供 了 两 种 常见 的 网 络 协 议 的 支持 : 


e TCP: TCP 是 传输 控制 协议 的 缩写 ， 它 保障 了 两 个 应 用 程序 之 间 的 可 靠 通信 。 
通常 用 于 互联 网 协议 ， 被 称 TCP IP. 

e UDP:UDP 是 用 户 数据 报 协 议 的 缩写 ， 一 个 无 连接 的 协议 。 提 供 了 点 用 程序 之 
间 要 发 送 的 数据 的 数据 包 。 


本 教程 主要 讲解 以 下 两 个 主题 。 


。 Socket 编程 : 这 是 使 用 最 广泛 的 网 络 概念 ， 它 已 被 解释 地 非常 详细 
e URL 处 理 : 这 部 分 会 在 另外 的 篇 幅 里 讲 ， 点 击 这 里 更 详细 地 了 解 在 Java 语 言 中 
的 URL 人 处理。 


Socket 编程 


套 接 字 使 用 TCP 提 供 了 两 台 计 算 机 之 间 的 通信 机 制 。 客户 端 程序 创建 一 个 套 接 字 ， 
并 尝试 连接 服务 器 的 套 接 字 。 


当 连 接 建立 时 ， 服 务 器 会 创建 一 个 Socket 对 象 。 客 户 端 和 服务 器 现在 可 以 通过 对 
Socket 对 象 的 写 入 和 读 取 来 进行 进行 通信 。 


java.net.Socket 类 代表 一 个 套 接 字 ， 并 且 java.net.ServerSocket 类 为 服务 器 程序 提 
供 了 一 种 来 监听 客户 端 ， 并 与 他 们 建立 连接 的 机 制 。 


以 下 步骤 在 两 台 计 算 机 之 间 使 用 套 接 字 建 立 TCP 连 接 时 会 出 现 : 


e 服务 器 实例 化 一 个 ServerSocket 对 象 ， 表 示 通 过 服务 器 上 的 端口 通信 。 

e 服务 器 调用 ServerSocket 类 的 accept () 方法 ， 该 方法 将 一 直 等 待 ， 直 到 客 
户 端 连 接 到 服务 器 上 给 定 的 端口 。 

e 服务 器 正在 等 待 时 ， 一 个 客户 端 实例 化 一 个 Socket 对 象 ， 指 定 服务 器 名 称 和 端 
口号 来 请 求 连接 。 

e Socket 类 的 构造 本 数 试图 将 客户 端 连接 到 指定 的 服务 器 和 端口 号 。 如 果 通 信 被 
建立 ， 则 在 客户 端 创 建 一 个 Socket 对 象 能 够 与 服务 器 进行 通信 。 

e 在 服务 器 端 ，accept() 方 法 返回 服务 器 上 一 个 新 的 socket 引 用 ， 该 socket 连 接 到 
客户 端的 Socket。 


连接 建立 后 ， 通 过 使 用 /MO 流 在 进行 通信 。 每 一 个 socket 都 有 一 个 输出 流 和 一 个 输入 


流 。 客户 端的 输出 流连 接 到 服务 器 端的 输入 流 ， 而 客户 端的 输入 流连 接 到 服务 器 端 
的 输出 流 。 


TCP 是 一 个 双向 的 通信 协议 ， 因 此 数据 可 以 通过 两 个 数据 流 在 同一 时 间 发 送 .以 下 是 
一 些 类 提供 的 一 套 完整 的 有 用 的 方法 来 实现 sockets。 


ServerSocket 类 的 方法 


服务 器 应 用 程序 通过 使 用 java.net.ServerSocket 类 以 获取 一 个 端口 ,并 且 侦 听 客户 端 
请 求 。 


ServerSocket 类 有 四 个 构造 方法 : 


方法 描述 
public ServerSocket(int port) throws 创建 绑 定 到 特定 端口 的 服务 器 套 
IOException 接 字 。 

Er A 口 
public ServerSocket(int port, int th te na 
backlog) throws IOException ence Ae 

Wm L1. 
public ServerSocket(int port, int 使 用 指定 的 端口 、 侦 听 backlog 
backlog, InetAddress address) throws 和 要 绑 定 到 的 本 地 IP 地 址 创建 服 
IOException LETT 
public ServerSocket() throws 创建 非 绑 定 服务 器 套 接 字 。 


IOException 


创建 非 绑 定 服务 器 套 接 字 。 如 果 ServerSocket 构 造 方法 没有 抛 异常 ， 就 意味 着 你 
的 应 用 程序 已 经 成 功 绑 定 到 指定 的 端口 ， 并 且 侦 听 客 户 端 请 求 。 


这 里 有 一 些 ServerSocket 类 的 常用 方法 : 


方法 描述 
public int getLocalPort() 返回 此 套 接 字 在 其 上 侦 听 的 端口 。 
public Socket accept() throws E cun 
IOException 侦 听 并 接受 到 此 套 接 字 的 连接 。 
public void setSoTimeout(int 38:1 Fa ERAN A B/S 
timeout) SO_TIMEOUT， 以 毫秒 为 单位 。 
public void bind(SocketAddress X "i ServerSocket 绑 定 到 特定 地 址 (IP 
host, int backlog) 地 址 和 端口 号 ) 。 


Socket 类 的 方法 


java.net.Socket 类 代表 客户 端 和 服务 器 都 用 来 互相 沟通 的 套 接 字 。 客户 端 要 获取 一 
个 Socket 对 象 通过 实例 化 ， 而 服务 器 获得 一 个 Socket 对 象 则 通过 accept() 方 法 的 返 
回 值 。 


Socket 类 有 五 个 构造 方法 . 
方法 


public Socket(String host, int port) throws 
UnknownHostException, IOException. 


public Socket(InetAddress host, int port) 
throws IOException 


public Socket(String host, int port, 
InetAddress localAddress, int localPort) 
throws IOException. 


public Socket(InetAddress host, int port, 
InetAddress localAddress, int localPort) 
throws IOException. 


public Socket() 


描述 
创建 一 个 流 套 接 字 并 将 其 连 
接 到 指定 主机 上 的 指定 端口 
E 
创建 一 个 流 套 接 字 并 将 其 连 
接 到 指定 IP 地 址 的 指定 端 
L1 EP 
创建 一 个 套 接 字 并 将 其 连接 
到 指定 远程 主机 上 的 指定 远 
创建 一 个 套 接 字 并 将 其 连接 
到 指定 远程 地 址 上 的 指定 远 
通过 系统 默认 类 型 的 
Socketlmpl 创建 未 连接 套 
接 字 


当 Socket 构 造 方法 返回 ， 并 没有 简单 的 实例 化 了 一 个 Socket 对 象 ， 它 实际 上 会 尝试 


连接 到 指定 的 服务 器 和 端口 。 


下 面 列 出 了 一 些 感 兴趣 的 方法 ， 注 意 客户 端 和 服务 器 端 都 有 一 个 Socket 对 象 ， 所 以 


无 论 客户 端 还 是 服务 端 都 能 够 调用 这 些 方法 。 


方法 


public void connect(SocketAddress 
host, int timeout) throws IOException 


public InetAddress getlnetAddress() 


public int getPort() 


public int getLocalPort() 
public SocketAddress 
getRemoteSocketAddress() 


public InputStream getlnputStream() 
throws IOException 


public OutputStream getOutputStream() 
throws IOException 


public void close() throws lOException 


描述 


将 此 套 接 字 连 接 到 服务 器 ， 并 指 
定 一 个 超时 值 。 


返回 套 接 字 连接 的 地 址 。 
返回 此 套 接 字 连接 到 的 远程 端 
口 


o 


返回 此 套 接 字 绑 定 到 的 本 地 端 
[s]: 


返回 此 套 接 字 连接 的 端点 的 地 
址 ， 如 果 未 连接 则 返回 null, 


返回 此 套 接 字 的 输入 流 。 
返回 此 套 接 字 的 输出 流 。 
关闭 此 套 接 字 。 


InetAddress 类 的 方法 


这 个 类 表示 互联 网 协议 (IP) 地 址 。 下 面 列 出 了 Socket 编 程 时 比较 有 用 的 方法 : 


方法 描述 
static InetAddress 在 给 定 原始 IP 地 址 的 情况 下 ， 返 回 
getByAddress(byte[] addr) InetAddress 对 象 。 
static InetAddress > 

i 根据 提供 的 主机 名 和 IP 地 址 创建 

getByAddress(String host, byte[] ine acres 
addr) 
static InetAddress 在 给 定 主机 名 的 情况 下 确定 主机 的 
getByName(String host) IP 地 址 。 
String getHostAddress() zm IP 地 址 字符 囊 《以 文本 表现 形 
String getHostName() 获取 此 IP 地 址 的 主机 名 。 
static InetAddress getLocalHost() 返回 本 地 主机 。 
String toString() 将 此 IP 地 址 转换 为 String. 


Socket 客户 端 实例 


如 下 的 GreetingClient 是 一 个 客户 端 程序 ， 改 程序 通过 socket 连 接 到 服务 器 并 发 送 
一 个 问候 ， 然 后 等 待 一 个 响应 。 


// 文件 名 GreetingClient.java 
<pre> 

import java.net.*; 

import java.io.*; 


public class GreetingClient 


{ 
public static void main(String [] args) 
f 
String serverName = args[0]; 
int port = Integer.parseInt(args[1]); 
try 
{ 
System.out.println("Connecting to " + serverName 
+e on port + DORE) 
Socket client - new Socket(serverName, port); 
System.out.println("Just connected to " 
+ client.getRemoteSocketAddress()); 
OutputStream outToServer = client.getOutputStream(); 
DataOutputStream out = 
new DataOutputStream(outToServer ); 
out.writeUTF("Hello from " 
+ client.getLocalSocketAddress()); 
InputStream inFromServer = client.getInputStream(); 
DataInputStream in = 
new DataInputStream(inFromServer ) ; 
System.out.println("Server says " + in.readUTF()); 
client.close(); 
jcatch(IOException e) 
{ 
e.printStackTrace(); 
} 
} 
} 
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Socket 服务 器 实例 


如 下 的 GreetingServer 程序 是 一 个 服务 器 端 应 用 程序 ， 改 程序 使 用 Socket 来 监听 一 
个 指定 的 端口 。 


$ java GreetingServer 6066 
Waiting for client on port 6066... 


像 下 面 一 样 开 启 客 户 端 : 


$ java GreetingClient localhost 6066 

Connecting to localhost on port 6066 

Just connected to localhost/127.0.0.1:6066 

Server says Thank you for connecting to /127.0.0.1:6066 
Goodbye! 


Java 发 送 邮 件 

使 用 Java 应 用 程序 发 送 E-mail 十 分 简单 ， 但 是 首先 你 应 该 在 你 的 机 器 上 安装 
JavaMail API 和 Java Activation Framework (JAF) 。 

你 可 以 在 JavaMail (Version 1.2) 下 载 最 新 的 版 本 。 

你 可 以 再 在 JAF (Version 1.1.1) 下 载 最 新 的 版 本 。 


下 载 并 解压 这 些 文件 ， 最 上 层 文 件 夹 你 会 发 现 很 多 的 jar 文 件 。 你 需要 将 mail.jar 和 
activation.jar 添加 到 你 的 CLASSPATH 中 。 


ee i 可 查看 文章 底部 用 户 认 证 完整 
的 实例 。 


发 送 一 封 简 单 的 E-mail 
下 面 是 一 个 发 送 简单 E-mail 的 例子 。 假 设 你 的 localhost 已 经 连接 到 网 络 。 


// 文件 名 SendEmail.java 


import java.util.*; 

import javax.mail.*; 

import javax.mail.internet.*; 
import javax.activation.*; 


public class SendEmail 


public static void main(String [] args) 


{ 
// 收 件 人 电子 邮箱 
String to = "abcd@gmail.com"; 


// 发 件 人 电子 邮箱 
String from = "web@gmail.com"; 


// 指定 发 送 邮 件 的 主机 为 localhost 
String host = "localhost"; 


// 获取 系统 属性 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 session 对 象 
Session session = Session.getDefaultInstance(properties); 


try{ 
// 创建 默认 的 MimeMessage 对 象 
MimeMessage message = new MimeMessage(session 


// Set From: 头 部 头 字 段 
message.setFrom(new InternetAddress(from) ); 


// Set To: KAER 


m 


message.addRecipient(Message.RecipientType.TO, 


new InternetAddress( 


// Set Subject: 头 部 头 字 段 
message.setSubject("This is the Subject Line! 


// 设置 消息 体 
message.setText("This is actual message"); 


// 发 送 消息 
Transport.send(message); 


System.out.println("Sent message successfully... 


jcatch (MessagingException mex) { 
mex.printStackTrace(); 


} 
} 
} 


编译 并 运行 这 个 程序 来 发 送 一 封 简单 的 E-mail : 


$ java SendEmail 
Sent message successfully.... 


如 果 你 想 发 送 一 封 e-mail 给 多 个 收 件 人 ， 那 么 使 用 下 面 的 方法 来 指 
ID : 


void addRecipients(Message.RecipientType type, 
Address[] addresses) 
throws MessagingException 


下 面 是 对 于 参数 的 描述 


to)); 


")i 


ao 


定 多 个 收 件 人 


e type: 要 被 设置 为 TO, CC 或 者 BCC. 这 里 CC 代表 抄 送 、BCC 代表 秘密 抄 送 y 


举例 : Message.RecipientType.TO 


e addresses: 这 是 email ID 的 数组 。 在 指定 电子 邮件 ID 时 ， 你 将 需要 使 用 


InternetAddress() 方 法 。 


一 封 HTML E-mail 


下 面 是 一 个 发 送 HTML E-mail 的 例子 。 假 设 你 的 localhost 已 经 连接 到 网 络 。 


和 上 一 个 例子 很 相似 ， 除 了 我 们 要 使 用 setContent() 方 法 来 通过 第 二 个 参数 
为 "text/html"， 来 设置 内 容 来 指定 要 发 送 HTML 内 容 。 


// 文件 名 SendHTMLEmail.java 


Import 
Import 
Import 
Import 


public 


pub 
{ 


java.util.*; 
javax.mail.*; 
javax.mail.internet.*; 
javax.activation.*; 


class SendHTMLEmail 


lic static void main(String [] args) 


// 收 件 人 电子 邮箱 
String to = "abcd@gmail.com"; 


// 发 件 人 电子 邮箱 
String from = "web@gmail.com"; 


// 指定 发 送 邮 件 的 主机 为 localhost 
String host = "localhost"; 


// 获取 系统 属性 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session 对 象 。 
Session session = Session.getDefaultInstance(properties); 


try{ 
// 创建 默认 的 MimeMessage 对 象 。 
MimeMessage message = new MimeMessage(session); 


// Set From: 头 部 头 字 段 
message.setFrom(new InternetAddress(from)); 


// Set To: 头 部 头 字段 
message.addRecipient(Message.RecipientType.TO, 
new InternetAddress(to)); 


// Set Subject: X EE 
message.setSubject("This is the Subject Line!"); 


// RE HTML 消息 ， 可 以 插入 html 标 签 
message.setContent("<hi>This is actual messagec/h1»", 
"text/html" ); 


// 发 送 消息 
Transport.send(message); 
System.out.println("Sent message successfully...."); 
jcatch (MessagingException mex) { 
mex.printStackTrace(); 
j 


编译 并 运行 此 程序 来 发 送 HTML e-mail : 


$ java SendHTMLEmail 
Sent message successfully.... 


发 送 带 有 附件 的 E-mail 
下 面 是 一 个 发 送 带 有 附件 的 E-mail 的 例子 。 假 设 你 的 localhost 已 经 连接 到 网 络 。 


// 文件 名 SendFileEmail.java 


import java.util.*; 

import javax.mail.*; 

import javax.mail.internet.*; 
import javax.activation.*; 


public class SendFileEmail 


í 


public static void main(String [] args) 


{ 


// 收 件 人 电子 邮箱 
String to = "abcd@gmail.com"; 


// 发 件 人 电子 邮箱 
String from = "web@gmail.com"; 


// 指定 发 送 邮 件 的 主机 为 localhost 
String host = "localhost"; 


// 获取 系统 属性 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session 对 象 。 
Session session = Session.getDefaultInstance(properties); 


try{ 
// 创建 默认 的 MimeMessage 对 象 。 
MimeMessage message = new MimeMessage(session); 


// Set From: 头 部 头 字段 
message.setFrom(new InternetAddress(from) ) 


// Set To: 头 部 头 字段 
message.addRecipient (Message.RecipientType.TO, 
new InternetAddress(to)); 


// Set Subject: XE 
message.setSubject("This is the Subject Line!"); 


// 创建 消息 部 分 
BodyPart messageBodyPart = new MimeBodyPart(); 


// 消息 
messageBodyPart.setText("This is message body"); 


// 创建 多 重 消息 
Multipart multipart = new MimeMultipart(); 


// 设置 文本 消息 部 分 
multipart .addBodyPart(messageBodyPart); 


// 附件 部 分 

messageBodyPart = new MimeBodyPart(); 

String filename = "file.txt"; 

DataSource source = new FileDataSource(filename) ; 
messageBodyPart.setDataHandler(new DataHandler(source)); 
messageBodyPart.setFileName(filename); 
multipart.addBodyPart(messageBodyPart); 


// 发 送 完整 消息 
message.setContent(multipart ); 


// 发 送 消 息 
Transport.send(message); 
System.out.println("Sent message successfully...."); 
jcatch (MessagingException mex) { 
mex.printStackTrace(); 
} 


EE |) 
编译 并 运行 你 的 程序 来 发 送 一 封 带 有 附件 的 邮件 。 


$ java SendFileEmail 
Sent message successfully.... 


用 户 认 证 部 分 


如 果 需 要 提供 用 户 名 和 密码 给 e-mail 服务 器 来 达到 用 户 认证 的 目的 ， 你 可 以 通过 如 
下 设置 来 完成 : 


props.put("mail.smtp.auth", "true"); 
props.setProperty("mail.user", "myuser"); 
props.setProperty("mail.password", "mypwd"); 


e-mail 其 他 的 发 送 机 制 和 上 述 保持 一 致 。 


需要 用 户 名 密码 验证 邮件 发 送 实例 : 


本 实例 以 QQ 邮件 服务 器 为 例 ， 你 需要 在 登录 QQ 邮箱 后 台 在 "设置 "=》 账 号 中 开启 
POP3/SMTP 服 务 ， 如 下 图 所 示 : 


POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服 务 


开启 服务 : 4 ZZENHZGS Foxmail 等 软件 收发 邮件 ? 
7) IMAP/SMTP 服 务 (什么 是 IMAP， 它 如 是 如 何 设置 ? 
7) Exchange 服 务 (什么 是 Exchange， 它 又 是 如 何 设置 人 
4| CardDAV/CaIDAVARS ( 什 必 星 CardDAV/CalDAV， 它 双星 如 何 设置 ? 
如 何 设置 ? 


Java 代码 如 下 : 


// 需要 用 户 名 密码 邮件 发 送 实例 
// 文 件 名 SendEmail2.java 
// 本 实例 以 QQ 邮箱 为 例 ， 你 需要 在 qdq 后 台 设 置 


import java.util.Properties; 


import javax.mail.Authenticator; 

import javax.mail.Message; 

import javax.mail.MessagingException; 
import javax.mail.PasswordAuthentication; 
import javax.mail.Session; 

import javax.mail.Transport; 


import javax.mail.internet.InternetAddress; 
import javax.mail.internet .MimeMessage; 


public class SendEmail2 


{ 


public static void main(String [] args) 


i 


// 收 件 人 电子 邮箱 
String to = "xxx@qq.com"; 


// 发 件 人 电子 邮箱 
String from = "xxx@qq.com"; 


// 指定 发 送 邮件 的 主机 为 localhost 
String host = "smtp.qq.com"; //QQ 邮件 服务 器 


// 获取 系统 属性 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


properties.put("mail.smtp.auth", "true"); 

// 获取 默认 session 对 象 

Session session = Session.getDefaultInstance(properties, new / 
public PasswordAuthentication getPasswordAuthentication( ) 


i 


return new PasswordAuthentication("xxx@qq.com", "qq 邮箱 密码 
} 
) 


, 


j 


try{ 
// 创建 默认 的 MimeMessage 对 象 
MimeMessage message = new MimeMessage(session); 


// Set From: 头 部 头 字 段 
message.setFrom(new InternetAddress(from)); 


// Set To: 头 部 头 字段 
message.addRecipient(Message.RecipientType.TO, 
new InternetAddress(to)); 


// Set Subject: 头 部 头 字 段 
message.setSubject("This is the Subject Line!"); 


// 设置 消息 体 
message.setText("This is actual message"); 


// 发 送 消息 

Transport.send(message) ; 

System.out.println("Sent message successfully....from w3c: 
jcatch (MessagingException mex) { 

mex.printStackTrace(); 








Java 多 线程 编程 


Java 给 多 线程 编程 提供 了 内 置 的 支持 。 一 个 多 线程 程序 包含 两 个 或 多 个 能 并 发 运行 
的 部 分 。 程 序 的 每 一 部 分 都 称 作 一 个 线程 ， 并 且 每 个 线程 定义 了 一 个 独立 的 执行 路 
径 。 

多 线程 是 多 任务 的 一 种 特别 的 形式 。 多 线程 比 多 任务 需要 更 小 的 开销 。 

这 里 定义 和 线程 相关 的 另 一 个 术语 : 进程 : 一 个 进程 包括 由 操作 系统 分 配 的 内 存 空 
间 ， 包 含 一 个 或 多 个 线程 。 一 个 线程 不 能 独立 的 存在 ， 它 必须 是 进程 的 一 部 分 。 一 
个 进程 一 直 运 行 ， 直 到 所 有 的 非 守候 线程 都 结束 运行 后 才能 结束 。 


多 线程 能 满足 程序 员 编 写 非常 有 效率 的 程序 来 达到 充分 利用 CPU 的 目的 ， 因 为 CPU 
的 空闲 时 间 能 够 保持 在 最 低 限 度 。 


一 个 线程 的 生命 周 


线程 经 过 其 生命 周期 的 各 个 阶段 。 下 图 显示 了 一 个 线程 完整 的 生命 周期 。 


program starts 
thread 


runnable 


sleep 
interval 
expires 





waiting timed waiting terminated 


i 


新 状态 : 一 个 新 产生 的 线程 从 新 状态 开始 了 它 的 生命 周期 。 它 保持 这 个 状态 知 
道 程序 start 这 个 线程 。 

运行 状态 : 当 一 个 新 状态 的 线程 被 start 以 后 ， 线 程 就 变 成 可 运行 状态 ， 一 个 线程 
在 此 状态 下 被 认为 是 开始 执行 其 任务 

就 绪 状态 : 当 一 个 线程 等 待 另 外 一 个 线程 执行 一 个 任务 的 时 候 ， 该 线程 就 进入 就 
绪 状 态 。 当 另 一 个 线程 给 就 绪 状 态 的 线程 发 送信 号 时 ， 该 线程 机 重新 切换 到 运 
行 状 态 。 

休眠 状态 : 由 于 一 个 线程 的 时 间 片 用 完了 ， 该 线程 从 运行 状态 进入 休眠 状态 。 

当时 间 间 隔 到 期 或 者 等 待 的 时 间 发 生 了 ， 该 状态 的 线程 切换 到 运行 状态 。 


。 终 止 状态 : 一 个 运行 状态 的 线程 完成 任务 或 者 其 他 终止 条 件 发 生 ， 该 线程 就 切 
换 到 终止 状态。 


线程 的 优先 级 


每 一 个 Java 线 程 都 有 一 个 优先 级 ， 这 样 有 助 于 操作 系统 确定 线程 的 调度 顺序 。Java 
优先 级 在 MIN_PRIORITY (1) 和 MAX_PRIORITY (10) 之 间 的 范围 内 。 默 认 情况 
下 ， 每 一 个 线程 都 会 分 配 一 个 优先 级 NORM_PRIORITY (5) © 


具有 较 高 优先 级 的 线程 对 程序 更 重要 ， 并 且 应 该 在 低 优先 级 的 线程 之 前 分 配 处 理 器 
时 间 。 然 而 ， 线 程 优先 级 不 能 保证 线程 执行 的 顺序 ， 而 且 非 常 依赖 于 平台 。 
创建 一 个 线程 

Java 提 供 了 两 种 创建 线程 方法 : 


通过 实现 Runable 接 口 ; 
通过 继承 Thread 类 本 身 。 


通过 实现 Runnable 接 口 来 创建 线程 


创建 一 个 线程 ， 最 简单 的 方法 是 创建 一 个 实现 Runnable 接 口 的 类 。 
为 了 实现 Runnable， 一 个 类 只 需要 执行 一 个 方法 调用 run()， 声 明 如 下 : 


publicvoid run() 
你 可 以 重 写 该 方法 ， 重 要 的 是 理解 的 run() 可 以 调用 其 他 方法 ， 使 用 其 他 类 ， 并 声明 
变量 ， 就 像 主线 程 一 样 。 
在 创建 一 个 实现 Runnable 接 口 的 类 之 后 ， 你 可 以 在 类 中 实例 化 一 个 线程 对 象 。 
Thread 定 义 了 几 个 构造 方法 ， 下 面 的 这 个 是 我 们 经 常 使 用 的 : 


Thread(Runnable threadOb, String threadName) ; 


这 里 ，threadOb 是 一 个 实现 Runnable 接口 的 类 的 实例 ， 并 且 threadName 指 定 新 
线程 的 名 字 。 


新 线程 创建 之 后 ， 你 调用 它 的 start() 方 法 它 才 会 运行 。 


void start(); 


实例 


下 面 是 一 个 创建 线程 并 开始 让 它 执行 的 实例 : 


// 创建 一 个 新 的 线程 
class NewThread implements Runnable { 
Thread t; 
NewThread() { 
// 创建 第 二 个 新 线程 
t = new Thread(this, "Demo Thread"); 
System.out.println("Child thread: " + t); 
t.start(); // 开始 线程 
} 


// 第 二 个 线程 入 口 
public void run() { 
try { 
for(int i = 5; i > 0; i--) { 
System.out.println("Child Thread: " + i); 
// 暂停 线程 
Thread.sleep(50); 


j 
) catch (InterruptedException e) ( 
System.out.println("Child interrupted."); 
j 


System.out.println("Exiting child thread."); 


} 
} 


public class ThreadDemo { 
public static void main(String args[]) { 
new NewThread(); // 创建 一 个 新 线程 
try { 
TOT CD pes M c EIE 
System.out.println("Main Thread: " + i); 
Thread.sleep(100); 


j 
) catch (InterruptedException e) ( 
System.out.println("Main thread interrupted."); 
} 


System.out.println("Main thread exiting."); 


} 
} 


编译 以 上 程序 运行 结果 如 下 : 


Child thread: Thread[Demo Thread,5,main] 
Main Thread: 5 

Child Thread: 5 
Child Thread: 4 

Main Thread: 4 

Child Thread: 3 
Child Thread: 2 

Main Thread: 3 

Child Thread: 1 
Exiting child thread. 
Main Thread: 2 

Main Thread: 1 

Main thread exiting. 


通过 继承 Thread 来 创建 线程 


创建 一 个 线程 的 第 二 种 方法 是 创建 一 个 新 的 类 ， 该 类 继承 Thread 类 ， 然 后 创建 一 个 
该 类 的 实例 。 

继承 类 必须 重 写 run() 方 法 ， 该 方法 是 新 线程 的 入 口 点 。 它 也 必须 调用 start() 方 法 才 
能 执行 。 


实例 


// 通过 继承 Thread 创建 线程 
class NewThread extends Thread { 
NewThread() { 
// 创建 第 二 个 新 线程 
super("Demo Thread"); 
System.out.println("Child thread: " + this); 
start(); // 开始 线程 
} 


// 第 二 个 线程 入 口 
public void run() { 
try { 
Don d tb 1095 ic 
System.out.println("Child Thread: " + i); 
// 让 线程 休眠 一 会 
Thread.sleep(50); 


} 
} catch (InterruptedException e) { 
System.out.println("Child interrupted."); 
} 
System.out.println("Exiting child thread."); 
} 
} 


public class ExtendThread { 
public static void main(String args[]) { 
new NewThread(); // 创建 一 个 新 线程 
try { 
for(int i = 5; i > 0}; i--) 
System.out.println("Main Thread: " + i); 
Thread.sleep(100); 


j 
) catch (InterruptedException e) { 
System.out.println("Main thread interrupted."); 
} 


System.out.println("Main thread exiting."); 


} 
} 


编译 以 上 程序 运行 结果 如 下 : 


Child thread: Thread[Demo Thread,5,main] 
Main Thread: 5 

Child Thread: 5 
Child Thread: 4 

Main Thread: 4 

Child Thread: 3 
Child Thread: 2 

Main Thread: 3 

Child Thread: 1 
Exiting child thread. 
Main Thread: 2 

Main Thread: 1 

Main thread exiting. 


Thread 方法 
下 表 列 出 了 Thread 类 的 一 些 重要 方法 : 


方法 


public void start() 


public void run() 


public final void 
setName(String 
name) 


public final void 
setPriority(int 
priority) 


public final void 
setDaemon(boolean 
on) 


public final void 
join(long millisec) 


public void 
interrupt() 


public final boolean 
isAlive() 


测试 线程 是 否 处 于 活动 状态 。 


Thread 类 的 静态 方法 。 


描述 
虚拟 机 
调用 该 
使 该 线程 开始 执行 ; Java 线程 的 
run 75 
Ke 


如 果 该 线程 是 使 用 独立 的 Runnable 运行 
对 象 构造 的 则 调用 该 Runnable 对 象 的 
run 方法 ; 否则 ， 该 方法 不 执行 任何 操作 
并 返回 


改变 线程 名 称 ， 使 之 与 参数 name 相同 。 


更 改线 程 的 优先 级 。 


将 该 线程 标记 为 守 折线 程 或 用 户 线程 。 


等 待 该 线程 终止 的 时 间 最 长 为 millis = 
秒 。 


中 断 线程 。 
测试 线程 是 否 处 于 活动 状态 。 


上 述 方法 是 被 Thread 对 象 调用 的 。 下 面 的 方法 是 


方法 


public static void 
yield() 


public static void 
sleep(long 
millisec) 


public static 
boolean 
holdsLock(Object 
x) 


public static 
Thread 
currentThread() 


public static void 
dumpStack() 


实例 


fh 
暂停 当前 正在 执行 的 线程 对 象 ， 并 执行 其 他 线程 。 
在 指定 的 毫秒 数 内 让 当前 正在 执行 的 线程 休眠 (暂停 执 


行 ) ， 此 操作 受到 系统 计时 器 和 调度 程序 精度 和 准确 性 
的 影响 。 


当 且 信 当 当前 线程 在 指定 的 对 象 上 保持 监视 器 锁 时 ， 才 
返回 true。 


返回 对 当前 正在 执行 的 线程 对 象 的 引用 。 


将 当前 线程 的 堆栈 跟踪 打印 至 标准 错误 流 。 


如 下 的 ThreadClassDemo 程序 演示 了 Thread 类 的 一 些 方法 : 


// 文件 名 : 


DisplayMessage. java 


// 通过 实现 Runnable 接口 创建 线程 
public class DisplayMessage implements Runnable 


{ 


private String message; 
public DisplayMessage(String message) 


i 


this.message = message; 


public void run() 


while(true) 


System.out.println(message); 


} 
} 
} 


// 文件 名 : GuessANumber.java 
// 通过 继承 Thread 类 创建 线程 


public class GuessANumber extends Thread 
{ 

private int number; 

public GuessANumber (int number) 


{ 


this.number = number; 


public void run() 
{ 
int counter = 
int guess = 0; 
do 
{ 


0; 


guess = (int) (Math.random() * 100 + 1); 
System.out.println(this.getName() 
+ " guesses " + guess); 
counter++, 
}while(guess != number); 
System.out.println("** Correct! " + this.getName() 
+ " in " + counter + ”guesses,**")， 


// 文件 名 : ThreadClassDemo. java 
public class ThreadClassDemo 


{ 


public static void main(String [] args) 

{ 
Runnable hello = new DisplayMessage("Hello"); 
Thread threadi = new Thread(hello); 
thread1.setDaemon(true); 
thread1.setName("hello"); 
System.out.println("Starting hello thread..."); 
threadi.start(); 


Runnable bye - new DisplayMessage("Goodbye"); 
Thread thread2 - new Thread(hello); 
thread2.setPriority(Thread.MIN PRIORITY); 
thread2.setDaemon(true); 
System.out.println("Starting goodbye thread..."); 
thread2.start(); 


System.out.println("Starting thread3..."); 
Thread thread3 - new GuessANumber(27); 
thread3.start(); 

try 


thread3. join(); 
jcatch(InterruptedException e) 


( 


j 
System.out.println("Starting thread4..."); 


Thread thread4 - new GuessANumber(75); 


System.out.println("Thread interrupted."); 


thread4.start(); 
System.out.println("main() is ending..."); 


运行 结果 如 下 ， 每 一 次 运行 的 结果 都 不 一 样 。 


Starting hello thread... 
Starting goodbye thread... 
Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Thread-2 guesses 27 

Hello 

** Correct! Thread-2 in 102 guesses. ** 
Hello 

Starting thread4... 

Hello 


acd UE remaining result produced. 


线程 的 几 个 主要 概念 : 

在 多 线程 编程 时 ， 你 需要 了 解 以 下 几 个 概念 : 
线程 同步 

线程 间 通 信 

线程 死 锁 

线程 控制 : 挂 起 、 停 止 和 恢复 


多 线程 的 使 用 

有 效 利 用 多 线程 的 关键 是 理解 程序 是 并 发 执行 而 不 是 串 行 执行 的 。 例 如 : 程序 中 有 
两 个 子 系统 需要 并 发 执行 ， 这 时 候 就 需要 利用 多 线程 编程 。 

通过 对 多 线程 的 使 用 ， 可 以 编写 出 非常 高 效 的 程序 。 不 过 请 注意 ， 如 果 你 创建 太 多 
的 线程 ， 程 序 执行 的 效率 实际 上 是 降低 了 ， 而 不 是 提升 了 。 


请 记 住 ， 上 下 文 的 切换 开销 也 很 重要 ， 如 果 你 创建 了 太 多 的 线程 ，CPU 花 费 在 上 下 
文 的 切换 的 时 间 将 多 于 执行 程序 的 时 间 ! 


Java Applet zł 


applet 是 一 种 Java 程 序 。 它 一 般 运 行 在 支持 Java 的 Web 浏 览 器 内 。 因 为 它 有 完整 的 
Java API 支 持 ,所 以 applet 是 一 个 全 功能 的 Java 应 用 程序 。 


如 下 所 示 是 独立 的 Java 应 用 程序 和 applet 程 序 之 间 重 要 的 不 同 : 


Java 中 applet 类 继承 了 java.applet.Applet 类 

Applet 类 没有 定义 main()， 所 以 一 个 Applet 程 序 不 会 调用 main() 方 法 ， 
Applets4& ik it 4 Be AZE—“SHTML & IB], 

当 用 户 浏览 包含 Applet 的 HTML 页 面 ，Applet 的 代码 就 被 下 载 到 用 户 的 机 器 上 。 
要 查看 一 个 applet 需 要 JVM。 JVM 可 以 是 Web 浏 览 器 的 一 个 插件 ， 或 一 个 独立 
的 运行 时 环境 。 

用 户 机 器 上 的 JVM 创 建 一 个 applet 类 的 实例 ， 并 调用 Applet 生 命 周 期 过 程 中 的 
各 种 方法 。 

Applets 有 Web 浏 览 器 强制 执行 的 严格 的 安全 规则 ，applet 的 安全 机 制 被 称 为 沙 
箱 安 全 。 

applet 需 要 的 其 他 类 可 以 用 Java 为 档 (JAR) 文件 的 形式 下 载 下 来 。 


Applet 的 生命 周期 


Applet 类 中 的 四 个 方法 给 你 提供 了 一 个 框架 ， 你 可 以 再 该 框架 上 开发 小 程序 : 


init: 该 方法 的 目的 是 为 你 的 applet 提 供 所 需 的 任何 初始 化 。 在 Applet 标 记 内 的 

param 标 签 被 处 理 后 调用 该 方法 。 

start: 浏览 器 调用 init 方 法 后 ， 该 方法 被 自动 调用 。 每 当 用 户 从 其 他 页 面 返 回 到 
包含 Applet 的 页 面 时 ， 则 调用 该 方法 。 

stop: 当 用 户 从 包含 applet 的 页 面 移 除 的 时 候 ， 该 方法 自动 被 调用 。 因 此 ， 可 以 
在 相同 的 applet 中 反复 调用 该 方法 。 

destroy: 此 方法 仅 当 浏览 器 正常 关闭 时 调用 。 因 为 applets 只 有 在 HTML 网 页 上 
有 效 ， 所 以 你 不 应 该 在 用 户 离开 包含 Applet 的 页 面 后 遗漏 任何 资源 . 

paint: 该 方法 在 start() 方 法 之 后 立即 被 调用 ， 或 者 在 applet 需 要 重 绘 在 浏览 器 的 
时 候 调 用 。paint() 方 法 实际 上 继承 于 java.awt。 


“Hello, World" Applet: 


下 面 是 一 个 简单 的 Applet 程 序 HelloWorldApplet.javal: 


import java.applet.*; 
import java.awt.*; 


public class HelloworldApplet extends Applet 


public void paint (Graphics g) 


{ 
g.drawString ("Hello World", 25, 50); 


} 
} 


这 些 import 语 句 将 以 下 类 导入 到 我 们 的 applet 类 中 : 


java.applet.Applet. 
java.awt.Graphics. 


没有 这 些 import 语 句 ，Java 编 译 器 就 识别 不 了 Applet 和 Graphics 类 。 


Applet # 


每 一 个 applet 都 是 java.applet.Applet 类 的 子 类 ， 基 础 的 Applet 类 提供 了 供 衍生 类 调 
用 的 方法 ,以 此 来 得 到 浏览 器 上 下 文 的 信息 和 服务 。 


这 些 方法 做 了 如 下 事情 : 


得 到 applet 的 参数 

得 到 包含 applet 的 HTML 文 件 的 网 络 位 置 
得 到 applet 类 目录 的 网 络 位 置 

打印 浏览 器 的 状态 信息 

获取 一 张 图 片 

获取 一 个 音频 片段 

播放 一 个 音频 片段 

调整 此 applet 的 大 小 


除 此 之 外 ，Applet 类 还 提供 了 一 个 接口 ， 该 接口 供 Viewer 或 浏览 器 来 获取 applet 的 
信息 ， 并 且 来 控制 applet 的 执行 。 


bk E 


Viewer =] Bez : 


请 求 applet 作 者 、 版 本 和 版 权 的 信息 
请 求 applet 识 别 的 参数 的 描述 

初始 化 applet 

销毁 applet 

开始 执行 applet 

结束 执行 applet 


Applet 类 提供 了 对 这 些 方法 的 默认 实现 ， 这 些 方法 可 以 在 需要 的 时 候 重 写 。 


"Hello，World"applet 都 是 按 标准 编写 的 。 唯 一 被 重 写 的 方法 是 paint 方 法 。 


Applet 的 调用 


applet 是 一 种 Java 程 序 。 它 一 般 运 行 在 支持 Java 的 Web 浏 览 器 内 。 因 为 它 有 完整 的 
Java API 支 持 ,所 以 applet 是 一 个 全 功能 的 Java 应 用 程序 。 


<applet> 标 签 是 在 HTML 文 件 中 做 入 applet 的 基础 。 以 下 是 一 个 调用 "Hello 
World"applet 的 例子 


«html» 

<title>The Hello, World Applet</title> 

<hr> 

«applet code="HelloWorldApplet.class" width="320" height="120"> 
If your browser was Java-enabled, a "Hello, World" 

message would appear here. 

</applet> 

<hr> 

</html> 


注意 : 你 可 以 参照 HTML Applet 标 签 来 更 多 的 了 解 从 HTML 中 调用 applet 的 方法 。 


<applet> 标 签 的 属性 指定 了 要 运行 的 Applet 类 。Width 和 height 用 来 指定 applet 运 行 
面板 的 初始 大 小 。applet 必 须 使 用 </applet> 标 签 来 关闭 。 


如 果 applet 接 受 参数 ， 那么 参数 的 值 需要 在 <param> 标 签 里 添加 ， Had 
<applet> 和 </applet> 之 间 。 浏 览 器 忽略 了 applet 标 签 之 间 的 文本 和 其 他 标签 


不 支持 Java 的 浏览 器 不 能 执行 <applet> 和 </applet>。 因 此 ， 在 标签 之 间 显 示 并 且 和 
applet 没 有 关系 的 任何 东西 ， 在 不 支持 的 Java 的 浏览 器 里 是 可 见 的 。 


Viewer 或 者 浏览 器 在 文档 的 位 置 寻找 编译 过 的 Java 代 码 ， 要 指定 文档 的 路 径 ， 得 使 
用 <applet> 标 签 的 codebase 属 性 指定 。 


如 下 所 示 : 


<applet codebase="http://amrood.com/applets" 
code="HelloWorldApplet.class" width="320" height="120"> 


如 果 applet 所 在 一 个 包 中 而 不 是 默认 包 ， 那 么 所 在 的 包 必 须 在 code 属 性 里 指定 ， 例 
如 : 


«applet code="mypackage.subpackage.TestApplet.class" 
width="320" height="120"> 


获得 applet 参 数 


下 面 的 例子 演示 了 如 何 使 用 一 个 applet 响 应 来 设置 文件 中 指定 的 参数 。 该 Applet 显 
示 了 一 个 黑色 棋盘 图 案 和 第 二 种 颜色 。 


第 二 种 颜色 和 每 一 列 的 大 小 通过 文档 中 的 applet 的 参数 指定 。 


CheckerApplet 在 init() 方 法 里 得 到 它 的 参数 。 也 可 以 在 paint() 方 法 里 得 到 它 的 参 
数 。 然 而 ， 在 applet 开 始 得 到 值 并 保存 了 设置 ， 而 不 是 每 一 次 刷新 的 时 候 都 得 到 
值 ， 这 样 是 很 方便 ， 并 且 高 效 的 。 


applet viewer 或 者 浏览 器 在 apple 诲 次 运行 的 时 候 调 用 init() 方 法 。 在 加 载 applet 之 
后 ，Viewer 立 即 调用 init() 方 法 (Applet.init() 什 么 也 没 做 ) ， 重 写 该 方法 的 默认 实 
现 ， 添 加 一 些 自 定义 的 初始 化 代码 。 


Applet.getParameter() 方 法 通过 给 出 参数 名 称 得 到 参数 值 。 如 果 得 到 的 值 是 数字 或 
者 其 他 非 字 符 数 据 ， 那 么 必须 解析 为 字符 串 类 型 。 


下 例 是 CheckerApplet.java 的 梗概 : 


import java.applet.*; 
import java.awt.*; 
public class CheckerApplet extends Applet 


int squareSize = 50;// 初始 化 默认 大 小 

public void init () {} 

private void parseSquareSize (String param) {} 
private Color parseColor (String param) {} 
public void paint (Graphics g) {} 


下 面 是 CheckerApplet 类 的 init() 方 法 和 私有 的 parseSquareSize() 方 法 : 


public void init () 


{ 
String squareSizeParam = getParameter ("squareSize"); 
parseSquareSize (squareSizeParam) ; 
String colorParam = getParameter ("color"); 
Color fg = parseColor (colorParam); 
setBackground (Color.black); 
setForeground (fg); 
} 
private void parseSquareSize (String param) 
{ 
if (param == null) return; 
try { 
squareSize = Integer.parseInt (param); 
catch (Exception e) { 
// 保留 默认 值 
} 
} 


该 applet 调 用 parseSquareSize()， 来 解析 squareSize 参 数 。parseSquareSize() 调 用 
了 库 方法 Integer. parselnt()， 该 方法 将 一 个 字符 串 解 析 为 一 个 整数 ， 当 参数 无 效 的 
时 候 ，Integer.parselnt() 抛 出 异常 。 


因此 ，parseSquareSize() 方 法 也 是 捕获 异常 的 ， 并 不 允许 applet 接 受 无 效 的 输入 。 


Applet 调 用 parseColor() 方 法 将 颜色 参数 解析 为 一 个 Color 值 。parseColor() 方 法 做 了 
一 系列 字符 串 的 比较 ， 来 匹配 参数 的 值 和 预定 义 颜色 的 名 字 。 你 需要 实现 这 些 方 法 
来 使 applet 工 作 。 


虽 定 applet 参 数 


如 下 的 例子 是 一 个 HTML 文 件 ， 其 中 人 其 入 了 CheckerApplet 类 。HTML 文 件 通 过 使 用 
<param> 标 签 的 方法 给 applet 指 定 了 两 个 参数 。 


<html> 

<title>Checkerboard Applet</title> 

<hr> 

<applet code="CheckerApplet.class" width="480" height="320"> 
«param name="color" value="blue"> 

<param name-"squaresize" value="30"> 

</applet> 

<hr> 

</html> 


注意 : 参数 名 字 大 小 写 不 敏感 。 


应 用 程序 转换 成 Applet 


将 图 形 化 的 Java 应 用 程序 (是 指 ， 使 用 AWT 的 应 用 程序 和 使 用 java 程 序 启动 器 启动 
的 程序 ) 转换 成 其 入 在 web 页 面 里 的 applet 是 很 简单 的 。 


下 面 


是 将 应 用 程序 转换 成 applet 的 几 个 步 又 : 


编写 一 个 HTML 页 面 ， 该 页 面 带 有 能 加 载 applet 代 码 的 标签 。 

编写 一 个 JApplet 类 的 子 类 ， 将 该 类 设置 为 public。 否 则 ，applet 不 能 被 加 载 。 
消除 应 用 程序 的 main() 方 法 。 不 要 为 应 用 程序 构造 框架 窗口 ， 因 为 你 的 应 用 程 
序 要 显示 在 浏览 器 中 。 

将 应 用 程序 中 框架 窗口 的 构造 方法 里 的 初始 化 代码 移 到 applet 的 init() 方 法 中 ， 
O 浏览 器 将 通过 调用 init() 方 法 来 实例 化 一 个 对 
移 除 对 setSize() 方 法 的 调用 ， 对 于 applet 来 讲 ， 大 小 已 经 通过 HTML 文 件 里 的 
width 和 height 参 数 设 定好 了 。 

移 除 对 setDefaultCloseOperation() 方 法 的 调用 。Applet 不 能 被 关闭 ， 它 随 着 浏 
览 器 的 退出 而 终止 。 

如 果 应 用 程序 调用 了 setTitle() 方 法 ， 消 除 对 该 方法 的 调用 。applet 不 能 有 标题 
兰 。 (当然 你 可 以 给 通过 html 的 title 标 签 给 网 页 自身 命名 ) 

不 要 调用 setVisible(true),applet 是 自动 显示 的 。 


事件 处 理 


Applet 类 从 Container 类 继承 了 许多 事件 处 理 方法 。Container 类 定义 了 几 个 方法 ， 
例如 : processKeyEvent() 和 processMouseEvent()， 用 来 处 理 特别 类 型 的 事件 ， 还 


有 一 


个 捕获 所 有 事件 的 方法 叫做 processEvent。 


为 了 响应 一 个 事件 ，applet 必 须 重 写 合 适 的 事件 处 理 方法 。 


import java.awt.event.MouseListener; 
import java.awt.event.MouseEvent; 
import java.applet.Applet; 

import java.awt.Graphics; 


public class ExampleEventHandling extends Applet 


implements MouseListener ( 
StringBuffer strBuffer; 


public void init() { 
addMouseListener(this); 
strBuffer - new StringBuffer(); 
addItem("initializing the apple "); 
j 


public void start() (1 
addItem("starting the applet "); 


j 


public void stop() { 
addItem("stopping the applet "); 
} 


public void destroy() { 
addItem("unloading the applet"); 
} 


void addItem(String word) { 
System.out.println(word); 
strBuffer.append(word); 
repaint(); 


} 


public void paint(Graphics g) { 
//Draw a Rectangle around the applet's display area. 
g.drawRect(0, 0, 
getwidth() - 1, 
getHeight() - 1); 


//display the string inside the rectangle. 
g.drawString(strBuffer.toString(), 10, 20); 


} 


public void mouseEntered(MouseEvent event) { 
} 
public void mouseExited(MouseEvent event) { 
} 
public void mousePressed(MouseEvent event) { 
} 


public void mouseReleased(MouseEvent event) { 


} 


public void mouseClicked(MouseEvent event) { 
addItem("mouse clicked! "); 
j 


如 下 调用 该 applet : 


<html> 

<title>Event Handling</title> 

<hr> 

<applet code="ExampleEventHandling.class" 
width="300" height="300"> 

</applet> 

<hr> 

</html> 


最 开始 运行 ，applet 显 示 "initializing the applet. Starting the applet."， 然 后 你 一 点 
击 矩形 框 ， 就 会 显示 "mouse clicked" 。 


显示 图 片 


applet 能 显示 GIFJPEG,BMP 等 其 他 格式 的 图 片 。 为 了 在 applet 中 显示 图 片 ， 你 需 
使 用 java.awt.Graphics 类 的 drawlmage() 方 法 。 


如 下 实例 演示 了 显示 图 片 的 所 有 步骤 : 


import java.applet.*; 
import java.awt.*; 
import java.net.*; 
public class ImageDemo extends Applet 
{ 
private Image image; 
private AppletContext context; 
public void init() 
{ 
context = this.getAppletContext(); 
String imageURL = this.getParameter ("image"); 
if(imageURL == null) 
{ 


} 
try 


imageURL = "java.jpg"; 


URL url = new URL(this.getDocumentBase(), imageURL); 
image = context.getImage(url); 
}catch(MalformedURLException e) 


{ 
e.printStackTrace(); 
// Display in browser status bar 
context.showStatus("Could not load image!"); 
} 
} 
public void paint(Graphics g) 
{ 
context.showStatus("Displaying image"); 
g.drawImage(image, 0, 0, 200, 84, null); 
g.drawString("www.javalicense.com", 35, 100); 
à 


如 下 调用 该 applet : 


<html> 

<title>The ImageDemo applet</title> 

<hr> 

<applet code="ImageDemo.class" width="300" height="200"> 
«param name="image" value="java.jpg"> 

</applet> 

<hr> 

</html> 


播放 音频 
Applet 能 通过 使 用 java.applet 包 中 的 AudioClip 接 口 播放 音频 。AudioClip 接 口 定义 了 
三 个 方法 : 


e public void play(): 从 一 开始 播放 音频 片段 一 次 。 
e public void loop(): 循环 播放 音频 片段 
e public void stop(): 停止 播放 音频 片段 


为 了 得 到 AudioClip 对 象 ， 你 必须 调用 Applet 类 的 getAudioClip() 方 法 。 无 论 URL 指 
向 的 是 否 是 一 个 真实 的 音频 文件 ， 该 方法 都 会 立即 返回 结果 。 


直到 要 播放 音频 文件 时 ， 该 文件 才 会 下 载 下 来 。 
如 下 实例 演示 了 播放 音频 的 所 有 步骤 : 


n 


import java.applet.*; 

import java.awt.*; 

import java.net.*; 

public class AudioDemo extends Applet 


{ 
private AudioClip clip; 
private AppletContext context; 
public void init() 
f 
context - this.getAppletContext(); 
String audioURL = this.getParameter("audio"); 
if(audioURL -- null) 
{ 
audioURL = "default.au"; 
} 
try 
{ 
URL url = new URL(this.getDocumentBase(), audioURL); 
clip = context.getAudioClip(url); 
}catch(MalformedURLException e) 
{ 
e.printStackTrace(); 
context.showStatus("Could not load audio file!"); 
} 
public void start() 
{ 
if(clip != null) 
clip.loop(); 
} 
public void stop() 
{ 
if(clip != null) 
clip.stop(); 
} 
} 
} 
如 下 调用 applet : 
<html> 
<title>The ImageDemo applet</title> 
<hr> 


<applet code="ImageDemo.class" width="0" height="0"> 
<param name="audio" value="test.wav"> 

</applet> 

<hr> 


你 可 以 使 用 你 电脑 上 的 test.wav 来 测试 上 面 的 实例 。 


Java 文档 注释 


Java 只 是 三 种 注释 方式 。 前 两 种 分 别 是 // 和 /* %， 第 三 种 被 称 作 说 明 注释 ， 它 以 /入 
开始 ， 以 */ 结 束 。 


说 明 注 释 人 允许 你 在 程序 中 嵌入 关于 程序 的 信息 。 你 可 以 使 用 javadoc 工 具 软 件 来 生 
成 信息 ， 并 输出 到 HTML 文 件 中 。 


说 明 注 释 ， 是 你 更 加 方面 的 记录 你 的 程序 的 信息 。 


javadoc 标签 


javadoc 工 具 软 件 识别 以 下 标签 : 


标签 
@author 
@deprecated 
{@docRoot} 


@exception 


{@inheritDoc} 


{@link} 
{@linkplain} 


@param 


@return 


@see 


@serial 


@serialData 


@serialField 


@since 


@throws 


{@value} 


@version 


文档 注释 


描述 
标识 一 个 类 的 作者 
指名 一 个 过 期 的 类 或 成 员 
指明 当前 文档 根 目录 的 路 径 


标志 一 个 类 抛 出 的 异常 


从 直接 父 类 继承 的 注释 
插入 一 个 到 另 一 个 主题 的 链 
接 


插入 一 个 到 另 一 个 主题 的 链 
接 ， 但 是 该 链接 显示 纯 文 本 
字体 


说 明 一 个 方法 的 参数 


说 明 返 回 值 类 型 


指定 一 个 到 另 一 个 主题 的 链 


接 

说 明 一 个 序列 化 属性 

说 明 通过 writeObject( ) 和 
writeExternal( ) 方 法 写 的 数 
据 

说 明 一 个 
ObjectStreamField 组 件 
标记 当 引 入 一 个 特定 的 变化 
时 


和 @exception 标 签 一 样 . 


显示 常量 的 值 ， 该 常量 必须 
是 static 属 性 。 


指定 类 的 版 本 


示例 
@author description 
@deprecated description 


Directory Path 


@exception exception-name 


explanation 


Inherits a comment from the 


immediate surperclass. 


{@link name text} 


Inserts an in-line link to 
another topic. 


@param parameter-name 
explanation 


@return explanation 
@see anchor 


@serial description 


@serialData description 


@serialField name type 
description 


@since release 


The @throws tag has the 
same meaning as the 
@exception tag. 


Displays the value of a 
constant, which must be a 
static field. 


@version info 


在 开始 的 /* 之 后 ， 第 一 行 或 几 行 是 关于 类 、 变 量 和 方法 的 主要 描述 . 


之 后 ， 你 可 以 包含 一 个 或 多 个 何 种 各 样 的 @ 标 签 。 每 一 个 @ 标 签 必 须 在 一 个 新 行 的 
开始 或 者 在 一 行 的 开始 紧 跟 星 号 (*). 


多 个 相同 类 型 的 标签 应 该 放 成 一 组 。 例 如 ， 如 果 你 有 三 个 @see 标 签 ， 可 以 将 它们 
一 个 接 一 个 的 放 在 一 起 。 


下 面 是 一 个 类 的 说 明 注 释 的 示例 : 
/*** This class draws a bar chart. 
* @author Zara Ali 


* @version 1.2 
55 


javadoc 输 出 什么 


javadoc 工 具 将 你 Java 程 序 的 源 代 码 作 为 输入 ， 输 出 一 些 包含 你 程序 注释 的 HTML 文 
人 


o 


每 一 个 类 的 信息 将 在 独自 的 HTML 文 件 里 。javadoc 也 可 以 输出 继承 的 树 形 结构 和 素 
引 。 


由 于 javadoc 的 实现 不 同 ， 工 作 也 可 能 不 同 ， 你 需要 检查 你 的 Java 开 发 系统 的 版 本 
等 细节 ， 选 择 合适 的 Javadoc 版 本 。 


实例 
下 面 是 一 个 使 用 说 明 注释 的 简单 实例 。 注 意 每 一 个 注释 都 在 它 描述 的 项 目的 前 面 。 
在 经 过 javadoc 处 理 之 后 ，SquareNum 类 的 注释 将 在 SquareNum.html 中 找到 。 


import java.io.*; 


JERS 
* This class demonstrates documentation comments. 
* @author Ayan Amhed 
* @version 1.2 
“y 
public class SquareNum { 
JRE 
* This method returns the square of num. 
* This is a multiline description. You can use 
* as many lines as you like. 
* @param num The value to be squared. 
* @return num squared. 
a 
public double square(double num) { 
return num * num; 
} 


JA 

* This method inputs a number from the user. 

* @return The value input as a double. 

* @exception IOException On input error. 

* @see IOException 

ay 

public double getNumber() throws IOException { 
InputStreamReader isr new InputStreamReader(System.in); 
BufferedReader inData new BufferedReader(isr); 
String str; 
str - inData.readLine(); 
return (new Double(str)).doubleValue(); 


This method demonstrates square(). 
Qparam args Unused. 

Qreturn Nothing. 

Qexception IOException On input error. 
Qsee IOException 


+ +*+ + ENS 
* 
+ 


z 
public static void main(String args[]) throws IOException 
x 

SquareNum ob = new SquareNum( ); 

double val; 

System.out.println("Enter value to be squared: "); 

val = ob.getNumber(); 

val = ob.square(val); 

System.out.println( "Squared value is " + val); 


如 下 ， 使 用 javadoc 工 具 人 处 理 SquareNum.java 文 件 : 


$ javadoc SquareNum. java 

Loading source file SquareNum. java... 

Constructing Javadoc information... 

Standard Doclet version 1.5.0 13 

Building tree for all the packages and classes... 

Generating SquareNum.html... 

SquareNum.java:39: warning - Qreturn tag cannot be used\ 
in method with void return type. 

Generating package-frame.html... 

Generating package-summary.html... 

Generating package-tree.html... 

Generating constant-values.html... 

Building index for all the packages and classes... 

Generating overview-tree.html... 

Generating index-all.html... 

Generating deprecated-list.html... 

Building index for all classes... 

Generating allclasses-frame.html... 

Generating allclasses-noframe.html... 

Generating index.html... 

Generating help-doc.html... 

Generating stylesheet.css... 

1 warning 

$ 


Java8 教 程 


JAVA8 有 什么 新 的 特 ， 


生 ? 





JAVA8 是 JAVA 编程 语言 开发 的 一 大 特色 版 本 。 它 的 最 初版 本 发 布 于 2014 年 3 月 18 


日 。 使 用 Java8 版 本 ， 提 供 Java 支 持 功能 编程 ， 新 的 JavaScript 引 擎 ， 日 期 时 间 操 
作 ， 新 的 流 API 等 新 APl。 
新 功能 


Lambda 表达 式 - 增加 函数 处 理 能 力 到 JAVA。 

方法 引用 - 引用 函数 由 他 们 名 称 ， 而 不 是 直接 调用 它们 。 使 用 函数 的 参数 。 
默认 方法 - 接口 有 默认 的 方法 实现 。 

新 工具 - 新 的 编译 器 工具 和 实用 程序 被 添加 ， 如 jdeps 找 出 依赖 。 
数据 流 API - 新 数据 流 的 APl， 以 方便 数据 流 处 理 。 

日 期 时 间 API - 改进 日 期 时 间 APl。 

可 选 - 强调 最 佳 实践 ， 受 善 你 理 空 (null) 值 。 

Nashorn , JavaScript 引 擎 - 一 个 基于 JAVA 引擎 执行 JavaScript 代 码 。 


考虑 下 面 的 代码 片段 。 


import 
import 
import 
import 


public 


java. 
java. 
java. 
java. 


class 


util.Collections; 
util.List; 
util.ArrayList; 
util.Comparator; 


Java8Tester { 


public static void main(String args[]){ 


} 


List<S 


names1. 
names1. 
names1. 
names1. 
names1. 


List<S 


names2. 


names2 


names2. 
names2. 
names2. 


Java8T 


System. 
tester. 
System. 


System. 
tester. 
System. 


tring> names1 = new ArrayList<String>(); 
add( "Mahesh "); 
add( "Suresh "); 
add( "Ramesh "); 
add( "Naresh "); 
add( "Kalpesh "); 


tring> names2 = new ArrayList<String>(); 
add( "Mahesh "); 
.add( "Suresh "); 
add( "Ramesh "); 
add( "Naresh "); 
add( "Kalpesh "); 


ester tester = new Java8Tester(); 


out.println("Sort using Java 7 syntax: "); 
sortUsingJava7(names1); 
out.println(names1); 


out.println("Sort using Java 8 syntax: "); 
sortUsingJava8(names2); 
out.println(names2); 


private void sortUsingJava7(List«String» names)( 


j 


//sort using java 7 

Collections.sort(names, new Comparator<String>() { 
QOverride 
public int compare(String si, String s2) ( 


2r 


return s1.compareTo(s2); 


private void sortUsingJava8(List<String> names) { 


//sort 
Collec 


using java 8 


tions.sort(names, (si, s2) -> si.compareTo(s2)); 


— Bl] 





Sort using Java 7 syntax: 


[ Kalpesh Mahesh Naresh Ramesh Suresh ] 
Sort using Java 8 syntax: 


[ Kalpesh Mahesh Naresh Ramesh Suresh ] 


在 这 里 ，sortUsingJava8 () 方法 使 用 排序 功能 使 用 一 个 lambda 表 达 式 作为 参数 ， 
以 获得 排序 条 件 。 
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Java8 环 境 设 置 

在 开始 学 习 本 教程 之 前 ， 我 们 需要 先 Java 编 程 语言 设置 环境 ， 那 么 这 部 分 指导 如 何 
下 载 和 设置 Java 在 机 器 上 。 请 按照 以 下 步骤 来 设置 环境 。 

Java SE 是 免费 提供 的 链接 下 载 Java。 所 以 ， 下 载 时 根据 您 的 操作 系统 版 本 。 


按照 说 明 下 载 java ( 注意 : 选择 java8 版 本 ) 并 运行 .exe 在 机 器 上 安装 Java。 一 旦 机 
器 上 安装 了 Java， 还 需要 设置 环境 变量 指向 正确 的 安装 目录 : 


为 Windows 2000/ XP 设 置 路 径 : 


假设 你 已 经 安装 在 C:Program Filesjavajdk 目录 : 
。 在 “我 的 电脑 "右键 单 击 并 选择 "属性 "。 
e 在 “高 级 "选项 卡 下 单 击 “ 环 境 变量 "按钮 。 


e 现在 ， 改 变 “Path” 变 量 ， 因 此 ， 它 也 包含 了 路 径 Java 可 执行 文件 。 例 如 ， 如 果 
路 径 当前 设置 为 "C:WINDOWSSYSTEM32”， 然 后 更 改 路 径 
A“C:WINDOWSSYSTEM32;c:Program Filesjavajdkin 。 


为 Linux，UNIX，Solaris 和 FreeBSD 路 径 设 置 : 


环境 变量 PATH 应 设置 为 指向 已 安装 的 Java 二 进 制 文件 的 位 置 。 


例如 ， 如 果 使 用 bash 作 为 shell， 那 么 将 下 面 的 行 添 加 到 文件 .bashrc' 的 末尾 
export PATH=/path/to/java:$PATH' 


流行 的 Java 编 辑 器 : 
编写 Java 程 序 ， 需 要 一 个 文本 编辑 器 。 在 市 场 上 可 用 的 IDE。 可 以 考虑 下 列 几 种 : 


e Notepad: 在 Windows 机 器 上 ， 可 以 使 用 像 记 事 本 的 任何 简单 的 文本 编辑 器 ( 推 
荐 本 教程 )，TextPad。 


。 Netbeans: 是 一 个 Java IDE， 它 是 开源 和 免费 的 ， 可 从 以 下 地 址 下 载 
http://www.netbeans.org/index.html. 


e Eclipse: 也 是 一 个 Java IDE 开 发 由 Eclipse 开源 社区 ， 可 以 从 下 载 
http://www.eclipse.org/. 


Java8 Lambda Xi: xt - Java8 教 程 


Lambda 表 达 式 是 在 Java8 中 引入 的 ， 并 号 称 是 Java8 的 最 大 的 特点 .Lambda 表 达 式 
有 利于 函数 式 编程 ， 简 化 了 开发 了 很 多 。 
语法 


lambda 表 达 式 的 特点 ， 它 的 语法 如 下 面 。 


parameter -> expression body 


下 面 是 一 个 lambda 表 达 式 的 重要 特征 。 
e 可 选 类 型 声明 - 无 需 声 明 参 数 的 类 型 。 编 译 器 可 以 从 该 参数 的 值 推断 。 
e 可 选 圆 括号 参数 - 无 需 在 括号 中 声明 参数 。 对 于 多 个 参数 ， 括 号 是 必需 的 。 
e 可 选 大 括号 - 表达 式 主 体 没 有 必要 使 用 大 括号 ， 如 果 主 体 中 含有 一 个 单独 的 语 


AJo 


可 选 return 关 键 字 - 编译 器 会 自动 返回 值 ， 如 果 主 体 有 一 个 表达 式 返 回 的 值 。 
花 括 号 是 必需 的 ， 以 表明 表达 式 返 回 一 个 值 。 


示例 
使 用 所 选择 的 任何 编辑 器 创建 下 面 的 java 程 序 C:/> JAVA 


Java8Tester.java 


public class Java8Tester { 
public static void main(String args[]){ 
Java8Tester tester = new Java8Tester(); 


//with type declaration 
MathOperation addition = (int a, int b) -> a * b; 


//with out type declaration 
MathOperation subtraction = (a, b) ->a - b; 


//with return statement along with curly braces 
MathOperation multiplication = (int a, int b) -> ( return a * 
//without return statement and without curly braces 
MathOperation division = (int a, int b) ->a/b; 


System.out.println("10 + 5 = " + tester.operate(10, 5, addit: 
System.out.println("10 - 5- " + tester.operate(10, 5, subtré 
System.out.println("10 x 5 = " + tester.operate(10, 5, multi 
System.out.println("10 / 5 = " + tester.operate(10, 5, divis: 


//with parenthesis 
GreetingService greetService1 = message -> System.out.printlr 


//without parenthesis 
GreetingService greetService2 = (message) -> System.out.prini 


greetServicei.sayMessage("Mahesh"); 
greetService2.sayMessage("Suresh"); 


} 


interface MathOperation { 
int operation(int a, int b); 


} 


interface GreetingService { 
void sayMessage(String message); 


} 


private int operate(int a, int b, MathOperation mathOperation) { 
return mathOperation.operation(a, b); 





验证 结 


使 用 javac 编 译 器 编译 如 下 类 


C:\JAVA>javac Java8Tester.java 


现在 运行 Java8Tester 看 到 的 如 下 : 


C:\JAVA>java Java8Tester 


看 到 结果 如 下 : 
10 4 5 - 15 
108-5725 
10 x 5 = 50 
10/5=2 


Hello Mahesh 
Hello Suresh 


prs MMC O 

以 下 是 对 使 用 上 述 例子 认为 是 重要 的 观点 。 
e。|lambda 表 达 式 主要 用 于 定义 内 联 执行 的 功能 的 接口 ， 即 只 有 一 个 单一 的 方法 接 
口 。 在 上 面 的 例子 中 ， 我 们 使 用 不 同类 型 的 lambda 表 达 式 定义 MathOperation 


接口 的 opearation 方 法 。 然 后 ， 我 们 定义 GreetingService 的 sayMessage 实 
Bho 


。Lambda 表 达 式 消除 匿名 类 的 需求 ， 并 给 出 了 一 个 非常 简单 但 功能 强大 的 函数 
式 编程 能 力 。 


变量 的 作用 域 


在 lambda 表 达 式 ， 可 以 指 任何 最 终 的 变量 或 有 效 的 最 后 一 个 变量 (被 分 配 一 次 ) 。 
如 果 变 量 被 二 次 赋值 ，lambda 表 达 式 将 抛 出 编译 错误 。 


作用 域 示 例 
选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> JAVA 


Java8Tester.java 





public class Java8Tester { 

final static String salutation = "Hello! "; 

public static void main(String args[]){ 
GreetingService greetService1 = message -> System.out.printlr 
greetServicei.sayMessage("Mahesh"); 

} 

interface GreetingService { 
void sayMessage(String message); 


} 








验证 结 

使 用 javac 编 译 器 编译 如 下 类 
C:\JAVA>javac Java8Tester.java 

现在 运行 Java8Tester 看 到 的 结果 如 下 : 


C:\JAVA>java Java8Tester 


看 看 以 下 结果 : 


Hello! Mahesh 


Java8 方 法 引用 - Java8 教 程 


方法 引用 有 助 于 自己 的 名 字 指 向 方法 。 方 法 参考 描述 使 用 “::" 符 号 。 一 种 方法 参考 可 
以 用 来 指向 下 列 类 型 的 方法 。 


e 静态 方法 。 
。 实例 方法 。 
e 使 用 new 运 算 符 构造 画 数 (TreeSet::new) 


方法 参考 实例 


使 用 所 选择 的 任何 编辑 器 创建 下 面 的 java 程 序 C:/> JAVA 


Java8Tester.java 


import java.util.List; 

import java.util.ArrayList; 

public class Java8Tester { 

public static void main(String args[]){ 

List names = new ArrayList(); 
names .add("Mahesh"); 
names.add("Suresh"); 
names .add("Ramesh"); 
names.add("Naresh"); 
names.add("Kalpesh"); 


names.forEach(System.out::println); 


在 这 里 ， 我 们 通过 使 用 System.out:: println 方 法 为 静态 方法 引用 。 


验证 结果 
使 用 javac 编 译 器 编译 如 下 类 


C:\JAVA>javac Java8Tester.java 


现在 运行 Java8Tester 看 到 的 结果 


C:\JAVA>java Java8Tester 


看 到 结果 。 


Mahesh 
Suresh 
Ramesh 
Naresh 
Kalpesh 


Java KAA ET] - Java8 教 程 


函数 式 接口 其 中 有 一 个 单一 的 功能 ， 以 显示 出 这 些 接口 。 例 如 ， 一 个 可 比 接口 使 用 
单个 方法 compareTo， 并 且 被 用 于 比较 目的 。 Java8 定 义 被 广泛 应 用 于 lambda 表 达 
式 很 多 函数 形式 的 接口 。 以 下 是 在 java.util.Function 包 中 定义 的 功能 接口 列表 。 


S.N. 接口 和 说 明 

1 BiConsumer<T,U> 表示 接收 两 个 输入 参数 和 不 返回 结果 的 操作 。 

2 BiFunction<T,U,R> 表示 接受 两 个 参数 ， 并 产生 一 个 结果 的 函数 。 

3 BinaryOperator<T> 表示 在 相同 类 型 的 两 个 操作 数 的 操作 ， 生 产 相 同类 
型 的 操作 数 的 结果 。 

4 BiPredicate<T,U> 代表 两 个 参数 谓词 (THR) 。 


5 BooleanSupplier 代表 布尔 值 结果 的 提供 者 。 
6 Consumer<T> 表示 接受 一 个 输入 参数 和 不 返回 结果 的 操作 。 
7 DoubleBinaryOperator 代表 在 两 个 double 值 操作 数 的 运算 ， 并 产生 一 


个 double 值 结果 。 
8 DoubleConsumer 表示 接受 一 个 double 值 参数 ， 不 返回 结果 的 操作 。 
9 DoubleFunction<R> 表示 接受 double 值 参数 ， 并 产生 一 个 结果 的 画 
数 。 
10 DoublePredicate 代表 一 个 double 值 参数 谓词 (AREA o 


11 DoubleSupplier 表示 double 值 结果 的 提供 者 。 


DoubleTolntFunction 表示 接受 double 值 参数 ， 并 产生 一 个 int 值 结果 的 


DoubleToLongFunction 代表 接受 一 个 double 值 参数 ， 并 产生 一 个 long 
值 结果 的 函数 。 


DoubleUnaryOperator 表示 上 产生 一 个 double 值 结果 的 单个 double 值 
操作 数 的 操作 。 


15 Function<T,R> 表示 接受 一 个 参数 ， 并 产生 一 个 结果 的 函数 。 
IntBinaryOperator 表示 对 两 个 int 值 操作 数 的 运算 ， 并 产生 一 个 int 值 结 


o 


17 IntConsumer 表示 接受 单个 int 值 的 参数 并 没有 返回 结果 的 操作 。 
18 IntFunction<R> 表示 接受 一 个 int 值 参数 ， 并 产生 一 个 结果 的 加 数 。 
19 IntPredicate 表示 一 个 整数 值 参数 谓词 (A RARR o 


20 


21 


22 


23 


24 


25 
26 
27 
28 


29 


30 


31 


32 


33 


34 


35 
36 


37 


38 


39 


40 


41 


IntSupplier 代表 整 型 值 的 结果 的 提供 者 。 
IntToDoubleFunction 表示 接受 一 个 int 值 参数 ， 并 产生 一 个 double 值 结 


果 的 功能 。 
IntToLongFunction 表示 接受 一 个 int 值 参数 ， 并 产生 一 个 long 值 结果 的 


IntUnaryOperator 表示 产生 一 个 int 值 结果 的 单个 int 值 操作 数 的 运算 。 


LongBinaryOperator 表示 在 两 个 long 值 操作 数 的 操作 ， 并 产生 一 个 
long 值 结果 。 


LongConsumer 表示 接受 一 个 long 值 参数 和 不 返回 结果 的 操作 。 
LongFunction<R> 表示 接受 long 值 参数 ， 并 产生 一 个 结果 的 函数 。 
LongPredicate 代表 一 个 long 值 参数 谓词 (ARERR 。 
LongSupplier 表示 long 值 结果 的 提供 者 。 


LongToDoubleFunction 表示 接受 double 参 数 ， 并 产生 一 个 double 值 
结果 的 函数 。 


LongTolntFunction 表示 接受 long 值 参数 ， 并 产生 一 个 int 值 结果 的 范 


o 


LongUnaryOperator 表示 上 产生 一 个 long 值 结果 单一 的 long 值 操作 数 


的 操作 。 

ObjDoubleConsumer<T> 表示 接受 对 象 值 和 double 值 参数 ， 并 且 没 有 
返回 结果 的 操作 。 

ObjlntConsumer<T> 表示 接受 对 象 值 和 整 型 值 参数 ， 并 返回 没有 结果 
的 操作 。 

ObjLongConsumer<T> 表示 接受 对 象 的 值 和 long 值 的 说 法 ， 并 没有 返 
回 结果 的 操作 。 


Predicate<T> 代表 一 个 参数 谓词 (RAR) 。 
Supplier<T> 表示 一 个 提供 者 的 结果 。 


ToDoubleBiFunction<T,U> 表示 接受 两 个 参数 ， 并 产生 一 个 double 值 
结果 的 功能 。 


ToDoubleFunction<T> 代表 一 个 产生 一 个 double 值 结果 的 功能 。 


TolntBiFunction<T,U> 表示 接受 两 个 参数 ， 并 产生 一 个 int 值 结果 的 画 
数 。 


TolntFunction<T> 代表 产生 一 个 int 值 结果 的 功能 。 
ToLongBiFunction<T,U> 表示 接受 两 个 参数 ， 并 产生 long 值 结果 的 功 


4b 
Abo 


ToLongFunction<T> 代表 一 个 产生 long 值 结果 的 功能 。 
43 表示 上 产生 相同 类 型 的 操作 数 的 结果 的 单个 操作 数 
^J se o 


42 


函数 接口 例子 

谓词 Predicate<T> 接口 与 方法 试验 〈 对 象 ) 返回 一 个 布尔 值 功 能 接口 。 此 接口 意 
味 着 一 个 对 象 被 检测 为 true 或 false。 

选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> JAVA 


Java8Tester.java 


import java.util.Arrays; 
import java.util.List; 
import java.util.function.Predicate; 


public class Java8Tester { 
public static void main(String args[]){ 


List<Integer> list = Arrays.asList(1, 2, 3, 4, 5, 6, 7, 8, 9. 


// Predicate<Integer> predicate - n -> true 

// n is passed as parameter to test method of Predicate intei! 
// test method will always return true no matter what value r 
System.out.println("Print all numbers:"); 

//pass n as parameter 

eval(list, n->true); 


// Predicate<Integer> predicate1 = n -> n%2 == 

// n is passed as parameter to test method of Predicate intei! 
// test method will return true if n%2 comes to be zero 
System.out.println("Print even numbers:"); 

eval(list, n-» n%2 -- 0 ); 


// Predicate<Integer> predicate2 =n ->n > 3 

// n is passed as parameter to test method of Predicate intei! 
// test method will return true if n is greater than 3. 
System.out.println("Print numbers greater than 3:"); 
eval(list, n-> n> 3 ); 


j 


public static void eval(List<Integer> list, Predicate<Integer> | 
for(Integer n: list) { 
if(predicate.test(n)) { 
System.out.println(n + " "); 





在 这 里 ， 我 们 使 用 通过 谓语 /Predicate 接口 ， 需 要 一 个 单一 的 输入 ， 并 返回 
boolean 值 。 


验证 结果 


使 用 javac 编 译 器 编译 如 下 类 


C:\JAVA>javac Java8Tester.java 


现在 运行 Java8Tester 看 到 的 结果 


C:\JAVA>java Java8Tester 


看 到 结果 。 


Print all numbers: 


1 
2 
3 
4 
5 
6 
7 
8 
9 
P 
2 
4 
6 
8 
P 
4 
5 
6 
7 
8 
9 


rint even numbers: 


rint numbers greater than 3: 





Java8 黑 认 方 法 - Java8 教 程 


Java8 引 入 的 接口 默认 方法 实现 一 个 新 的 概念 。 此 功能 是 为 了 向 后 兼容 性 增加 ， 使 
旧 接 口 可 用 于 利用 JAVA8。 lambda 表 达 式 的 能 力 ， 例 如 ， 列 表 或 集合 接口 不 具备 
forEach 方 法 声明 。 从 而 增加 了 这 样 的 方法 只 会 打破 收集 框架 实现 。 Java85lA TR 
认 的 方法 使 列表 /Collection 接 口 可 以 拥有 forEach 默 认 方法 ， 并 实行 类 实现 这 些 接口 
不 需要 实现 相同 功能 。 


语法 


public interface vehicle { 
default void print(){ 
System.out.println("I am a vehicle!"); 
j 


多 重 默 认 


在 接口 默认 方法 ， 它 们 是 一 类 实现 两 个 接口 使 用 相同 的 默认 方法 ， 那 么 如 何 解决 这 
种 模糊 性 。 考 虑 下 面 的 情况 。 


public interface vehicle { 
default void print(){ 
System.out.println("I am a vehicle!"); 
j 


public interface fourWheeler ( 
default void print(){ 
System.out.println("I am a four wheeler!"); 
j 


第 一 个 解决 方案 是 创建 一 个 自己 的 方法 ， 并 履 盖 默认 实现 。 


public class car implements vehicle, fourWwheeler { 
default void print(){ 
System.out.println("I am a four wheeler car vehicle!"); 
j 


第 二 个 解决 方法 是 调用 使 用 超 指定 接口 的 默认 方法 。 


public class car implements vehicle, fourWwheeler { 
default void print(){ 
vehicle.super.print(); 


} 


静态 默认 方法 
现在 ， 从 Java8 起 接口 也 可 以 有 静态 辅助 方法 。 


public interface vehicle { 
default void print(){ 
System.out.println("I am a vehicle!"); 


static void blowHorn(){ 
System.out.println("Blowing horn!!!"); 


j 


默认 方法 示例 


使 用 所 选择 的 任何 编辑 器 创建 下 面 的 java 程 序 C:/> JAVA 


Java8Tester.java 


public class Java8Tester { 
public static void main(String args[]){ 
Vehicle vehicle - new Car(); 
vehicle.print(); 


} 
} 


interface Vehicle { 
default void print(){ 
System.out.println("I am a vehicle!"); 
} 


static void blowHorn(){ 
System.out.println("Blowing horn!!!"); 
} 


} 


interface FourWheeler { 
default void print(){ 
System.out.println("I am a four wheeler!"); 
j 


j 


class Car implements Vehicle, FourWheeler ( 
public void print(){ 
Vehicle.super.print(); 
FourWheeler.super.print(); 
Vehicle.blowHorn(); 
System.out.println("I am a car!"); 


} 


验证 结果 

使 用 javac 编 译 器 编译 如 下 类 
C:\JAVA>javac Java8Tester.java 

现在 运行 Java8Tester 看 到 的 结果 


C:\JAVA>java Java8Tester 


看 到 结果 。 


I am a vehicle! 

I am a four wheeler! 
Blowing horn!!! 

I am a car! 








Java8 数 据 流 - Java8 教 程 


流 /Stream 是 在 JAVA8 中 引入 的 一 个 抽象 ， 可 以 处 理 类 似 SQL 语 句 声 明 数 据 。 例 
如 ， 考 虑 下 面 的 SQL 语句 。 


SELECT max(salary),employee id,employee name FROM Employee 


上 面 的 SQL 表达 式 会 自动 返回 最 大 薪水 员工 的 细节 ， 没 有 对 开发 者 的 最 终 做 任何 计 
算 。 在 Java 中 使 用 集合 框架 ， 开 发 人 员 必 须 使 用 循环 ， 使 检查 反复 。 另 一 个 值得 关 
注 的 是 效率 ， 多 核 处 理 器 可 放心 ，Java 开 发 人 员 必 须 编写 的 并 行 代码 处 理 ， 但 是 非 
常 容易 出 错 。 


为 了 解决 这 样 的 问题 ，JAVA8 引 入 了 流 的 概念 ， 它 允许 开发 者 通过 声明 处 理 数据 ， 
并 可 以 leverate 多 核 架 构 ， 而 不 需要 编写 任何 特定 的 代码 。 


么 是 数据 流 ? 
流 代 表 从 支持 聚合 操作 源 的 序列 的 对 象 。 以 下 是 数据 流 的 特点 。 


e 元 素 序 列 - 流 提供 了 一 组 特定 类 型 的 以 顺序 方式 元 素 。 流 获取 /计算 需求 的 元 
素 。 它 不 存储 元 素 。 


原 - 流 使 用 集合 ， 数 组 或 MO 资源 为 输入 源 。 
聚合 操作 - 数据 流 支持 如 filter, map, limit, reduced, find, match 等 聚合 操作 。 


道 传输 - 大 多 数 流 操作 的 返回 流 本 身 使 他 们 的 结果 可 以 被 管道 传输 。 这 些 操 
oe 它们 的 功能 是 上 用 输入 ， 处 理 输入 和 输出 返回 到 目标 。 
collect() 方 法 是 终端 操作 ， 这 是 通常 出 现在 管道 传输 操作 结束 标记 流 的 结束 。 


e BAAR - 流 操作 内 部 做 了 反复 对 比 ， 其 中 明确 迭代 需要 集合 提供 源 元 素 。 


生成 数据 法 


使 用 Java8，Collection 接口 有 两 个 方法 来 生成 流 。 
e stream() -返回 顺序 流 考虑 集合 作为 其 源 。 
e parallelStream() - 返回 并 行 数据 流 考虑 集合 作为 其 源 。 


List<String> strings = Arrays.asList("abc", "", "bc", "efg", "abcd' 
List<String> filtered = strings.stream().filter(string -> !string.: 


«| = 








ForEach 


数据 流 提供 了 新 的 forEach 方 法 通 历 该 流 中 的 每 个 元 素 。 考 虑 下 面 的 例子 打印 10 个 
随机 数字 。 


Random random = new Random(); 
random. ints().1limit(10).forEach(System.out::println); 


map 
map 方 法 用 于 映射 每 个 元 素 对 应 的 结果 。 考 虑 下 面 的 例子 打印 唯一 的 方形 数字 。 


List<Integer> numbers = Arrays.asList(3, 2, 2, 3, 7, 3, 5); 
//get list of unique squares 
List<Integer> squaresList = numbers.stream().map( i -> i*i).distinc 


Ki — 





filter 
filter 方 法 用 于 消除 基于 标准 元 素 。 考 虑 下 面 的 例子 打印 空 字符 串 计数 (总 数 )。 


List<String>strings = Arrays.asList("abc", "", "bc", "efg", "abcd", 
//get count of empty string 
int count = strings.stream().filter(string -> string.isEmpty()).cot 
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limit 
limit 方法 用 于 减少 流 的 大 小 。 考 虑 下 面 的 例子 打印 10 个 随机 数字 。 
Random random = new Random(); 
random. ints().limit(10).forEach(System.out::println); 
sorted 
sorted 方 法 用 来 流 排序 。 考 虑 下 面 的 例子 打印 10 个 随机 数字 的 排序 顺序 。 


Random random = new Random(); 
random. ints().1limit(10).sorted().forEach(System.out::println); 


并 行 处 理 
parallelStream 是 流 进行 并 行 处 理 的 蔡 代 方案 。 考虑 下 面 的 例子 打印 空 字符 串 计 


o 


List<String> strings = Arrays.asList("abc", "", "bc", "efg", "abcd' 
//get count of empty string 
int count = strings.parallelStream().filter(string -> string.isEmp! 
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这 是 很 容易 在 顺序 和 并 行 的 流 之 间 进 行 切换 。 


收集 器 


收集 器 是 用 来 处 理 组 合 在 一 个 数据 流 的 元 素 的 结果 。 收 集 器 可 用 于 返回 一 个 列表 或 
一 个 字符 串 。 


List<String>strings = Arrays.asList("abc", "", "bc", "efg", "abcd", 
List<String> filtered = strings.stream().filter(string -> !string.: 
System.out.println("Filtered List: " + filtered); 

String mergedString = strings.stream().filter(string -> !string.ist 
System.out.println("Merged String: " + mergedString); 





统计 
使 用 Java8， 统 计 收集 器 引入 计算 所 有 统计 数据 时 ， 流 处 理 可 以 做 这 些 。 


List<Integer> numbers = Arrays.asList(3, 2, 2, 3, 7, 3, 5); 


IntSummaryStatistics stats = integers.stream().mapToInt((x) -> x).: 


System.out.println("Highest number in List : " + stats.getMax()); 
System.out.println("Lowest number in List : " + stats.getMin()); 
System.out.println("Sum of all numbers : " + stats.getSum()); 
System.out.println("Average of all numbers : " + stats.getAverage! 





fe mu m 


Stream 例子 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> JAVA 


Java8Tester.java 


import 
import 
import 
import 
import 
import 
import 


public 
pub 


java.util.ArrayList; 
java.util.Arrays; 
java.util.IntSummaryStatistics; 
java.util.List; 
java.util.Random; 
java.util.stream.Collectors; 
java.util.Map; 


class Java8Tester { 
lic static void main(String args[]){ 


System.out.println("Using Java 7: "); 

// Count empty strings 

List<String> strings = Arrays.asList("abc", "", "bc", "efg", 
System.out.println("List: " +strings); 

long count = getCountEmptyStringUsingJava7(strings); 
System.out.println("Empty Strings: " + count); 


count = getCountLength3UsingJava7(strings); 
System.out.println("Strings of length 3: " + count); 


//Eliminate empty string 
List«String» filtered - deleteEmptyStringsUsingJava7(string: 
System.out.println("Filtered List: " + filtered); 


//Eliminate empty string and join using comma. 

String mergedString = getMergedStringUsingJava7(strings,", " 
System.out.println("Merged String: " + mergedString); 
List<Integer> numbers = Arrays.asList(3, 2, 2, 3, 7, 3, 5); 
//get list of square of distinct numbers 

List<Integer> squaresList = getSquares(numbers); 


System.out.println("Squares List: " + squaresList); 


List<Integer> integers = Arrays.asList(1,2,13,4,15,6,17,8,19. 


System.out.println("List: " +integers); 

System.out.println("Highest number in List : " + getMax(intec 
System.out.println("Lowest number in List : " + getMin(intege 
System.out.println("Sum of all numbers : " + getSum(integers: 
System.out.println("Average of all numbers : " + getAverage(: 


System.out.println("Random Numbers: "); 

//print ten random numbers 

Random random = new Random(); 

for(int 1-0; i < 10; 144) f 
System.out.println(random.nextInt()); 


} 
System.out.println("Using Java 8: "); 
System.out.println("List: " +strings); 


count = strings.stream().filter(string-»string.isEmpty()).cot 
System.out.println("Empty Strings: " + count); 


count = strings.stream().filter(string -> string.length() == 
System.out.println("Strings of length 3: " + count); 


filtered = strings.stream().filter(string -> !string.isEmptyi 
System.out.println("Filtered List: " + filtered); 


mergedString - strings.stream().filter(string -» !string.isEr 
System.out.println("Merged String: " + mergedString); 


squaresList = numbers.stream().map( i -> i*i).distinct().col. 
System.out.println("Squares List: " + squaresList); 


System.out.println("List: " +integers); 
IntSummaryStatistics stats = integers.stream().mapToInt((x) 


System.out.println("Highest number in List : " + stats.getMa 
System.out.println("Lowest number in List : " + stats.getMir 
System.out.println("Sum of all numbers : " + stats.getSum()), 
System.out.println("Average of all numbers : " + stats.getA 


System.out.println("Random Numbers: "); 
random.ints().limit(10).sorted().forEach(System.out::println: 


//parallel processing 
count - strings.parallelStream().filter(string -» string.isEr 
System.out.println("Empty Strings: " + count); 


j 


private static int getCountEmptyStringUsingJava7(List<String> si 
int count = 0; 
for(String string: strings) { 
if(string.isEmpty()){ 
count++, 
j 


j 


return count; 
j 
private static int getCountLength3UsingJava7(List<String> string 
int count - 0; 
for(String string: strings) { 
if(string.length() == 3){ 
count++, 
j 


j 


return count; 
j 
private static List<String> deleteEmptyStringsUsingJava7(List«sSi 
List<String> filteredList = new ArrayList<String>(); 
for(String string: strings) { 
if(!string.isEmpty()){ 
filteredList.add(string); 
j 


return filteredList; 


} 


private static String getMergedStringUsingJava7(List<String> sti! 
StringBuilder stringBuilder = new StringBuilder(); 
for(String string: strings) { 
if(!string.isEmpty())( 
stringBuilder.append(string); 
stringBuilder.append(seperator); 
} 
} 
String mergedString = stringBuilder.toString(); 
return mergedString.substring(0, mergedString.length()-2); 
j 


private static List<Integer> getSquares(List«Integer» numbers) { 
List«Integer» squaresList = new ArrayList«Integer»(); 
for(Integer number: numbers) { 
Integer square = new Integer(number.intValue() * number.ir 
if(!squaresList.contains(square) ) { 
squaresList.add(square); 
} 
} 


return squaresList; 


} 


private static int getMax(List<Integer> numbers){ 
int max = numbers.get(0); 
for(int i-1;i« numbers.size();i++){ 
Integer number = numbers.get(i); 
if (number .intValue() > max){ 
max = number.intValue(); 
} 


j 


return max; 


j 


private static int getMin(List<Integer> numbers) { 
int min = numbers.get(0); 
for(int i-1;i« numbers.size();it+){ 
Integer number = numbers.get(i); 
if(number.intValue() < min){ 
min = number.intValue(); 
} 


} 


return min; 


} 


private static int getSum(List<Integer> numbers){ 
int sum = numbers.get(0); 
for(int i-1;i« numbers.size();it++){ 
sum += numbers.get(i).intValue(); 


} 


return sum; 


} 
private static int getAverage(List<Integer> numbers){ 
return getSum(numbers) / numbers.size(); 


} 
} 
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验证 结果 
使 用 javac 编 译 器 编译 如 下 类 


C:\JAVA>javac Java8Tester.java 


现在 运行 Java8Tester 看 到 的 结果 


C:\JAVA>java Java8Tester 


看 到 结果 


Using Java 7: 

List: [abc, , bc, efg, abcd, , jkl] 
Empty Strings: 2 

Strings of length 3: 3 

Filtered List: [abc, bc, efg, abcd, jkl] 
Merged String: abc, bc, efg, abcd, jkl 
Squares List: [9, 4, 49, 25] 

Eista Ii, 73 v4 1525 617559. 39] 
Highest number in List : 19 

Lowest number in List : 1 

Sum of all numbers : 85 

Average of all numbers : 9 

Random Numbers: 

-1279735475 

903418352 

-1133928044 

-1571118911 

628530462 

18407523 

-881538250 

-718932165 

270259229 

421676854 

Using Java 8: 

List: [abc, , bc, efg, abcd, , jkl] 
Empty Strings: 2 

Strings of length 3: 3 

Filtered List: [abc, bc, efg, abcd, jkl] 
Merged String: abc, bc, efg, abcd, jkl 
Squares List: [9, 4, 49, 25] 

tists ir 2 iey A iS a tpe 
Highest number in List : 19 

Lowest number in List : 1 

Sum of all numbers : 85 

Average of all numbers : 9.444444444444445 
Random Numbers: 

-1009474951 

- 551240647 

-2484714 

181614550 

933444268 

1227850416 

1579250773 

1627454872 

1683033687 

1798939493 

Empty Strings: 2 


Java8 Optional% - Java8 教 程 


Optional 用 于 包含 非 空 对 象 的 容器 对 象 。Optional 对 象 ， 用 于 表示 使 用 不 存在 null 
值 。 这 个 类 有 各 种 实用 的 方法 ， 以 方便 代码 来 处 理 为 可 用 或 不 可 用 ， 而 不 是 检查 
null 值 。 它 是 Java 引 入 , 是 类 似 于 在 Guava 中 的 Optional 。 


4 ob 
类 两 明 
以 下 是 java.util.Optional<T> 类 的 声明 : 


public final class Optional<T> 
extends Object 


S.N. 
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方法 及 说 明 
static <T> Optional<T> empty() 返回 一 个 空 的 Optional 实例 。 


boolean equals(Object obj) 表示 某 个 其 他 对 象 是 否 “ 等 于 ”此 
Optional。 


Optional<T> filter(Predicate<? super T> predicate) 如 果 值 存在 ， 并 
且 该 值 给 定 的 谓词 匹配 ， 返 回 一 个 可 选 描述 值 ， 否 则 返回 一 个 空 
Optional。 

<U> Optional<U> flatMap(Function<? super T,Optional<U>> 
mapper) 如 果 值 存在 ， 应 用 提供 的 可 选 承载 映射 功能 到 它 ， 返 回 结果 ， 
否则 返回 一 个 空 Optional。 

T get() 如 果 值 是 出 现在 这 个 Optional 中 ， 返 回 这 个 值 ， 否 则 抛 出 
NoSuchElementException s? & , 


int hashCode() 返回 当前 值 ， 哈 希 码 值 (如 有 ) 或 0 (S), MRA 
存在 。 


void ifPresent(Consumer<? super T> consumer) 如 果 值 存在 ， 调 用 
指定 的 使 用 方 提供 值 ， 否 则 什么 都 不 做 。 


boolean isPresent() 返回 true， 如 果 有 一 个 值 存在 ， 否 则 为 false。 


<U> Optional<U> map(Function<? super T,? extends U> mapper) 
WOR TE, SARRAR, MRE REE, eE T Optional 
描述 结果 。 


static <T> Optional<T> of(T value) 返回 一 个 Optional 具 有 指定 当前 非 
50 
空 值 。 


static <T> Optional<T> ofNullable(T value) 返回 一 个 Optional 描 述 指 
定 的 值 ， 如 果 非 空 ， 否 则 返回 一 个 空 的 Optional。 


T orElse(T other) 返回 值 (如 果 存 在 ) ， 否 则 返回 other。 


T orElseGet(Supplier<? extends T» other) 如果 存在 ， 返 回 值 ， 否 则 
调用 其 他 并 返回 调用 的 结果 。 


<X extends Throwable> T orElseThrow(Supplier<? extends X> 
exceptionSupplier) 返回 所 含 值 ， 如 果 存 在 的 话 ， 否 则 抛 出 将 由 提供 者 
创建 的 一 个 例外 。 


String toString() 返回 此 Optional 适 合 调试 一 个 非 空 字符 串 表 示 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


Optional 例子 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> JAVA 


Java8Tester.java 


import java.util.Optional; 


public class Java8Tester ( 
public static void main(String args[]){ 


} 


Java8Tester java8Tester = new Java8Tester(); 


Integer Valuel null; 

Integer value2 new Integer(10); 

//Optional.ofNullable - allows passed parameter to be null. 
Optional<Integer> a = Optional.ofNullable(value1i); 
//Optional.of - throws NullPointerException if passed paramet 
Optional«Integer» b - Optional.of(value2); 


System.out.println(java8Tester.sum(a,b)); 


public Integer sum(Optional«Integer» a, Optional<Integer> b){ 


//Optional.isPresent - checks the value is present or not 
System.out.println("First parameter is present: " + a.isPrese 


System.out.println("Second parameter is present: " + b.isPre: 
//Optional.orElse - returns the value if present otherwise re 
//the default value passed. 


Integer valuei = a.orElse(new Integer(0)); 


//Optional.get - gets the value, value should be present 
Integer value2 - b.get(); 


return value1 + value2; 





验证 结果 


使 用 javac 编 译 器 编译 如 下 类 


C:\JAVA>javac Java8Tester.java 


现在 运行 Java8Tester 看 到 的 结果 


C:\JAVA>java Java8Tester 


到 结果 。 


First parameter is present: false 
Second parameter is present: true 
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Java8 Nashorn JavaScript5|® - Java8 教 程 


使 用 Java8，Nashorn 大 大 提高 了 JavaScript 引擎 引入 ， 以 取代 现 有 的 Nashorn 
Java 脚 本 引擎 。Nashorn 提 供 2 至 10 倍 更 好 的 性 能 ， 因 为 它 直 接 编译 代码 在 存储 
器 ， 并 传递 到 字 节 码 JVM.Nashorn 使 用 invokedynamics 函 数 ， 在 Java7 引 入 以 提高 
性 能 。 

jjs 

对 于 Nashorn 引 擎 ，JAVA8 引 入 了 一 个 新 的 命令 行 工具 ，JJS 到 控制 台 执 行 Java 脚 
本 代码 。 


解读 js 文件 
创建 并 保存 sample.js 在 C : > JAVA 文件 夹 。 


sample.js 


print('Hello World!'); 


打开 控制 台 并 使 用 下 面 的 命令 。 


C:\JAVA>jjs sample.js 


看 到 结果 


Hello World! 


JJS 在 交互 模式 
打开 控制 台 并 使 用 下 面 的 命 全 


C:NJAVA»jjs 

jjs» print("Hello, World!") 
Hello, World! 

jjs> quit() 

>> 


打开 控制 台 并 使 用 下 面 的 命令 。 


C:\JAVA> jjs -- abc 


jjs» print('letters: ' targuments.join(", ")) 
letters: a, b, c 
jjs> 


在 JAVA 调 用 JavaScript 


使 用 ScriptEngineManager，JavaScript 代 码 用 Java 编 写 可 以 被 调用 。 


示例 
选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> JAVA 


Java8Tester.java 


import javax.script.ScriptEngineManager; 
import javax.script.ScriptEngine; 
import javax.script.ScriptException; 


public class Java8Tester ( 
public static void main(String args[]){ 
ScriptEngineManager scriptEngineManager = new ScriptEngineMar 
ScriptEngine nashorn = scriptEngineManager.getEngineByName("i 
String name = "Mahesh"; 


Integer result = null; 
try { 

nashorn.eval("print('" + name + "')"); 

result = (Integer) nashorn.eval("10 + 2"); 
jcatch(ScriptException e){ 

System.out.println("Error executing script: "+ e.getMessac 
j 


System.out.println(result.toString()); 





验证 结 


使 用 javac 编 译 器 编译 如 下 类 


C:\JAVA>javac Java8Tester.java 


现在 运行 Java8Tester 看 到 的 结果 


C:\JAVA>java Java8Tester 


看 到 结果 


Mahesh 
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从 JavaScript 调 用 Java 


下 面 的 例子 将 展示 如 何 导 入 和 使 用 Java 类 的 Java 脚 本 。 
创建 并 保存 sample.js 在 c: > JAVA HER. 


sample.js 


var BigDecimal = Java.type('java.math.BigDecimal' ); 


function calculate(amount, percentage) { 
var result = new BigDecimal(amount).multiply( 
new BigDecimal(percentage)).divide( 
new BigDecimal("100"), 2, BigDecimal.ROUND HALF EVEN); 
return result.toPlainString(); 


j 
var result - calculate(568000000000000000023,13.9); 
print(result); 


打开 控制 台 并 使 用 下 面 的 命令 。 


C:\JAVA>jjs sample.js 


看 到 结果 


78952000000000000003 .20 


Java8 日 期 时 间 API - Java8 教 程 


使 用 Java8， 新 的 日 期 时 间 API 引 入 覆盖 旧 的 日 期 时 间 API 的 以 下 缺点 。 
e 非 线程 安全 - java.util.Date 不 是 线程 安全 的 ， 因 此 开发 者 必须 在 使 用 日 期 处 理 


并 发 性 问题 。 新 的 日 期 时 间 API 是 不 可 变 的 ， 并 且 没 有 setter 方 法 。 


e. 设计 不 佳 - 默认 的 开始 日 期 从 1900 年 ， 开 始 每 月 从 1 天 从 0 开始 ， 所 以 没有 统 


一 。 不 直接 使 用 方法 操作 日 期 。 新 的 API 提 供 了 这 样 操作 实用 方法 。 


e 困难 的 时 区 人 处理- 开发 人 员 必 须 编写 大 量 的 代码 来 处 理 时 区 的 问题 。 新 的 API 


设计 开发 保持 特定 领域 设计 。 


JAVA8 引 入 了 javatime 包 - 下 一 个 新 的 日 期 时 间 API。 以 下 是 一 些 在 java.time 程 序 
包 引 入 重要 的 类 。 


e 本 地 - 简化 日 期 时 间 APl， 没 有 时 间 你 理 区 的 复杂 性 。 
e 时 区 - 专业 的 日 期 时 间 API 来 处 理 各 种 时 区 。 


SN 
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使 用 描述 方法 


本 地 日 期 时 间 API LocalDate/ 本 地 时 间 和 LocalDateTime 类 简化 时 区 不 需 
要 开发 。 


时 区 日 期 时 间 API 时 区 日 期 时 间 API 使 用 的 时 区 是 需要 考虑 的 。 


计时 单位 枚 举 java.time.temporal.ChronoUnit 枚 举 在 Java8 添 加 ， 以 取代 
日 的 API 用 来 代表 日 ， 月 等 整数 值 


周期 和 持续 时 间 这 些 类 引入 到 处理 时 间 的 差异 。 


时 间 调 节 器 TemporalAdjuster 是 做 数学 日 期 。 例 如 ， 要 获得 “本 月 第 二 个 
星期 六 ”或 “下 周二 ”。 


向 后 兼容 性 tolnstant() 方 法 被 添加 到 可 用 于 将 它们 转换 到 新 的 日 期 时 间 的 
API 原 始 日 期 和 日 历 对 象 。 


Java8 Base64 - Java8 教 程 
使 用 Java8，Base64 终 于 得 到 了 在 Java 整 合 。 Java8s,TE3 VJI8 45 53 d FU RE oe 
Base64 编 码 。 在 Java8 中 ， 我 们 可 以 使 用 三 种 类 型 的 Base64 编 码 。 


e 简单 - 输出 映射 设置 字符 在 A-ZA-Z0-9+/。 编 码 器 不 添加 任何 换行 输出 和 解码 
器 拒绝 在 A-Za-z0-9+/ 以 外 的 任何 字符 。 


URL - 输出 映射 设置 字符 在 A-Za-z0-9+_。 输 出 URL 和 文件 名 安全 。 


MIME - 输出 映射 到 MIME 友 好 的 格式 。 输 出 表示 在 每 次 不 超过 76 个 字符 行 和 使 
用 \r' 后 跟 一 个 换行 符 \n' 回 车 作为 行 分 隔 符 。 无 行 隔 板 的 存在 是 为 了 使 编码 的 结 
束 输 出 。 


Nested 类 


S.N. Nested # & 描述 


static class Base64.Decoder 这 个 类 实现 了 一 个 解码 器 使 用 的 Base64 
编码 方案 解码 字 节 的 数据 ， 在 RFC4648 和 RFC2045 规 定 。 


static class Base64.Encoder 这 个 类 实现 一 个 编码 器 使 用 的 Base64 编 
码 方 案 编 码 字 节 数 据 在 RFC4648 和 RFC2045 规 定 。 


方法 


S.N. 方法 名 称 & 描述 


一 


1 static Base64.Decoder getDecoder() 返回 Base64.Decoder 解 码 使 用 
基本 型 base64 编 码 方案 。 

2 static Base64.Encoder getEncoder() 返回 Base64.Encoder 编 码 使 用 
的 基本 型 base64 编 码 方案 。 

3 static Base64.Decoder getMimeDecoder() 返回 Base64.Decoder 解 码 
使 用 MIME 类 型 的 base64 解 码 方案 。 

4 static Base64.Encoder getMimeEncoder() 返回 Base64.Encoder 编 码 


使 用 MIME 类 型 base64 编 码 方案 。 
static Base64.Encoder getMimeEncoder(int lineLength, byte[] 


5 lineSeparator) 返回 Base64.Encoder 编 码 使 用 指定 的 行 长 度 和 线 分 隔 的 
MIME 类 型 base64 编 码 方案 。 
6 static Base64.Decoder getUrlDecoder() 返回 Base64.Decoder 解 码 使 
用 URL 和 文件 名 安全 型 base64 编 码 方 案 。 
7 static Base64.Encoder getUrlEncoder() 返回 Base64.Decoder 解 码 使 
用 URL 和 文件 名 安全 型 base64 编 码 方 案 。 
方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.lang.Object 
Base64 例子 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 C:/> JAVA 


Java8Tester.java 


import java.util.Base64; 
import java.util.UUID; 
import java.io.UnsupportedEncodingException; 


public class Helloworld { 


public static void main(String args[]){ 


try ( 


// Encode using basic encoder 
String base64encodedString = Base64.getEncoder().encodeTo: 
System.out.println("Base64 Encoded String (Basic) :" + ba: 


// Decode 
byte[] base64decodedBytes = Base64.getDecoder().decode(ba: 
System.out.println("Original String: "+new String(base64de 


base64encodedString = Base64.getUrlEncoder().encodeToStrir 
System.out.println("Base64 Encoded String (URL) :" + baset 


StringBuilder stringBuilder - new StringBuilder(); 

for (int i = 0; i < 10; ++i) { 
stringBuilder.append(UUID.randomUUID().toString()); 

} 


byte[] mimeBytes = stringBuilder.toString().getBytes("utf- 
String mimeEncodedString = Base64.getMimeEncoder().encode 
System.out.println("Base64 Encoded String (MIME) :"+mir 


}catch(UnsupportedEncodingException e){ 


System.out.println("Error :"+e.getMessage()); 





验证 结果 


使 用 javac 编 译 如 下 编译 类 


C:\JAVA>javac Java8Tester.java 


现在 运行 Java8Tester 看 到 的 结果 


C:\JAVA>java Java8Tester 


看 到 结果 


Base64 Encoded String (Basic) :VHVOb3JpYWxzUG9pbnQ/amF2YTg- 
Original String: YiiBai?java8 

Base64 Encoded String (URL) :VHVOb3JpYWxzUG9pbnQ amF2YTg- 

Base64 Encoded String (MIME) :ZWJjY2YzZWUtYmUwZCOOY j g1LTlkYjUtNWUy! 
4ZGQAZjE1NGJmMjEtNTdkNiO0OYzMi1LTg4 
MzYtNDZlYzNhZDM2NTdkZmQzY2RiNzMtMTU10COO0Z j BnLWFmZGQtM2YyZWU3MDYZzZ j( 
WQO 

ODCtZWEyZSOOYzM2LWEyZmUtOGVkMmN; MGNnZGM3MTg5YWUyZGQtMz g4MS00M2NKLW: 
jNh 

Zjk20GIxZDU2YzkzODZ1YTUtNj 1jNCOOZmIyLTkzYTQtMzVl1OTFl1NjdlY2bEOMDCWNME 
mE4 
YyOOOT1jJLTg2NmItMjE3ZTZmMmIyY2NiNZI2MjAwZWQtM] IONCOOYz JhLWJiMGItOT( 
ZIX 

NGFkY2QyZmVhODItNmUyOSOO0MWNj LWFLODItNZdmNZRhYmQ4NGU5ZGQ3Zj YSNZktZ jt 
zlk 

LTImNDgtOTNINTIWYZIZZDCy 


E — —Hm 





java 实 例 教程 


java 


Programming 
Examples. 
汇集 可 以 使 用 的 Java 编 程 实例 。 Java 运 行 于 各 种 平台 ， 如 Windows，Mac OS 和 各 


种 版 本 的 UNIX。 
这 些 例 子 对 于 项 目 开 发 ， 论 文 和 学 习 是 非常 有 用 的 。 


读者 


此 参考 教程 是 为 初学 者 ， 帮 助 他 们 了 解 基本 的 Java 编 程 语 言 和 先进 设计 理念 。 


前 提 条 件 
在 开始 做 练习 以 及 在 此 引用 给 定 的 例子 ， 假 设 读者 已 经 知道 什么 是 Java 编 程 和 概 


io 


编译 /执行 Java 程 序 


public class MyFirstJavaProgram { 


public static void main(String []args) { 
System.out.println("Hello World"); 
j 


1 - JAVA 面试 试题 


通过 最 期 望 和 重要 的 面试 问题 来 增强 自己 的 信心 。 


Java 面试 题 
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Java 环 境 - java 实 例 教程 


学 习 如 何 使 用 Java 编 程 的 编程 环境 。 下 面 是 最 常用 的 例子 : 
1. 如 何 编译 一 个 java 文 件 ? 

. 如 何 运行 一 个 类 文件 ? 

.如 何 调 斌 一 个 java 文 件 ? 

. How to set classpath? 

.如 何 查看 当前 classpath? 

. 如何 设置 类 文件 的 目标 ? 

. 如 何 运 行 编译 后 的 class 文 件 ? 

. 如 何 检查 Java 运 行 在 系统 上 的 版 本 ? 

.如 何 设置 classpath， 当 类 文件 均 为 .jar 文 件 ? 
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Java String/ 字 符 串 操作 实例 - java 3z HATE 


了 解 如 何在 Java 编 程 中 的 字符 串 使 用 。 下 面 是 最 常用 的 例子 : 


1. 
. 如 何 搜索 一 个 子 串 的 最 后 一 次 数 出 现 ? 

. 如 何 从 一 个 字符 串 中 删除 特定 的 字符 ? 

. 如 何 通过 一 个 字符 串 蔡 换 字符 串 中 的 另 一 个 子 串 ? 
.如何 逆 转 一 个 字符 串 ? 

. 如何 搜索 一 个 字符 串 中 的 单词 ? 

.如何 将 一 个 字符 串 分 割 成 若干 子 字符 串 ? 

. 如 何 将 字符 串 全 部 转换 成 大 写 ? 

.如 何在 一 个 字符 串 匹 配 区 域 ? 

. 如 何 比 较 两 个 字符 串 的 性 能 ? 

.如 何 优化 字符 串 创建 ? 

. 如 何 格式 化 字符 串 ? 

. 如 何 连 接 两 个 字符 串 ? 

.如何 获 得 字符 串 的 unicode? 

.如 何 将 字符 串 缓冲 区 ? 
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如 何 比 较 字 符 串 ? 
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Java Arrays/ 数 组 实例 -java 实例 教程 


了 解 如 何在 Java 编 程 中 使 用 数组 。 下 面 是 最 常用 的 例子 : 
1. 
. 如 何 排序 的 数组 ， 并 插入 元 素 ? 

. 如 何 确定 定义 一 个 二 维 数组 ? 

. 如 何 逆转 数组 ? 

. 如 何 写 一 个 字符 串 数 组 到 输出 控制 台 ? 

. 如何 搜索 数组 的 最 小 和 最 大 元 素 ? 

. How to merge two arrays? 

. 如何 填 写 〈 初 始 化 一 次 ) 的 数组 ? 

. 如 何 初始 化 后 延长 /扩大 一 个 数组 ? 

. 如 何 对 数组 进行 排序 和 搜索 里 面 的 元 素 ? 
.如 何 删 除数 组 中 的 一 个 元 素 ? 

.如 何 从 一 个 数组 中 删除 另 一 个 数组 ? 

.如 何 找 到 从 数组 中 公共 元 素 ? 

. 如 何在 Array 中 查找 一 个 对 象 或 一 个 字符 串 ? 
. 如 何 检查 是 否 两 个 数组 是 否 相 等 ? 

. 如 何 比 较 两 个 数组 ? 
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如 何 对 数组 进行 排序 和 搜索 里 面 的 元 素 ? 


Java Arrays/ 数 组 实例 -java 实例 教程 
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JavaH HA, 4 ja Date/Time - java 实 例 教程 


了 解 如 何在 Java 编 程 中 使 用 数据 和 时 间 。 下 面 是 最 常用 的 例子 : 
1. 如 何在 AM-PM 格 式 化 时 间 ? 

. 如 何在 (MMM) 格式 显示 月 份 名 称 ? 
. 如 何 显 示 小 时 和 分 钟 ? 

. 如 何 显示 当前 日 期 和 时 间 ? 

.如 何 显示 24 小 时 制 时 间 格 式 ? 

.如 何在 MMMM 格 式 格式 化 时 间 ? 

.如 何 格 式 化 秒 ? 

. 如 何在 short 格 式 显 示 的 月 份 名 称 ? 

.如何 显示 工作 日 的 名 称 ? 

10. 如 何 添加 时 间 日 期 ? 

11. 如 何以 不 同 的 国家 的 格式 显示 时 间 ? 
12. 如 何在 不 同 的 语言 显示 时 间 ? 

13. 如 何 滚动 小 时 和 月 份 ? 

14. 如 何 找到 本 年 度 的 星期 ? 

15. 如 何以 不 同 的 格式 显示 日 期 ? 
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Java 方 法 实例 -java 实例 教程 


学 习 如 何 使 用 Java 编 程 的 方法 。 下 面 是 最 常用 的 例子 : 


1. 
. 如 何 使 用 方法 重 载 用 于 打印 不 同类 型 的 数组 ? 
.如何 使 用 方法 求解 汉 诺 塔 问题 ? 

.如何 使 用 方法 计算 Fibonacci 数 列 ? 

. 如 何 使 用 方法 ， 用 于 计算 数 阶 乘 ? 

. 如 何 使 用 方法 重 载 继承 的 子 类 ? 

. 如 何 用 instanceof 关 键 字 来 显示 Object 类 ? 

. 如 何 使 用 break 跳 出 循环 的 方法 ? 

. 如 何 使 用 continue 在 方法 中 ?in a method? 

. 如 何在 方法 中 使 用 标签 ? 

.如何 使 用 枚 举 和 switch 语 句 ? 

. 如 何 使 枚 举 构 造 本 数 ， 实 例 变量 和 方法 ? 

. 如 何 使 用 和 foreach 循 环 对 数组 的 值 打印 ? 

. 如 何 使 一 个 方法 把 变量 lentgth 参 数 作为 输入 ? 
. 如 何方 法 重 载 义理 使 用 可 变 参 数 作为 输入 ? 
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如 何 重 载 的 方法 呢 ? 
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Java 文 件 操作 实例 -java 实例 教程 


了 解 如 何在 Java 编 程 中 使 用 文件 。 下 面 是 最 常用 的 例子 : 
1. 
. Java 如 何 创 建 一 个 新 的 文件 ? 

. Java 如 何 得 到 一 个 文件 的 最 后 修改 日 期 ? 
. Java 如 何在 指定 目录 下 创建 一 个 文件 ? 
. Java 如 何 检 查 一 个 文件 存在 和 与 否 ? 

. Java 如 何 使 一 个 文件 设置 为 只 读 ? 
:Java 如何 重 命名 一 个 文件 ? 

. Java 如 何 得 到 一 个 文件 的 大 小 CES)? 
. Java 如 何 改 变 一 个 文件 的 最 后 修改 时 间 ? 
. Java 如 何 创 建 一 个 临时 文件 ? 

Java 如 何 追 加 一 个 字符 串 到 现 有 文件 ? 
. Java 如 何 将 一 个 文件 复制 到 另 一 个 文件 ? 
. Java 如 何 删 除 一 个 文件 ? 

. Java 如 何 读 取 一 个 文件 ? 

. Java 如 何 写 入 一 个 文件 ? 
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Java 如 何 比较 两 个 文件 的 路 径 ? 


Java 文 件 操 作 实 例 -java 实例 教程 
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Java x i&fF 3: Bl - java 实例 教程 


了 解 Java 编 程 中 如 何 访问 目录 。 下 面 是 最 常用 的 例子 : 
1. 


oO Oo - Oo a A C N 


Java 如 何 递归 创建 目录 ? 


. Java 如 何 删 除 一 个 目录 ? 
. Java 如 何 获 得 一 个 目录 为 空 或 不 是 为 空 ? 
. Java 如 何 获 得 一 个 目录 是 否 为 隐藏 ? 
. Java 如 何 打印 目录 层次 结构 ? 

. Java 如 何 打印 目录 的 最 后 修改 时 间 ? 
.Java 如 何 得 到 一 个 文件 的 父 目录 ? 

. Java 如 何 搜索 一 个 目录 内 的 所 有 文件 ? 
. Java 如 何 获得 一 个 目录 的 大 小 ? 
.Java 如何 通 历 一 个 目录 ? 

.Java 如 何 找到 当前 工作 目录 ? 

. Java 如 何在 系统 中 显示 的 根 目录 ? 

. Java 如 何 搜索 目录 中 的 文件 ? 

.Java 如何 显示 所 有 目录 中 的 文件 ? 
.Java 如何 显示 在 一 个 目录 下 的 所 有 目录 ? 


Java 目 录 操 作 实例 -java 实例 教程 
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Java Exception/ X 35 


了 解 如 何在 Java 编 程 中 使 用 异常 。 下 面 是 最 


1. 
. Java 如 何 使 用 处 理 异常 层次 结构 ? 

. Java 如 何 使 用 处 理 异常 的 方法 ? 

. Java 如 何 使 用 处 理 运行 时 异常 ? 

. Java 如 何 使 用 处 理 空 栈 异常 ? 
.Java 如 何 使 用 catch 来 处 理 异 常 ? 
.Java 如 何 使 用 catch 来 处 理 异常 链 ? 
:Java 如何 使 用 重 载 方法 处 理 该 异常 ? 
Java 如 何人 处理 已 检查 异常 ? 

. Java 如 何 传递 参数 而 抛 出 检查 型 异常 ? 
.Java 如 何 处 理 多 个 异常 〈 如 除 以 0) ? 
:Java 如何 处 理 多 个 异常 (数组 越界 ) ? 
.Java 如 何 打印 异常 堆栈 ? 
.Java 如 何 使 用 线程 异常 ? 

. Java 如 何 创建 用 户 定义 的 异常 ? 
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Java 如 何 使 用 finally 块 用 于 捕获 异常 ? 


Java Exception/ 异 常 实例 - java 实 例 教程 
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常用 的 例子 : 
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Java 数 据 结构 实例 -java 实例 教程 


了 解 如 何在 Java 编 程 中 使 用 数据 结构 。 下 面 是 最 常用 的 例子 : 
1. 
.Java 如何 获得 链表 的 第 一 和 最 后 一 个 元 
. Java 如 何在 一 个 链表 第 一 个 和 最 

Java 如何 将 中 级 表达 式 转 换 为 后 级 表达 式 ^ 
. Java 如 何 实现 队列 Queue ? 

.Java 如何 使 用 堆栈 来 反 转 一 个 字符 串 ? 
. Java 如 何 搜索 一 个 链表 里 面 的 元 素 ? 

. Java 如 何 实现 栈 ? 

. Java 如 何 换 一 个 向 量 的 两 个 元 素 ? 

.Java 如 何 更 新 一 个 链表 ? 

:Java 如 何 从 一 个 向 量 得 到 最 大 的 元 素 ? 
. Java 如 何在 向 量 执 行 二 进 制 搜索 ? 

. Java 如 何 获得 LinkedList 的 一 个 元 素 ? 
. Javad fe] A it z Fh tl PRS SICH ? 
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Java 如 何 打印 n 个 数 的 总 和 ? 


Java 数 据 结 构 实例 -java 实例 教程 
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Java 集 合 实例 - java 实 例 教程 


了 解 如 何在 Java 编 程 中 使 用 集合 。 下 面 是 最 常用 的 例子 : 


1. 
.Java 如何 比较 集合 中 元 素 呢 ? 

.Java 如何 将 集合 转换 成 一 个 数组 ? 

.Java 如 何 打印 一 个 集合 ? 

. Java 如 何 使 一 个 集合 只 读 ? 

. Java 如 何 从 集合 中 删除 一 个 特定 的 元 素 ? 

.Java 如何 逆转 一 个 集合 ? 

. Java 如 何 打 乱 一 个 集合 中 的 元 素 ? 

. Java 如 何 获得 一 个 集合 的 大 小 ? 

.Java 如 何 循 环 HashMap 中 的 元 素 ? 
Java 如 何 使 用 不 同类 型 的 集合 ? 

. Java 如 何 使 用 枚 举 来 显示 哈 希 表 的 内 容 是 什么 ? 
. 如 何 从 Java 哈 希 表 获得 Set 视 图 的 键 ? 

.Java 如何 从 一 个 列表 List 中 找到 最 小 和 最 大 值 ? 
. Java 如 何 找 出 一 个 列表 的 子 列表 ? 

. Java 如 何 替 换 列表 中 的 一 个 元 素 ? 

. Java 如 何 旋转 列表 元 素 ? 
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Java 如 何 将 一 个 数组 转换 成 一 个 集合 ? 
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Java 网 络 编程 实例 -java 实例 教程 


学 习 如 何在 Java 编 程 中 修改 网 络 。 下 面 是 最 常用 的 例子 : 
1. 

.Java 如 何 获得 与 Web 服 务 器 连接 ? 

. Java 如 何 检 查 一 个 文件 服务 器 有 没有 被 修改 ? 

. Java 如 何 建立 一 个 多 线程 的 服务 器 ? 

. Java 如 何 从 服务 器 获取 文件 的 大 小 ? 

. Java 如 何 使 显示 信息 给 一 个 客户 机 的 套 接 字 ? 

Java 如何 使 一 个 srever 人 允许 连接 到 套 接 字 6123 ? 

. Java 如 何 获得 一 个 URL 的 部 分 ? 

.Java 如 何 获得 URL 连 接 的 日 期 ? 

Java 如何 读 取 和 下 载 一 个 网 页 ? 

. Java 如何 从 IP 地 址 找到 主机 名 ? 

.Java 如 何 确 定 IP 地 址 和 本 地 计算 机 的 主机 名 ? 

.Java 如 何 检 查 端口 是 否 被 使 用 ? 

. Java 如 何 找到 一 个 系统 的 代理 设置 ? 

. Java 如 何在 一 个 特定 的 端口 创建 一 个 socket ? 
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Java 如 何 将 主机 名 改 为 其 特定 的 IP 地 址 ? 


Java 网 络 编程 实例 -java 实例 教程 
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Java Applet: JJ -java 实例 教程 


了 解 如 何在 Java 编 程 中 使 用 Applets。 下 面 是 最 常用 的 例子 : 
1. 
. 如 何 使 用 Applet 的 横幅 ? 

.如 何 使 用 Applet 来 显示 时 钟 ? 

. 如 何 使 用 Applet 的 来 创建 不 同 的 形状 ? 

. 如 何 使 用 Applet 填 充 颜 色 形 状 ? 

.如 何 使 用 Applet 跳 转 链接 ? 

. 如 何在 Applet 创 建 一 个 事件 监听 器 ? 

. 如何 使 用 Applet 来 显示 图 像 ? 

.如 何 使 用 Applet 在 一 个 新 的 窗口 中 打开 链接 ? 
. 如 何 使 用 Applet 来 播放 声音 ? 

.如何 使 用 Applet 读 取 一 个 文件 ? 

. 如何 使 用 Applet 宇 入 一 个 文件 ? 

. 如 何在 JAVA 中 使 用 Swing 应 用 程序 applet ? 
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如 何 创 建 一 个 基本 的 小 程序 Applet ? 
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Java 简 单 的 图 形 用 户 界面 -GUI -java 实例 教程 


了 解 如 何在 Java 编 程 中 使 用 简单 的 GUI。 下 面 是 最 常用 的 例子 : 
1. 
. Java 如 何 使 用 GUI| 来 画 一 条 线 ? 

. Java 如 何在 新 的 框架 中 显示 的 消息 ? 

.Java 如 何 使 用 GUI 来 绘制 一 个 多 边 形 ? 
. Java 如 何在 一 个 矩形 显示 字符 串 ? 

.Java 如何 使 用 GUl 来 显示 不 同 的 形状 ? 
.Java 如何 使 用 GUI 绘制 实心 矩形 ? 

.Java 如何 创建 一 个 透明 的 光标 ? 

.Java 如 何 检查 抗 锯齿 功 能 启用 与 否 ? 
. Java 如 何在 框架 中 显示 的 颜色 ? 

.Java 如 何 使 用 显示 框架 饼 图 ? 

. Java 如 何 使 用 GUI 来 绘制 文字 ? 
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Java 如 何 显示 不 同 字体 的 文字 ? 
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Java JDBC 3: i| -java 实例 教程 


了 解 如 何在 Java 编 程 中 使 用 JDBC。 下 面 是 最 常用 的 例子 : 
1. JDBC 如 何 与 数据 库 建 立 连 接 ? 

. JDBC 如 何 创建 ， 编 辑 和 使 用 Java 的 alter table ? 

. JDBC 如 何 显示 数据 库 表 的 内 容 是 什么 ? 

. JDBC 如 何 更 新 ， 编 辑 和 删除 一 行 数 据 ? 

. JDBC 如 何 用 java 命 令 在 数据 库 中 搜索 ? 

. JDBC 如 何 用 java 命 令 排 序列 的 元 素 呢 ? 

. JDBC 如 何 从 多 个 表 中 将 数据 组 合 ? 

. JDBC 如 何在 Java 中 使 用 commit 语 句 ? 

. JDBC 如 何在 Java 编 写 的 语句 ? 

10. JDBC 如 何 设 置 和 回 滚 到 一 个 保存 点 ? 

11. JDBC 如 何 用 java SQL 38 4 Jj 4TH 4e ? 

12. JDBC 如 何在 java 使 用 不 同 的 行 方法 ? 

13. JDBC 如 何在 java 中 使 用 不 同 的 列 方法 列 ? 
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Java 正 则 表达 式 实 例 -java 实例 教程 


了 解 如 何在 Java 编 程 中 使 用 正则 表达 式 。 下 面 是 最 常用 的 例子 : 
1. 
. 如 何在 正则 表达 式 匹 配 重复 的 单词 ? 

. 如何 找到 一 个 单词 的 出 现 次 数 ? 

. 如何 知 道 一 个 字符 串 中 特定 单词 的 最 后 一 个 索引 ? 

.如何 打印 从 一 个 文件 中 所 有 给 定 模式 匹配 的 字符 串 ? 
. 如 何 去 除 空格 ? 

. 如 何在 列表 中 特定 的 模式 相 匹 配 电话 号 码 ? 

.如 何 计算 一 个 字符 串 的 一 组 词 ? 

.如 何在 一 个 字符 串 搜 索 一 个 特定 的 词 ? 

.如何 拆 分 一 个 正则 表达 式 ? 

.怎么 算 蔡 换 第 一 次 出 现 的 字符 串 ? 

. 如何 检查 日 期 是 否 为 正确 的 格式 ? 

. 如 何 验 证 电子 邮件 地 址 的 格式 ? 

. 如何 更 换 一 个 字符 串 的 所 有 匹配 ? 

. 如何 让 每 个 单词 的 第 一 个 字符 转 为 大 写 ? 
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如 何 重 置 一 个 正则 表达 式 的 模式 ? 
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JavaFX 教 程 


JavaFX 编程 语言 可 用 于 开发 互联 网 应 用 程序 (RIA) 。JavaFX 技 术 主 要 应 用 于 创建 
Rich Internet applications (RIAs) 。 当 前 的 JavaFX 包 括 JavaFX 脚 本 和 JavaFX 
Mobile (一 种 运营 于 行动 装置 的 操作 系统 ) ， 今 后 JavaFX 将 包括 更 多 的 产品 。 
JavaFX Script 编 程 语 言 ( 以 下 称 为 JavaFX) 是 一 种 声明 性 的 、 静 态 类 型 脚本 语 


Flo 


JavaFX 技 术 有 着 良好 的 前 景 ， 包 括 可 以 直接 调用 Java API 的 能 力 。 因 为 JavaFX 
Script 是 静态 类 型 ， 它 同 祥 具有 结构 化 代码 、 重 用 性 和 封装 性 ， 如 包 、 类 、 继承 和 
单独 编译 和 发 布 单元 ， 这 些 特 性 使 得 使 用 JavaFX 技 术 创 建 和 管理 大 型 程序 变 为 可 
a5 


Abo 


JavaFX 的 开发 者 很 先 同 让 用 户 发 布 自己 的 上 应用， 并 坚信 开源 和 社区 的 力量 。 但 当前 
的 JavaFX 版 本 是 在 评估 授权 下 发 布 的 ， 因 此 并 不 能 够 被 重新 发 布 。 你 当然 能 够 发 布 
自己 编写 的 基于 JavaFX 的 应 用 ， 但 不 能 够 和 JavaFX 一 起 捆绑 发 布 ， 并 需要 告 之 使 
用 者 : 需要 到 openjfx 项 目 站 点 下 载 JavaFX 二 进 制 代码 库 。 并 且 ， 由 于 正人 处 于 早期 
的 JavaFX 代 码 还 处 在 评估 授权 下 ， 因 此 它 不 能 用 于 商业 用 途 。 当 Sun 完 成 了 
JavaFX 的 商业 化 版 本 开发 后 ， 相 信 这 将 会 得 到 改变 。 


JavaFX 是 什么 ? - JavaFX 教 程 


这 个 教程 将 指导 您 设计 ， 编 写 并 部 署 一 个 联系 人 应 用 程序 。 应 用 程序 最 后 将 会 是 这 
个 样子 : 


la AddressApp = Oo 


File Statistics Help 


First Name Last Name Person Details 


Hans Muster 

Ruth Mueller 

Heinz nx First Name Anna 
Cornelia Meier Last Name Best 

Werner Meyer some street 
Lydia Kunz 


aa LZ Z e 
ostal Cod e 


Stefan Meier 1234 


Martin Mueller Birthday 21.02.1999 





"ITI HIT: 


你 将 学 到 什么 ? 


创建 并 启动 一 个 JavaFX 项 目 。 

使 用 Scene Builder 设计 Ulo 

构造 一 个 模型 - 视图 - 控制 器 (MVC) 模式 的 应 用 程序 。 
使 用 ObservableLists 来 自动 更 新 用 户 界 面 。 
使 用 TableView 来 响应 列表 中 的 选择 。 

创建 一 个 edit persons 的 自 定义 弹出 式 对 话 框 。 
验证 用 户 输入 。 

使 用 CSS 样式 化 一 个 JavaFX 应 用 程序 。 

使 用 XML 保存 数据 。 

在 用 户 配置 中 保存 最 后 一 次 打开 文件 的 路 径 。 
创建 JavaFX 的 统计 图 表 。 

部 署 一 个 JavaFX 到 本 机 软件 包 。 


这 是 相当 多 的 ! 所 以 ， 当 你 学 习 完 这 个 教程 后 ， 你 应 该 准备 好 使 用 JavaFX 构建 复 
条 的 应 用 程序 。 


如 何 使 用 这 个 教程 ? 


这 有 两 种 使 用 本 教程 两 种 方法 : 


e 最 大 化 学 习 的 通道 : 从 头 开 始 创 建 自己 的 JavaFX 项 目 。 

e 快速 通道 : 导入 教程 部 分 的 源 代码 到 你 的 IDE( 它 是 一 个 Eclipse 项 目 ， 但 是 你 
i ed IDE 例如 NetBeans 这 样 的 )。 然 后 再 通过 教程 来 
理解 代码 。 


现在 ， 我 希望 你 觉得 有 趣 ! 开始 第 一 部 分 : Scene Builder. 


JavaFX - Scene Builder - JavaFX 教 程 
第 一 部 分 的 主题 


e 开始 了 解 JavaFX 。 

e 创建 并 运行 一 个 JavaFX 项 目 。 

e 使 用 Scene Builder 来 设计 用 户 界面 。 

e 使 用 模型 - 视图 - 控制 器 (MVC) 模 式 构造 基础 的 应 用 。 


你 需要 准备 


e 最 新 的 Java JDK 8 (包含 JavaFX 8), 

e Eclipse 4.3 或 更 高 版 本 与 e(fx)clipse 插件 。 最 简单 的 方法 是 从 e(fx)clipse 网 站 
下 载 预 先 配置 的 发 行 版 本 。 作 为 一 种 各 选 你 可 以 使 用 一 个 update site 来 给 您 
的 Eclipse 安装 。 

e Scene Builder 2.0 或 更 高 。 


Eclipse 配置 


配置 Eclipse 所 使 用 JDK 和 Scene Builder : 
1. 打开 Eclipse 的 设置 并 找到 Java | Installed JREs 。 
2. 点 击 Add..., 选择 Standard VM 并 选择 你 安装 JDK 8 的 Directory 。 
3. 移 除 其 他 的 JREs 或 JDKs 从 而 使 JDK 8 成 为 默认 。 














e Preferences diio 
type filter text Installed JREs er ne Ne 
Install/Update ^ 
a Java Name Location Type Add... ss 
Appearance [V] = jdk1.8.0 (default) C:\Program FilesWava\j... Standard... Edit... 
Build Path = 
Code Style Duplicate... 
Compiler / 
Debug Remove 
Editor Search... 
Installed JREs = 
JUnit 
Properties Files Editc 
JavaFX 
Maven ^d T 
> 
(2) OK Cancel 











JiioaLeo 


4. 在 Java | Compiler 中 设置 Compiler compliance level 到 1.8, 
e Preferences 


type filter text Compiler 
Install/Update ^ 
4 Java 3 
JDK Compliance 
Appearance 
Build Path Compiler compliance level: 





Code Style v| Use default compliance settings 
Compiler 


Debug 
Editor 
Installed JREs 
JUnit 
Properties Files Editc 
JavaFX 
Maven Classfile Generation 














Model Editor x [V] Add variable attributes to generated class files (used by the debugger) 


< > ZA 


= B 


groovy 


Configure Project Specific Settings... A 


5. 在 JavaFX 中 指定 你 的 Scene Builder 可 执行 文件 的 路 径 。 


e Preferences 


type filter text JavaFX 


Install/Update ^ 


Jlioaicori 


4 Java SceneBuilder executable | CA Program Files (x86)\Oracle\JavaFX Scene Builder 2.0 JavaFX Scene Builder 2.0.exe | | Browse... 


Appearance 
Build Path 
Code Style 
Compiler 
Debug 
Editor 
Installed JREs 
JUnit 
Properties Files Editc 

JavaFX 

Maven 


"a 


Restore Defaults Apply 


> 





®© 





OK 





Cancel 





帮助 链接 


你 可 能 会 想 收藏 下 面 的 链接 : 


Java 8 API - Java 标准 类 的 文档 。 

JavaFX 8 API - JavaFX 类 的 文档 。 

ControlsFX API - ControlsFX project 额外 JavaFX 控件 的 文档 。 
Oracle's JavaFX Yiibai - Oracle 的 JavaFX 官方 教程 。 


一 切 就 绪 ， 让 我 们 开始 吧 ! 


JiioaLeo 


JavaFX - 创建 JavaFX 项 目 - JavaFX 教 程 


创建 一 个 新 的 JavaFX 项 目 


在 Eclipse( 已 安装 e(fx)clipse 的 ) 中 ， 点 击 File | New| Other... 并 选择 JavaFX 
Project, 指定 这 个 项 目的 名 字 (e.g. AddressApp) 并 点 击 Finish, 


如 果 application 包 被 自动 创建 ， 那 么 删除 它 和 它 的 内 容 。 


创建 包 


Model-View-Controller (MVC) 是 一 个 非常 重要 的 软件 设计 原则 。 按 照 MVC 模 式 可 以 
将 我 们 的 应 用 程序 划分 成 3 个 部 分 ， 然 后 为 这 每 一 部 分 建立 自己 的 包 (在 源 代码 文件 
夹 上 右键 ， 选择 新 建 | 包 ): 


e ch.makery.address - 放置 所 有 的 控制 器 类 (也 就 是 应 用 程序 的 业务 逻辑 ) 
e ch.makery.address.model - 放置 所 有 的 模型 类 
e ch.makery.address.view - 放置 所 有 界面 和 控件 类 


注意 : view 包 里 可 能 会 包含 一 些 控 制 器 类 ， 它 可 以 直接 被 单个 的 view 引 用 ， 我 们 叫 
它 视图 -控制 器 。 


创建 FXML 布 局 文件 


有 两 种 方式 来 创建 用 户 界面 ， 一 终 是 能 过 XML 文件 来 定义 ， 另 外 一 种 就 是 直接 通过 
java 代 码 来 创建 . 这 两 种 方式 你 都 可 以 在 网 上 搜 到 . 我 们 这 里 将 使 用 XML 的 方式 来 创 
建 大 部 分 的 界面 。 因 为 这 种 方式 将 会 更 好 的 将 你 的 业务 逻辑 和 你 的 界面 开 来 ， 以 保 
持 代 码 的 简洁 。 在 接 下 来 的 内 容 里 ， 我 们 将 会 介绍 使 用 Scene Builder( 所 见 即 所 得 ) 
来 编辑 我 们 的 XML 布局 文件 ， 它 可 以 避免 我 们 直接 去 修改 XML 文件 。 


在 view 包 上 右键 创建 一 个 新 FXML Document， 把 它 命 名 为 PersonOverview。 
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Select a wizard 


New 


Wizards: 


type filter text 





4 © JavaFX 
@ JavaFX Html Template 
JavaFX Library Project 
B JavaFX Product Configuration 


JavaFX Project 

&f | New FXGraph 

4> | New FXML Document 
> (g Classes 





@ IT En 


E - cam 
FXML File 一 
Create a new FXMIL File 二 























Source folder AddressApp/src | 
Package | chmakery.address.view | 
Name 

Root Element AnchorPane - javafx.scene.layout v | | Browse... 
Dynamic Root (fcroot) [ ] 

@ Me New 
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JavaFX - Scene Builder;z i+ F MA - JavaFX 教 程 


用 Scene Builder 来 设计 你 的 界面 


注意 : 你 可 以 下 载 这 部 分 教程 的 源码 ， 它 里 面 已 经 包含 了 设计 好 的 布局 文件 。 


在 PersonOverview.fxml 右键 选择 Open with Scene Builder， 那 么 你 将 会 在 打开 的 
Scene Builder 里 面 看 到 一 个 固定 的 界面 设计 区 域 (在 整个 界面 的 左边 )。 


1. 选中 这 个 界面 设计 区 域 ， 你 就 可 以 在 右边 的 属性 设置 栏 中 对 它 的 尺寸 进行 修改 : 





一 x 
Inspector . Or 
> Properties : AnchorPane 
v Layout : AnchorPane 
Interr 
ri | 口 | 
Padding 
Min Width USE COMPUTED SIZE hd 
Min Height USE COMPUTED SIZE M 
Pref Width > 
Pref Height 300 v 
Max Width USE COMPUTED SIZE v 
Max Height USE COMPUTED SIZE v 
Width 
Height 


yijsaj eds) 


2. 从 Scene Builder 的 左边 控件 栏 中 拖 搜 一 个 Splite Pane(Horizontal Flow) 到 界 
面 设计 区 域 ， 在 Builder 的 右边 视图 Aag 先 择 刚 添加 的 Pane， 在 弹出 的 右键 


Document 办 ~ 







Y Hierarchy 


> AnchorPane Cet 
Copy 


[£] AnchorPai 
[£] AnchorPal paste Into 
Duplicate 


Delete 


Select Parent 


È i j Use C tt joes ac 
菜单 中 选择 Fit to Parent 。 se Comput) ‘325,29 y) 


3. 同样 从 左边 的 控件 栏 中 拖 搜 一 个 p 到 SplitePane 的 左边 ， 选 择 这 个 

TableView( 而 不 是 它 的 列 ) 对 它 的 布局 进行 设置 ， 你 可 以 在 AnchorPane 中 对 这 

个 TableView 四 个 边 的 外 边 距 进行 调节 。 ym information on Layouts). 
Inspector Q 9- 
Properties : TableView 
v Layout : TableView 





Anchor Pane Constraints 





Jiioalco u 


4. 点 击 菜单 中 的 Preview | Show Preview in Window 可 以 预览 你 设计 好 的 界面 ， 
试 着 缩放 预览 的 界面 ， 你 会 发 现 TableView 会 随 着 窗口 的 缩放 而 变化 。 


5. 修改 TableView 中 的 列 名 字 ，"First Name" and "Last Name"， 在 右边 面板 中 的 


First Name Last Name 


Kein Content in Tabelle 





属性 设置 项 


6. 选择 这 个 TableView ， 在 右边 面板 中 将 它 的 Column Resize Policy 修改 成 
constrained-resize (同样 是 在 属性 设置 项 里 面 )。 确 保 这 个 TableView 的 列 能 够 


* Properties : TableView 





Editable 


Column Resize Policy | constrained-resize v 


Table Menu Button Vi.. 


= Fixed Cell Size a ufilasi ste 
铺 满 所 有 的 可 用 空间 。 | yijoaj go] 





.添加 一 个 Label 到 SplitePane 的 右边 部 分 ， 并 设置 它 的 显示 文字 为 "Person 
Details" (提示 : 你 可 以 通过 搜索 来 找到 Label 这 个 控件 )。 使 用 anchors 来 调节 
这 个 控件 的 布局 位 置 。 





Layout : Label 


First Name Last Name 


HC 


Kein Content in Tabelle 
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再 添加 一 个 GridPane SplitePane 的 右边 部 分 , 使 用 anchors 来 调节 这 个 控件 的 
“布局 位 置 























Kein Content in Tabelle 


. || Edit.. | | Delete 





isco 


9. TRE 照 下 面 的 图 添加 多 个 Lables 到 表格 中 去 。 


10. 注意 : 添加 一 个 控件 到 已 经 存在 的 行 里 面 去 ， 你 可 在 这 行 的 行 号 上 右键 选择 
"Add Row". 


First Name Last Name f 








First Name 


Kein Content in Tabelle 





Birthday 


| 














11. 添加 3 个 按钮 到 这 个 GridPane 的 下 面 。 小 提示 : 选择 这 3 个 按钮 ， 右 键 Wrap 


In| HBox， 那 么 它们 会 a e c. 你 可 能 需要 对 这 个 HBox 指 定 


一 个 spacing, 同 时 也 需要 设置 它们 的 右边 和 下 边 的 anchors。 


| IE E 
~ New.. Edit... Delete +} 
gl Jr ia 


PN Chana Diiledarit:lL EH nm avua CY £h o 
Javar A - ocene Dul Id Criz ir IMH - Javar AX 


12. 那么 基本 已 经 完成 了 界面 的 设计 ， 你 可 以 通过 Preview 来 预览 一 下 你 设计 的 界 
面 ， 同 时 缩放 一 下 窗口 来 检验 一 下 各 个 控件 的 位 置 是 否 正确 。 


First Name Last Name 


Kein Content in Tabelle 


PersonOverview.fxml - H 


Person Details: 


First Name Label 
Last Name Label 
Street Label 
City Label 
Postal Code Label 
Birthday Label 


New... Edit... Delete 
JiloaLcoz! 


JavaFX - 创建 主 应 用 程序 - JavaFX 教 程 


创建 主 应 用 程序 
我 们 需要 建立 一 个 新 的 布局 文件 PersonOverview.fxml 来 做 为 主 布局 文件 ， 它 
将 包含 一 个 菜单 栏 和 你 即将 要 显示 的 布局 。 


1. 在 view 包 里 面 创建 一 个 新 的 FXML Document 叫做 RootLayout.fxml ,这 一 
次 ， 选 择 BorderPane 做 为 它 的 根 节点 


e = O 
FXML File à 
Create a new FXML File 
— | 
Source folder AddressApp/src Browse... 
Package ch.makery.address.view Browse... 
Name RootLayout 
Root Element BorderPane - javafx.scene.layout v | | Browse... 











Dynamic Root (ficroot) 








JiioaLeco: 
2. 在 Scene Builder 中 打开 RootLayout.fxml 。 
3. 通过 设置 Pref Width 为 600 和 Pref Height 为 400 来 改变 这 个 BorderPane 的 尺 


Y Layout : BorderPane 
Min Width USE COMPUTED SIZE v 
Min Height USE_COMPUTED_SIZE v 


十 Pref Height 400 Jiiodieo u 
、 
o 





4. 在 最 项 上 添加 一 个 MenuBar， 先 不 去 给 这 个 菜单 添加 任何 的 功能 。 





File Edit Help 


Jiioai, co, 


The JavaFX Main Class 


现在 ， 我 们 需要 创建 一 个 main java class 用 来 加 载 RootLayout.fxml ， 同 时 添 
加 PersonOverview.fxml 到 RootLayout.fxm/ 中 去 ， 这 个 main class 将 做 为 我 们 
这 个 应 用 程序 的 入 口 。 


1. 在 工程 上 右键 选择 New | Other...， 然 后 选择 JavaFX Main Class. 


e New = E 
Select a wizard —<> 
Wizards: 


type filter text 





4 © JavaFX ^ 
@ JavaFX Html Template 
国 JavaFX Library Project 
B JavaFX Product Configuration 
C JavaFX Project 
of New FXGraph 
4> New FXML Document 











4 ( Classes 
CF Eclipse 3.x ViewPart Class 
& JavaFX Main Class <= v 
D < Back Next > Finish Cancel 


JiioaLco 


2. 将 这 个 class 命 名 为 ”MainApp ， 将 它 放 置 到 controller 包 中 ， 也 就 是 上 面 建 的 
ch.makery.address (注意 : 这 个 包 下 有 两 个 子 包 ， 分 别 是 view 和 
model )。 


TutorialsPoint Java 技术 教程 


e oO 


JavaFX Main Class 


Create a new JavaFX Main Class Q 


Source folder | AddressApp-Part-1/src | | Browse ... | 





Package | ch.makery.address 


— | Browse n 
Name MainApp cu 




















O) = Back | Next > | Cancel 


DIPPED 
你 可 能 注意 到 了 IDE 生 成 的 MainApp.java 继承 自 Application 同时 包含 了 两 


个 方法 ， 这 是 一 个 JavaFX 应 用 程序 的 最 基本 的 代码 结构 ， 这 里 最 重要 的 方法 是 


start(Stage primarystage) ， 它 将 会 在 应 用 程序 运行 时 通过 内 部 的 main 
方法 自动 调用 。 


正如 你 所 看 到 的 ， 这 个 start(...) 方法 会 接收 一 个 stage 类 型 的 参数 ， 下 面 
的 图 向 你 展示 了 一 个 JavaFX 应 用 程序 的 基本 结构 。 







Main 
Container 


Background 


scene for Ul Elements 


image Example UI 
View Elements 


Junoa,Lcorn) Image Source: 
http://www.oracle.com 


一 切 看 起 来 象 是 剧场 里 表演 : 这 里 的 stage 是 一 个 主 容器 ， 它 就 是 我 们 通常 所 认 
为 的 窗口 (有 边 ， 高 和 宽 ， 还 有 关闭 按钮 )。 在 这 个 Stage 里面， 你 可 以 放置 一 个 
Scene ， 当 然 你 可 以 切换 别 的 Scene ， 而 在 这 个 Scene 里 面 ， 我 们 就 可 以 放 
置 各 种 各 样 的 控件 。 


更 详细 的 信息 ， 你 可 以 参考 Working with the JavaFX Scene Graph. 


JavaFX - 创建 主 应 用 程序 - JavaFX 教 程 
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打开 MainApp.java ， 将 已 有 的 代码 替换 成 下 面 的 代码 : 


package ch.makery.address; 


import 


import 
import 
import 
import 
import 
import 


public 


java.io. IOException; 


javafx.application.Application; 
javafx.fxml.FXMLLoader; 
javafx.scene.Scene; 
javafx.scene.layout.AnchorPane; 
javafx.scene.layout.BorderPane; 
javafx.stage.Stage; 


class MainApp extends Application { 


private Stage primaryStage; 
private BorderPane rootLayout; 


QOverride 
public void start(Stage primaryStage) { 


} 


[frre 


* 


i 


this.primaryStage = primaryStage; 
this.primaryStage.setTitle("AddressApp"); 


initRootLayout(); 


showPersonOverview(); 


Initializes the root layout. 


public void initRootLayout() ( 


j 


try ( 
// Load root layout from fxml file. 


FXMLLoader loader - new FXMLLoader(); 
loader.setLocation(MainApp.class.getResource("view/Rool 
rootLayout = (BorderPane) loader.load(); 


// Show the scene containing the root layout. 
Scene scene - new Scene(rootLayout); 
primaryStage.setScene(scene); 
primaryStage.show(); 

} catch (IOException e) { 
e.printStackTrace(); 

} 


[ere 
* Shows the person overview inside the root layout. 
A 
public void showPersonOverview() { 
try { 


// Load person overview. 

FXMLLoader loader = new FXMLLoader(); 

loader .setLocation(MainApp.class.getResource("view/Per: 
AnchorPane personOverview = (AnchorPane) loader.load(), 


// Set person overview into the center of root layout. 
rootLayout.setCenter(personOverview); 

) catch (IOException e) { 
e.printStackTrace(); 

j 


j 


VASE 
* Returns the main stage. 
* @return 
“7 
public Stage getPrimaryStage() { 
return primaryStage; 
} 


public static void main(String[] args) { 
launch(args); 





代码 中 的 注释 会 给 你 一 些小 提示 ， 注 明代 码 的 含义 。 


如 果 你 现在 就 运行 这 个 程序 ， 那 么 你 将 会 看 到 和 这 篇 文章 开头 所 展示 的 图 片 那样 的 
界面 。 

你 有 可 能 遇见 的 问题 

如 果 你 的 应 用 程序 找 不 到 你 所 指定 的 fxm 布局 文件 ， 那 么 系统 会 提示 以 下 的 错 
误 : 

java.lang.IllegalStateException: Location is not set. 


你 可 以 检查 一 下 你 的 fxml 文件 名 是 否 拼写 错误 


如 果 还 是 不 能 工作 ， 请 下 载 这 篇 教程 所 对 应 的 源 代码 ， 然 后 将 源 代码 中 的 fxml 文 件 
E decis RBS 


JavaFX - Model 和 TableView - JavaFX 教 程 


先 来 看 看 我 们 要 实现 的 功能 : 
B AddressApp = 
File Edit Help 


First Name Last Name Person Details: 
Hans Muster k 
First Name 
Ruth Mueller 
s Last Name 
Heinz Kurz 


Cornelia Meier Street 


Werner Meyer City 


Lydi Kunz 
Lime zs Postal Code 
Anna Best 

Birthday 
Stefan Meier Ed 


Martin Mueller 





New... Edit... Delete 
JgioaLcou 


第 二 部 分 的 主题 
。 创 建 一 个 模型 类 。 


e 在 ObservableList 使 用 模型 类 。 
e 使 用 Controllers 在 TableView 上 显示 数据 。 


创建 模型 X, 
我 们 需要 一 个 模型 类 来 保存 联系 人 信息 到 我 们 的 通讯 录 中 。 在 模型 包 中 
( ch.makery.address.model ) 添加 一 个 叫 Person 的 类 。 Person 类 将 会 有 一 


些 变量 ， 名 字 ， 地 址 和 生日 。 将 以 下 代码 添加 到 类 。 在 代码 后 ， 我 将 解释 一 些 
JavaFX 的 细节 。 


Person.java 


package ch.makery.address.model; 
import java.time.LocalDate; 
import javafx.beans.property.IntegerProperty; 


import javafx.beans.property.ObjectProperty; 
import javafx.beans.property.SimpleIntegerProperty; 


import javafx.beans.property.SimpleObjectProperty; 
import javafx.beans.property.SimpleStringProperty; 
import javafx.beans.property.StringProperty; 


JERS 
* Model class for a Person. 
* 
* @author Marco Jakob 
A 
public class Person ( 


private final StringProperty firstName; 

private final StringProperty lastName; 

private final StringProperty street; 

private final IntegerProperty postalCode; 

private final StringProperty city; 

private final ObjectProperty<LocalDate> birthday; 


VASE 
* Default constructor. 
x 
public Person() ( 
this(null, null); 
} 


A a 
* Constructor with some initial data. 
* 
* @param firstName 
* @param lastName 
p 
public Person(String firstName, String lastName) { 
this.firstName - new SimpleStringProperty(firstName); 
this.lastName - new SimpleStringProperty(lastName); 


// Some initial dummy data, just for convenient testing. 

this.street - new SimpleStringProperty("some street"); 

this.postalCode = new SimpleIntegerProperty(1234); 

this.city - new SimpleStringProperty("some city"); 

this.birthday = new SimpleObjectProperty<LocalDate>(LocalDé 
j 


public String getFirstName() { 
return firstName.get(); 
} 


public void setFirstName(String firstName) { 
this.firstName.set(firstName); 
} 


public StringProperty firstNameProperty() { 
return firstName; 
} 


public String getLastName() { 
return lastName.get(); 
} 


public void setLastName(String lastName) { 
this.lastName.set(lastName); 
j 


public StringProperty lastNameProperty() { 
return lastName; 
} 


public String getStreet() { 
return street.get(); 
} 


public void setStreet(String street) { 
this.street.set(street); 
} 


public StringProperty streetProperty() { 
return street; 
j 


public int getPostalCode() { 
return postalCode.get(); 
j 


public void setPostalCode(int postalCode) { 
this.postalCode.set(postalCode); 
j 


public IntegerProperty postalCodeProperty() ( 
return postalCode; 
j 


public String getCity() ( 
return city.get(); 
j 


public void setCity(String city) { 
this.city.set(city); 
j 


public StringProperty cityProperty() { 
return city; 
j 


public LocalDate getBirthday() { 
return birthday.get(); 
j 


public void setBirthday(LocalDate birthday) { 
this.birthday.set(birthday); 
} 


public ObjectProperty<LocalDate> birthdayProperty() { 
return birthday; 
} 


} 


«| = 








解释 


e 在 JavaFX 中 ,对 一 个 模型 类 的 所 有 属性 使 用 Properties 是 很 常见 的 . 一 个 
Property 允许 我 们 , 打 个 比方 , 4 lastname 或 其 他 属性 被 改变 时 自动 收 到 
通知 , 这 有 助 于 我 们 保持 视图 与 数据 的 同步 ， 阅 读 Using JavaFX Properties 
and Binding 学 习 更 多 关于 Properties 的 内 容 。 
e LocalDate , 我们 使 用 了 birthday 类 型 , 这 是 一 个 新 的 部 分 在 Date and 
Time API for JDK 8. 


人 员 列表 


我 们 的 应 用 主要 管理 的 数据 是 一 群 人 的 信息 .让 我 们 在 MainApp 类 里 面 创建 一 个 
Person 对 象 的 列表 。 稍 后 其 他 所 有 的 控制 器 类 将 存 取 MainApp 的 核心 列表 。 


ObservableList 
我 们 义理 JavaFX 的 view classes 需 要 在 人 员 列 表 发 生 任 何 改变 时 都 被 通知 . 这 是 很 
重要 的 ,不 然 视 图 就 会 和 数据 不 同步 .为 了 达到 这 个 目的 ,JavaFX 引 入 了 一 些 新 的 集合 


在 这 些 集合 中 , 我 们 需要 的 是 ObservableList . 将 以 下 代码 增加 到 MainApp X 
的 开头 去 创建 一 个 新 的 ObservableList . 我们 也 会 增加 一 个 构造 器 去 创建 一 些 样 
本 数据 和 一 个 公共 的 getter 方 法 : 


MainApp.java 


// ... AFTER THE OTHER VARIABLES ... 


EXER 
* The data as an observable list of Persons. 
ns 
private ObservableList<Person> personData = FXCollections.obse! 


VASE 
* Constructor 
2/ 
public MainApp() { 
// Add some sample data 
personData.add(new Person("Hans", "Muster")); 
personData.add(new Person("Ruth", "Mueller")); 
personData.add(new Person("Heinz", "Kurz")); 
personData.add(new Person("Cornelia", "Meier")); 
personData.add(new Person("Werner", "Meyer")); 
personData.add(new Person("Lydia", "Kunz")); 
personData.add(new Person("Anna", "Best")); 
personData.add(new Person("Stefan", "Meier")); 
personData.add(new Person("Martin", "Mueller")); 


} 


[Pee 
* Returns the data as an observable list of Persons. 
* @return 
i 
public ObservableList<Person> getPersonData() { 
return personData; 
} 


Z/ 22> VHEOREST “OF MHE CLASS 2: 





The PersonOverviewController 


现在 我 们 终于 要 将 数据 加 入 到 表格 中 了 ,我 们 需要 一 个 控制 器 为 


了 PersonOverview.fxml ,. 


1. 在 view 包 下 创建 一 个 名 为 “PersonoverviewCcontroller,java 的 普通 java 类 
(我 们 需要 将 这 个 类 放 在 和 Personoverview.fxml 相同 的 包 下 , 不 然 
SceneBuilder 会 找 不 到 它 - 至 少 在 当前 的 版 本 ). 

2. 我 们 需要 增加 一 些 实例 变量 来 访问 表格 和 在 视图 中 的 标签 .这 些 属性 和 一 些 方 法 
rz 个 特殊 的 @FxML 注解 . set a A I BUE RIRU PSR CR 

必需 的 . 当 将 一 切 都 在 fxml 文 件 中 设置 好 之 后 , 应 用 程序 会 在 fxml 文 件 被 载 人 时 
人 真 充 这 这 些 变量 . 让 我 们 添加 以 下 的 代码 : 


Note: 记 住 要 使 用 javafx imports, 而 不 是 awt 和 swingl 


PersonOverviewController.java 


package ch.makery.address.view; 


import 
import 
import 
import 
import 
import 


public 


javafx.fxml.FXML; 
javafx.scene.control.Label; 
javafx.scene.control.TableColumn; 
javafx.scene.control.TableView; 
ch.makery.address.MainApp; 
ch.makery.address.model.Person; 


class PersonOverviewController { 


@FXML 

private TableView<Person> personTable; 

@FXML 

private TableColumn<Person, String> firstNameColumn; 
@FXML 

private TableColumn<Person, String> lastNameColumn; 


@FXML 

private Label firstNameLabel; 
@FXML 

private Label lastNameLabel; 
@FXML 

private Label streetLabel; 
@FXML 

private Label postalCodeLabel; 
@FXML 

private Label cityLabel; 
@FXML 

private Label birthdayLabel; 


// 


Reference to the main application. 


private MainApp mainApp; 


VASEN 


* The constructor. 
* The constructor is called before the initialize() method. 


A 
public PersonOverviewController() { 
} 
EXER 
* Initializes the controller class. This method is automatica: 
* after the fxml file has been loaded. 
x 
@FXML 


private void initialize() { 


// Initialize the person table with the two columns. 
firstNameColumn.setCellValueFactory(cellData -> cellData.ge 
lastNameColumn.setCellValueFactory(cellData -> cellData.gel 


EXER 
* Is called by the main application to give a reference back 1 
* 
* (param mainApp 
27 
public void setMainApp(MainApp mainApp) { 
this.mainApp - mainApp; 


// Add observable list data to the table 
personTable.setItems(mainApp.getPersonData()); 





可 能 需要 解释 一 下 这 段 代码 ; 


e. 所 有 fxml 文 件 需要 访问 的 属性 和 方法 必须 加 上 @FXML 注解 .实际 上 ,只 有 在 私 
有 的 情况 下 才 需 要 , 但 是 让 它们 保持 私有 并 且 用 注解 标记 的 方式 更 好 ! 

e initialize() 方法 在 fxml 文 件 完成 载 人 时 被 自动 调用 . 那 时 , 所 有 的 FXML 属 
性 都 点 已 被 初始 化 . 

e 我 们 在 表格 列 上 使 用 setcellvalueFactory(...) 来 确定 为 特定 列 使 
用 Person 对 象 的 某 个 属性 . BU. -&gt; 表示 我 们 在 使 用 Java 8 的 
Lambdas 特性 . ( 另 一 个 选择 是 使 用 PropertyValueFactory, 但 它 不 是 类 型 安全 
B4). 


连接 MainApp 和 PersonOverviewController 

setMainApp(...) 必须 被 MainApp 类 调用 . 这 让 我 们 可 以 访问 MainApp 对 象 
并 得 到 Persons 的 列表 和 其 他 东西 . 用 以 下 代码 替换 showPersonOverview() 75 
法 . 它 包 含 了 新 增 的 两 行 : 


MainApp.java - new showPersonOverview() method 


Ysa 
* Shows the person overview inside the root layout. 
ard 
public void showPersonOverview() { 
try { 
// Load person overview. 
FXMLLoader loader = new FXMLLoader(); 
loader .setLocation(MainApp.class.getResource("view/Person0\ 
AnchorPane personOverview = (AnchorPane) loader.load(); 


// Set person overview into the center of root layout. 
rootLayout.setCenter(personOverview); 


// Give the controller access to the main app. 
PersonOverviewController controller = loader.getControlleri| 
controller.setMainApp(this); 


} catch (IOException e) { 
e.printStackTrace(); 





FiView 5 Controlleri£4j 


我 们 快要 完成 了 ! 但 是 有 件 小 事 被 遗漏 了 : 至 今 没有 告诉 

PersonOverview.fxml 使 用 的 是 哪个 控制 器 以 及 元 素 与 控制 器 中 的 属性 的 对 应 关 
R. 

1. 使 用 SceneBuilder 打开 PersonOverview.fxml 


2. 打开 左边 的 Controller 组 选择 PersonOverviewController 作为 controller 





Document Or 
> Hierarchy 
Y Controller 


Controller class 
ch.makery.address.view.PersonOverviewController [-] 
Use fx:root construct 
fuid 4 Component 
Kein Content in Tabelle 


class Yiisgieou 


3. 在 Hierarchy 组 选择 TableView 并 选择 Code 组 籽 personTable 作为 
v Code : TableView 


Identity 
fxid personTable [-] 


„s Main 
fx:id JiioaLeco4) 


4. 对 列 做 相同 的 事 并 且 将 firstNamecolumn and lastNameColumn 分 别 作为 
fx:id . 


. 对 在 第 二 列 的 each label , 选择 对 应 的 fx:id. 







Y Code : Label 


E fxid firstNameLabe v 


a | 
Iam | 





Ie First Name —Label— 

-TF 
a Last Name tabel | YiigaLecow 
[pue 





1 m On Draa Detected 


6. 重要 事项 : 回 到 eclipse 并 且 refresh the entire AddressApp project (F5). 这 是 必 
要 的 因为 有 时 候 eclipse 并 不 知道 在 Scene Builder 中 作出 的 改变 . 


启动 应 用 程序 


当 你 现在 启动 了 你 的 应 用 ,你 应 该 看 到 了 类 似 这 篇 博客 开头 的 截图 的 程序 界面 . 


JavaFX - 用 户 交 互 - JavaFX 教 程 


r AddressApp = E 


File Edit Help 





First Name Last Name Person Details: 
Hans Muster : : 
First Name Lydia 
Ruth Mueller 
. . Last Name Kunz 
Heinz Kurz 
lei L Edit P E 
Cornelia Meier it Person 
Werner Meyer 
; First Name Lydia 
Lydia Kunz z ih 
Anna Best Last Name Kunz 
Stefan Meier 
Street some street 
Martin Mueller 
City some city 
Postal Code 1234 
Birthday 21.02.1999 


OK Cancel 
JiiouLt 





第 3 部 分 的 主题 : 


.在 表 中 反应 选择 的 改变 (TableView 中 )。 
. 增加 增加 ， 编 辑 和 删除 按钮 的 功能 。 

. 创建 自 定义 弹出 对 话 框 编 辑 人 员 。 

. 验证 用 户 输入 。 


BOND 一 


响应 表 的 选择 


显然 ， 我 们 还 没有 使 用 应 用 程序 的 右边 。 想 法 是 当 用 户 选择 表 中 的 人 员 时 ， 在 右边 
显示 人 员 的 详情 。 


首先 ， 让 我 们 在 PersonOverviewController 添加 一 个 新 的 方法 ， 帮 助 我 们 使 用 
单个 人 员 的 数据 填写 标签 。 


创建 方法 showPersonDetails(Person person) > WAMA, FAH 
FA setText(..) 方法 设置 标签 的 文本 为 个 人 的 详情 。 如 果 null 作 为 参数 传递 ， 所 有 
的 标签 应 该 被 清空 。 


PersonOverviewController.java 


jf ihe 
* Fills all text fields to show details about the person. 
* If the specified person is null, all text fields are cleared. 
* 
* @param person the person or null 
S 
private void showPersonDetails(Person person) { 
if (person != null) { 
// Fill the labels with info from the person object. 
firstNameLabel.setText(person.getFirstName()); 
lastNameLabel.setText(person.getLastName( )); 
streetLabel.setText(person.getStreet()); 
postalCodeLabel.setText(Integer.toString(person.getPostalC: 
cityLabel.setText(person.getCity()); 


// TODO: We need a way to convert the birthday into a Strir 
// birthdayLabel.setText(...); 
) else { 
// Person is null, remove all the text. 
firstNameLabel.setText(""); 
lastNameLabel.setText(""); 
streetLabel.setText(""); 
postalCodeLabel.setText(""); 
cityLabel.setText(""); 
birthdayLabel.setText(""); 





转换 生日 日 期 为 字符 串 


你 注意 到 我 们 没有 设置 birthday 到 标签 中 ， 因 为 它 是 LocalDate 类 型 ， 不 
是 String 。 我 们 首先 需要 格式 化 日 期 。 


在 几 个 地 方 上 我 们 使 用 LocalDate 和 String 之 间 的 转换 。 好 的 实践 是 创建 一 个 
带 有 static 方法 的 帮助 类 。 我 们 称 它 为 DateUtil ， 并 且 把 它 放 到 单独 的 包 
中 ， 称 为 ch.makery.address.util 。 


DateUtil.java 


package ch.makery.address.util; 


import java.time.LocalDate; 
import java.time.format.DateTimeFormatter; 
import java.time.format.DateTimeParseException; 


[rire 


* Helper functions for handling dates. 
* 
* @author Marco Jakob 
yf 
public class DateUtil { 


/** The date pattern that is used for conversion. Change as yot 
private static final String DATE_PATTERN = "dd.MM.yyyy"; 


/** The date formatter. */ 
private static final DateTimeFormatter DATE_FORMATTER = 
DateTimeFormatter.ofPattern(DATE PATTERN); 


Returns the given date as a well formatted String. The above 
{@link DateUtilZDATE PATTERN) is used. 


Qparam date the date to be returned as a string 
Qreturn formatted string 


+ FF ob FF Ro G 


ai 
public static String format(LocalDate date) { 
if (date == null) { 
return null; 


} 
return DATE FORMATTER. format (date); 
} 
yf uiis 
* Converts a String in the format of the defined {@link DateUt 
* to a {@link LocalDate} object. 
* 
* Returns null if the String could not be converted. 
* 
* (param dateString the date as String 
* @return the date object or null if it could not be converte« 
A 
public static LocalDate parse(String dateString) { 
try { 
return DATE FORMATTER.parse(dateString, LocalDate::fror 
) catch (DateTimeParseException e) { 
return null; 
} 
} 
[Pike 


* Checks the String whether it is a valid date. 

* 

* @param dateString 

* @return true if the String is a valid date 

tots 

public static boolean validDate(String dateString) { 

// Try to parse the String. 
return DateUtil.parse(dateString) != null; 








提示 : 你 能 通过 改变 DATE_PATTERN 修改 日 期 的 格式 。 所 有 可 能 的 格式 参考 


DateTimeFormatter. 


使 用 DateUtil 


现在 ， 我 们 需要 在 PersonOverviewController 的 showPersonDetails 方法 中 
使 用 我 们 新 建 的 Dateutil 。 使 用 下 面 这 样 蔡 代 我 们 添加 的 TODO o 


birthdayLabel.setText(DateUtil.format(person.getBirthday())); 


监听 表 选 择 的 改变 


为 了 当 用 户 在 人 员 表 中 选择 一 个 人 时 获得 通知 ， 我 们 需要 监听 改变 。 


在 JavaFX 中 有 一 个 接口 称 为 ChangeListener ， 带 有 一 个 方法 changed() 。 该 
方法 有 三 个 参数 : observable , oldValue 和 newValue 。 


我 们 使 用 Java 8 lambda 表 达 式 创建 这 样 一 个 ChangeListener 。 让 我 们 添加 一 些 
行 到 PersonOverviewController 的 initialize() 方法 中 。 现 在 看 起 来 是 这 样 
的 。 


PersonOverviewController.java 


@FXML 
private void initialize() { 
// Initialize the person table with the two columns. 
firstNameColumn.setCellValueFactory( 
cellData -» cellData.getValue().firstNameProperty()); 
lastNameColumn.setCellValueFactory( 
cellData -» cellData.getValue().lastNameProperty()); 


// Clear person details. 
showPersonDetails(null); 


// Listen for selection changes and show the person details whe 
personTable.getSelectionModel().selectedItemProperty().addList: 
(observable, oldValue, newValue) -> showPersonDetails(r 


j 


«| EE 











使 用 showPersonDetails(null) ， 我 们 重 设 个 人 详情 。 


使 用 personTable.getSelectionModel..，， 我 们 获得 人 员 表 

的 selectedItemProperty ， 并 且 添 加 监听 。 不 管 什 么 时 候 用 户 选 择 表 中 的 人 
员 ， 都 会 执行 我 们 的 lambda 表达 式 。 我 们 获取 新 选择 的 人 员 ， 并 且 把 它 传递 
给 showPersonDetails(...) 方法 。 


现在 试 着 运行 你 的 应 用 程序 ， 验 证 当 你 选择 表 中 的 人 员 时 ， 关 于 该 人 员 的 详情 是 否 
正确 的 显示 。 


如 果 有 些 事情 不 能 工作 ， 你 可 以 对 比 下 PersonOverviewControllerjava 中 


的 PersonOverviewController X 


删除 按钮 


我 们 的 用 户 接口 已 经 包含 一 个 删除 按钮 ， 但 是 没有 任何 功能 。 我 们 能 

在 SceneBuilder 中 的 按钮 上 选择 动作 。 在 我 们 控制 器 中 的 任何 使 用 @FXML (或 者 它 
是 公用 的 ) 注 释 的 方法 都 可 以 被 Scene Builderiz i], Alte, ik Fei 

在 PersonOverviewController 类 的 最 后 添加 一 个 删除 方法 。 


PersonOverviewControllerjava 


Jess 
* Called when the user clicks on the delete button. 
Sy 
@FXML 
private void handleDeletePerson() { 
int selectedIndex = personTable.getSelectionModel().getSelectec 
personTable.getItems().remove(selectedIndex); 


HE 于 


现在 ， 使 用 SceneBuilder 打 开 PersonoOverview.fxml 文件 ， 选 择 Delete 按 钮 ， 打 
开 Code 组 ， 在 On Actin 的 下 拉 菜 单 中 选择 handleDeletePerson o 





On Action 


* | handleDeletePerson [-] 


maar Perso 
On Drag Detected BEES] 


- initialize 


Jikoabe od 


错误 处 理 


如 果 你 现在 运行 应 用 程序 ， 你 应 该 能 够 从 表 中 删除 选择 的 人 员 。 但 是 ， 当 你 没有 在 
表 中 选择 人 员 时 点 击 删除 按钮 时 会 发 生 什么 呢 。 


这 里 有 一 个 ArrayIndexoutofBoundsException ， 因 为 它 不 能 删除 掉 索 引 为 -1 人 
WB. xal 1H getselectedIndex() 返回 ， 它 意味 着 你 没有 选择 项 目 。 


oa d uU OM IT 
。( 更 好 的 是 我 们 应 该 禁用 删除 按钮 ， 以 便 用 户 没有 机 会 做 错误 的 事情 )。 


我 们 添加 一 | 个 弹出 对 话 框 通 前 知 用 户 ， 你 将 需要 * 添 加 一 个 库 Dialogs : 


1. 下 载 controlsfx-8.0.6_20.jar (你 也 能 从 ControlsFX Website 中 获取 )。 BE: 
ControlsFX 必 须 是 8.0.6_20 以 上 版 本 才能 在 JDK8U20 以 上 版 本 工作 。 

在 项 目 中 创建 一 个 lib 子 目录 ， 添 加 controlsf jar 文 件 到 该 目录 下 。 
3. 添加 库 到 你 的 项 目 classpath 中 。 在 Eclipse 中 右 击 jar 文 件 | 选择 Build Path| Add 
to Build Path。 现 在 Eclipse 知 道 这 个 库 了 。 


4 Š AddressApp-Part-3 
(B src 
E JRE System Library [JavaSE- 1.8] 
=) JavaFX SDK 
= Referenced Libraries 


4 © lib 
Al build.fxbuild "Jibacon 
xt handleDeletePerson() 方法 做 一 些 修改 后 ， 不 管 什么 时 候 用 户 没 有 选择 表 中 


的 人 员 时 按 下 删除 按钮 ， 我 们 能 显示 一 个 简 EN HE. 
PersonOverviewController.java 


[Eira 
* Called when the user clicks on the delete button. 
n 
QFXML 
private void handleDeletePerson() { 
int selectedIndex = personTable.getSelectionModel().getSelectec 
if (selectedIndex >= 0) { 
personTable.getItems().remove(selectedIndex); 
) else { 
// Nothing selected. 
Dialogs.create() 
.title("No Selection") 
.masthead("No Person Selected") 
.message("Please select a person in the table.") 
. showWarning(); 





更 多 如 何 使 用 Dialog 的 示例 ， 请 阅读 JavaFX 8 Dialogs. 


新 建 和 编辑 对 话 框 


UtorialsPoint Java Tx A AlAs 


新 建 和 编辑 的 动作 有 点 工作 : 我 们 需要 一 个 自 定义 带 表单 的 对 话 框 (例如 : 新 的 
Stage)， 询 问 用 户 关 于 人 员 的 详情 。 











设计 对 话 框 
1. 在 view 包 中 创建 新 的 fxml 文 件 ， 称 为 PersonEditDialog.fxml 
^e - o Re 
FXML File à 
Create a new FXML File 
Source folder AddressApp-Part-3/src Browse... 
Package ch.makery.address.view Browse... | 
Name PersonEditDialog q 
Root Element | AnchorPane - javafx.scene.layout v | | Browse... 
Dynamic Root (fx:root) [ | 
Qa < Back Next » Cancel 
JiioaLco: 





2. 使 用 GridPan , Label, TextField 和 Button 创建 一 个 对 话 框 ， 如 下 











Cancel 


Jiibai.com 





所 示 : 
如 果 你 不 能 完成 工作 ， 你 能 下 载 这 个 PersonEditDialog.fxml. 


创建 控制 器 


为 对 话 框 创建 控制 器 PersonEditDialogController.java : 


| 
wy 


PersonEditDialogController.java 


package ch.makery.address.view; 


import javafx.fxml.FXML; 
import javafx.scene.control.TextField; 
import javafx.stage.Stage; 


import org.controlsfx.dialog.Dialogs; 


import ch.makery.address.model.Person; 
import ch.makery.address.util.DateUtil; 


Jf ott 
* Dialog to edit details of a person. 
* 
* (author Marco Jakob 
s 
public class PersonEditDialogController { 


@FXML 

private TextField firstNameField; 
@FXML 

private TextField lastNameField; 
@FXML 

private TextField streetField; 
@FXML 

private TextField postalCodeField; 
@FXML 

private TextField cityField; 
@FXML 

private TextField birthdayField; 


private Stage dialogStage; 
private Person person; 
private boolean okClicked = false; 


fois 
* Initializes the controller class. This method is automatica: 
* after the fxml file has been loaded. 
iA 

@FXML 

private void initialize() { 


} 


[ese 
* Sets the stage of this dialog. 
* 
* @param dialogStage 
A 
public void setDialogStage(Stage dialogStage) { 
this.dialogStage - dialogStage; 


} 


VASE 
* Sets the person to be edited in the dialog. 
* 
* (param person 
ey 
public void setPerson(Person person) { 
this.person = person; 


firstNameField.setText(person.getFirstName()); 
lastNameField.setText(person.getLastName()); 
streetField.setText(person.getStreet()); 
postalCodeField.setText(Integer.toString(person.getPostalC: 
cityField.setText(person.getCity()); 
birthdayField.setText(DateUtil.format(person.getBirthday(). 
birthdayField.setPromptText("dd.mm.yyyy"); 


j 


feit 
* Returns true if the user clicked OK, false otherwise. 
* 
* @return 
cA 
public boolean isOkClicked() { 
return okClicked; 
} 


[fe 
* Called when the user clicks ok. 
d 
@FXML 
private void handleOk() { 
if (isInputValid()) { 
person.setFirstName(firstNameField.getText()); 
person.setLastName(lastNameField.getText()); 
person.setStreet(streetField.getText()); 
person.setPostalCode(Integer.parseInt(postalCodeField.t 
person.setCity(cityField.getText()); 
person.setBirthday(DateUtil.parse(birthdayField.getTex! 


okClicked - true; 
dialogStage.close(); 


j 


AREA 
* Called when the user clicks cancel. 
ap 
@FXML 
private void handleCancel() { 
dialogStage.close(); 
} 


[frre 
* Validates the user input in the text fields. 
* 
* @return true if the input is valid 
ay 
private boolean isInputValid() { 
String errorMessage = ""; 


if (firstNameField.getText() == null || firstNameField.get™ 
errorMessage += "No valid first name!\n"; 


if (lastNameField.getText() == null || lastNameField.getTe> 
errorMessage += "No valid last name!\n"; 


if (streetField.getText() == null || streetField.getText() 
errorMessage += "No valid street!\n"; 
} 


if (postalCodeField.getText() == null || postalCodeField. ge 
errorMessage += "No valid postal code!\n"; 
) else { 
// try to parse the postal code into an int. 
try { 
Integer.parseInt(postalCodeField.getText()); 
} catch (NumberFormatException e) { 
errorMessage += "No valid postal code (must be an : 
j 


j 


if (cityField.getText() == null || cityField.getText().lent 
errorMessage += "No valid city!\n"; 
j 


if (birthdayField.getText() == null || birthdayField.getTe» 
errorMessage += "No valid birthday!\n"; 
) else { 
if (!DateUtil.validDate(birthdayField.getText())) { 
errorMessage += "No valid birthday. Use the format 
j 


j 


if (errorMessage.length() == 0) { 
return true; 
) else { 
// Show the error message. 
Dialogs.create() 
.title("Invalid Fields") 
.masthead("Please correct invalid fields") 
.message(errorMessage) 
. showError(); 
return false; 


} 
‘| ee 








关于 该 控制 器 的 一 些 事情 应 该 注意 : 


1. setPerson(.) 方法 可 以 从 其 它 调用 ， 用 来 设置 编辑 的 人 员 。 

2. 当 用 户 点 击 OK 按 钮 时 ， 调 用 handleok() 方法 。 首 先 ， 通 过 调 
用 isInputvalid() 方法 做 一 些 验证 。 只 有 验证 成 功 ，Person 对 象 使 用 输入 
的 数据 填充 。 这 些 修 改 将 直接 应 用 到 Person 对 象 上 ， 传 递 
给 setPerson(..) o 

3. 布尔 值 okClicked 被 使 用 ， 以 便 调 用 者 决定 用 户 是 否 点 击 OK 或 者 Cancel 按 
钮 。 


连接 视图 和 控制 器 
使 用 已 经 创建 的 视图 (FXML) 和 控制 器 ， 需 要 连接 到 一 起 。 


1. 使 用 SceneBuilder 打 开 PersonEditDialog.fxml 文件 

2. 在 左边 的 Controller 组 中 选择 PersonEditDialogController 作为 控制 器 类 
3. 设置 所 有 TextField 的 fx:id 到 相应 的 控制 器 字段 上 。 

4. 设置 两 个 按钮 的 onAction 到 相应 的 多 理 方法 上 。 


打开 对 话 框 
在 MainApp 中 添加 一 个 方法 加 载 和 显示 编辑 人 员 的 对 话 框 。 


MainApp.java 


JS 


* 
* 
* 
* 
* 


* 


2 


Opens a dialog to edit details for the specified person. If the 
clicks OK, the changes are saved into the provided person objeci 
is returned. 


Qparam person the person object to be edited 
Qreturn true if the user clicked OK, false otherwise. 


public boolean showPersonEditDialog(Person person) ( 


try { 
// Load the fxml file and create a new stage for the popup 
FXMLLoader loader = new FXMLLoader(); 
loader.setLocation(MainApp.class.getResource("view/PersonE¢ 
AnchorPane page = (AnchorPane) loader.load(); 


// Create the dialog Stage. 

Stage dialogStage = new Stage(); 
dialogStage.setTitle("Edit Person"); 
dialogStage.initModality(Modality.WINDOW MODAL); 
dialogStage.initOwner(primaryStage); 

Scene scene - new Scene(page); 
dialogStage.setScene(scene); 


// Set the person into the controller. 
PersonEditDialogController controller - loader.getControll: 
controller.setDialogStage(dialogStage); 
controller.setPerson(person); 


// Show the dialog and wait until the user closes it 
dialogStage.showAndWait(); 


return controller.isOkClicked(); 
} catch (IOException e) { 

e.printStackTrace(); 

return false; 





添加 下 面 的 方法 到 PersonOverviewController P, :4FH Pt FNewzkEditi£4n 
时 ， 这 些 方法 将 从 MainApp 中 调用 showPersonEditDialog(...) o 


PersonOverviewController.java 


J 
* Called when the user clicks the new button. Opens a dialog to et 
* details for a new person. 
WA 
@FXML 
private void handleNewPerson() { 
Person tempPerson = new Person(); 
boolean okClicked - mainApp.showPersonEditDialog(tempPerson); 
if (okClicked) { 
mainApp.getPersonData().add(tempPerson); 
} 


} 


Jp 
* Called when the user clicks the edit button. Opens a dialog to « 
* details for the selected person. 
4 
@FXML 
private void handleEditPerson() { 
Person selectedPerson = personTable.getSelectionModel().getSel: 
if (selectedPerson != null) { 
boolean okClicked = mainApp.showPersonEditDialog(selectedP: 
if (okClicked) { 
showPersonDetails(selectedPerson) ; 
j 


) else { 
// Nothing selected. 
Dialogs.create() 
.title("No Selection") 
.masthead("No Person Selected") 
.message("Please select a person in the table.") 
. showWarning(); 





在 Scene Builder 中 打开 PersonOverview.fxml 文件 ， 为 New 和 Edit 按 钮 的 On 
Action 中 选择 对 应 的 方法 。 

完成 ! 

现在 你 应 该 有 一 个 可 以 工作 的 Aaaress 应 用 。 应 用 能 够 添加 、 编 辑 和 删除 人 员 。 这 
里 甚至 有 一 些 文本 字段 的 验证 避免 坏 的 用 户 输入 。 

我 希望 本 应 用 的 概念 和 结构 让 开始 编写 自己 的 JavaFX 应 用 |! 玩 的 开心 。 
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第 4 部 分 主题 


e CSS 样 式 表 
e. 添加 应 用 程序 图 标 


CSSH XA 
ttJavaFXrh, MAERA A ARE th RA PEDI, SEM | 自 定义 Java 应 
用 界面 从 来 不 是 件 简单 的 事情 。 


在 本 教程 中 ， 我 们 闻 创 建 一 个 DarkTheme 主 题 ， 灵 感 来 自 于 Windows 8 Metro 设 
计 。 按 钮 的 CSS 来 至 于 Pedro Duque Vieia 的 博客 


熟悉 CSS 


如 果 你 希望 修饰 你 的 JavaFX 应 用 ， 通 常 你 应 该 对 CSS 有 一 个 基本 的 了 解 。 一 个 好 
的 起 点 是 


关于 CSS 更 多 JavaFX 指 定 信 息 : 
e - Oracle f 


e JavaFX CSS 参 考 - BA 


缺 省 的 JavaFX CSS 


在 JavaFX 8 中 缺 省 的 CSS 风 格 源码 是 一 个 称 为 modena.css 文件 。 该 CSS 文 件 可 
以 在 JavaFX jar 文 件 jfxrt.jar 中 找到 ， 它 位 于 Java 目 
录 /jdk1.8.x/jre/lib/ext/jfxrt.jar o 


解压 jfxrt.jar ， 你 应 该 能 
在 com/sun/javafx/scene/control/skin/modena/ 目录 下 找到 modena.css 。 


缺 省 的 样式 表 总 用 到 JavaFX 应 用 上 。 过 添加 自 定 义 样 式 表 ， 你 能 
ik modena.css Yid 


提示 : 查看 缺 省 的 CSS 文 件 能 够 让 你 模板 你 需要 覆盖 掉 那 些 样式 。 


添加 CSS 样 式 表 
添加 下 面 的 CSS 文 件 DarkTheme.css 到 view 包 中 。 


DarkTheme.css 


.background { 
-fx-background-color: #1d1d1d; 


} 
.label { 
-fx-font-size: 11pt; 
-fx-font-family: "Segoe UI Semibold"; 
-fx-text-fill: white; 
-fx-opacity: 0.6; 
} 


.label-bright { 
-fx-font-size: 11pt; 
-fx-font-family: "Segoe UI Semibold"; 
-fx-text-fill: white; 
-fx-opacity: 1; 
j 


.label-header { 
-fx-font-size: 32pt; 
-fx-font-family: "Segoe UI Light"; 
-fx-text-fill: white; 
-fx-opacity: 1; 

} 


.table-view { 
-fx-base: #1d1d1d; 
-fx-control-inner-background: #1d1d1d; 


-fx-background-color: #1d1d1d; 
-fx-table-cell-border-color: transparent; 
-fx-table-header-border-color: transparent; 
-fx-padding: 5; 

j 


.table-view .column-header-background { 
-fx-background-color: transparent; 
} 


.table-view .column-header, .table-view .filler { 

-fx-size: 35; 
-fx-border-width: © 0 1 0; 
-fx-background-color: transparent; 
-fx-border-color: 

transparent 

transparent 

derive(-fx-base, 8096) 

transparent; 
-fx-border-insets: 0 10 1 0; 


j 


.table-view .column-header .label { 
-fx-font-size: 20pt; 
-fx-font-family: "Segoe UI Light"; 
-fx-text-fill: white; 
-fx-alignment: center-left; 
-fx-opacity: 1; 

j 


.table-view:focused .table-row-cell:filled:focused:selected { 
-fx-background-color: -fx-focus-color; 
} 


.Split-pane:horizontal > .split-pane-divider { 
-fx-border-color: transparent #1didid transparent #1d1d1d; 
-fx-background-color: transparent, derive(£Z1d1d1d, 20%) ; 


j 


.split-pane { 
-fx-padding: 1 © 0 0; 
j 


.menu-bar { 
-fx-background-color: derive(£Z1d1did, 20%) ; 
j 


.context-menu { 
-fx-background-color: derive(#1id1id1d, 50%) ; 
j 


.menu-bar .label ( 
-fx-font-size: 14pt; 


-fx-font-family: "Segoe UI Light"; 
-fx-text-fill: white; 
-fx-opacity: 0.9; 

j 


.menu .left-container ( 
-fx-background-color: black; 
j 


.text-field { 
-fx-font-size: 12pt; 
-fx-font-family: "Segoe UI Semibold"; 


jf 
* Metro style Push Button 
* Author: Pedro Duque Vieira 
* http://pixelduke.wordpress.com/2012/10/23/jmetro-windows-8-contt 
I4 
.button ( 
-fx-padding: 5 22 5 22; 
-fx-border-color: #e2e2e2; 
-fx-border-width: 2; 
-fx-background-radius: 0; 
-fx-background-color: #1d1d1d; 
-fx-font-family: "Segoe UI", Helvetica, Arial, sans-serif; 
-fx-font-size: 11pt; 
-fx-text-fill: #d8d8d8; 
-fx-background-insets: 0000, 0, 1, 2; 
} 


.button:hover { 
-fx-background-color: #3a3a3a; 
} 


.button:pressed, .button:default:hover:pressed { 
-fx-background-color: white; 
-fx-text-fill: #1d1d1d; 

} 


.button:focused { 
-fx-border-color: white, white; 
-fx-border-width: 1, 1; 
-fx-border-style: solid, segments(1, 1); 
-fx-border-radius: 0, 0; 
-fx-border-insets: 1 1 1 1, 0; 

j 


.button:disabled, .button:default:disabled ( 
-fx-opacity: 0.4; 
-fx-background-color: #1d1d1d; 
-fx-text-fill: white; 


.button:default { 
-fx-background-color: -fx-focus-color; 
-fx-text-fill: #ffffff; 


} 


.button:default:hover { 
-fx-background-color: derive(-fx-focus-color, 30%); 


} 





x] 


现在 我 们 需要 把 CSS 添 加 到 我 们 的 场景 中 。 我 们 能 在 Java 代 码 中 编程 完成 ， 但 是 我 
们 将 使 用 SceneBUilder 来 添加 它 到 xm 文件 中 





添加 CSS 到 RootLayout.fxml 


1. 在 Scene Builder 中 打开 RootLayout.fxml 


2. 在 Hierarchy 视 图 中 选择 根 节 点 BorderPan 。 在 Properties 组 中 添 
加 DarkTheme.css 作为 样式 表 。 


Style Class 





Jiioaico:zi 


添加 CSS 到 PersonEditDialog.fxml 


1. 在 Scene Builder 中 打开 PersonEditDialog.fxml 。 选 择 根 节 
点 AnchorPane ， 并 且 在 Properties 组 中 选择 DarkTheme.css 作为 样式 表 。 


2. 背景 仍然 是 白色 的 ， 因 此 添加 样式 类 background 到 根 节 点 AnchorPane 。 


Siyle 


Style Class 
background ale 
Stylesheets 
@ | DarkTheme.css yijoss Lo 2 
1. 选择 OK 按钮 ， 在 Properties 视 图 中 选择 Default Button 单 选 框 。 这 将 修改 它 的 颜 
色 ， 当 用 户 输入 关键 词 时 ， 使 用 它 作为 缺 省 的 按钮 。 


添加 CSS 到 PersonOverview.fxml 


1. 在 Scene Builder 中 打开 文件 PersonOverview.fxml 。 在 Hierarchy 组 中 选择 
根 节点 AnchorPane 。 在 Properties 下 面 添加 DarkTheme.css 文件 作为 样式 
表 。 


2. 你 现在 应 该 已 经 看 到 一 些 修改 ， 表 和 按钮 是 黑色 的 。 来 自 modena.css 中 所 
有 类 样式 .table-view 和 .button 应 用 到 表 和 按钮 。 因 为 我 们 已 经 在 自 定 
义 CSS 中 重 定义 (因此 覆盖 掉 ) 一 些 样式 。 新 的 样式 自动 应 用 。 

3. 你 可 能 需要 调整 按钮 的 大 小 ， 以 便 显示 所 有 的 文本 。 

4. 选择 SplitPane 中 右边 的 AnchorPane 。 


Y Hierarchy 


> [E] AnchorPane 
> [[] SplitPane 
[1] AnchorPane 


E ae 
TableView 


] r . 
TableColumn First Name 





m ~ à 
TableColumn Last Name 


yiibai cor 


5. 进入 到 Properties 组 ， 并 且 选 择 background 作为 样式 表 。 背 景 现在 应 该 变 为 
JavaFX CSS 


Style 

Style Class 
mm background Jgiioaegi 
4V E, 


使 用 不 同样 式 的 标签 


现在 ， 在 左边 的 所 有 的 标签 都 有 相同 的 大 小 。 这 里 已 经 有 一 些 样式 定义 在 CSS 文 件 
中 ， 称 为 .label-header 和 .label-bright 。 我 们 将 使 用 更 多 样式 的 标签 
Label, 


1. 选择 Person Detail 标 签 ， 添 加 label-header 作为 样式 类 。 


Style Class 


abel-neader yiibaitádun 


2. 为 了 让 右边 栏 的 每 个 Label( 显 示 实 际 人 员 的 详情 )， 添 加 CSS 样 式 
Person Details 


First Name Label 





Last Name Label 
Street Label 
City Label 


Postal Code Label 


Birthday Label 


Nbalco 


类 label-bright 。 


添加 应 用 图 标 
现在 ， 在 标题 栏 和 任务 栏 中 ， 我 们 的 应 用 只 有 一 个 缺 省 图 标 : 


8 AddressApp 

使 用 自 定 义 图 标 看 起 来 更 好 了 。 

国 AddressApp 

图 标 文件 

获取 图 标的 一 个 可 能 地 方 是 lcon Finder。 我 下 载 了 一 个 地 址 本 的 图 标 . 


通常 在 你 的 AddressApp 项 目 中 创建 一 个 目录 称 为 resources， 在 它 中 子 目 录 称 为 
images。 把 你 选择 的 图 标 放 和 人 到 images 目 录 中 。 现 在 ， 你 的 目录 结构 应 该 看 上 去 
如 下 所 示 : 


4 B AddressApp-Part-4 


§ src 
E JRE System Library [JavaSE-1.8] 
=) Referenced Libraries 
& lib 
4 (> resources 
4 (& images 


区 address_book_32.png] 


HL buildfxbulld JILLA 
设置 图 标 到 场景 
为 了 给 你 场景 设置 图 标 ， 添 加 下 面 一 行 到 Mainapp.jar 的 start(..) ABA, 
MainApp.java 


this.primaryStage.getIcons().add(new Image("file:resources/images/: 
剧本 
现在 ， 整 个 start(.) 方法 看 上 去 应 该 是 这 样 的 。: 





public void start(Stage primaryStage) { 
this.primaryStage = primaryStage; 
this.primaryStage.setTitle("AddressApp"); 


// Set the application icon. 
this.primaryStage.getIcons().add(new Image("file:resources/imac 


initRootLayout(); 


showPersonOverview(); 


j 
站 | 
当然 ， 你 也 应 该 添加 图 标 到 人 员 编 辑 对 话 框 的 Stage 中 。 
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lx AddressApp - example-file.xml 
Edit Help 


New CiN Last Name Person Bae. 


Open... Ctrl+O Muster 
Mueller 


Save Ctrl+S d First Name 


urz 
SaveA 0 Meier Last Name 
Exit Meyer Street 
. Kunz 
Anna Best 
Stefan Meier 


Martin Mueller 


Delete 


"ITI HIT, 





第 5 部 分 的 主题 


e 持久 化 数据 为 XML 

e 使 用 JavaFX 的 FileChooser 

e 使 用 JavaFX 的 菜单 

e 在 用 户 设置 中 保存 最 后 打开 的 文件 路 径 。 


现在 我 们 的 地 址 点 用 程序 的 数据 只 保存 在 内 存 中。 每 次 我 们 关闭 应 用 程序 ， 数 据 将 
丢失 ， 因 此 是 时 候 开始 考虑 持久 化 存储 数据 了 。 


保存 用 户 设置 
Java 人 允许 我 们 使 用 Preferences 类 保存 一 些 应 用 状态 。 依 赖 于 操作 系 
统 ， Perferences 保存 在 不 同 的 地 方 (例如 : Windows 中 的 注册 文件 )。 


我 们 不 能 使 用 Preferences 来 保存 全 部 地 址 舌 。 但 是 它 人 允许 我 们 保存 一 些 简 单 的 
应 用 状态 。 一 件 这 样 事情 是 最 后 打开 文件 的 路 径 。 使 用 这 个 信息 ， 我 们 能 加 载 最 后 
应 用 的 状态 ， 不 管用 户 什 么 时 候 重 馈 应 用 程序 。 


下 面 两 个 方法 用 于 保存 和 检索 Preference。 添 加 它们 到 你 的 MainApp 类 的 最 后 : 


MainApp.java 


JS 
* Returns the person file preference, i.e. the file that was last 
* The preference is read from the OS specific registry. If no sucl 
* preference can be found, null is returned. 
* 
* @return 
S 
public File getPersonFilePath() { 
Preferences prefs = Preferences.userNodeForPackage(MainApp.cla: 
String filePath = prefs.get("filePath", null); 
if (filePath != null) { 
return new File(filePath); 
} else { 
return null; 
} 


} 


CS 
* Sets the file path of the currently loaded file. The path is pet 
* the OS specific registry. 


* 


* @param file the file or null to remove the path 
S 
public void setPersonFilePath(File file) { 
Preferences prefs = Preferences.userNodeForPackage(MainApp.cla: 
if (file != null) { 
prefs.put("filePath", file.getPath()); 


// Update the stage title. 

primaryStage.setTitle("AddressApp - " + file.getName()); 
} else { 

prefs.remove("filePath"); 


// Update the stage title. 
primaryStage.setTitle("AddressApp"); 





持久 性 效 据 到 XML 


为 什么 是 XML ? 


持久 性 数据 的 一 种 最 常用 的 方法 是 使 用 数据 库 。 数 据 库 通常 包含 一 些 类 型 的 关系 数 
据 ( 例 如 : 表 )， 当 我 们 需要 保存 的 数据 是 对 象 时 。 这 称 object-relational impedance 
mismatch。 匹 配对 象 到 关系 型 数据 库 表 有 很 多 工作 要 做 。 这 里 有 一 些 框架 帮助 我 们 
匹配 (例如 : Hibernate， 最 流行 的 一 个 )。 但 是 它 仍然 需要 相当 多 的 设置 工作 。 


对 于 简单 的 数据 模型 ， 非 常 容易 使 用 XML。 我 们 使 用 称 为 JAXB(Java Architecture 
for XML Binding) 的 库 。 只 需要 几 行 代码 ，JAXB 将 允许 我 们 生成 XML 输出 ， 如 下 所 
小: 


示例 XML 输出 


<persons> 
<person> 
<birthday>1999 -02-21</birthday> 
<city>some city</city> 
<firstName>Hans</firstName> 
<lastName>Muster</lastName> 
<postalCode>1234</postalCode> 
<street>some street</street> 
</person> 
<person> 
<birthday>1999 -02-21</birthday> 
<city>some city</city> 
<firstName>Anna</firstName> 
<lastName>Best</lastName> 
<postalCode>1234</postalCode> 
<street>some street</street> 
</person> 
</persons> 


使 用 JAXB 


JAXB 已 经 包含 在 JDK 中 。 这 意味 着 我 们 不 需要 包含 任何 其 它 的 库 。 


JAXB 提 供 两 个 主要 特征 : 编列 (marshal)Java 对 象 到 XML 的 能 力 ， 反 编列 
(unmarshal)XML 到 Java 对 象 。 


为 了 让 JAXB 能 够 做 转换 ， 我 们 需要 准备 我 们 的 模型 。 


准 各 JAXB 的 模型 类 


我 们 希望 保持 的 数据 位 于 MainApp 类 的 personData BH, JAXBEKH 
用 QxmlRootElement 注释 作为 最 顶层 的 

X, personData 是 ObservableList 类 ， 我 们 不 能 把 任何 注释 放 

到 ObservableList 上 上。 因此， 我 们 需要 创建 另外 一 个 类 ， 它 只 用 于 保 

存 Person 列表 ， 用 于 存储 成 XML 文 件 。 


创建 的 新 类 名 为 PersonListwrapper ， 把 它 放 入 
到 ch.makery.address.model 包 中 。 


PersonListWrapper.java 


package ch.makery.address.model; 
import java.util.List; 


import javax.xml.bind.annotation.XmlElement; 
import javax.xml.bind.annotation.XmlRootElement; 


JS 
* Helper class to wrap a list of persons. This is used for saving 
* list of persons to XML. 


* @author Marco Jakob 

a 
QXmlRootElement(name = "persons") 
public class PersonListWrapper { 


private List«Person» persons; 
QXmlElement(name = "person") 


public List«Person» getPersons() ( 
return persons; 
} 


public void setPersons(List<Person> persons) { 
this.persons = persons; 





+ a SS 
注意 两 个 注释 : 


e @XmlRootElement 定义 根 元 素 的 名 称 。 
e @XmlElement 一 个 可 选 的 名 称 ， 用 来 指定 元 素 。 


使 用 JAXB 污 写 数 据 


我 们 让 MainApp 类 负责 读 写 人 员 数 据 。 添 加 下 面 两 个 方法 到 MainApp.java 的 最 
后 : 


ffs 
* Loads person data from the specified file. The current person d: 
* be replaced. 
* 
* @param file 
uf 
public void loadPersonDataFromFile(File file) { 
try { 
JAXBContext context = JAXBContext 
.newInstance(PersonListwWrapper.class); 
Unmarshaller um = context.createUnmarshaller(); 


// Reading XML from the file and unmarshalling. 
PersonListWrapper wrapper = (PersonListWrapper) um.unmarsh: 


personData.clear(); 
personData.addAll(wrapper.getPersons()); 


// Save the file path to the registry. 
setPersonFilePath(file); 


} catch (Exception e) { // catches ANY exception 
Dialogs.create() 
-title("Error") 
.masthead("Could not load data from file:\n" + file 
. showException(e); 


} 


If ore 
* Saves the current person data to the specified file. 
* 
* @param file 
27 
public void savePersonDataToFile(File file) { 
try { 
JAXBContext context = JAXBContext 
.newInstance(PersonListwWrapper.class); 
Marshaller m = context.createMarshaller(); 
m.setProperty(Marshaller.JAXB FORMATTED OUTPUT, true); 


// Wrapping our person data. 
PersonListWrapper wrapper = new PersonListWrapper(); 
wrapper.setPersons(personData); 


// Marshalling and saving XML to the file. 
m.marshal(wrapper, file); 


// Save the file path to the registry. 
setPersonFilePath(file); 
) catch (Exception e) ( // catches ANY exception 
Dialogs.create().title("Error") 
.masthead("Could not save data to file:\n" + file.t 
. showException(e); 





编组 和 解 组 已 经 准备 好 ， 让 我 们 创建 保存 和 加 载 的 菜单 实际 的 使 用 它 。 


Ae EB SE. 3E o 


在 我 们 RootLayout.fxml 中 ， 这 里 已 经 有 一 个 菜单 ， ee 在 我 
们 添加 响应 到 菜单 中 之 前 ， 我 们 首先 创建 所 有 的 菜单 项 


在 Scene Builder 中 打开 RootLayout.fxml ， 从 library 组 中 拖 丰 必 要 的 菜单 


到 Hierarchy 组 的 MemuBar 中 。 创 建 New，Open...，Save，Save As... 和 Exit 菜 单 
项 。 





Document Or 


EI Hierarchy 


[Li] BorderPane 
回避 MenuBar 
Menu File 


Menultem New 


Menultem Ope 
Menultem Save 
Menultem Save As 
Menultem Exit 
© Menu Edit 
© Menu Help AR 


提示 : 使 用 Propeties 组 下 的 Acceljerator 设 置 ， 你 能 设置 菜单 项 的 快捷 键 。 


RootLayoutController 


为 了 义理 菜单 动作 ， 我 们 需要 创建 一 个 新 的 控制 器 类 。 在 控制 器 
包 ch.makery.address.view 中 创建 一 个 类 RootLayoutController 。 


添加 下 面 的 内 容 到 控制 器 中 : 


RootLayoutControllerjava 


package ch.makery.address.view; 
import java.io.File; 


import javafx.fxml.FXML; 
import javafx.stage.FileChooser; 


import org.controlsfx.dialog.Dialogs; 
import ch.makery.address.MainApp; 


Vas 
* The controller for the root layout. The root layout provides the 


* application layout containing a menu bar and space where other . 
* elements can be placed. 


* 


* @author Marco Jakob 


des 


public class RootLayoutController { 


// Reference to the main application 
private MainApp mainApp; 


fiia 


* Is called by the main application to give a reference back 1 


* 


* (param mainApp 


D 


public void setMainApp(MainApp mainApp) { 


j 
[frre 


this.mainApp = mainApp; 


* Creates an empty address book. 


dri 


QFXML 
private void handleNew() { 


j 
VASE 


mainApp.getPersonData().clear(); 
mainApp.setPersonFilePath(null); 


* Opens a FileChooser to let the user select an address book 1 


2 


@FXML 
private void handleOpen() { 


j 
ff re 


FileChooser fileChooser = new FileChooser(); 


// Set extension filter 

FileChooser.ExtensionFilter extFilter = new FileChooser.Exl 
"XML files (*.xml)", "5. xml 

fileChooser.getExtensionFilters().add(extFilter); 


// Show save file dialog 
File file = fileChooser.showOpenDialog(mainApp.getPrimaryS! 


if (file !- null) ( 
mainApp.loadPersonDataFromFile(file); 
j 


* Saves the file to the person file that is currently open. I1 
* open file, the "save as" dialog is shown. 


A 


QFXML 
private void handleSave() { 


File personFile = mainApp.getPersonFilePath(); 
if (personFile != null) { 
mainApp.savePersonDataToFile(personFile); 


} else { 
handleSaveAs(); 
j 


j 


ff ws 
* Opens a FileChooser to let the user select a file to save t« 
1 
QFXML 
private void handleSaveAs() ( 
FileChooser fileChooser - new FileChooser(); 


// Set extension filter 

FileChooser.ExtensionFilter extFilter = new FileChooser.Exl 
"XML files (*. xml)”, -"* xml" ys 

fileChooser.getExtensionFilters().add(extFilter); 


// Show save file dialog 
File file = fileChooser.showSaveDialog(mainApp.getPrimaryS! 


if (file !- null) ( 
// Make sure it has the correct extension 
if (!file.getPath().endsWith(".xm1")) { 
file = new File(file.getPath() + ".xml"); 


j 
mainApp.savePersonDataToFile(file); 
j 
j 
EXER 
* Opens an about dialog. 
7 
@FXML 


private void handleAbout() { 
Dialogs.create() 
.title("AddressApp") 
.masthead("About") 
.message("Author: Marco Jakob\nWebsite: http://code.mal 
. showInformation(); 


j 


VASE 
* Closes the application. 
we 
@FXML 
private void handleExit() { 
System.exit(0); 
} 








FileChooser 


注意 在 上 面 的 RootLayoutController 中 使 用 Filecooser 的 方法 。 首 先 ， 创 建 
新 的 Filechooser 类 对 象 的 ， 然 后 ， 添 加 扩展 名 过 滤器 ， 以 至 于 只 显示 
以 . Xml 结尾 的 文件 。 最 后 ， 文件 选择 器 显示 在 主 Stage 的 上 面 。 


如 果 用 户 没 有 选择 一 个 文件 关闭 对 话 框 ， 返 回 null 。 否 则 ， 我 们 获得 选择 的 文 
件 ， 我 们 能 传递 它 

到 MainApp 的 loadPersonDataFromFile(..) 或 savePersonDataToFile() 75 
法 中 。 


连接 fxml 视 图 到 控制 器 


1. 在 Scene Builder 中 打开 RootLayout.fxml 。 在 Controller 组 中 选 
择 RootLayoutController 作为 控制 器 类 。 


2. 回 到 Hierarchy 组 中 ， 选 择 一 个 菜单 项 。 在 Code 组 中 On Action 下 ， 应 该 看 到 所 
有 可 用 控制 器 方法 的 选择 。 为 每 个 菜单 项 选择 响应 的 方法 。 


On Acti 
UN Action 


口 


On Menu Validation handieAbout 


handleExit 
handleNew 
handleOpen 
handleSave 


handleSaveAs 
292),c0 1) 


3. 为 每 个 菜单 项 重复 第 2 步 。 
4. 关闭 Scene Builder， 并 且 在 项 目的 根 目 录 上 按 下 刷新 F5。 这 让 Eclipse 知道 在 
Scene Builder 中 所 做 的 修改 。 


连接 MainApp 和 RootLayoutController 


在 几 个 地 方 ， RootLayoutController 需要 引用 MainApp 类 。 我 们 也 没有 传递 
一 个 MainApp 的 引用 到 RootLayoutController 。 


打开 MainApp 类 ， 使 用 下 面 的 替代 initRootLayout() 方法 : 


aa 
* Initializes the root layout and tries to load the last opened 
* person file. 
ws 

public void initRootLayout() { 


try { 
// Load root layout from fxml file. 


FXMLLoader loader = new FXMLLoader(); 

loader.setLocation(MainApp.class 
.getResource("view/RootLayout.fxm1")); 

rootLayout = (BorderPane) loader.load(); 


// Show the scene containing the root layout. 
Scene scene - new Scene(rootLayout); 
primaryStage.setScene(scene); 


// Give the controller access to the main app. 
RootLayoutController controller - loader.getController(); 
controller.setMainApp(this); 


primaryStage.show(); 
) catch (IOException e) { 

e.printStackTrace(); 
} 


// Try to load last opened person file. 

File file = getPersonFilePath(); 

if (file != null) { 
loadPersonDataFromFile(file); 

} 


| 
注意 两 个 修改 : 一 行 给 控制 器 访问 MainApp 和 最 后 三 行 加 载 最 新 打开 的 人 员 文件 。 


测试 
做 应 用 程序 的 测试 驱动 ， 你 应 该 能 够 使 用 菜单 保存 人 员 数 据 到 文件 中 。 


当 你 在 编辑 器 中 打开 一 个 xml 文件 ， 你 将 注意 到 生日 没有 正确 保存 ， 这 是 一 个 空 
的 &lt;birthday/&gt; 标签 。 原 因 是 JAXB 不 只 奥 如 何 转换 LocalDate 到 
XML。 我 们 必须 提供 一 个 自 定义 的 LocalDateAdapter 定义 这 个 转换 。 


在 ch.makery.address.util 中 创建 新 的 类 ， 称 为 LocalDateAdapter ， 内 容 如 
下 : 


LocalDateAdapter.java 


package ch.makery.address.util; 
import java.time.LocalDate; 
import javax.xml.bind.annotation.adapters.XmlAdapter; 


Vie 
* Adapter (for JAXB) to convert between the LocalDate and the ISO 
* String representation of the date such as '2012-12-03'. 
* 
* @author Marco Jakob 
5 
public class LocalDateAdapter extends XmlAdapter«String, LocalDate: 


QOverride 

public LocalDate unmarshal(String v) throws Exception { 
return LocalDate.parse(v); 

} 


@Override 
public String marshal(LocalDate v) throws Exception { 
return v.toString(); 





然后 打开 Person.jar ， 添 加 下 面 的 注释 到 getBirthday() 方法 上 : 


@XmlJavaTypeAdapter(LocalDateAdapter.class) 
public LocalDate getBirthday() { 

return birthday.get(); 
} 


现在 ， 再 次 测试 。 试 着 保存 和 加 载 XML 文 件 。 在 重启 之 后 ， 它 应 该 自动 加 载 最 后 使 
用 的 文件 。 


它 如 何 工作 


让 我 们 看 下 它 是 如 何 一 起 工作 的 : 


1. 应 用 程序 使 用 MainApp 中 的 main(...) 方法 启动 。 

2. 调用 public MainApp() 构造 罚 数 添加 一 些 样 例 数 据 。 

3. 调用 MainApp BY start(..) 方法 ， 调 
用 initRootLayout() 从 RootLayout.fxml 中 初始 化 根 布局 。fxml 文 件 有 
关于 使 用 控制 器 的 信息 ， 连 接 视图 到 RootLayoutController 。 

4. MainApp 从 fxml 加 载 器 中 获取 RootLayoutController ， 传 递 自己 的 引用 到 
控制 器 中 。 使 用 这 些 引 用 ， 控 制 器 随后 可 以 访问 Mainapp 的 公开 方法 。 


5. 在 initRootLayout 方法 结束 ， 我 们 试 着 从 Perferences 中 获取 最 后 打开 
的 人 员 文 件 。 如 果 Perferences 知道 有 这 样 一 个 XML 文件 ， 我 们 将 从 这 个 
XML 文件 中 加 载 数据 。 这 显然 会 覆盖 掉 构 造 本 数 中 的 桩 例 数据 。 
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第 6 部 分 的 主题 

e 创建 一 个 统计 图 显示 生日 的 分 布 。 

生日 统计 

在 AddressApp 中 所 有 人 员 都 有 生日 。 当 我 们 人 员 庆 祝 他 们 生日 的 时 候 ， 如 果 有 一 
些 生日 的 统计 不 是 会 更 好 。 


我 们 使 用 柱状 图 ， 包 含 每 个 月 的 一 个 条 形 。 每 个 条 形 显示 在 指定 月 份 中 有 多 少 人 需 
要 过 生日 。 


统计 FXML 视 图 


1. 


5. 
6. 


在 ch.makery.address.view 包 中 我 们 开始 创建 一 
个 BirthdayStatistics.fxml ( 右 击 包 |Newlother..|New FXML Document) 








e E 
FXML File à 
Create a new FXML File 
= | 
Source folder AddressApp-Part-6/src Browse... 
Package ch.makery.address.view Browse... 
Name BirthdayStatistics | 
Root Element AnchorPane - javafx.scene.layout v | | Browse... 
Dynamic Root (fx:root) 











(?) < Back Next Cancel 


YijaaLeow 


. 在 Scene Builder 中 打开 BirthdayStatistics.fxml 文件 。 


. 选择 根 节点 AnchorPane 。 在 Layout 组 中 设置 Pref Width 7; 620, Pref Height 


为 450。 


. 添加 Barchart 到 AnchorPane 中 。 


右 击 Barchart 并 且 选 择 Fit to Parent, 
保存 fxml 文 件 ， 进 入 到 Eclipse 中 ，F5 刷 新 项 目 。 


在 我 们 返回 到 Scene Builder 之 前 ， 我 们 首先 创建 控制 器 ， 并 且 在 我 们 
的 MainApp 中 准备 好 一 切 。 


统计 控制 器 


在 view 包 ch.makery.address.view 中 创建 一 个 Java 类 ， 称 
A BirthdayStatisticsController.java v 


在 开始 解释 之 前 ， 让 我 们 看 下 整个 控制 器 类 。 


BirthdayStatisticsController.java 


package ch.makery.address.view; 


import java.text.DateFormatSymbols; 
import java.util.Arrays; 
import java.util.List; 


import 


import 
import 
import 
import 
import 
import 
import 


Fa 


java.util.Locale; 


javafx.collections.FXCollections; 
javafx.collections.ObservableList; 
javafx.fxml.FXML; 
javafx.scene.chart.BarChart; 
javafx.scene.chart.CategoryAxis; 
javafx.scene.chart.XYChart; 
ch.makery.address.model.Person; 


* The controller for the birthday statistics view. 


* 


* @author Marco Jakob 


2 
public 


class BirthdayStatisticsController { 


@FXML 
private BarChart<String, Integer> barChart; 


@FXML 
private CategoryAxis xAxis; 


private ObservableList<String> monthNames = FXCollections.obse! 


J 


* 


* 


p 


Initializes the controller class. This method is automatica: 
after the fxml file has been loaded. 


@FXML 
private void initialize() ( 


} 


// Get an array with the English month names. 

String[] months = DateFormatSymbols .getInstance(Locale.ENGI 
// Convert it to a list and add it to our ObservableList ol 
monthNames.addAll(Arrays.asList(months)); 


// Assign the month names as categories for the horizontal 
XAxis.setCategories(monthNames); 


ff hie 
* Sets the persons to show the statistics for. 
* 
* @param persons 
=y 
public void setPersonData(List<Person> persons) { 
// Count the number of people having their birthday in a sy 
int[] monthCounter - new int[12]; 
for (Person p : persons) { 
int month - p.getBirthday().getMonthValue() - 1; 
monthCounter [month]++; 


XYChart.Series<String, Integer» series = new XYChart.Serie: 


// Create a XYChart.Data object for each month. Add it to 1 
for (int i = 0; i < monthCounter.length; i++) { 
series.getData().add(new XYChart.Data<>(monthNames. get 








} 
barChart.getData().add(series); 
} 
} 
«| I 
控制 器 如 何 工作 


1. 控制 器 需要 从 FXML 文 件 中 访问 两 个 元 素 : 


o barchar : 它 有 string 和 Integer 类 型 。 String 用 于 x 轴 上 的 月 
份 ， Integer 用 于 指定 月 份 中 人 员 的 数量 。 
o xAxis : 我 们 使 用 它 添加 月 字符 串 
2. initialize() 方法 使 用 所 有 月 的 列表 填充 x-axis 。 


3. setPersonData(..) 方法 将 由 MainApp 访问 ， 设 置 人 员 数 据 。 它 志 历 所 有 人 
员 ， 统 计 出 每 个 月 生日 的 人 数 。 然 后 它 为 每 个 月 添加 XYchart .Data 到 数据 
序列 中 。 每 个 XYchart .Data 对 象 在 图 表 中 表示 一 个 条 形 。 


连接 视图 和 控制 器 
1. 在 Scene Builder 中 打开 BirthdayStatistics.fxml 。 


. 在 Controller 组 中 设置 BirthdayStatisticsController 为 控制 器 。 


选择 BarChart ， 并 且 选 择 barchar 作为 fx:id 属 性 (在 Coae 组 中 ) 


Boo N 


. 选择 CategoryAxis ， 并 且 选 择 xaxis 作为 fx:id 属 性 。 


CategoryAxis 


= iv 
= , h - 





5. 你 可 以 添加 一 个 标题 给 Barchar (在 Properties 组 中 ) 进 一 步 修饰 。 


连接 View/Controller 和 MainApp 


我 们 为 生日 统计 使 用 与 编辑 人 员 对 话 框 相同 的 机 制 ， 一 个 简单 的 弹出 对 话 框 。 
添加 下 面 的 方法 到 MainApp 类 中 


hs 
* Opens a dialog to show birthday statistics. 
i 
public void showBirthdayStatistics() { 
try { 


// Load the fxml file and create a new stage for the popup 
FXMLLoader loader = new FXMLLoader(); 
loader.setLocation(MainApp.class.getResource("view/Birthda 
AnchorPane page - (AnchorPane) loader.load(); 

Stage dialogStage - new Stage(); 
dialogStage.setTitle("Birthday Statistics"); 
dialogStage.initModality(Modality.WINDOW MODAL); 
dialogStage.initOwner(primaryStage); 

Scene scene - new Scene(page); 

dialogStage.setScene(scene); 


// Set the persons into the controller. 
BirthdayStatisticsController controller = loader.getContro- 
controller.setPersonData(personData); 


dialogStage.show(); 


} catch (IOException e) { 
e.printStackTrace(); 





一 切 设 置 完 半 ， 但 是 我 们 没有 任何 未 西 实际 上 调用 新 
的 showBirthdayStatistics() 方法 。 幸 运 的 是 我 们 已 经 
在 RootLayout.fxml 中 有 一 个 菜单 ， 它 可 以 用 于 这 个 目的 。 


显示 生日 统计 菜单 


在 RootLayoutController 中 添加 下 面 的 方法 ， 它 将 义理 显示 生日 统计 菜单 项 的 
用 户 点 击 。 


JE 
* Opens the birthday statistics. 
S 

@FXML 

private void handleShowBirthdayStatistics() { 
mainApp.showBirthdayStatistics(); 

} 


现在 ， 使 用 Scene Builder 打 开 RootLayout.fxml 文件 。 创 建 Staticstic 菜单 ， 
带 有 一 个 Show Statistcs MenuItem : 


Help 


Show Statistics 





选择 Show Statistics MenuItem ， 并 且 选 择 handleShowBirthdayStatistics 作 
为 On Action (在 Code 组 中 )。 


On Action 


* | handleShowBirthdayStatistics v 


进入 到 Eclipse， 刷 新 项 目 ， 测 试 它 。 


JavaFX Chart 的 更 多 信息 


更 多 信息 的 一 个 好 地 方 是 官方 Oracle 教 程 ， 使 用 JavaFX Chart. 


JavaFX - 部 署 - JavaFX 教 程 


ue Setup - AddressApp = 2 
Ready to Install 
Setup is now ready to begin installing AddressApp on your computer. 


Click Install to continue with the installation. 


Install Cancel 


JiloaLeco: 


我 想 已 经 写 到 本 教程 系列 的 最 后 一 部 分 了 ， 应 该 教 你 如 何 部 署 (例如 : 打包 和 发 
布 )AddressApp 


第 7 部 分 的 主题 


e 使 用 e(fx)clipse 本 地 包 (Native Package) 部 署 我 们 的 JavaFX 应 用 程序 。 


什么 是 部 署 


部 署 是 打包 和 发 布 软件 给 用 户 的 过 程 。 这 是 软件 开发 的 关键 部 分 ， 因 为 它 是 第 一 次 
与 使 用 我 们 软件 的 用 户 交 流 。 


Java 的 广告 口号 是 编写 一 次 ， 到 处 运行 ， 这 说 明 Java 语 言 的 跨 平 台 好 处 。 理 想 情况 
下 ， 这 意味 着 我 们 Java 应 用 可 以 运行 在 任何 装 各 有 JVM 的 设备 上 。 在 过 去 ， 安 装 
Java 应 用 程序 的 用 户 经 验 不 总 是 平滑 的 。 如 果 用 户 在 系统 中 没有 要 求 的 Java 版 本 ， 
它 必须 首先 直接 安装 它 。 这 导致 有 些 困难 ， 例 如 ， 需 要 管理 员 权 限 ，Java 版 本 之 间 
的 兼容 问题 等 等 。 幸运 的 是 ，JavaFX 提 供 新 的 部 署 选 项 称 为 本 地 打包 (也 称 为 自 包 
含 应 用 程序 包 )。 一 个 本 地 包 是 一 个 包含 你 的 上 应用 代码 和 平台 指定 的 Java 运 行 时 的 
打包 程序 。 Oracle 提 供 的 官方 JavaFx 文 档 包 含 一 个 所 有 JavaFX 部 署 选 项 的 扩展 指 
Bj. 在 本 章节 中 ， 我 们 教 你 如 何 使 用 Eclipse 和 e(fx)clipse 插 件 创建 本 地 包 。 


创建 本 地 包 


目标 是 在 用 户 的 计算 机 上 单个 目录 中 创建 一 个 自 包含 的 应 用 程序 。 下 面 是 
AddressApp 应 用 看 起 来 的 样子 (在 Windows 上 ): 


4 |. bundles " 
app 
4 出 ee 出 runtime 
4 4 
D d a| AddressApp.exe 
Jk libs 


\® AddressApp.ico 
|» resources 


4 ài runtime 


d jre JiioaLeor 
app 目录 包含 我 们 的 应 用 数据 和 runtime 目录 (包含 平台 相关 的 Java 运 行 时 )。 
为 了 让 用 户 更 加 舒适 ， 我 们 也 提供 一 个 安装 器 : 


e Windows 下 的 exe 文件 安装 器 
e MacOS 下 的 dmg ( 拖 放 ) 安 装 器 。 


E(fx)clipse 插 件 会 帮助 我 们 生成 本 地 包 和 安装 器 。 


第 1 步 编辑 build.fxbuild 


E(fx)clipse 使 用 build.fxbuild 文件 生成 一 个 被 Ant 编 译 工具 使 用 的 文件 。( 如 果 
你 没有 一 个 build.fxbuid 文件 ， 在 Eclipse 中 创建 一 个 新 的 Java FXRA, FAH 
贝 生成 的 文件 过 来 。 


1. 从 项 目的 根 目 录 下 打开 build.fxbuild 。 


2. 填写 包含 一 个 星 号 的 字段 。 对 于 MacOS : 在 应 用 程序 标题 中 不 能 使 用 空格 ， 
为 好 像 会 产生 问题 。 
& FX Build Configuration G 
v Build & Package Properties v Building Exporting 
The following properties are needed to build the JavaFX-Application 
To generate build instructions and export the project: 
































Build Directory": S(project]/build Filesystem... | Workspace... 
* Generate ant build.xml! only 
Vendor name": makery.ch 一 一 一 
* Generate ant build.xml and run 
Application title*: AddressApp <= 
Application version*: | 1.0 < 一 一 一 
Application class*: ch.makery.address.MainApp Browse... 
Preloader class: Browse ... 
Splash: Browse ... 
Manifest-Attributes: n Vahe 
Add... 
Remove 
Toolkit Type: v 
Packaging Format: | exe v 
automatic Proxy Resolution — 
Convert CSS into binary form 
Enable verbose build mode (Not recommended) yiibai con 











3. 在 Windows 下 Packaging Format 选 择 exe ，MacOS 下 选择 dmg , Linux Fit 
择 rpm 
4. 点 击 Generate ant build.xml only 的 连接 (在 右边 可 以 找到 )。 


v Building Exporting 


To generate build instructions and export the project: 


* Generate ant build.xml only Me — 


è Generate ant build.xml and run 


5. 验证 是 否 创 建 一 个 新 的 build 目录 和 文件 build.xml 


第 2 步 添加 安 装 程序 的 图 标 


我 们 希望 安装 程序 有 一 些 好 看 的 图 标 : 


e AddressApp.ico 安装 文件 图 标 
AddressApp-setup-icon. bmp £e 安装 启动 画面 图 标 
AddressApp.icns Mac 安 EE 


在 build 目录 下 创建 下 面 的 子 目录 : 


o build/package/windows (只 用 于 Windows) 
o build/package/macos (只 用 于 macos) 
拷贝 上 面 的 相关 图 标 到 这 些 目录 中 ， 现 在 它 应 该 看 起 来 如 下 所 示 : 


4 & build 
4 © package 

4 (= macosx 
=| AddressApp-volume.icns 
=| AddressApp.icns 

4 © windows 
| AddressApp-setup-icon.bmp 
|. | AddressApp.ico 

$ build.xml Jiioaicor 


e 重要 : 图 标的 名 称 必 须 精 确 匹 配 build.fxbuild 中 指定 的 Application 的 标题 
名 : 


o YourAppTitle.ico 
o YourAppTitle-setup-icon.bmp 
o YourAppTitle.icns 


第 3 步 添加 资源 
我 们 的 resources 目录 不 能 自动 拷贝 。 我 们 必须 手动 添加 它 到 build 目 录 下 : 


1. 在 build 目录 下 创建 下 面 的 子 目录 : 
o build/dist 
2. WR resources 目录 (包含 我 们 应 用 的 图 标 ) 到 build/dist . 
4 © build 
4 (z dist 


(& package 
3) build.xml 


第 4 步 编辑 build.xml 包 含 图 标 


E(fx)clipse 生 成 的 build/build.xml 文件 (准备 使 用 Ant 执 行 )。 我 们 的 安装 器 图 标 
和 资源 图 像 不 能 正常 工作 。 


当 e(fx)clipse 没 有 告诉 它 包含 其 它 资 源 ， 例 如 resources 目录 和 上 面 添加 的 安装 
文件 图 标 时 ， 我 们 必须 手动 编辑 build.xml 文件 。 


打开 build.xml 文件 ， 找 到 路 径 fxant 。 添 加 一 行 到 ${basedir} (将 让 我 们 安 
装 器 图 标 可 用 )。 


build.xml - 添加 "basedir" 


<path id="fxant"> 
<filelist> 
«file name="${java.home}\..\lib\ant-javafx.jar"/> 
«file name="${java.home}\lib\jfxrt.jar"/> 
«file name="${basedir}"/> 
</filelist> 
</path> 


找到 块 fx:resources id-"appRes" ， 文 件 的 更 下 面 位 置 。 为 resources 添加 
12 


build.xml - 添加 "resources" 


<fx:resources id="appRes"> 
«fx:fileset dir="dist" includes="AddressApp.jar"/> 
«fx:fileset dir="dist" includes="libs/*"/> 
<fx:fileset dir="dist" includes="resources/**"/> 
«/fx:resources» 


有 时 候 ， 版 本 数 不 能 添加 到 fx:application 中 ， 使 得 安装 器 总 是 缺 省 的 版 
本 1.0 (在 注释 中 很 多 人 指出 这 个 问题 )。 为 了 修复 它 ， 手 动 添加 版 本 号 (感谢 Marc 
找到 解决 办 法 )。 解决 ): 


build.xml - 添加 "version" 


«fx:application id="fxApplication" 
name="AddressApp" 
mainClass="ch.makery.address.MainApp" 
version="1.0" 

/> 


现在 ， 我 们 已 经 能 够 使 用 ant 编 译 运行 build.xml 了 。 这 将 会 生成 一 个 可 运行 的 项 
目 jar 文 件 。 但 是 我 们 希望 更 进一步 ， 创 建 一 个 很 好 的 安装 器 。 


第 5 步 (Windows) - Windows exe 安 装 器 


AddressApp.exe 
a AddressApp Setup 
makery.ch 


使 用 Inno Setup， 我 们 能 为 我 们 的 应 用 程序 创建 一 个 单独 .exe 文件 的 Windows 安 
装 器 。 生 成 的 ,exe 执行 用 户 级 别 的 安装 (无 需 管理 员 权 限 )。 也 创建 一 个 快捷 方式 
(菜单 和 桌面 )。 


1. 下 载 Inno Setup 5 以 后 版 本 ， 安 装 Inno 程 序 到 你 的 计算 机 上 。 我 们 的 Ant 脚 本 将 
使 用 它 自动 生成 安装 器 。 


2. 告诉 Windows Inno 程 序 的 安装 路 径 ( 例 
如 : C:\Program Files (x86)\Inno Setup 5) 。 添 加 Inno 安 装 路 径 到 Path 
环境 变量 中 。 如 果 你 不 知道 哪里 可 以 找到 它 ， 阅 读 Windows 中 如 何 设 置 路 径 和 


环境 变量 . 


3. 重启 Eclipse， 并 且 继 续 第 6 步 。 


78527 (MAC) - MacOS dmg #2425 


AddressApp.app Applications 





yubai.com 


为 了 创建 Mac OS dmg 拖 放 安装 器 ， 不 需要 任何 的 要 求 。 
注意 : 为 了 让 安装 器 映像 能 工作 ， 它 的 名 称 必 须 与 应 用 名 称 相同 。 
第 5 步 (Linux 等 ) Linux rpm 安 装 器 


其 它 打包 选项 (Windows 的 msi ，Linux 的 rpm ) 参 考 本 地 打包 博客 或 者 本 oracle 
文档 . 


第 6 步 运行 build.xml 


最 后 一 步 ， 我 们 使 用 ant 运 行 build.xml ， 右 击 build.xml 文件 | Run As | Ant 
Build. 


Run As 


>| 1 Ant Build N Alt+Shift+X, Q 
Debug As >| $Æ 2 Ant Build... 
= ; External Tools Configurations... 
Compare With b 


编译 将 运行 一 会 (在 我 的 计算 机 上 大 概 1 分 钟 )。 


如 果 一 切 都 成 功 ， 你 应 该 在 build/deploy/bundles 目录 下 找到 本 地 打包 。 
Windows 版 本 看 起 来 如 下 所 示 : 


4 {> build 
E> build 
4 & deploy 
4 © bundles 


m`] AddressApp-1.0.exe 


文件 AddressApp-1.0.exe 可 以 用 作为 单个 文件 安装 应 用 。 该 安装 程序 将 拷贝 打 
包 到 C:/Users/[yourname]/AppData/Local/AddressApp 目录 下 。 


Java.io 包 教程 


Java.io 包 提供 了 用 于 系统 的 输入 和 输出 ， 通 过 数据 流 ， 序 列 化 和 文件 系统 。 本 参考 
将 引导 您 完成 java.io 包 中 提供 简单 ， 实 用 的 方法 和 实例 。 


该 参考 是 为 初学 者 而 准 各 ， 帮 助 他 们 了 解 相关 Java.io 包 中 所 有 可 用 的 方法 的 基本 功 
能 
Wr RAF 


在 开始 做 练习 的 各 类 在 此 引用 给 定 的 例子 ， 假 设 您 已 经 知道 基本 的 Java 编 程 或 简单 
应 用 。 


Java.io.BufferedlnputStream # 3: | - Java.io® 
Java.io.BufferedinputStream 类 添加 功能 到 另 一 个 输入 流 ， 缓冲 输入 以 及 支持 
mark 和 reset methods.Following 是 关于 缓冲 输入 流 的 要 点 : 

e 当 创 建 缓冲 输入 ， 创 建 一 个 内 部 缓冲 区 数组 。 


。 如 从 该 流 的 字 节 被 读 出 或 跳 过 ， 内 部 缓冲 器 被 再 从 包含 的 输入 流 ， 许 多 字 节 一 
次 必要 的 。 


2 p 
类 的 声明 
以 下 是 java.io.BufferedlnputStream 类 的 声明 : 


public class BufferedInputStream 
extends FilterInputStream 


字段 域 
以 下 是 java.io.BufferedlnputStream 类 中 的 字段 : 
e protected byte[] buf -- 这 是 其 中 数据 存储 在 内 部 缓冲 器 阵列 。 


e protected int count -- 这 是 该 指数 1 大 于 在 缓冲 器 中 的 最 后 一 个 有 效 字 节 的 索 
Bl. 


e protected int marklimit -- 这 是 预 读 之 前 ， 后 续 调 用 reset 方 法 失败 调用 mark 方 
法 后 允许 的 最 大 值 。 


e protected int markpos -- 这 是 pos 区 域 在 最 后 标记 方法 被 调用 时 的 值 。 
e protected int pos -- 这 是 在 缓冲 器 中 的 当前 位 置 
e protected InputStream in -- 这 是 将 进行 过 滤 的 输入 流 。 


类 构造 画 数 


S.N. MS ES & 描述 
1 pn in) 这 将 创建 一 个 缓冲 输入 并 保存 
2 BufferedInputStream(InputStream in, int size) 这 将 创建 具有 指定 绥 


冲 区 大 小 的 一 个 缓冲 输入 流 ， 并 保存 其 参数 在 输入 流 中 ， 以 各 后 用 。 


类 方法 


S.N. 


方法 & 描述 


int available() 此 方法 从 这 个 输入 流 中 可 通过 一 个 方法 的 下 一 次 调用 阻塞 
该 输入 流 返 回 可 以 读 取 (或 跳 过 ) 的 字 节 数 的 估计 值 。 


void close() 此 方法 关闭 此 输入 流 并 释放 和 与 该 流 关 联 的 所 有 系统 资源 。 
void mark(int readlimit) 此 方法 请 参阅 InputStream 的 mark 方 法 的 常规 协 
Es 

boolean markSupported() 如 果 此 输入 流 是 否 支 持 mark 和 reset 方 法 的 方 
法 测试 。 


int read() 此 方法 读 取 从 输入 流 中 的 下 一 个 数据 字 节 。 


int read(byte[] b, int off, int len) 此 方法 读 取 该 字 节 输入 流 中 的 字 节 到 指 
定 的 字 节 数组 ， 并 从 给 定 的 偏 移 量 。 


void reset() 此 方法 重新 定位 这 个 流 ， 以 当时 的 mark 方 法 最 后 调用 这 个 
输入 流 中 的 位 置 。 


long skip(long n) 此 方法 跳 过 并 丢弃 n 个 字 节 从 此 输入 流 中 的 数据 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.FilterlnputStream 


e Java.io.Object 


Java.io.BufferedOutputStream 2: ($ FH fi - 
Java.io g 


Java.io.BufferedOutputStream 类 实现 一 个 缓冲 输出 流 。 通 过 建立 这 样 一 个 输出 


流 ， 应 用 程序 可 以 写字 节 到 底层 输出 流 ， 而 不 必然 导致 调用 底层 的 系统 写 人 的 每 个 
字 节 。 

34 二 
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以 下 是 Java.io.BufferedOutputStream 类 的 声明 : 


public class BufferedOutputStream 
extends FilterOutputStream 


ri a 

字段 域 

以 下 是 Java.io.BufferedOutputStream 类 中 的 字段 : 
e protected byte[] buf -- 这 是 在 数据 被 存储 在 内 部 缓冲 器 中 。 
e protected int count -- 这 是 在 缓冲 器 中 的 有 效 字 节 数 。 
e protected OutputStream out -- 这 是 相关 的 输出 流 进 行 过 滤 。 


类 构造 图 数 


S.N. 构造 函数 & 描述 


BufferedOutputStream(OutputStream out) 这 将 创建 一 个 新 的 缓冲 输 
出 流 将 数据 写 入 到 指定 的 基础 输出 流 。 


BufferedOutputStream(OutputStream out, int size) 这 将 创建 一 个 新 
的 缓冲 输出 流 的 数据 与 指定 的 缓冲 区 大 小 写 入 指定 的 基础 输出 流 。 


1 


S.N. 方法 & 描述 
1 void flush() 这 个 方法 刷新 此 缓冲 的 输出 流 。 


void write(byte[] b, int off, int len) 这 个 方法 从 指定 的 字 节 数组 开始 在 这 
个 缓冲 的 输出 流 天 闭 写 人 len 字 节 。 


3 void write(int b) 此 方法 写 入 指定 的 字 节 写 入 此 缓冲 的 输出 流 。 


方法 继承 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.FilterOutputStream 


e Java.io.Object 


Java.io.BufferedReader X - Java.io 包 


Java.io.BufferedReader 类 从 字符 输入 流 中 读 取 文 本 ， 缓 冲 各 个 字符 ， 从 而 提供 字 
符 ， 数组 和 行 的 高 效 读 取 。 以 下 是 有 关 的 BufferedReader 要 点 : 
e 缓冲 区 的 大 小 可 以 被 指定 或 默认 的 大 小 也 可 使 用 。 


e Reader 的 每 一 个 读 取 请 求 会 导致 相应 的 读 取 请 求 底层 字符 或 字 节 流 。 
类 的 声明 
以 下 是 java.io.BufferedReader 类 的 声明 : 


public class BufferedReader 
extends Reader 


字段 
以 下 是 java.io.BufferedReader 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


X B AE WM 


S.N. GAM & 描述 


BufferedReader(Reader in) 这 将 创建 一 个 使 用 默认 大 小 输入 缓冲 区 的 
缓冲 字符 输入 流 。 


BufferedReader(Reader in, int sz) 这 将 创建 一 个 使 用 指定 大 小 输入 组 
冲 区 的 缓冲 字符 输入 流 。 
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方法 与 说 明 
void close() 此 方法 关闭 该 流 并 释放 与 之 关联 的 所 有 系统 资 
void mark(int readAheadLimit) 此 方法 标记 流 中 的 当前 位 置 


boolean markSupported() 这 个 方法 告诉 此 流 是 否 支 持 mark() 操 作 ， 
确实 如 此 。 


int read() 此 方法 读 取 单 个 字符 。 


int read(char[] cbuf, int off, int len) 此 方法 读 取 字 符 到 一 个 数组 中 的 一 


String readLine() 此 方法 读 取 一 行文 本 。 

boolean ready() 这 个 方法 告诉 此 流 是 否 已 准备 好 被 读 取 。 
void reset() 这 个 方法 重 置 流 。 

long skip(long n) 此 方法 跳 过 n 个 字符 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Reader 


e Java.io.Object 


2 iffaranRaadnar 3 (ires Pe 
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Java.io.BufferedWriter3: - Java.io 包 


Java.io.BufferedWriter 类 将 文本 写 入 字符 输出 流 ， 缓 冲 各 个 字符 ， 从 而 提供 单个 
字符 ， 数 组 和 字符 串 的 高 效 写 入。 以 下 是 有 关 的 BufferedWriter 要 点 : 


e 缓冲 区 的 大 小 可 以 被 指定 或 默认 的 大 小 也 可 使 用 。 
e Writer 发 送 其 输出 到 底层 字符 或 字 节 流 。 

类 的 声明 

以 下 是 Java.io.BufferedWriter 类 的 声明 : 


public class Bufferedwriter 
extends Writer 


ri 
字段 
以 下 是 Java.io.BufferedWriter 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 操作 的 对 象 。 


X B AE WM 


S.N. KDE ER 23 5 ist BH 
1 BufferedWriter(Writer out) 这 将 创建 一 个 使 用 默认 大 小 输出 缓冲 区 的 


缓冲 字符 输出 流 。 


BufferedWriter(Writer out, int sz) 这 将 创建 一 个 使 用 给 定 大 小 的 输出 
缓冲 区 的 新 缓冲 字符 输出 流 。 
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方法 与 说 明 
void close() 此 方法 关闭 该 流 ， 但 要 先 刷 新 它 。 
void flush() 这 个 方法 刷新 流 。 
void newLine() 此 方法 写 入 一 个 行 分 隔 符 。 
void write(char[] cbuf, int off, int len) 此 方法 宇和 字符 数组 的 一 部 分 。 
void write(int c) 此 方法 写 入 的 单个 字符 。 
void write(String s, int off, int len) 此 方法 写 入 一 个 字符 串 的 一 部 分 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Writer 


e Java.io.Object 


java.io 


D, iffaran\Alritar 3 mre TAS 
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Java.io.ByteArrayInputStream X - Java.io 包 


java.io.ByteArrayInputStream 类 包含 包含 可 从 流 中 读 取 的 字 节 的 内 部 缓冲 器 。 内 
部 计数 器 保持 下 一 个 字 节 的 读 法 提供 的 轨道 。 以 下 是 关于 ByteArraylnputStream X: 
重要 的 几 点 : 

e 关闭 ByteArraylnputStream 类 没有 任何 效果 。 


e 在 这 个 类 中 的 方法 可 以 在 流 已 关闭 后 ， 而 被 调用 不 会 产生 一 个 IOException。 
类 的 声明 
以 下 是 java.io.ByteArraylnputStreamx 类 的 声明 : 


public class ByteArrayInputStream 
extends InputStream 


ri 
FER 
以 下 是 java.io.ByteArraylnputStream 中 类 中 的 字段 : 
e protected byte[] buf -- 这 是 由 流 的 创建 者 所 提供 的 字 节 数组 。 


e protected int count -- 这 是 索引 一 个 大 于 在 输入 流 缓 冲 器 中 的 最 后 一 个 有 效 字 
符 。 


e protected int mark -- 这 是 流 中 的 当前 标记 的 位 置 。 


e protected int pos -- 这 是 从 输入 流 缓存 器 读 取 的 下 一 个 字符 索引 。 


X B AE WM 
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1 ByteArrayInputStream(byte[] buf) 这 将 创建 一 个 
ByteArraylnputStream 类 ， 以 便 它 使 用 的 buf 为 缓冲 区 数组 。 

2 ByteArrayInputStream(byte[] buf, int offset, int length) 这 将 创建 一 


个 ByteArraylnputStream 类 使 用 的 buf 为 缓冲 区 数组 。 


Tutorials 
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方法 与 说 明 
int available() 这 这 个 方法 从 当前 输入 流 返 回 可 以 读 取 ( 或 跳 过 ) 的 剩余 字 节 


o 


void close() 关闭 ByteArraylnputStream 类 没有 任何 影响 效果 。 


void mark(int readAheadLimit) 这 种 方法 在 流 中 设置 的 当前 标记 的 位 
iB. 


boolean markSupported() 是 否 这 个 InputStream 支 持 标 记 / 重 置 此 方法 测 
io 
int read() 此 方法 读 取 从 这 个 输入 流 数 据 的 下 一 个 字 节 。 


int read(byte[] b, int off, int len) 此 方法 读 取 最 多 len 个 字 节 数据 到 从 这 个 
输入 流 中 的 字 节 数组 。 


void reset() 这 种 方法 缓冲 区 重 置 为 标记 位 置 。 
long skip(long n) 此 方法 跳 过 输入 流 中 n 个 字 节 的 输入 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e java.io.InputStream 


e java.io.Object 


Java.io.ByteArrayOutputStream X - Java.io 包 


Java.io.ByteArrayOutputStream 类 实现 输出 流 中 的 数据 被 宇 入 一 个 字 节 数组 。 作 
为 数据 写 人 到 它 的 缓冲 自动 增长 。 以 下 是 有 关 的 ByteArrayOutputStream 要 点 : 


e 关闭 一 个 字 节 数组 输出 流 没 有 影响 。 

。 在 这 个 类 中 的 方法 可 以 在 流 已 关闭 后 被 调用 ， 不 会 产生 一 个 IOException。 
类 的 声明 
以 下 是 java.io.ByteArrayOutputStream 声 明 的 类 : 


public class ByteArrayOutputStream 
extends OutputStream 


= EL 
字段 
以 下 是 java.io.ByteArrayOutputStream 中 类 中 的 字段 : 


e protected byte[] buf -- 这 是 在 数据 被 存储 在 缓冲 器 中 。 
e protected int count -- 这 是 在 缓冲 器 中 的 有 效 字 节 数 。 


类 的 构造 画 数 


S.N. Mie WS it BA 
1 ByteArrayOutputStream() 这 将 创建 一 个 新 的 字 节 数组 输出 流 。 
2 ByteArrayOutputStream(int size) 这 将 创建 一 个 新 的 字 节 数组 输出 


流 ， 具 有 缓冲 容量 指定 的 大 小 ， 以 字 节 为 单位 。 
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S.N. 方法 与 说 明 
1 void close() 关闭 一 个 字 节 数组 输出 流 没 有 影响 。 


void reset() 此 方法 重 置 该 字 节 数组 输出 流 为 需 的 计数 字段 ， 以 便 在 输出 
流 中 的 所 有 当前 累计 输出 被 丢弃 。 


3 int size() 此 方法 返回 缓冲 区 的 当前 大 小 。 
4 byte[] toByteArray() 此 方法 创建 一 个 新 分 配 的 字 节 数组 。 
String toString() 这 种 方法 将 缓冲 区 的 内 容 转换 为 使 用 平台 的 默认 字符 集 


” ”的 字符 串 解码 字 节 。 

6 String toString(String charsetName) 此 方法 通过 使 用 指定 charsetName 
解码 字 节 将 缓冲 区 的 内 容 转换 成 一 个 字符 串 。 

7 void write(byte[] b, int off, int len) 这 个 方法 从 指定 的 字 节 数组 开始 在 该 
字 节 数组 输出 流 关 闭 写 入 len 字 节 。 

8 void write(int b) 这 种 方法 将 指定 字 节 写 入 该 字 节 数组 输出 流 。 
void writeTo(OutputStream out) 此 方法 写 入 该 字 节 数组 输出 流 的 全 部 内 

9 容 写 和 人 到 指定 的 输出 流 参 数 ， 因 为 这 与 使 用 out.write(buf, 0, count) 调 用 


输出 流 的 write 方法 。 


继承 的 方法 
这 个 类 继承 自 以 下 类 方法 : 
e Java.io.OutputStream 


e Java.io.Object 


Java.io.CharArrayReader X - Java.io 包 


Java.io.CharArrayReader 类 实现 ， 可 以 用 来 作为 一 个 字符 输入 流 的 字符 缓冲 区 。 


xy = 
A FAR 
以 下 是 java.io.CharArrayReader 类 的 声明 : 


public class CharArrayReader 
extends Reader 


字段 
以 下 是 java.io.CharArrayReader 中 类 中 的 字段 : 
e protected char[] buf -- 这 是 字符 缓冲 区 。 
e protected int count -- 这 是 此 缓冲 区 的 末尾 的 索引 。 
e protected int markedPos -- 这 是 标记 在 缓冲 区 中 的 位 置 
e protected int pos -- 这 是 当前 的 缓冲 区 位 置 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


X B AE WM 
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1 CharArrayReader(char[] buf) 这 将 创建 由 字符 指定 一 个 数组 
CharArrayReader。 

2 CharArrayReader(char[] buf, int offset, int length) 这 将 创建 


指定 一 个 数组 CharArrayReader。 


字符 
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S.N. 方法 与 说 明 

1 void close() 此 方法 关闭 该 流 并 释放 与 之 关联 的 所 有 系统 资源 。 

void mark(int readAheadLimit) 此 方法 标记 流 中 的 当前 位 置 。 
boolean markSupported() 这 个 方法 告诉 此 流 是 否 支 持 mark() 操 作 。 
int read() 此 方法 读 取 单个 字符 。 

int read(char[] b, int off, int len) 该 方法 读 取 字符 到 数组 的 一 部 分 。 
boolean ready() 此 方法 通知 此 流 是 否 已 准 各 好 被 读 取 。 


7 void reset() 此 方法 重 置 流 至 最 新 的 标记 ， 或 者 如 果 它 从 来 没有 被 标记 的 
开始 。 


8 long skip(long n) 此 方法 跳 过 n 个 字符 。 


O a A C N 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.Reader 


e Java.io.Object 


Java.io.CharArrayReader # - Java.io® 1169 


Java.io.CharArrayWriter * - Java.io 包 


Java.io.CharArrayWriter 类 可 以 用 来 作为 一 个 Writer 的 字符 缓冲 区 。 当 数据 被 写 人 
到 流 缓 冲 区 会 自动 增长 。 


J^ —- 
A FAR 
以 下 是 java.io.CharArrayWriter 类 的 声明 : 


public class CharArrayWriter 
extends Writer 


字段 
以 下 是 java.io.CharArrayWriter 类 中 的 字段 : 
e protected char[] buf -- 这 是 被 存储 在 缓冲 器 中 的 数据 。 
e protected int count -- 这 是 在 缓冲 区 字符 的 数目 。 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


X B AE WM 
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1 CharArrayWriter() 这 将 创建 由 字符 指定 数组 一 个 CharArrayReader。 

2 CharArrayWriter(int initialSize) 这 将 创建 一 个 新 的 CharArrayWriter 使 
用 指定 的 初始 大 小 。 
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S.N. 方法 与 说 明 

1 CharArrayWriter append(char c) 此 方法 将 指定 字符 追加 到 这 个 writer。 

2 CharArrayWriter append(CharSequence csq) 此 方法 将 指定 的 字符 序列 
追加 到 这 个 writer。 

3 CharArrayWriter append(CharSequence csq, int start, int end) 此 方法 
将 指定 的 字符 序列 的 子 序列 写 入 此 writer。 

4 void close() 这 种 方法 关闭 流 。 

5 void flush() 这 个 方法 刷新 流 。 

void sid 此 方法 重 设 缓冲 区 ， 这 样 就 可 以 再 次 使 用 它 而 无 需 丢 弃 已 分 
配 的 缓冲 区 。 

7 int size() 此 方法 返回 缓冲 区 的 当前 大 小 。 

8 char[] toCharArray() 此 方法 返回 输入 数据 的 副本 。 

9 String toString) 这 种 方法 的 输入 数据 转换 为 字符 串 。 

10 void write(char[] c, int off, int len) 此 方法 写 入 字符 到 缓冲 区 。 

11 void write(int c) 这 种 方法 将 一 个 字符 写 入 到 缓冲 区 。 

12 CH write(String str, int off, int len) 此 方法 写 入 的 字符 串 的 一 部 分 到 缓冲 

13 void writeTo(Writer out) 此 方法 写 入 的 缓冲 区 的 内 容 到 另 一 个 字符 流 。 

继承 的 方法 


这 个 类 从 以 下 类 继承 的 方法 : 


e Java.io.Writer 


e Java.io.Object 


Java.io 
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Java.io.Console X - Java.io 包 


Java.io.Console 类 提供 了 方法 来 访问 基于 字符 的 控制 台 设 备 ， 与 当前 Java 虚 拟 机 


相关 联 。 


类 声明 


以 下 是 Java.io.Console 类 的 声明 : 


public final class Console 
extends Object 


implements Flushable 


类 方法 


S.N. 


方法 与 说 明 
void flush() 此 方法 刷新 控制 台 ， 并 强制 所 有 缓冲 的 输出 立即 写 入 。 


Console format(String fmt, Object... args) 此 方法 写 入 一 个 格式 化 字符 
串 使 用 指定 格式 字符 串 和 参数 这 个 控制 台 的 输出 流 。 


Console printf(String format, Object... args) 此 方法 是 用 来 写 一 个 格式 化 
字符 串 使 用 指定 格式 字符 串 和 参数 这 个 控制 台 的 输出 流 。 


Reader reader() 此 方法 检索 与 此 控制 台 关联 的 唯一 Reader 对 象 。 
String readLine() 此 方法 从 控制 台 读 取 单 行文 本 。 


String readLine(String fmt, Object... args) 此 方法 提供 了 一 个 格式 化 提 
示 ， 然 后 从 控制 台 读 取 单 行文 本 。 


char[] readPassword() 此 方法 从 控制 台 读 取 密 码 或 口 售 ， 禁 用 回 显 。 


char[] readPassword(String fmt, Object... args) 此 方法 提供 了 一 个 格式 
化 提示 ， 然 后 读 取 密 码 或 口令 从 控制 台 禁 用 回 显 。 


PrintWriter writer() 此 方法 检索 与 此 控制 台 关 联 的 唯一 PrintWriter 对 象 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 


Java.io.DatalnputStream # - Java.io 包 


Java.io.DatalnputStream 类 人 允许 应 用 程序 读 取 在 与 机 器 无 关 方 式 从 底层 输入 流 基本 
Java 数 据 类 型 。 以 下 是 有 关 数 据 输入 流 的 要 点 : 


e 应 用 程序 使 用 数据 输出 流 写 人 ， 以 后 可 以 通过 一 个 数据 输入 流 中 读 取 数 据 。 


e 数据 输入 流 并 不 一 定 是 安全 的 多 线程 访问 。 线 程 安全 是 可 选 的 ， 在 这 个 类 中 的 
方法 用 户 的 责任 。 


xy -—- 
类 丙 明 
以 下 是 java.io.DatalnputStream 类 的 声明 : 


public class DataInputStream 
extends FilterInputStream 
implements DataInput 


ra EL 
字段 
以 下 是 java.io.DatalnputStream 类 中 的 字段 : 


e protected InputStream in -- 这 是 将 输入 流 进 行 过 滤 。 
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S.N. ie HS t HH 
1 DatalnputStream(InputStream in) 这 将 创建 一 个 DatalnputStream 使 


用 指定 的 底层 InputStream。 
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方法 & 描述 


int read(byte[] b) 此 方法 从 包含 的 输入 流 中 读 取 字 节 数 部 分 ， 并 将 它们 
存储 到 缓冲 区 数组 b 


int read(byte[] b, int off, int len) 此 方法 读 取 最 多 len 个 从 包含 的 输入 流 的 
数据 字 节 为 字 节 数组 。 


boolean readBoolean() 此 方法 读 取 一 个 输入 字 节 ， 如 果 该 字 节 不 为 需 
返回 true， 如 果 该 字 节 是 需 则 返回 false。 


byte readByte() 此 方法 读 取 并 返回 一 个 输入 字 节 。 

char readChar() 此 方法 读 取 两 个 输入 字 节 并 返回 一 个 char 值 。 
double readDouble() 此 方法 读 取 八 个 输入 字 节 并 返回 一 个 double 值 。 
float readFloat() 此 方法 读 取 四 个 输入 字 节 并 返回 一 个 float 值 。 


void readFully(byte[] b) 此 方法 读 取 从 输入 流 的 一 些 字 节 ， 并 将 它们 存 
储 到 缓冲 区 数组 b 中 。 


void readFully(byte[] b, int off, int len) 此 方法 从 输入 流 读 取 len 个 字 节 。 
int readInt() 此 方法 读 取 四 个 输入 字 节 并 返回 一 个 int 值 。 

long readLong() 此 方法 读 取 八 个 输入 字 节 并 返回 一 个 长 整 型 值 。 

short readShort() 此 方法 读 取 两 个 输入 字 节 并 返回 一 个 short 值 。 


int readUnsignedByte() 此 方法 读 取 一 个 输入 字 节 ， 需 扩展 到 int 类 型 ， 
并 返回 结果 ， 所 以 结果 的 范围 是 从 0 到 255。 


int readUnsignedShort() 此 方法 读 取 两 个 输入 字 节 ， 并 通过 返回 在 范 
0-65535 的 int 值 。 


String readUTF() 此 方法 读 取 在 已 使 用 UTF-8 修 改版 格式 编码 的 字符 


o 


static String readUTF(Datalnput in) 此 方法 读 取 来 自 编 码 经 修订 的 UTF- 
8 格式 的 Unicode 字 符 串 的 表示 数据 流 ; 这 串 字 符 接着 返回 一 个 字符 串 。 


int skipBytes(int n) 此 方法 使 得 试图 从 输入 流 中 的 数据 跳 过 n 个 字 节 ， 技 
弃 跳 过 的 字 节 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.FilterInputStream 


e Java.io.Object 


Java.io. 


DatalnputStream # - Java.io % 1174 


Java.io.DataOutputStream X - Java.io® 


Java.io.DataOutputStream 类 多 许 应 用 程序 写 人 基本 Java 数 据 类 型 在 一 个 可 移植 
的 方式 输出 流 。 然 后 ， 应 用 程序 可 以 使 用 数据 输入 流 中 读 取 的 数据 回 和 人 。 


xy = 
A a HH 
以 下 是 java.io.DataOutputStream 类 的 声明 : 


public class DataOutputStream 
extends FilterOutputStream 
implements DataOutput 


= EL 
字段 
以 下 是 java.io.DataOutputStream 类 的 字段 : 


e protected int written -- 这 是 写 人 到 数据 输出 流 到 目前 为 止 的 字 节 数 。 
e protected OutputStream out -- 这 是 相关 的 输出 流 进行 过 滤 。 


X B AE WM 


S.N. His ES AC & 描述 
1 DataOutputStream(OutputStream out) 这 将 创建 一 个 新 的 数据 输出 流 


将 数据 写 入 到 指定 的 基础 输出 流 。 
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S.N. 方法 & 描述 
1 void flush() 此 方法 刷新 此 数据 输出 流 。 


int size() 此 方法 返回 计数 器 的 当前 值 写 人 ， 写 和 人 该 数据 输出 流 到 目前 为 
止 的 字 节 数 。 


void write(byte[] b, int off, int len) 此 方法 从 指定 的 字 节 数 组 开始 到 底层 
输出 流 关闭 写 和 len 字 节 。 


4 void write(int b) 此 方法 宇和 人 指定 的 字 节 ( 低 8 位 参数 b) 底 层 输 出 流 。 
void writeBoolean(boolean v) 此 方法 写 入 一 个 布尔 到 底层 输出 流 为 1 个 


字 节 的 值 。 

void writeByte(int v) 此 方法 写 入 了 一 个 字 节 到 基础 输出 流 中 1 个 字 节 的 
{Bo 

7 void writeBytes(String s) 此 方法 写 出 的 字符 串 到 底层 输出 流 为 字 节 序 
列 。 

3 void writeChar(int v) 此 方法 写 和 一 个 char 到 底层 输出 流 作 为 一 个 2-byte 
值 ， 高 字 节 在 前 。 

9 void writeChars(String s) 此 方法 将 一 个 字符 串 写 入 基础 输出 流 作 为 一 个 


字符 序列 。 


Void writeDouble(double v) 此 方法 将 float 参 数 转换 为 使 用 Float 类 的 
10 floatTolntBits 方 法 ， 写 入 int 值 到 底层 输出 流 作 为 一 个 4 字 节 的 数量 ， 高 字 
节 在 前 。 


void writeFloat(float v) 此 方法 将 float 参 数 转换 为 使 用 Float 类 的 
11 floatTolntBits 方 法 ， 写 入 int 值 到 底层 输出 流 作 为 一 个 4 字 节 的 数量 ， 高 字 


节 在 前 。 

12 void writelnt(int v) 此 方法 写 入 一 个 int 到 底层 输出 流 为 4 个 字 节 ， 高 字 节 
{EBM 

13 void writeLong(long v) 此 方法 写 入 了 long 的 基础 输出 流 中 的 8 个 字 节 ， 
高 字 节 在 前 。 

14 void writeShort(int v) 此 方法 写 入 了 短 到 底层 输出 流 为 两 个 字 节 ， 高 字 节 
在 前 。 

45 void writeUTF(String str) 此 方法 将 一 个 字符 串 写 人 使 用 经 修订 的 UTF-8 


编码 以 与 机 器 无 关 的 方式 的 基础 输出 流 。 


继承 的 方法 
这 个 类 继承 自 以 下 类 方法 : 


e Java.io.FilterOutputStream 
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e Java.io.Object 


e Java.io.DataOutput 


Java.io.File# - Java.io 包 


java.io.File 类 是 文件 和 目录 路 径 名 的 抽象 表示 。 以 下 是 有 关 文 件 的 要 点 : 


e 实例 可 以 或 可 以 不 表示 实际 的 文件 系统 对 象 ， 如 文件 或 目录 。 如 果 是 这 样 表示 
这 样 一 个 对 象 ， 然 后 该 对 象 位 于 一 个 分 区 。 分 区 是 存储 为 文件 系统 的 操作 系统 
的 特定 部 分 。 


e 文件 系统 可 以 实现 限制 某 些 操作 的 实际 文件 系统 对 象 ， 如 读 ， 写 ， 和 执行 上 。 
这 些 限 制 统称 为 访问 权限 。 


e File 类 的 实例 是 不 可 变 的 ;也 就 是 说 ， 一 旦 创建 ， 由 一 个 File 对 象 表 示 的 抽象 路 
径 名 是 不 会 改变 的 。 


类 的 声明 
以 下 是 声明 java.io.File 类 : 


public class File 
extends Object 
implements Serializable, Comparable<File> 


ri 
字段 
以 下 是 java.io.File 类 的 字段 : 


e static String pathSeparator -- 这 是 系统 相关 的 路 径 分 隔 符 ， 表 示 为 一 个 字符 串 
以 方便 使 用 。 


e static char pathSeparatorChar -- 这 是 依赖 于 系统 的 路 径 分 陋 符 。 


e static String separator -- 这 是 与 系统 有 关 的 默认 名 称 分 隔 符 ， 表 示 为 一 个 字符 
串 以 方便 使 用 。 


e static char separatorChar -- 这 是 与 系统 有 关 的 默认 名 称 分 隔 符 。 


X BS MEE ERN 
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S.N. 构造 函数 & 描述 

1 File(File parent, String child) 此 方法 创建 从 父 抽 象 路 径 名 和 child 路 径 
名 字符 串 的 新 File 实 例 。 

2 File(String pathname) 该 方法 通过 将 给 定 路 径 名 字符 串 转换 为 抽象 路 
径 名 来 创建 一 个 新 File 实 例 。 

3 File(String parent, String child) 此 方法 创建 从 父 路 径 名 字符 串 和 child 
路 径 名 字符 串 的 新 File 实 例 。 

4 File(URI uri) URI 转 换 成 抽象 路 径 名 : 此 方法 通过 给 定 的 文件 将 创建 一 
个 新 的 File 实 例 。 

X 733 

S.N. 方法 & 描述 

boolean canExecute() 此 方法 测试 应 用 程序 是 否 可 以 执行 表示 此 抽象 路 
径 名 的 文件 。 

2 boolean canRead() 这 种 方法 测试 应 用 程序 是 否 可 以 读 取 表示 此 抽象 路 
径 名 的 文件 。 

3 boolean canWrite() 此 方法 测试 应 用 程序 是 否 可 以 修改 表示 此 抽象 路 径 
名 的 文件 。 

4 int compareTo(File pathname) 这 种 方法 比较 两 个 抽象 路 径 名 的 字典 顺 
序 。 

5 boolean createNewFile() 此 方法 自动 创建 此 抽象 路 径 名 命名 的 ， 当 且 公 
当 具 有 此 名 称 的 文件 尚 不 存在 一 个 新 的 空 文件 。 

6 static File createTempFile(String prefix, String suffix) 此 方法 创建 的 默认 
临时 文件 目录 的 空 文件 ， 使 用 给 定 前 级 和 后 级 生成 其 名 称 。 
static File createTempFile(String prefix, String suffix, File directory) 此 

7 方法 会 在 指定 的 目录 中 一 个 新 的 空 文件 ， 使 用 给 定 前 级 和 后 级 字符 串 生 
成 其 名 称 。 

8 boolean delete() 此 方法 删除 表示 此 抽象 路 径 名 的 文件 或 目录 。 

9 void deleteOnExit() 此 方法 要 求 将 表示 此 抽象 路 径 名 的 文件 或 目录 在 虚 
拟 机 终止 时 被 删除 。 

10 boolean equals(Object obj) 此 方法 测试 此 抽象 路 径 名 与 给 定 对 象 是 否 相 
等 。 

11 boolean exists() 此 方法 测试 表示 此 抽象 路 径 名 的 文件 或 目录 是 否 存在 。 

12 File getAbsoluteFile() 此 方法 返回 此 抽象 路 径 名 的 绝对 形式 。 
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13 String getAbsolutePath() 此 方法 返回 此 抽象 路 径 名 的 绝对 路 径 名 字符 
Bo 


14 File getCanonicalFile() 此 方法 返回 此 抽象 路 径 名 的 规范 形式 。 


15 String getCanonicalPath() 此 方法 返回 此 抽象 路 径 名 的 规范 路 径 名 字符 
FR, 

16 long getFreeSpace() 此 方法 返回 此 抽象 路 径 名 的 分 区 中 的 未 分 配 的 字 节 
数 。 


17 String getName() 此 方法 返回 表示 此 抽象 路 径 名 的 文件 或 目录 的 名 称 。 
String getParent() 此 方法 返回 此 抽象 路 径 名 的 父 路 径 名 的 字符 串 ， 或 者 


null， 如 果 此 路 径 名 没有 指定 父 目 录 。 
19 File getParentFile() 此 方法 返回 此 抽象 路 径 名 的 父 抽象 路 径 名 ， 或 null, 


如 果 此 路 径 名 没有 指定 父 目录 。 
20 String getPath() 此 方法 此 抽象 路 径 名 转换 为 一 个 路 径 名 字符 串 。 
21 long getTotalSpace() 此 方法 返回 此 抽象 路 径 名 的 分 区 的 大 小 。 


long getUsableSpace() 此 方法 返回 可 用 字 节 数 这 个 虚拟 机 上 命名 此 抽 
象 路 径 名 的 分 区 。 


23 int hashCode() 此 方法 用 于 计算 此 抽象 路 径 名 的 哈 希 码 。 
24 boolean isAbsolute() 此 方法 测试 此 抽象 路 径 名 是 否 是 绝对 的 。 
boolean isDirectory() 此 方法 测试 表示 此 抽象 路 径 名 的 文件 是 否 是 一 个 


25 | 目录 。 

26 boolean isFile() 此 方法 测试 表示 此 抽象 路 径 名 的 文件 是 否 是 一 个 正常 的 
NE o 

27 boolean isHidden() 此 方法 测试 此 抽象 路 径 名 的 文件 是 否 是 一 个 隐藏 文 

28 long lastModified() 此 方法 返回 的 时 候 ， 表 示 此 抽象 路 径 名 的 文件 的 最 


后 修改 
29 long length() 此 方法 返回 表示 此 抽象 路 径 名 的 文件 的 长 度 。 
String[] list) 此 方法 返回 的 字符 串 命 名 表示 此 抽象 路 径 名 的 目录 中 的 文 


90 。， 件 和 目录 的 数组 。 

31 String[] list(FilenameFilter filter) 此 方法 返回 的 字符 串 命名 的 目录 表示 此 
抽象 路 径 名 满足 指定 过 滤器 的 文件 和 目录 的 数组 。 

30 File[] listFiles() 此 方法 返回 抽象 路 径 名 表示 在 表示 此 抽象 路 径 名 的 目录 
中 的 文件 的 数组 。 

33 File[] listFiles(FileFilter filter) 此 方法 返回 抽象 路 径 名 表示 的 目录 表示 此 


抽象 路 径 名 满足 指定 过 滤器 的 文件 和 目录 的 数组 。 
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File[] listFiles(FilenameFilter filter) 此 方法 返回 抽象 路 径 名 表示 的 目录 表 


34 
示 此 抽象 路 径 名 满足 指定 过 滤器 的 文件 和 目录 的 数组 。 

35 static File[] listRoots() 此 方法 列 出 可 用 的 文件 系统 的 根 。 

36 boolean mkdir() 此 方法 创建 此 抽象 路 径 名 的 目录 。 

37 boolean mkdirs() 此 方法 创建 此 抽象 路 径 名 的 目录 ， 包 括 任何 必需 但 不 
存在 的 父 目录 

38 boolean renameTo(File dest) 这 种 方法 将 重 命名 表示 此 抽象 路 径 名 的 文 
件 。 

39 boolean setExecutable(boolean executable) 这 是 一 个 方便 的 方法 来 设 
置 所 有 者 对 于 此 抽象 路 径 名 执行 权限 。 

40 boolean setExecutable(boolean executable, boolean ownerOnly) 此 方 
法 设置 所 有 者 或 每 个 人 的 执行 权限 ， 此 抽象 路 径 名 。 

A1 boolean setLastModified(long time) 此 方法 设置 此 抽象 路 径 名 的 文件 或 
目录 的 最 后 修改 时 间 。 

42 boolean setReadable(boolean readable) 这 是 一 个 方便 的 方法 来 设置 此 
抽象 路 径 名 的 所 有 者 的 读 取 权 限 。 

43 boolean setReadable(boolean readable, boolean ownerOnly) 此 方法 设 
置 所 有 者 或 在 此 抽象 路 径 名 大 家 的 读 取 权 限 。 

44 boolean setReadOnly() 此 方法 标志 着 此 抽象 路 径 名 命名 的 ， 这 样 只 人 允 
许 读 操 作 的 文件 或 目录 。 

45 boolean setWritable(boolean writable) 这 是 一 个 方便 的 方法 来 设置 此 抽 
象 路 径 名 的 所 有 者 的 写 权 限 。 

46 boolean setWritable(boolean writable, boolean ownerOnly) 此 方法 设置 
此 抽象 路 径 名 的 所 有 者 或 每 个 人 的 写 权 限 。 

47 String toString() 此 方法 返回 此 抽象 路 径 名 的 路 径 名 字符 串 。 

48 URI toURI() 这 种 方法 构造 一 个 文件 : URI 表 示 此 抽象 路 径 名 。 

继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 


Java.io. 
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Java.io.FileDescriptor # - Java.io® 


Java.io.FileDescriptor 类 实例 作为 一 个 不 透明 的 句柄 底层 机 器 特有 的 结构 表示 一 
个 打开 的 文件 ， 打 开 的 套 接 字 或 其 他 来 源 或 字 节 的 接收 器 。 以 下 是 关于 
FileDescriptor 要 点 : 


e 主要 实际 使 用 的 文件 描述 符 是 创建 一 个 FilelnputStream 或 FileOutputStream 来 


wile. 
e 应 用 程序 不 应 创建 自己 的 文件 描述 符 。 
类 的 声明 
以 下 是 java.io.FileDescriptor 类 的 声明 : 


public final class FileDescriptor 
extends Object 


5 EJL 

字段 

以 下 是 java.io.FileDescriptor 类 中 的 字段 : 
e static FileDescriptor err -- 这 是 句柄 的 标准 错误 流 。 
e static FileDescriptor in -- 这 是 句柄 的 标准 输入 流 。 


e static FileDescriptor out -- 这 是 句柄 到 标准 输出 流 。 


类 的 构造 图 数 


S.N. Wis HX & 描述 
1 FileDescriptor() 这 种 方法 构造 一 个 (无 效 )FileDescriptor 对 象 。 


类 方法 


S.N. 方法 & 描述 
1 void sync() 此 方法 强制 所 有 系统 缓冲 区 与 基础 设备 同步 。 


1 boolean valid() 如 果 此 方法 测试 文件 描述 符 对 象 是 否 有 效 ? 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 


Java.io.FilelnputStream X: - Java.io® 
Java.io.FilelnputStream 类 从 文件 系统 中 的 一 个 文件 中 获取 输入 字 节 。 那 些 文件 依 
赖 于 主机 环境 。 以 下 是 关于 文件 输入 流 的 要 点 : 

。 这 个 类 是 指 对 原始 字 节 诸如 图 像 数据 读 出 流 。 

e 对 于 字符 读 取 流 ， 使 用 FileReader。 


EZ: + 
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以 下 是 java.io.FilelInputStream 类 的 声明 : 


public class FileInputStream 
extends InputStream 


类 构造 方法 


S.N. 构造 函数 & 描述 
FilelnputStream(File file) 这 通过 打开 一 个 到 实际 文件 ， 命 名 在 文件 系 
统 中 的 File 对 象 文 件 的 文件 的 连接 创建 一 个 FilelnputStream。 


FilelnputStream(FileDescriptor fdObj) 这 通过 使 用 文件 描述 符 
2 fdObj， 它 代表 在 文件 系统 中 某 个 实际 文件 的 现 有 连接 创建 一 个 


FilelnputStream, 


FilelnputStream(String name) 这 将 创建 一 个 FilelnputStream 通 过 打开 
一 个 到 实际 文件 的 连接 ， 通 过 路 径 名 名 在 文件 系统 命名 的 文件 。 


1 


S.N. 方法 & 描述 
int available() 此 方法 从 输入 流 中 通过 一 个 方法 的 下 一 次 调用 阻塞 该 输入 


1o ， 流 返 回 可 以 读 取 “( 或 跳 过 ) 的 剩余 字 节 数 的 估计 值 。 

2 void close() 此 方法 关闭 此 文件 输入 流 并 释放 与 该 流 关联 的 所 有 系统 次 

3 protected void finalize() 此 方法 可 确保 此 文件 输入 流 的 close 方 法 被 调用 
当 它 没有 更 多 的 参考 引用 。 

4 FileChannel getChannel() 此 方法 返回 与 此 文件 输入 流 关 联 的 唯一 文件 
通道 对 象 。 

5 FileDescriptor getFD() 此 方法 返回 FileDescriptor 对 象 ， 表 示 连 接 到 正在 


使 用 此 文件 输入 流 文 件 系统 的 实际 文件 。 
6 int read() 此 方法 读 取 当 前 输入 流 中 一 个 字 节 的 数据 。 
int read(byte[] b) 此 方法 从 这 个 输入 流 中 数据 读 取 可 达 b.length 个 字 节 到 


和 字 节 数组 。 
3 int read(byte[] b, int off, int len) 此 方法 读 取 最 多 |len 个 从 这 个 输入 流 中 数 


据 的 字 节 到 字 节 数组 。 
9 long skip(long n) 此 方法 跳 过 并 丢弃 n 个 字 节 从 输入 流 中 的 数据 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.InputStream 


e Java.io.Object 


Java.io.FileOutputStream X: - Java.io® 
Java.io.FileOutputStream 类 是 用 于 将 数据 写 入 一 个 文件 或 FileDescriptor 的 输出 
流 。 以 下 是 关于 文件 输出 流 的 要 点 : 

。 这 个 类 是 指 用 于 记录 的 原始 字 节 ， 例 如 图 像 数 据 流 。 

。 写 字符 流 ， 可 以 使 用 文件 字符 FileWriter 


J^ Œ 
类 两 明 
以 下 是 java.io.FileOutputStream 类 的 声明 : 


public class FileOutputStream 
extends OutputStream 


S.N. ISN & 描述 


造 
1 FileOutputStream(File file) 这 将 创建 一 个 文件 输出 流 写 人 到 由 指定 的 
File 对 象 表示 文件 。 


2 FileOutputStream(File file, boolean append) 这 将 创建 一 个 文件 输出 
流 宇 入 到 由 指定 的 File 对 象 表示 的 文件 。 
FileOutputStream(FileDescriptor fdObj) 这 将 创建 一 个 输出 文件 流 宇 

3 入 到 指定 的 文件 描述 符 ， 它 代表 了 文件 系统 中 的 某 个 实际 文件 的 现 有 连 


o 


4 FileOutputStream(String name) 这 将 创建 一 个 输出 文件 流 写 入 到 具有 
指定 名 称 的 文件 。 
5 FileOutputStream(String name, boolean append) 这 将 创建 一 个 输出 


文件 流 写 入 到 具有 指定 名 称 的 文件 。 
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S.N. 方法 & 描述 


void close() 此 方法 关闭 此 文件 输出 流 并 释放 与 此 流 有 关 的 所 有 系统 资 
源 。 


2 protected void finalize() 这 种 方法 清除 连接 到 文件 ， 并 确保 此 文件 输出 
流 的 close 方 法 被 调用 时 ， 此 流 不 再 有 引用 。 


3 FileChannel getChannel() 此 方法 返回 与 此 文件 输出 流 关 联 的 唯一 文件 
通道 对 象 。 


4 FileDescriptor getFD() 此 方法 返回 与 此 流 有 关 的 文件 描述 符 。 


void write(byte[] b) 此 方法 写 入 b.length 个 字 节 从 指定 的 字 节 数组 到 该 文 
件 输出 流 。 


6 void write(byte[] b, int off, int len) 此 方法 从 指定 的 字 节 数组 开始 到 该 文 
件 输出 流 关闭 写 入 len 字 节 。 


7 void write(int b) 此 方法 写 入 指定 的 字 节 写 入 此 文件 输出 流 。 
继承 的 方法 
这 个 类 继承 自 以 下 类 方法 : 


e Java.io.OutputStream 


e Java.io.Object 


Java.io.FilePermission X - Java.io 包 
Java.io.FilePermission 类 表示 访问 一 个 文件 或 目录 。 它 包括 一 个 路 径 名 和 一 套 有 
效 的 路 径 名 操作 。 以 下 是 有 关 的 FilePermission 要 点 : 


e. 将 予 授 出 的 动作 传递 给 构造 本 数 中 包含 一 个 或 多 个 逗号 分 隔 的 关键 字 列 表 的 字 
符 串 。 可 能 的 关键 字 是 "read", "write", "execute", 和 "delete"。 


e. 代码 总 是 可 以 从 同一 目录 它 在 (或 该 目录 的 子 目 录 ) 读 取 文 件 ; 它 并 不 需要 明确 许 
可 这 样 做 。 


sp —L 
类 的 声明 
以 下 是 Java.io.FilePermission 类 的 声明 : 


public final class FilePermission 
extends Permission 
implements Serializable 


S.N. Mieke & 描述 
1 FilePermission(String path, String actions) 将 创建 具有 指定 操作 新 


的 FilePermission 对 象 。 


类 方法 


S.N. 方法 & 描述 
1 boolean equals(Object obj) 此 方法 检查 两 个 FilePermission 对 象 是 否 相 


sTo 


2 String getActions() 此 方法 返回 动作 的 "规范 化 字符 串 表 示 形 式 ”。 


3 int hashCode() 此 方法 返回 此 对 象 的 哈 希 码 值 。 

4 boolean implies(Permission p) 此 方法 检查 ，FilePermission 对 象 是 
否 “ 暗 含 " 指 定 的 权限 。 

5 PermissionCollection newPermissionCollection() 此 方法 返回 一 个 新 的 


对 象 PermissionCollection 存 储 的 FilePermission 对 象 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.Permission 


e Java.io.Object 


Java.io.FileReader X: - Java.io 包 


Java.io.FileReader 类 是 一 个 方便 的 类 用 于 读 取 字 符 文 件 。 以 下 是 有 关 的 
FileReader 要 点 : 


© 这 个 类 的 构造 方法 假定 默认 字符 编码 和 默认 字 节 缓冲 区 大 小 都 是 适当 的 。 


e FileReader 是 为 字符 读 取 流 。 对 于 原始 字 节 流 读 取 ， 使 用 文件 输入 流 - 
FilelnputStream, 


类 的 声明 
以 下 是 Java.io.FileReader 类 的 声明 : 


public class FileReader 
extends InputStreamReader 


字段 
以 下 是 Java.io.FileReader 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


X B AE WM 


S.N. Hye & 描述 
1 FileReader(File file) 创建 一 个 新 的 FileReader， 从 给 定 的 文件 读 取 。 
2 FileReader(FileDescriptor file) 创建 一 个 新 的 FileReader， 从 给 出 的 


FileDescriptor 读 取 。 


FileReader(String fileName) 创建 一 个 新 的 FileReader， 因 为 要 读 取 的 
文件 的 名 称 。 


类 方法 
这 个 类 继承 自 以 下 类 方法 : 
e Java.io.InputStreamReader 


e java.uti.Reader 
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e Java.io.Object 


Java.io.FileReader # - Java.io 包 1191 


Java.io.FileWriter3: - Java.io@ 


Java.io.FileWriter 类 是 一 个 方便 的 类 写 入 字符 文件 。 以 下 是 关于 FileWriter 中 重要 
的 几 点 : 


e 这 个 类 的 构造 方法 假定 默认 字符 编码 和 默认 字 节 缓冲 区 大 小 都 是 可 以 接受 的 。 
e 文件 字符 写 的 意思 是 写 入 字符 流 。 对 于 原始 字 人流， 使 用 文件 输 出 流 。 
类 声明 
以 下 是 Java.io.FileWriter 类 的 声明 : 


public class FileWriter 
extends OutputStreamReader 


字段 
以 下 是 Java.io.FileWriter 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 酌 数 

S.N. Hye & 描述 

1 FileWriter(File file) 此 构造 一 个 文件 字符 写 对 象 给 出 一 个 File 对 象 。 

2 FileWriter(File file, boolean append) 此 构造 一 个 文件 字符 写 对 象 给 出 
一 个 File 对 象 。 

3 FileWriter(FileDescriptor fd) 此 构造 与 文件 描述 符 相 关联 的 文件 字符 
写 的 对 象 。 

4 FileWriter(String fileName) 此 构造 一 个 文件 字符 写 对 象 给 出 文件 名 。 

5 FileWriter(String fileName, boolean append) 此 构造 函数 一 个 文件 字 


符 写 对 象 给 出 一 个 布尔 值 ， 指 示 是 否 附加 写 入 数据 的 文件 名 。 


类 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.OutputStreamWriter 
e java.uti.Writer 


e Java.io.Object 


Java.io.FilterInputStream X - Java.io 包 


Java.io.FilterInputStream 类 包含 其 他 一 些 输入 流 ， 它 用 作 其 基本 数据 源 ， 它 可 以 
直接 传输 数据 或 提供 一 些 额 外 的 功能 。 以 下 是 关于 FilterlnputStream 中 的 要 点 : 


e 类 本 身 只 是 简单 地 重 写 InputStream 和 与 所 有 请 求 传 递 给 所 包含 的 输入 流 版 本 的 
所 有 方法 


e 这 个 类 的 子 类 可 进一步 重 写 其 中 的 一 些 方法 ， 还 可 能 提供 额外 的 方法 和 字段 。 
J^ TE 
类 两 明 
以 下 是 java.io.FilterInputStream 类 的 声明 : 


public class FilterInputStream 
extends InputStream 


= FJL 
字段 
以 下 是 java.io.FilterInputStream 类 中 的 字段 : 


e protected InputStream in -- 此 是 将 输入 流 进行 过 滤 。 


eS 


S.N. Mis HR & 描述 
1 protected FilterinputStream(InputStream in) 在 到 字段 这 个 分 配 参数 


创建 一 个 FilterlnputStream。 并 记 住 它 供 以 后 使 用 。 
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S.N. 方法 & 描述 


int available() 此 方法 从 这 个 输入 流 中 可 通过 一 个 方法 的 调用 者 阻止 这 个 
输入 流 返 回 可 以 读 取 ( 或 跳 过 ) 的 字 节 数 的 估计 值 。 


2 void close() 此 方法 关闭 此 输入 流 并 释放 与 该 流 关 联 的 所 有 系统 资源 。 
3 void mark(int readlimit) 此 方法 标志 着 在 此 输入 流 的 当前 位 置 。 


boolean markSupported() 如 果 此 输入 流 是 否 支 持 mark 和 reset 方 法 此 方 
法 测试 。 


5 int read() 此 方法 读 取 从 这 个 输入 流 数 据 的 下 一 个 字 节 。 


6 int read(byte[] b) 此 方法 从 这 个 输入 流 中 数据 的 读 取 byte.length 字 节 到 
字 节 数组 。 


7 int read(byte[] b, int off, int len) 此 方法 从 这 个 输入 流 中 数据 读 取 最 多 len 
个 字 节 到 字 节 数组 。 


8 void reset() 此 方法 重新 定位 此 流 ， 以 当时 的 mark 方 法 最 后 调用 这 个 输 
入 流 中 的 位 置 。 


9 long skip(long n) 此 方法 从 此 输入 流 中 的 数据 跳 过 并 丢弃 n 个 字 节 。 


继承 的 方法 
这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 
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Java.io.FilterOutputStream X - Java.io® 


Java.io.FilterOutputStream 类 是 所 有 类 过 滤器 的 输出 流 的 超 类 。 以 下 是 关于 
FilterOutputStream 的 要 点 : 


e 类 本 身 只 是 简单 地 重 写 OutputStream 的 所 有 方法 与 所 有 请 求 传递 给 所 包含 的 输 
流 的 版 本 。 


e 这 个 类 的 子 类 可 进一步 重 写 其 中 的 一 些 方法 ， 还 可 能 提供 额外 的 方法 和 字段 。 


xy —- 
类 两 明 
以 下 是 java.io.FilterOutputStream 类 的 声明 : 


public class FilterOutputStream 
extends OutputStream 


ri 
FER 
以 下 是 java.io.FilterOutputStream 类 中 的 字段 : 


e protected OutputStream out -- 这 是 输出 流 进行 过 滤 。 


eS 


S.N. 构造 函数 & 描述 
1 FilterOutputStream(OutputStream out) 这 将 创建 基于 指定 的 基础 输 


出 流 之 上 的 输出 流 过 滤器 。 


S.N. 方法 & 描述 
1 void close() 此 方法 关闭 此 输出 流 并 释放 与 该 流 关联 的 所 有 系统 资源 。 
2 void flush() 此 方法 刷新 此 输出 流 并 强制 将 所 有 缓冲 的 输出 字 节 被 写 出 到 


到 
AL o 
3 void write(byte[] b) 此 方法 守信 b.length 个 字 节 到 输出 流 。 


void write(byte[] b, int off, int len) 此 方法 从 指定 的 字 节 数组 开始 到 当前 
输出 流 关闭 写 入 len 个 字 节 。 


5 void write(int b) 此 方法 将 指定 字 节 写 入 此 输出 流 。 
继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 


Java.io.FilterWriter - Java.io 包 


Java.io.FilterWriter 类 是 用 于 写 和 人 已 过 滤 的 字符 流 。 以 下 是 关于 FilterWriter 要 点 : 
e 类 本 身 提供 了 所 有 请 求 传递 给 所 包含 的 流 的 默认 方法 。 
e FilterWriter 子 类 应 重 写 其 中 的 一 些 方法 ， 还 可 能 提供 额外 的 方法 和 字段 。 
JA —- 
类 两 明 
以 下 是 Java.io.FilterWriter 类 的 声明 : 


public abstract class Filterwriter 
extends Writer 


ms FN 二 
字段 域 
以 下 是 Java.io.FilterWriter 类 中 的 字段 : 
e protected Writer in -- 这 是 字符 输出 流 。 


e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 对 象 。 


A MEER A 


S.N. MOS EST & 描述 
1 protected FilterWriter(Writer in) 这 将 创建 一 个 新 的 过 滤 writer。 


类 方法 


S.N. 方法 & 描述 

1 void close() 该 方法 刷 关 闭 流 。 

2 void flush() 该 方法 刷新 流 。 

3 void write(char[] cbuf, int off, int len) 此 方法 写 入 字符 数组 的 一 部 分 。 
4 void write(int c) 此 方法 写 入 的 单个 字符 。 

5 void write(String str, int off, int len) 该 方法 写 和 人 一 个 字符 串 的 一 部 分 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.Writer 


e Java.io.Object 


Java.io.InputStream X - Java.io 包 


Java.io.InputStream 类 是 表示 字 节 输入 流 的 所 有 类 的 超 类 。 这 需要 定义 
InputStream 的 子 类 的 应 用 程序 必须 始终 提供 返回 输入 的 下 一 个 字 节 的 方法 。 


xy = 
类 丙 明 
以 下 是 java.io.InputStream 类 的 声明 : 


public abstract class InputStream 
extends Object 
implements Closeable 


S.N. IGA & 描述 
1 InputStream() #418 BX 


TutorialsPoint Java 1x 7 


S.N. 方法 & 描述 


1 int available() 此 方法 从 这 个 输入 流 中 可 通过 一 个 方法 的 下 一 次 调用 阻塞 
该 输入 流 返 回 可 以 读 取 (或 跳 过 ) 的 字 节 数 的 估计 值 。 


2 void close() 此 方法 关闭 此 输入 流 并 释放 与 该 流 关联 的 所 有 系统 资源 。 


3 void mark(int readlimit) 该 方法 标志 在 此 输入 流 的 当前 位 置 。 

4 boolean markSupported() 如 果 此 输入 流 是 否 支 持 mark 和 reset 方 法 此 方 
法 测试 。 

5 abstract int read() 此 方法 读 取 从 输入 流 中 的 下 一 个 数据 字 节 。 

int read(byte[] b) 此 方法 读 取 一 定数 量 的 字 节 从 输入 流 并 将 它们 存储 到 
缓冲 区 数组 b 中 。 

7 int read(byte[] b, int off, int len) 此 方法 从 输入 流 中 读 取 多 达 |en 个 数据 的 
字 节 到 字 节 数组 。 

8 void reset() 此 方法 重新 定位 此 流 ， 当 mark 方 法 最 后 调用 这 个 输入 流 
的 位 置 。 


9 long skip(long n) 此 方法 从 此 输入 流 中 跳 过 并 丢弃 n 个 字 节 的 数据 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 
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Java.io.InputStreamReader X - Java.io 包 


Java.io.InputStreamReader 类 是 一 座 桥 从 字 节 流 与 字符 流 。 它 读 取 字 节 并 将 其 解 
码 为 使 用 指定 的 字符 集 的 字符 。 


wy = 
A FAR 
以 下 是 java.io.InputStreamReader 类 的 声明 : 


public class InputStreamReader 
extends Reader 


ri ` 
字段 域 
以 下 是 java.io.InputStreamReader 类 中 的 字段 : 


e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 画 数 


S.N. ye & 描述 

1 InputStreamReader(InputStream in) 这 将 创建 一 个 使 用 默认 字符 集 的 
输入 流 。 

2 InputStreamReader(InputStream in, Charset cs) 这 将 创建 一 个 使 用 
给 定 字符 集 的 输入 流 。 

3 InputStreamReader(InputStream in, CharsetDecoder dec) 这 将 创 
建 一 个 使 用 给 定 的 charset 解 码 器 的 输入 流 。 

4 InputStreamReader(InputStream in, String charsetName) 这 将 创建 


一 个 使 用 指定 的 字符 集 的 输入 流 。 


S.N. 方法 & 描述 

1 void close() 此 方法 关闭 该 流 并 释放 与 之 关联 的 所 有 系统 资源 。 

2 String getEncoding() 此 方法 返回 正在 使 用 此 流 的 字符 编码 的 名 称 。 
3 int read() 此 方法 读 取 单个 字符 。 


4 int read(char[] cbuf, int offset, int length) 此 方法 读 取 字符 到 一 个 数组 中 
的 一 部 分 。 


5 boolean ready() 此 方法 通知 此 流 是 否 已 准 各 好 被 读 取 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.Reader 


e Java.io.Object 


Java.io.LineNumberlnputStream X - Java.io® 


Java.io.LineNumberlnputStream 类 是 一 个 输入 流 过 滤器 ， 可 提供 跟踪 当前 的 行 
号 的 增加 的 功能 。 行 是 用 一 个 回 车 符 ('r)， 换 行 符 (' n)， 或 者 一 个 回 车 符 结 束 的 字 
节 序 列 后 面 紧 跟 一 个 换行 符 。 


\z oe 
A FA HH 
以 下 是 java.io.LineNumberlnputStream 类 的 声明 : 


public class LineNumberInputStream 
extends Reader 


字段 域 


以 下 是 java.io.LineNumberlnputStream 类 中 的 字段 : 


类 
e protected InputStream in -- 这 是 将 进行 过 滤 的 输入 流 。 


类 构造 画 数 


S.N. 构造 函数 & 描述 
1 LineNumberlnputStream(InputStream in) 此 构造 一 个 读 取 指 定 的 输 


入 流 的 输入 的 新 行 号 输入 流 。 
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S.N. 方法 & 描述 

1 int available() 此 方法 返回 可 以 从 此 输入 流 中 可 无 阻塞 读 取 的 字 节 数 。 
2 int getLineNumber() 此 方法 返回 当前 行 号 。 

3 void mark(int readlimit) 该 方法 标记 在 此 输入 流 的 当前 位 置 。 

4 int read() 此 方法 读 取 从 这 个 输入 流 数据 的 下 一 个 字 节 。 


int read(byte[] b, int off, int len) 此 方法 从 这 个 输入 流 中 读 取 多 过 |en 个 字 
节 数 据 到 字 节 数组 。 


6 void reset() 这 个 方法 重新 定位 此 流 ， 以 当时 的 mark 方 法 最 后 调用 这 个 
输入 流 中 的 位 置 。 


7 void setLineNumber(int lineNumber) 此 方法 设置 行 号 以 指定 的 参数 。 
8 long skip(long n) 这 种 方法 从 此 输入 流 中 跳 过 并 丢弃 n 个 字 节 的 数据 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.FilterInputStream 


e Java.io.Object 
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Java.io.LineNumberReader X - Java.io@ 


Java.io.LineNumberReader 类 是 跟踪 行 号 的 缓冲 字符 输入 流 。 一 行 被 认为 是 由 一 
个 换行 符 ('')， 回 车 符 (' ') 或 回 车 符 中 的 任何 一 个 被 终止 紧 跟 一 个 换行 符 。 


we = 
类 丙 明 
以 下 是 java.io.LineNumberReader 类 的 声明 : 


public class LineNumberReader 
extends BufferedReader 


= EJL 
字段 
以 下 是 java.io.LineNumberReader 类 中 的 字段 : 


e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


X MSS ERR 


S.N. TS ES XC & Th 


LineNumberReader(Reader in) 这 将 创建 一 个 新 的 行 号 读 取 器 ， 使 用 
默认 输入 缓冲 区 的 大 小 。 


LineNumberReader(Reader in, int sz) 这 将 创建 一 个 新 的 行 号 读 取 
器 ， 将 字符 读 入 给 定 大 小 的 缓冲 区 。 


1 
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S.N. 方法 & 描述 
1 int getLineNumber() 此 方法 获取 当前 行 号 。 
2 void mark(int readAheadLimit) 此 方法 标记 流 中 的 当前 位 置 。 


3 int read() 此 方法 读 取 单 个 字符 。 
int read(char[] cbuf, int off, int len) 此 方法 读 字 符 到 一 个 数组 的 某 一 部 


4 

5 String readLine() 此 方法 读 取 一 行文 本 。 

6 void reset() 此 方法 重 置 流 的 最 近 标 记 。 

7 void setLineNumber(int lineNumber) 此 方法 设置 的 当前 行 数 。 
8 long skip(long n) 此 方法 跳 过 n 个 字符 。 


方法 继承 

这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.BufferedReader 
e Java.io.Reader 


e Java.io.Object 


sa) ae AN alsmeD ld i DE ee 
Java.io.LineNumberReader # - Java.iog 


Java.io.ObjectinputStream X - Java.io 包 
Java.io.ObjectiInputStream 类 反 序列 化 的 原始 数据 和 以 前 写 的 对 象 使 用 一 个 
ObjectOutputStream。 以 下 是 关于 缓冲 输入 流 的 要 点 : 


e 它 是 用 来 恢复 先前 序列 化 的 对 象 。 它 确保 所 有 对 象 的 图 形 中 从 流 中 创建 的 类 型 
匹配 存在 于 Java 虚 拟 机 的 类 。 


e 类 加 载 使 用 标准 的 机 制 ， 作 为 必需 的 。 
类 声明 
以 下 是 java.io.ObjectlnputStream 类 的 声明 : 


public class ObjectInputStream 
extends InputStream 
implements ObjectInput, ObjectStreamConstants 


3X MER ZA 
S.N. MS HR & 描述 
protected ObjectlnputStream() 这 个 子 类 ， 是 完全 重新 实现 
1 ObjectInputStream 到 不 必 分 配 仅 由 ObjectiInputStream 实 现 私 有 数据 提 
供 了 一 种 方法 。 
2 ObjectInputStream(InputStream in) 这 将 创建 一 个 ObjectlnputStream 从 


指定 的 InputStream 。 


类 方法 


S.N. 方法 & 描述 
1 int available() 此 方法 返回 可 以 不 受阻 塞 地 读 取 的 字 节 数 。 


2 void close() 此 方法 关闭 输入 流 。 
3 void defaultReadObject() 此 方法 读 取 当 前 类 的 从 这 个 流 中 的 非 静 态 和 非 


瞬 态 字段。 


protected boolean enableResolveObject(boolean enable) 此 方法 使 该 
流 ， 以 允许 要 被 替换 从 流 中 读 取 的 对 象 。 


5 int read() 此 方法 读 取 一 个 字 节 的 数据 。 
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int read(byte[] buf, int off, int len) 此 方法 读 取 到 一 个 字 节 数组 。 
boolean readBoolean() 此 方法 读 取 一 个 布尔 值 。 

byte readByte() 此 方法 读 取 一 个 8 位 字 节 。 

char readChar() 此 方法 返回 16 位 字符 。 


protected ObjectStreamClass readClassDescriptor() 这 种 方法 读 取 序列 
化 流 的 类 描述 符 。 


double readDouble() 此 方法 污 取 一 个 64 位 双 。 


ObjectInputStream.GetField readFields() 此 方法 从 流 中 读 取 持久 字段 并 
使 其 可 通过 名 称 。 


float readFloat() 此 方法 读 取 一 个 32 位 浮 点 。 
void readFully(byte[] buf) 此 方法 读 取 字 节 ， 阻 塞 直到 所 有 字 节 被 读 取 。 


void readFully(byte[] buf, int off, int len) 此 方法 读 取 字 节 ， 阻 塞 直 到 所 
有 字 节 被 读 取 。 


int readlnt() 此 方法 读 取 一 个 32 位 的 整数 。 
long readLong() 此 方法 读 取 一 个 64 位 长 。 
Object readObject() 此 方法 从 ObjectlnputStream 中 读 取 对 象 。 


protected Object readObjectOverride() 这 种 方法 被 称 为 由 
ObjectOutputStream 受 信任 子 类 使 用 受 保护 的 无 参数 构造 本 数 构造 对 象 


输出 流 。 
short readShort() 此 方法 读 取 一 个 16 位 的 短 类 型 。 


protected void readStreamHeader() 提供 此 方法 允许 子 类 读 取 并 验证 自 
己 的 数据 流 头 。 


Object readUnshared() 此 方法 从 ObjectInputStream 中 读 取 “ 非 共 享 " 对 
象 。 


int readUnsignedByte() 此 方法 读 取 一 个 无 符号 8 位 字 节 。 
int readUnsignedShort() 此 方法 读 取 一 个 无 符号 的 16 位 短 类 型 。 
String readUTF() This method reads a String in modified UTF-8 format. 


void registerValidation(ObjectInputValidation obj, int prio) 此 方法 注册 对 
象 的 图 形 被 返回 之 前 进行 验证 。 

protected Class<?> resolveClass(ObjectStreamClass desc) 此 方法 加 
载 本 地 类 相当 于 指定 的 流 类 的 描述 。 


protected Object resolveObject(Object obj) 此 方法 允许 
ObjectlnputStream 受 信任 子 类 反 序 列 化 过 程 中 一 个 对 象 蔡 代 另 一 个 。 
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protected Class<?> resolveProxyClass(String[] interfaces) 此 方法 返回 

29 一 个 实现 在 代理 类 的 描述 符 指定 接口 的 代理 类 ; 子 类 可 以 实现 此 方法 ， 从 
随 描 述 符 和 动态 代理 类 流 中 读 取 自 定义 数据 ， 人 允许 它们 使 用 的 替换 加 载 
机 制 的 接口 和 代理 类 。 


30 int skipBytes(int len) 此 方法 跳 过 len 个 字 节 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.InputStream 
e Java.io.Object 


e Java.io.Objectlnput 


Java.io.ObjectinputStream.GetField # - Java.io 


a 


Java.io.ObjectlnputStream.GetField 类 提供 对 从 输入 流 中 读 取 持久 字段。 
Pe 

类 丙 明 

以 下 是 Java.io.ObjectlnputStream.GetField 类 的 声明 : 


public abstract static class ObjectInputStream.GetField 
extends Object 


SHE T7 z 
3€ 7478 RN 
S.N. Hise & 描述 
1 ObjectinputStream.GetField() Single Constructor 


TutorialsPoint Java 技术 教程 


一 


S.N. 方法 & 描述 


abstract boolean defaulted(String name) 此 方法 返回 true， 如 果 指 定 的 
字段 是 默认 的 ， 也 没有 这 个 值 在 流 中 。 


abstract boolean get(String name, boolean val) 此 方法 从 持久 字段 获取 


2 “指定 的 布尔 字段 的 值 。 

3 abstract byte get(String name, byte val) 此 方法 从 持久 字段 获取 指定 字 
节 字 段 的 值 。 

4 abstract char get(String name, char val) 此 方法 从 持久 字段 获取 指定 
char 字 段 的 值 。 

5 abstract double get(String name, double val) 此 方法 从 持久 字段 获取 指 
定 的 double 字 段 的 值 。 

6 abstract float get(String name, float val) 此 方法 从 持久 字段 获取 指定 浮 
点 (float) 字 段 的 值 。 

7 abstract int get(String name, int val) 此 方法 从 持久 字段 获取 指定 的 整 型 
(int) 字 段 的 值 。 

8 abstract long get(String name, long val) 此 方法 从 持久 字段 获取 指定 
long 字 段 的 值 。 

9 abstract Object get(String name, Object val) 此 方法 从 持久 字段 获取 指 
定 的 对 象 字段 的 值 。 

10 abstract short get(String name, short val) 此 方法 从 持久 字段 获取 指定 的 
short 字 段 的 值 。 

11 abstract ObjectStreamClass getObjectStreamClass() 此 方法 获取 描述 


流 中 的 ObjectStreamClass 字 段 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 
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Java.io.ObjectOutputStream X - Java.io 包 


Java.io.ObjectOutputStream 类 写 人 基本 数据 类 型 和 Java 对 象 的 图 形 到 
OutputStream。 这 些 对 象 可 以 被 读 取 ( 重 组 ) 使 用 ObjectlnputStream。 


4 ob 
AX Fa AR 
以 下 是 java.io.ObjectOutputStream 类 的 声明 : 


public class ObjectOutputStream 
extends OutputStream 
implements ObjectOutput, ObjectStreamConstants 


S.N. Wis HX & 描述 
protected ObjectOutputStream() 这 提供 了 一 种 方法 ， 子 类 是 完全 重 
1 新 实现 ObjectOutputStream 来 不 必 分 配 仅 由 这 个 实现 
ObjectOutputStream 的 私有 数据 。 
2 ObjectOutputStream(OutputStream out) 这 将 创建 一 个 指定 的 


OutputStream 写 人 到 一 个 ObjectOutputStream。 


类 方法 


S.N. 方法 & 描述 

1 protected void annotateClass(Class «?» cl) 子 类 可 以 实现 此 方法 允许 类 
的 数据 被 存储 在 流 中 。 

2 protected void annotateProxyClass(Class«?» cl) 子 类 可 以 实现 此 方法 


来 存储 自 定义 数据 的 描述 符 动 态 代理 类 的 流 中 。 
3 void close() 此 方法 关闭 该 流 。 
void defaultWriteObject() 此 方法 写 入 当前 类 的 非 静 态 和 非 瞬 态 字 段 守信 


此 流 。 


5 protected void drain() 此 方法 排出 ObjectOutputStream 的 所 有 缓冲 的 数 
据 。 


protected boolean enableReplaceObject(boolean enable) 此 方法 使 流 
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6 执行 流 中 的 替换 对 象 。 


7 void flush() 此 方法 刷新 流 。 


ObjectOutputStream.PutField putFields() 此 方法 检索 用 于 缓冲 持久 性 字 
段 被 写 和 人 流 的 对 象 。 


protected Object replaceObject(Object obj) 此 方法 允许 
9 ObjectOutputStream 的 受信 任 子 类 的 序列 化 过 程 中 一 个 对 象 蔡 代 另 一 
个 


[`o 


10 void reset() 此 方法 复位 将 忽略 已 经 写 入 流 中 的 任何 对 象 的 状态 。 


void useProtocolVersion(int version) 将 数据 写 入 流 时 ， 此 方法 指定 流 协 
议 版 本 才能 使 用 。 


12 void write(byte[] buf) 此 方法 写 入 的 字 节 数组 .. 

13 void write(byte[] buf, int off, int len) 此 方法 写 入 的 字 节 子 数组 。 

14 void write(int val) 此 方法 写 入 一 个 字 节 。 

15 void writeBoolean(boolean val) 此 方法 写 入 一 个 布尔 值 。 

16 void writeByte(int val) 此 方法 写 入 一 个 8 位 字 节 。 

17 void writeBytes(String str) 此 方法 写 入 一 个 String 作 为 一 个 字 节 序列 。 
18 void writeChar(int val) 此 方法 写 入 一 个 16 位 字符 。 

19 void writeChars(String str) 此 方法 写 和 人 一 个 字符 串 作 为 字符 的 序列 。 


protected void writeClassDescriptor(ObjectStreamClass desc) 此 方法 
写 入 指定 的 类 描述 符 的 对 象 输出 流 。 


21 void writeDouble(double val) 此 方法 写 入 一 个 64 位 double。 
22 void writeFields() 此 方法 写 入 缓冲 字段 的 流 .. 

23 void writeFloat(float val) 此 方法 写 入 一 个 32 位 浮 点 数 。 

24 void writeInt(int val) 此 方法 写 入 一 个 32 位 整数 。 

25 void writeLong(long val) 此 方法 写 入 一 个 64 位 long。 

void writeObject(Object obj) 此 方法 将 指定 的 对 象 写 入 


20 ObjectOutputStream 中 。 
27 protected void writeObjectOverride(Object obj) 此 方法 由 子 类 重 写 默 认 
writeObject 方 法 。 


28 void writeShort(int val) 此 方法 写 入 一 个 16 位 的 short.. 


protected void writeStreamHeader() 提供 此 方法 ， 所 以 子 类 可 以 追加 或 


29 预先 准 各 自己 的 头 流 。 
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30 流 。 


void writerUTF(String str) 这 个 字符 串 在 经 修订 的 UTF-8 格 式 此 方法 原始 


31 AMEBA, 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 


Java.io.ObjectOutputStream.PutField # - 
Java.io® 


Java.io.ObjectOutputStream.PutField 类 提供 编程 访问 持久 字段 写 入 
ObjectOutput。 


44 — 
类 丙 明 
以 下 是 Java.io.ObjectOutputStream.PutField 类 的 声明 : 


public abstract static class ObjectOutputStream.PutField 
extends Object 


SHE T7 z 
类 构造 函数 
S.N. IGA & 描述 
1 ObjectOutputStream.PutField() 单一 构造 画 数 
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S.N. 方法 & 描述 

1 abstract void put(String name, boolean val) 此 方法 把 指定 的 布尔 字段 的 
值 放 到 持久 性 字段 。 

2 abstract void put(String name, byte val) 此 方法 把 指定 的 字 节 字段 的 值 
放 到 持久 性 字段 。 

3 abstract void put(String name, char val) 此 方法 把 指定 的 char 字 段 的 值 
放 到 持久 性 字段 。 

4 abstract void put(String name, double val) 此 方法 把 指定 的 双 字 段 的 值 
放 到 持久 性 字段 。 

5 abstract void put(String name, float val) 此 方法 把 据 定 的 浮 点 型 字段 的 
值 放 到 持久 性 字段 。 

6 abstract void put(String name, int val) 此 方法 把 指定 的 整 型 字段 的 值 放 
到 持久 性 字段 。 

7 abstract void put(String name, long val) 此 方法 把 指定 的 long 字 段 的 值 
放 到 持久 性 字段 。 

8 abstract void put(String name, Object val) 此 方法 把 指定 的 对 象 字段 的 
值 放 到 持久 性 字段 。 

9 abstract void put(String name, short val) 此 方法 把 指定 的 短 字段 的 值 放 
到 持久 性 字段 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 
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Java.io.ObjectStreamClass X - Java.io 包 


Java.io.ObjectStreamClass 类 是 序列 化 的 描述 符 类 。 它 包含 类 的 名 称 和 
serialVersionUID。 ObjectStreamClass 在 这 个 Java 虚 拟 机 加 载 一 个 特定 的 类 都 可 以 
使 用 查找 方法 找到 /创建 。 

4 ob 

AX Fa AR 
以 下 是 java.io.ObjectStreamClass 类 的 声明 : 


public class ObjectStreamClass 
extends Object 
implements Serializable 


ra EN 二 
字段 域 
以 下 是 java.io.ObjectStreamClass 类 的 字段 : 
e static ObjectStreamField[] NO FIELDS -- 这 是 serialPersistentFields 值 ， 表 示 
不 序列 化 字段 。 


类 方法 


S.N. 方法 & 描述 
1 Class<?> forClass() 此 方法 返回 这 个 版 本 被 映射 到 类 中 的 本 地 VM。 
ObjectStreamField getField(String name) 该 方法 通过 名 字 得 到 这 个 类 


“ 的 字段 。 

3 eee getFields() 此 方法 返回 当前 序列 化 类 的 字段 的 数 

4 String getName() 此 方法 返回 由 这 个 描述 符 描述 的 类 的 名 称 。 

5 long getSerialVersionUID() 此 方法 返回 这 个 类 的 serialVersionUID。 

6 static ObjectStreamClass lookup(Class<?> cl) 此 方法 找到 该 描述 符 为 
可 序列 化 的 类 。 

7 static ObjectStreamClass lookupAny(Class«?» cl) 此 方法 返回 的 描述 符 


的 任何 类 ， 不 管 它 是 否 实现 Serializable 接 口 。 


8 String toString() 此 方法 返回 描述 这 个 ObjectStreamClass 的 字符 串 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 


Java.io.ObjectStreamField X - Java.io 包 


Java.io.ObjectStreamField 类 是 可 序列 化 字段 来 自 Serializable 类 的 描述 。 
ObjectStreamFields 数 组 用 来 声明 一 个 类 的 序列 化 字段 。 


wy = 
类 丙 明 
以 下 是 Java.io.ObjectStreamField 类 的 声明 : 


public class ObjectStreamField 
extends Object 
implements Comparable<Object> 


S.N. ye & 描述 

1 ObjectStreamField(String name, Class<?> type) 使 用 指定 类 型 创建 
一 个 序列 化 的 字段 。 
ObjectStreamField(String name, Class<?> type, boolean 

2 unshared) 这 将 创建 ObjectStreamField 表 示 给 定 的 名 称 和 类 型 可 序列 化 
字段 。 
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S.N. 方法 & 描述 

1 compareTo(Object obj) 这 种 方法 此 字段 与 其 他 ObjectStreamField 比 
Bo 

2 String getName() 此 方法 获取 该 字段 的 名 称 。 

3 int getOffset() 此 方法 返回 字段 的 实例 数据 的 偏 移 量 。 

4 Class<?> getType() 此 方法 获取 字段 的 类 型 。 

5 char getTypeCode() 此 方法 返回 字段 类 型 的 字符 编码 。 

6 String getTypeString() 此 方法 返回 JVM 类 型 签名 。 

7 boolean isPrimitive() 如 果 这 个 字段 为 基本 类 型 ， 此 方法 返回 true。 

8 boolean isUnshared() 此 方法 返回 布尔 值 指示 是 否 通过 
ObjectStreamField 实 例 所 表示 的 序列 化 字段 是 独 享 的 。 

9 protected void setOffset(int offset) 此 方法 返回 的 实例 数据 中 的 偏 移 量 。 

10 String toString() 此 方法 返回 一 个 描述 此 字段 的 字符 串 。 

继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 


e Java.io.Object 


Java.io 
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Java.io.OutputStreamWriter X: - Java.io 包 


Java.io.OutputStreamWriter 类 是 从 字符 流 桥 接 字 节 流 。 写 和 人 字符 编码 成 使 用 指 
定 的 字符 集 的 字 节 。 


J^ Œ 
X Fa BH 
以 下 是 Java.io.OutputStreamWriter 类 的 声明 : 


public class OutputStreamwriter 
extends Writer 


ri 
字段 
以 下 是 Java.io.OutputStreamWriter 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 画 数 


S.N. 构造 函数 & 描述 
1 OutputStreamWriter(OutputStream out) 这 将 创建 一 个 使 用 默认 的 字 


符 编 码 的 OutputStreamWriter。 


2 OutputStreamWriter(OutputStream out, Charset cs) 这 将 创建 一 个 
使 用 给 定 字 符 集 的 OutputStreamWriter。 


3 OutputStreamWriter(OutputStream out, CharsetEncoder enc) 这 将 
创建 一 个 使 用 给 定 的 charset 编 码 器 的 OutputStreamWriter。 


4 OutputStreamWriter(OutputStream out, String charsetName) 这 将 
创建 一 个 使 用 指定 的 字符 集 的 OutputStreamWriter。 
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S.N. 方法 & 描述 

1 void close() 此 方法 关闭 该 流 ， 但 要 先 刷 新 它 。 

void flush() 此 方法 刷新 流 。 

String getEncoding() 此 方法 返回 正在 使 用 此 流 的 字符 编码 的 名 称 。 
void write(char[] cbuf, int off, int len) 此 方法 宇和 字符 数组 的 一 部 分 。 
void write(int c) 此 方法 写 入 的 单个 字符 。 

void write(String str, int off, int len) 此 方法 将 写 入 一 个 字符 串 的 一 部 分 。 


O a A C N 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.Writer 


e Java.io.Object 
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Java.io.PipedinputStream X - Java.io 包 


Java.io.PipedinputStream 类 是 一 个 管道 输入 流 ， 可 以 连接 到 一 个 管道 输出 流 ， 管 
道 输入 流 提供 的 所 有 数据 字 节 写 入 管道 输出 流 。 以 下 是 有 关 PipedlnputStream 的 要 
点 : 

e 该 管道 输入 流 包含 一 个 缓冲 区 ， 解 耦 读 操 作 和 写 操 作 限 制 之 内 。 

。 不 推荐 试图 从 单个 线程 使 用 这 两 个 对 象 ， 因 为 它 可 能 会 死 锁 的 线程 。 

e 管道 ， 如 果 被 提供 的 数据 字 节 连接 的 管道 输出 流 线 程 不 再 处 于 活动 状态 被 打 


Ti. 
类 声明 


以 下 是 java.io.PipedlnputStream 类 的 声明 : 


public class PipedInputStream 
extends InputStream 


ri 
FER 
以 下 是 java.io.PipedlnputStream 类 中 的 字段 : 
e protected byte[] buffer -- 一 个 循环 缓冲 区 在 其 中 输入 数据 被 放置 。 


e protected int in -- 在 循环 缓冲 区 的 数据 的 下 一 个 字 节 从 连接 的 管道 输出 流 中 接 
收 时 将 存储 的 位 置 的 索引 。 


e protected int out -- 在 循环 缓冲 区 的 位 置 ， 在 该 数据 的 下 一 个 字 节 将 通过 这 个 管 
道 输 入 流 中 读 取 的 索引 。 


e protected static int PIPE_SIZE -- 管道 的 循环 输入 缓冲 区 的 默认 大 小 。 


类 构造 画 数 


S.N. TS SX & 描述 
1 PipedinputStream() 这 创建 了 一 个 管道 输入 流 ， 以 便 它 尚未 连接 。 
PipedinputStream(int pipeSize) 这 创建 了 一 个 管道 输入 流 ， 以 便 它 尚 


“ 未 连接 ， 并 使 用 指定 的 管道 大 小 为 管道 缓冲 区 。 

3 PipedinputStream(PipedOutputStream src) 这 将 创建 一 个 管道 输入 
流 ， 使 其 连接 到 管道 输出 流 src 中 。 
PipedinputStream(PipedOutputStream src, int pipeSize) 这 创建 了 

4 一 个 管道 输入 流 ， 以 便 它 被 连接 到 管道 输出 流 src 和 使 用 指定 的 管道 尺寸 


为 管道 缓冲 区 。 


类 方法 


S.N. 方法 & 描述 
1 int available() 此 方法 返回 可 以 从 此 输入 流 中 可 无 阻塞 读 取 的 字 节 数 。 


2 void close() 此 方法 关闭 此 管道 输入 流 并 释放 与 该 流 关联 的 所 有 系统 资 


N 
To 


void connect(PipedOutputStream src) 此 方法 使 该 管道 输入 流连 接 到 管 


道 输出 流 src 中 。 

4 int read() 此 方法 从 这 个 管道 输入 流 中 读 取 下 一 个 数据 字 节 。 

5 int read(byte[] b, int off, int len) 此 方法 读 取 了 从 该 管道 输入 流 中 len 个 字 
节 数 据 到 一 个 字 节 数组 。 

6 protected void receive(int b) 这 个 方法 接收 一 个 字 节 的 数据 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.InputStream 


e Java.io.Object 


Java.io.PipedinputStream.available() 534 3: (1 - 
Java.io 包 


java.io.PipedInputStream.available() 方法 返回 可 以 从 此 输入 流 中 可 无 阻塞 读 取 的 
字 节 数 。 


s 
Fa BH 
以 下 是 java.io.PipedlnputStream.available() 方 法 的 声明 


public int available() 


3 [E] f 


此 方法 返回 可 以 从 此 输入 流 而 不 阻塞 ， 或 0 读 取 的 字 节 数 ， 如 果 这 个 输入 流 已 天 闭 
通过 调用 close() 方 法 ， 或 者 如 果 管 道 未 连接 ， 或 中 断 。 


FL 
FB 
e lOException -- 如 果 发 生 |/ O 错 误 。 


例子 


下 面 的 示例 演示 java.io.PipedlnputStream.available() 方 法 的 用 法 。 


package com.yiibai; 
import java.io.*; 
public class PipedInputStreamDemo { 
public static void main(String[] args) { 
// create a new Piped input and Output Stream 


PipedOutputStream out = new PipedOutputStream(); 
PipedInputStream in = new PipedInputStream(); 


try { 
// connect input and output 
in.connect(out); 


// write something 
out .write(70); 
out .write(71); 


// print how many bytes are available 
System.out.println("" + in.available()); 


// read what we wrote 


for (int i = 0; i < 2; i++) { 
System.out.println("" + (char) in.read()); 
} 


} catch (IOException ex) { 
ex.printStackTrace(); 
} 


让 我 们 编译 和 运行 上 面 的 程序 ， 这 将 产生 以 下 结果 : 


TI N 


Java.io.PipedOutputStream X - Java.io 包 


Java.io.PipedOutputStream 类 是 一 个 管道 输出 流 可 以 连接 到 一 个 管道 输入 流 ， 以 
创建 通信 管道 。 以 下 是 有 关 PipedOutputStream 要 点 : 


该 管道 输出 流 是 管道 的 发 送 端 。 
不 推荐 试图 从 单个 线程 使 用 这 两 个 对 象 ， 因 为 它 可 能 会 死 锁 的 线程 。 


数据 被 写 和 人 到 一 个 管道 输出 流 对 象 由 一 个 线程 和 数据 是 从 由 其 他 线程 所 连接 的 
PipedlnputStream 读 取 。 


该 管道 如 果 是 从 连接 中 读 取 数 据 字 节 的 线程 管道 输入 流 被 中 断 已 不 再 是 活动 。 


类 声明 


以 下 是 java.io.PipedOutputStream 类 的 声明 : 


public class PipedOutputStream 


extends OutputStream 


S.N. 构造 画 数 & 描述 


PipedOutputStream() 这 将 创建 一 个 尚未 连接 到 一 个 管道 输入 流 的 管道 
输出 流 。 

PipedOutputStream(PipedInputStream snk) 这 将 创建 连接 到 指定 的 
管道 输入 流 的 管道 输出 流 。 


S.N. 方法 & 描述 
void close() 此 方法 关闭 此 管道 输出 流 并 释放 和 与 此 流 有 关 的 所 有 系统 次 


源 。 
2 void connect(PipedInputStream snk) 此 方法 这 个 管道 输出 流连 接 到 一 个 
接收 器 。 


3 void flush() 此 方法 刷新 此 输出 流 并 强制 将 所 有 缓冲 的 输出 字 节 被 写 出 。 
void write(byte[] b, int off, int len) 此 方法 从 指定 的 字 节 数组 开始 到 这 个 


: 管道 输出 流 偏 移 量 off 写 入 len 字 节 。 
5 void write(int b) 此 方法 写 入 指定 的 字 节 到 管道 输出 流 。 


继承 的 方法 
这 个 类 继承 自 以 下 类 方法 : 
e Java.io.OutputStream 


e Java.io.Object 


Java.io.PipedReader X: - Java.io 包 
Java.io.PipedReader 类 是 管道 字符 输入 流 。 

类 声明 

以 下 是 java.io.PipedReader 类 的 声明 : 


public class PipedReader 
extends Reader 


字段 
以 下 是 java.io.PipedReader 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 画 数 


S.N. 构造 函数 & 描述 

1 PipedReader() 这 创造 了 一 个 PipedReader 以 便 它 尚未 连接 。 

2 PipedReader(int pipeSize) 这 将 创建 一 个 PipedReader 以 便 它 尚未 连 
接 ， 并 使 用 指定 的 管道 大 小 ， 管 道 缓冲 区 。 

3 PipedReader(PipedWriter src) 这 将 创建 一 个 PipedReader 以 便 它 被 连 
接 到 传送 writer src 中 。 
PipedReader(PipedWriter src, int pipeSize) 这 将 创建 一 个 

4 PipedReader 以 便 它 被 连接 到 传送 writer src 和 使 用 指定 的 管道 大 小 ， 管 
道 缓冲 区 。 


S.N. 方法 & 描述 
1 void close() 此 方法 关闭 这 个 管道 流 并 释放 和 与 该 流 关 联 的 所 有 系统 资源 。 
2 void connect(PipedWriter src) 此 方法 使 该 管道 读 取 器 连接 到 传送 writer 


src 中 。 
3 int read() 这 个 方法 从 这 个 管道 流 中 读 取 数 据 的 下 一 个 字符 。 
4 int read(char[] cbuf, int off, int len) 此 方法 读 取 最 多 从 这 个 管道 流 中 len 


个 数据 字符 转换 成 字符 数组 。 
5 boolean ready() 此 方法 判断 此 流 是 否 已 准备 好 被 读 取 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.Reader 


e Java.io.Object 


Java.io.PipedWriter3: - Java.io 包 
Java.io.PipedWriter 类 是 管道 字符 输出 流 。 

类 声明 

以 下 是 java.io.PipedWriter 类 的 声明 : 


public class PipedWriter 
extends Writer 


字段 域 
以 下 是 java.io.PipedWriter 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 画 数 


S.N. IGA & 描述 

1 PipedWriter() 这 将 创建 一 个 尚未 连接 到 一 个 管道 读 取 一 个 管道 写 入 

2 PipedWriter(PipedReader snk) 这 将 创建 一 个 写 人 器 管道 连接 到 指定 
的 管道 读 取 器 。 


S.N. 方法 & 描述 


void close() 此 方法 关闭 此 管道 输出 流 并 释放 与 此 流 有 关 的 所 有 系统 资 
源 。 


2 void connect(PipedReader snk) 此 方法 连接 该 管道 写 人 器 到 一 个 接收 


3 void flush() 此 方法 刷新 此 输出 流 并 强制 宇 出 所 有 缓冲 的 输出 字符 。 


4 void write(char[] cbuf, int off, int len) 此 方法 写 入 len 个 字符 从 指定 的 字符 
数组 开始 到 这 个 管道 输出 流 偏 移 量 。 


5 void write(int c) 此 方法 写 入 指定 的 字符 到 管道 输出 流 。 


继承 的 方法 


这 个 类 继承 自 以 下 类 方法 : 
e Java.io.Writer 


e Java.io.Object 


Java.io.PrintStream X - Java.io@ 


Java.io.PrintStream 类 添加 功能 到 另 一 个 输出 流 ， 打 印 各 种 数据 值 表示 形式 方便 的 


有 /Jo。 

J^ Œ 

类 两 明 

以 下 是 java.io.PrintStream 类 的 声明 : 


public class PrintStream 
extends FilterOutputStream 
implements Appendable, Closeable 


ri x 
字段 域 
以 下 是 java.io.PrintStream 类 中 的 字段 : 


e protected OutputStream out -- 输出 流 进 行 过 滤 。 


类 构造 画 数 


S.N. Wis HR & 描述 
1 PrintStream(File file) 这 将 创建 一 个 新 的 打印 流 ， 和 与 指定 的 文件 无 自动 行 
刷新 。 


2 PrintStream(File file, String csn) 这 将 创建 一 个 新 的 打印 流 ， 无 自动 行 刷 
新 ， 指 定 文 件 和 字符 集 。 


3 PrintStream(OutputStream out) 这 将 创建 一 个 新 的 打印 流 。 

4 PrintStream(OutputStream out, boolean autoFlush) 这 将 创建 一 个 新 的 
打印 流 。 

5 PrintStream(OutputStream out, boolean autoFlush, String encoding) 这 


将 创建 一 个 新 的 打印 流 。 


6 PrintStream(String fileName) 这 将 创建 一 个 新 的 打印 流 ， 无 自动 行 刷新 
的 ， 与 指定 的 文件 名 。 


PrintStream(String fileName, String csn) 这 将 创建 一 个 新 的 打印 流 ， 无 
自动 行 刷 新 ， 用 指定 的 文件 名 和 字符 集 。 


N 
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类 方法 


S.N. 方法 & 描述 

1 PrintStream append(char c) 此 方法 将 指定 字符 追加 到 当前 输出 流 。 

2 PrintStream append(CharSequence csq) 此 方法 将 指定 的 字符 序列 此 输 
出 流 。 


PrintStream append(CharSequence csq, int start, int end) 此 方法 将 指 
定 的 字符 序列 的 子 序 列 来 此 输出 流 。 


4 boolean checkError() 此 方法 刷新 流 并 检查 其 错误 状态 。 
5 protected void clearError() 此 方法 清除 该 流 的 内 部 错误 状态 。 
6 void close() 此 方法 关闭 该 流 。 

7 void flush() 此 方法 刷新 流 。 

PrintStream format(Locale |, String format, Object... args) 此 方法 写 人 


2 一 个 格式 化 字符 串 使 用 指定 格式 字符 串 和 参数 此 输出 流 。 
9 PrintStream format(String format, Object... args) 此 方法 写 入 一 个 格式 


化 字符 串 使 用 指定 格式 字符 串 和 参数 此 输出 流 。 

10 void print(boolean b) 此 方法 打印 一 个 布尔 值 。 

11 void print(char c) 这 种 方法 打印 的 字符 。 

12 void print(char[] s) 这 种 方法 打印 一 个 字符 数组 。 

13 void print(double d) 此 方法 打印 一 个 双 精 度 浮 点 数 。 
14 void print(float f) 此 方法 打印 一 个 浮 点 数 。 

15 void print(int i) 此 方法 打印 一 个 整数 -int。 

16 void print(long I) 此 方法 打印 一 个 长 整数 -long。 

17 void print(Object obj) 此 方法 打印 一 个 对 象 。 

18 void print(String s) 此 方法 打印 一 个 字符 串 。 


PrintStream printf(Locale |, String format, Object... args) 这 是 一 个 方便 


19 的 方法 使 用 指定 格式 字符 串 和 参数 将 格式 化 字符 串 写 入 此 输出 流 。 
20 PrintStream printf(String format, Object... args) 这 是 一 个 方便 的 方法 使 


用 指定 格式 字符 串 和 参数 将 格式 化 字符 串 写 和 人 此 输出 流 。 

21 void printin() 此 方法 通过 写 和 信行 分 隔 符 字 符 串 终止 当前 行 。 

22 void printIn(boolean x) 此 方法 打印 一 个 布尔 值 ， 然 后 终止 该 行 。 
23 void println(char x) 此 方法 打印 一 个 字符 ， 然 后 终止 该 行 。 
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24 void printIn(char[] x) 此 方法 打印 字符 数组 ， 然 后 终止 该 行 。 
25 void printIn(double x) 此 方法 打印 double， 然 后 终止 该 行 。 
26 void println(float x) 此 方法 打印 一 个 float， 然 后 终止 该 行 。 
27 void printIn(int x) 此 方法 打印 一 个 整数 int， 然 后 终止 该 行 。 
28 void println(long x) 此 方法 打印 一 个 long， {Te 
29 void printIn(Object x) 此 方法 打印 一 个 对 象 ， 然 后 终止 该 行 。 
30 void printIn(String x) ae 然后 终止 该 行 。 
31 protected void setError() 此 方法 设置 流 的 错误 状态 为 true。 


void write(byte[] buf, int off, int len) 此 方法 从 指定 的 字 节 数组 开始 ， 在 
这 个 流 offset 偏 移 写 入 len 字 节 。 


33 void write(int b) 此 方法 将 指定 字 节 写 入 此 流 。 


32 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.FilterOutputStream 


e Java.io.Object 


Java.io.PrintWriter - Java.io® 
Java.io.PrintWriter 类 打印 格式 化 对 象 的 表示 到 文本 输出 流 。 
类 声明 

以 下 是 java.io.PrintWriter 类 的 声明 : 


public class PrintWriter 
extends Writer 


ra FEN 二 
字段 域 
以 下 是 java.io.PrintWriter 类 中 的 字段 : 
e protected Writer out -- 这 是 该 PrintWriter 字 符 输 出 流 。 


e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 图 数 


S.N Wis WX & 描述 

1 PrintWriter(File file) 这 将 创建 一 个 新 的 PrintWriter， 不 带 自 动 行 刷 新 指 
定 文 件 。 

2 PrintWriter(File file, String csn) 这 将 创建 一 个 新 的 PrintWriter， 不 带 
自动 行 刷新 的 指定 文件 和 字符 集 。 

3 PrintWriter(OutputStream out) 这 将 创建 一 个 新 的 PrintWriter， 无 自动 
行 刷 新 ， 从 现 有 的 OutputStream。 

4 PrintWriter(OutputStream out, boolean autoFlush) 这 将 创建 从 现 有 
的 OutputStream 一 个 新 的 PrintWriter。 

5 PrintWriter(String fileName) 这 将 创建 一 个 新 的 PrintWriter， 无 自动 行 
刷新 ， 用 指定 的 文件 名 。 

6 PrintWriter(String fileName, String csn) 这 将 创建 一 个 新 的 
PrintWriter， 无 自动 行 刷 新 ， 用 指定 的 文件 名 和 字符 集 。 

7 PrintWriter(Writer out) 这 将 创建 一 个 新 的 PrintWriter， 无 自动 行 刷 
新 。 

3 PrintWriter(Writer out, boolean autoFlush) 这 将 创建 一 个 新 的 
PrintWriter。 

类 方法 

S.N. 方法 & 描述 

1 PrintWriter append(char c) 此 方法 将 指定 字符 追加 到 这 个 writer。 
PrintWriter append(CharSequence csq) 此 方法 将 指定 的 字符 序列 到 此 
Writer。 

3 PrintWriter append(CharSequence csq, int start, int end) 此 方法 将 指定 
的 字符 序列 的 子 序列 写 入 此 writer。 

4 boolean checkError() 这 个 方法 刷新 流 ， 如 果 它 没有 关闭 ， 并 检查 其 错 
误 状 态 。 

5 protected void clearError() 这 种 方法 清除 该 流 的 错误 状态 .. 

6 void close() 此 方法 关闭 该 流 并 释放 与 之 关联 的 所 有 系统 资源 。 

7 void flush() 此 方法 刷新 该 流 .. 
PrintWriter format(Locale |, String format, Object... args) 使 用 指定 的 格 
式 字 符 串 和 参数 此 方法 写 和 人 一 个 格式 化 的 字符 串 写 人 此 writer.. 

9 PrintWriter format(String format, Object... args) 使 用 指定 的 格式 字符 串 


和 参数 此 方法 写 入 一 个 格式 化 的 字符 串 写 入 此 writer.. 
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10 void print(boolean b) 此 方法 打印 一 个 布尔 值 

11 void print(char c) 此 方法 打印 的 字符 。 

12 void print(char[] s) 此 方法 打印 一 个 字符 数组 .. 

13 void print(double d) 此 方法 打印 一 个 双 精 度 浮 点 数 。 

14 void print(float f) 此 方法 打印 一 个 浮 点 数 。 

15 void print(int i) 此 方法 打印 一 个 整数 。 

16 void print(long I) 此 方法 打印 一 个 长 整数 。 

17 void print(Object obj) 此 方法 打印 对 象 。 

18 void print(String s) 此 方法 打印 一 个 字符 串 。 

PrintWriter printf(Locale |, String format, Object... args) 这 是 一 个 方便 的 


19 方法 使 用 指定 格式 字符 串 和 参数 将 格式 化 字符 串 写 入 此 writer 中 。 
20 PrintWriter printf(String format, Object... args) 这 是 一 个 方便 的 方法 使 用 


指定 格式 字符 串 和 参数 将 格式 化 字符 串 写 入 此 writer 中 。 

21 void printin() 此 方法 通过 写 和 人行 分 隔 符 字 符 串 终止 当前 行 。 

22 void printIn(boolean x) 此 方法 打印 一 个 布尔 值 ， 然 后 终止 该 行 。 

23 void println(char x) 此 方法 打印 一 个 字符 ， 然 后 终止 该 行 。 

24 void println(char[] x) 此 方法 将 打印 的 字符 数组 ， 然 后 终止 该 行 。 

25 void printIn(double x) 此 方法 打印 一 个 双 精 度 浮 点 数 ， 然 后 终止 该 行 。 
26 void printin(float x) 此 方法 打印 一 个 浮 点 数 ， 然 后 终止 该 行 。 

27 void printin(int x) 此 方法 将 打印 的 整数 ， 然 后 终止 该 行 。 

28 void println(long x) 此 方法 打印 一 个 长 整数 ， 然 后 终止 该 行 。 

29 void printIn(Object x) 此 方法 打印 一 个 对 象 ， 然 后 终止 该 行 。 

30 void println(String x) 此 方法 打印 一 个 String， 然 后 终止 该 行 

31 protected void setError() 此 方法 表明 发 生 了 错误 。 

32 void write(char[] buf) 此 方法 写 入 字符 数组 。 

33 void write(char[] buf, int off, int len) 此 方法 写 入 字符 数组 的 一 部 分 。 
34 void write(int c) 此 方法 写 入 的 单个 字符 。 

35 void write(String s) 此 方法 写 入 一 个 字符 串 。 

36 void write(String s, int off, int len) 此 方法 将 一 个 字符 串 的 一 部 分 写 和 人。 


Java.io.PrintWriter 类 - Java.io 包 1239 


方法 继承 
这 个 类 从 以 下 类 继承 的 方法 : 


e Java.io.Object 


Java.io.PushbacklnputStream X - Java.io 包 


Java.io.PushbacklnputStream 类 添加 功能 到 另 一 个 输入 流 ， 即 “push back” “AR 
INS at 


unread" — TF 7. 


we = 
A FAR 
以 下 是 java.io.PushbacklnputStream 类 的 声明 : 


public class PushbackInputStream 
extends FilterInputStream 


ri * 
字段 域 
以 下 是 java.io.PushbacklnputStream 类 中 的 字段 : 
e protected byte[] buf -- 推 回 缓冲 区 。 
e protected int pos -- 推 回 缓冲 区 从 下 一 个 字 节 将 被 读 取 中 的 位 置 。 


e protected InputStream in -- 将 输入 流 进 行 过 滤 。 


类 构造 画 数 


S.N. Wish & 描述 
PushbacklnputStream(lnputStream in) 这 将 创建 一 个 
PushbacklnputStream 并 保存 其 参数 ， 在 输入 流 中 ， 以 备 后 用 。 


PushbacklnputStream(lnputStream in, int size) 这 将 创建 具有 指定 
2 大 小 的 推 回 缓冲 区 PushbacklnputStream， 并 保存 其 参数 ， 在 输入 流 
中 ， 以 备 后 用 。 


1 
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S.N. 方法 & 描述 


int available() 这 个 方法 从 这 个 输入 流 中 可 通过 一 个 方法 的 下 一 次 调用 阻 
塞 该 输入 流 返 回 可 以 读 取 ( 或 跳 过 ) 的 字 节 数 的 估计 值 。 


2 void close() 此 方法 关闭 此 输入 流 并 释放 和 与 该 流 关联 的 所 有 系统 资源 。 
3 void mark(int readlimit) 该 方法 标志 着 在 此 输入 流 的 当前 位 置 。 


boolean markSupported() 如 果 此 输入 流 是 否 支持 mark 和 reset 方 法 ， 它 
不 此 方法 测试 。 


5 int read() 此 方法 读 取 从 这 个 输入 流 数 据 的 下 一 个 字 节 。 
int read(byte[] b, int off, int len) 此 方法 从 这 个 输入 流 中 读 取 len 个 数据 的 


6 字 节 到 字 节 数组 。 
7 Void reset() 这 个 方法 重新 定位 此 流 ， 以 当时 的 mark 方 法 最 后 调用 这 个 


输入 流 中 的 位 置 。 
8 long skip(long n) 这 种 方法 跳 过 并 丢弃 n 个 字 节 从 此 输入 流 中 的 数据 。 
void unread(byte[] b) 这 种 方法 推 回 的 字 节 将 其 复制 到 推 回 缓冲 区 前 面 


2 的 数组 。 

10 void unread(byte[] b, int off, int len) 该 方法 通过 将 其 复制 到 推 回 缓冲 区 
的 前 面 推 回 一 个 字 节 数组 的 一 部 分 。 

1 void unread(int b) 此 方法 通过 将 其 复制 到 推 回 缓冲 区 前 面 推 回 一 个 字 


Po 


继承 的 方法 


这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.FilterlnputStream 


e Java.io.Object 


Java.io.RandomAccessFile X: - Java.io@ 


Java.io.RandomAccessFile 类 文件 的 行为 就 像 一 个 大 数组 存储 在 文件 系统 中 的 字 
节 。 这 个 类 的 实例 支持 读 取 和 写 入 随机 访问 文件 。 


we Æ 
AX Fa AR 
以 下 是 java.io.RandomAccessFile 类 的 声明 : 


public class RandomAccessFile 
extends Object 
implements DataOutput, DataInput, Closeable 


S.N. MESA, & 描述 

1 RandomAccessFile(File file, String mode) 这 将 创建 一 个 随机 访问 文 
件 流 来 读 取 ， 并 选择 性 地 写 入 ， 由 File 参 数 指定 的 文件 。 

2 RandomAccessFile(File file, String mode) 这 将 创建 一 个 随机 访问 文 


件 流 来 读 取 ， 并 选择 性 地 写 入 ， 具 有 指定 名 称 的 文件 。 
类 方法 


S.N. 方法 & 描述 
void close() 此 方法 关闭 此 随机 存 取 文件 流 并 释放 和 与 该 流 关 联 的 所 有 系统 


Pd 
a JE 
7i Iso 


2 FileChannel getChannel() 此 方法 返回 与 此 文件 关联 的 唯一 文件 通道 对 


o 


3 FileDescriptor getFD() 此 方法 返回 与 此 流 关 联 的 不 透明 文件 描述 符 对 


o 


long getFilePointer() 此 方法 返回 当前 在 此 文件 中 的 偏 移 。 
long length() 这 个 方法 返回 当前 文件 的 长 度 。 
int read() 此 方法 读 取 数 据 从 该 文件 一 个 字 节 。 


7 int read(byte[] b) 此 方法 读 取 为 从 该 文件 b.length 个 数据 字 节 为 字 节 数 
组 。 


o on A 


e” 
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Java.io.RandomAccessFile # - Java.io 包 1244 


int read(byte[] b, int off, int len) 此 方法 读 取 为 从 该 文件 len 个 字 节 数据 到 
一 个 字 节 数组 。 


boolean readBoolean() 此 方法 读 取 该 文件 一 个 布尔 值 。 
byte readByte() 此 方法 从 该 文件 读 取 有 符号 8 位 的 值 。 
char readChar() 此 方法 从 文件 读 取 一 个 字符 。 

double readDouble() 此 方法 从 文件 读 取 一 个 double 数 。 
float readFloat() 此 方法 从 文件 读 取 一 个 浮 点 数 。 


void readFully(byte[] b) 此 方法 读 取 该 文件 b.length 个 字 节 到 字 节 数组 ， 
并 从 当前 文件 指针 。 


void readFully(byte[] b, int off, int len) 此 方法 读 取 这 个 文件 正好 len 个 字 
节 到 字 节 数组 ， 并 从 当前 文件 指针 。 


int readInt() 此 方法 从 该 文件 中 读 取 一 个 有 符号 的 32 位 整数 。 

String readLine() 此 方法 从 该 文件 中 读 取 文本 的 下 一 行 。 

long readLong() 此 方法 从 该 文件 中 读 取 一 个 有 符号 的 64 位 整数 。 
short readShort() 此 方法 从 该 文件 中 读 取 一 个 有 符号 的 16 位 数 。 

int readUnsignedByte() 此 方法 从 该 文件 中 读 取 一 个 无 符号 的 八 位 数 。 
int readUnsignedShort() 此 方法 从 该 文件 中 读 取 一 个 无 符号 的 16 位 数 。 
String readUTF() 从 这 个 文件 中 的 字符 串 此 方法 读 取 。 


void seek(long pos) 此 方法 设置 文件 指针 偏 移 量 ， 从 这 个 文件 开始 测 
量 ， 进 行 下 一 个 读 或 写 操 作 发 生 。 


void setLength(long newLength) 此 方法 设置 此 文件 的 长 度 。 
int skipBytes(int n) 此 方法 尝试 跳 过 n 个 字 节 的 输入 丢弃 跳 过 的 字 节 。 


void write(byte[] b) 此 方法 写 入 b.length 个 字 节 从 指定 的 字 节 数组 到 该 文 
件 ， 并 从 当前 文件 指针 。 


void write(byte[] b, int off, int len) 此 方法 从 指定 的 字 节 数组 开始 到 该 文 
件 偏 移 量 off 写 入 len 字 节 。 


void write(int b) 此 方法 写 入 指定 的 字 节 写 人 此 文件 。 


void writeBoolean(boolean v) 此 方法 写 和 一 个 布尔 值 ， 该 文件 为 一 个 字 
节 的 值 。 


void writeByte(int v) 此 方法 写 人 一 个 字 节 到 文件 作为 一 个 单字 节 值 。 
void writeBytes(String s) 此 方法 写 和 字符 串 到 文件 为 一 个 字 节 序列 。 


void writeChar(int v) 此 方法 写 和 人 一 个 字符 的 文件 作为 一 个 双 字 节 值 ， 高 
字 节 在 前 。 


T 
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void writeChars(String s) 此 方法 将 一 个 字符 串 写 入 该 文件 作为 一 个 字符 
序列 。 


void writeDouble(double v) 此 方法 double 参 数 转 换 为 long 使 用 
doubleToLongBits 方 法 在 类 Double， 然 后 写 到 long 值 的 文件 作为 八字 节 
数量 ， 高 字 节 在 前 。 


void writeFloat(float v) 此 方法 float 参 数 转换 为 使 用 floatTolntBits 方 法 在 
类 Float 一 个 int， 然 后 写 到 int 值 ， 以 该 文件 为 一 个 四 字 节 数量 ， 高 字 节 在 


Ao 
void writelnt(int v) 此 方法 写 入 一 个 int 到 文件 为 四 个 字 节 ， 高 字 节 在 前 。 
节 ， 


void writeLong(long v) 此 方法 写 人 一 个 长 的 文件 作为 八 个 字 
在 前 。 


void writeShort(int v) 此 方法 写 入 一 个 短 的 文件 为 两 个 字 节 ， 高 字 节 在 


"Tr 


Alo 


void writeUTF(String str) 这 种 方法 将 一 个 字符 串 写 入 使 用 经 修订 的 UTF- 
8 编码 以 与 机 器 无 关 的 方式 的 文件 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e Java.io.Object 


Java.io.Reader 3X: - Java.io 包 
Java.io.Reader 类 是 一 个 抽象 类 ， 用 于 读 取 字符 流 。 
类 声明 

以 下 是 java.io.Reader 类 的 声明 : 


public class Reader 
extends Object 
implements DataOutput, DataInput, Closeable 


ri x 
字段 域 
以 下 是 java.io.Reader 类 中 的 字段 : 


e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 画 数 


S.N. iG HA & 描述 

1 protected Reader() 这 将 创建 一 个 新 的 字符 流 reader， 其 重要 部 分 将 在 
读 取 器 本 身 同步 。 

2 protected Reader(Object lock) 这 将 创建 一 个 新 的 字符 流 reader， 其 


重要 部 分 将 在 给 定 的 对 象 同步 。 


TutorialsPoint Java 技术 教程 


S.N. 方法 & 描述 

1 abstract void close() 此 方法 关闭 该 流 并 释放 与 之 关联 的 所 有 系统 资源 。 
2 void mark(int readAheadLimit) 这 种 方法 标记 流 中 的 当前 位 置 。 

3 boolean markSupported() 这 个 方法 告诉 此 流 是 否 支 持 mark() 操 作 。 

4 int read() 此 方法 读 取 单个 字符 。 

5 int read(char[] cbuf) 此 方法 读 取 字符 到 一 个 数组 中 。 


abstract int read(char[] cbuf, int off, int len) 此 方法 读 取 字符 到 一 个 数组 
中 的 一 部 分 。 


7 int read(CharBuffer target) 此 方法 试图 读 取 字符 入 指定 的 字符 缓冲 区 。 
8 boolean ready() 此 方法 通知 此 流 是 否 已 准 各 好 被 读 取 。 

9 void reset() 这 种 方法 重 置 流 。 

10 long skip(long n) 此 方法 跳 过 字符 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e Java.io.Object 


Java.io.Reader 类 - Java.io 包 1247 


Java.io.SequencelnputStream X - Java.io 包 


Java.io.SequencelnputStream 类 代表 的 其 他 输入 流 的 逻辑 连接 。 它 开始 时 与 输 
入 流 的 有 序 集合 ， 并 从 第 一 个 到 文件 结束 读 取 为 止 ， 之 后 将 其 从 第 二 个 读 出 ， 依 此 
类 推 ， 直 到 文件 的 末尾 的 最 后 的 包含 的 输入 流 。 


xy = 
类 两 明 
以 下 是 java.io.SequencelnputStream 类 的 声明 : 


public class SequenceInputStream 
extends InputStream 


S.N. Mia HR & duh 
SequencelnputStream(Enumeration«? extends InputStream> e) 这 
1 将 初始 化 通过 记 住 参数 ， 它 必须 是 生产 对 象 的 运行 时 类 型 为 


InputStream 枚 举 一 个 新 创建 的 SequencelnputStream. 


SequencelnputStream(InputStream s1, InputStream s2) 这 将 初始 

2 化 通过 记 住 两 个 参数 ， 这 将 是 按 顺 序 阅 读 ， 第 一 S1 和 S2， 然 后 ， 提 供 
从 这 个 SequencelnputStream 读 取 的 字 节 一 个 新 创建 的 
SequencelnputStream, 


类 方法 


S.N. 方法 & 描述 
1 int available() 这 个 方法 从 当前 底层 输入 流 中 可 通过 方法 下 一 次 调用 阻塞 


当前 底层 输入 流 返 回 可 以 读 取 (或 跳 过 ) 的 字 节 数 的 估计 和 值 。 
2 void close() 此 方法 关闭 此 输入 流 并 释放 和 与 该 流 关联 的 所 有 系统 资源 。 
3 int read() 此 方法 读 取 从 这 个 输入 流 数据 的 下 一 个 字 节 。 


4 int read(byte[] b, int off, int len) 此 方法 读 取 最 多 |len 个 从 这 个 输入 流 中 数 
据 的 字 节 到 字 节 数组 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.InputStream 


e Java.io.Object 


Java.io.SerializablePermission X - Java.io@ 


Java.io.SerializablePermission X =F FE 245 BS4x BR. SerializablePermission@ 
合 一 个 名 称 (也 称 为 “target name”)， 但 没有 动作 列表 ;要 么 有 命名 的 权限 ， 也 可 以 没 
有 。 目 标 名 称 是 可 序列 化 权限 的 名 称 。 


JA —-L 
A RR HH 
以 下 是 Java.io.SerializablePermission 类 的 声明 : 


public final class SerializablePermission 
extends BasicPermission 


S.N. Mieke & 描述 
1 SerializablePermission(String name) 这 将 创建 一 个 新 的 


SerializablePermission 具 有 指定 名 称 。 


2 SerializablePermission(String name, String actions) 3x $4 £8285 
指定 名 称 的 新 的 SerializablePermission 对 象 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.BasicPermission 
e Java.io.Permission 


e Java.io.Object 


Java.io.StreamTokenizer# - Java.io 包 


Java.io.StreamTokenizer 类 获取 输入 流 并 将 其 解析 为 “标记 ” 人 允许 使 牌 被 读 取 一 
次 。 流 标记 生成 器 可 以 识别 标识 符 ， 数 字 ， 带 引号 的 字符 串 ， 以 及 各 种 注释 样式 。 


JA —- 
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以 下 是 java.io.StreamTokenizer 类 的 声明 : 


public class StreamTokenizer 
extends Object 


ra EN 二 
字段 域 
以 下 是 java.io.StreamTokenizer 类 中 的 字段 : 


e double nval -- 如 果 当 前 标记 是 一 个 数字 ， 此 字段 包含 该 数字 的 值 。 


e String sval -- 如 果 当 前 标记 是 一 个 文字 标记 ， 则 此 字段 包含 一 个 字符 串 ， 给 出 
该 文字 标记 的 字符 。 

e static int TT_EOF -- 一 个 常量 ， 表 明 流 的 末尾 已 被 读 取 。 

e static int TT EOL -- 一 个 常数 ， 指 示 末 尾行 已 被 读 取 。 

e static int TT NUMBER -- 一 个 常量 ， 表 示 一 个 数字 标记 已 读 。 


e static int TT_WORD -- 一 个 常量 ， 表 示 一 个 文字 标记 已 读 。 
e int ttype -- 调用 nextToken 方 法 后 ， 此 字段 包含 刚 读 取 的 标记 的 类 型 。 


HSB 


S.N. HERZ & 描述 
StreamTokenizer(Reader r) 这 将 创建 一 个 标记 者 ， 解 析 给 定 的 字符 
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方法 & 描述 
void commentChar(int ch) 指定 的 字符 参数 启动 一 个 单行 注释 。 


void eollsSignificant(boolean flag) 这 种 方法 确定 的 线 端 部 是 否 被 视 为 倒 
牌 。 


int lineno() 此 方法 返回 当前 行 号 。 

void lowerCaseMode(boolean fl) 此 方法 确定 是 否 文字 标记 会 自动 小 
T 

int nextToken() 此 方法 分 析 从 标记 生成 器 的 输入 流 中 的 下 一 个 标记 。 
void ordinaryChar(int ch) 这 个 方法 指定 了 字符 的 参数 是 "ordinary "这 个 
词 器 。 

void ordinaryChars(int low, int hi) 本 方法 规定 ， 在 范围 内 的 所 有 字符 C 
在 low <= c <= high 是 “ordinary” 这 个 词 器 。 

void parseNumbers() 这 种 方法 指定 数字 应 该 由 这 个 标记 生成 器 解析 。 


void pushBack() 这 种 方法 会 导致 此 标记 生成 器 的 nextToken 方 法 的 下 一 
次 调用 返回 的 当前 值 在 ttype 字 段 和 不 修改 该 值 在 nval 或 sval 字段 中 。 


void quoteChar(int ch) 这 种 方法 指定 的 匹配 对 这 个 人 物 的 分 隔 字符 串 常 
量 在 此 标记 生成 器 . 


void resetSyntax() 让 所 有 的 字符 都 是 这 种 方法 重 置 此 标记 生成 器 的 语法 
表示 "ordinary"”。 请 参阅 上 一 个 字符 为 普通 详细 信息 ， 此 时 要 用 
ordinaryChar 方 法 。 

void slashSlashComments(boolean flag) 此 方法 确定 是 否 标记 生成 器 识 
别 的 C + + 风格 的 注释 。 

void slashStarComments(boolean flag) 此 方法 确定 是 否 标记 生成 器 在 
识别 C 风 格 的 注释 。 

String toString() 此 方法 返回 当前 流标 记 的 字符 串 表 示 形 式 ， 它 发 生 在 的 
行 号 。 

void whitespaceChars(int low, int hi) 这 种 方法 指定 的 范围 low <= c <= 


high 内 为 空白 字符 的 所 有 字符 角 


void wordChars(int low, int hi) 本 方法 规定 ， 在 范围 内 的 所 有 字符 C 在 
low <= c >= high 单 词 成 分 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e Java.io.Object 


Java.io.StreamToken 
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Java.io.StringBufferlnputStream X: - Java.io 包 


Java.io.StringBufferlnputStream 类 多 许 应 用 程序 创建 ， 其 中 读 取 的 字 节 由 字符 串 
的 内 容 提供 的 输入 流 。 应 用 程序 还 可 以 通过 使 用 ByteArraylnputStream.Only 字 符 串 
中 的 低 八 位 每 个 字符 都 使 用 这 个 类 读 取 一 个 字 节 数组 字 节 。 


这 个 此 类 已 被 Oracle 否 决 ， 不 再 被 使 用 。 

JA Œ 

A RR HH 

以 下 是 Java.io.StringBufferlnputStream 类 的 声明 : 


public class StringBufferInputStream 
extends InputStream 


ri * 
字段 域 
以 下 是 Java.io.StringBufferlnputStream 类 中 的 字段 : 
e protected String buffer -- 这 是 字 节 被 读 取 的 字符 串 。 
e protected int count -- 这 是 在 输入 数据 流 缓存 器 有 效 字 符 数 。 
e protected int pos -- 这 是 下 一 个 字符 从 输入 流 缓存 器 读 取 的 索引 。 


类 构造 画 数 


S.N. Wis HX & 描述 
1 StringBufferlnputStream(String s) 这 将 创建 一 个 字符 串 输入 流 中 读 取 
指定 的 字符 串 数据 。 


S.N. 方法 & 描述 


1 int available() 此 方法 返回 可 以 从 输入 流 中 可 无 阻塞 读 取 的 字 节 数 。 
2 int read() 此 方法 读 取 从 这 个 输入 流 数据 的 下 一 个 字 节 。 
3 int read(byte[] b, int off, int len) 此 方法 读 取 最 多 |len 个 从 这 个 输入 流 中 数 


据 的 字 节 到 字 节 数组 。 


4 void reset() 这 种 方法 重 置 输入 流 ， 开 始 从 这 个 输入 流 的 基础 缓冲 区 的 第 
一 个 字符 读 。 


5 long skip(long n) 此 方法 跳 过 输入 流 中 的 n 个 字 节 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.InputStreams 


e Java.io.Object 


Java.io.StringReader X - Java.io 包 
Java.io.StringReader 类 是 字符 流 的 源 ， 是 一 个 字符 串 。 
类 声明 

以 下 是 java.io.StringReader 类 的 声明 : 


public class StringReader 
extends Reader 


ri x 
字段 域 
以 下 是 java.io.StringReader 类 中 的 字段 : 
e protected Object lock -- 这 是 用 于 同步 针对 此 流 操 作 的 对 象 。 


HSB 


S.N. MESZ & 描述 
1 StringReader(String s) 这 将 创建 一 个 新 的 字符 串 读 取 器 。 
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S.N. 方法 & 描述 

1 void close() 此 方法 关闭 该 流 并 释放 与 之 关联 的 所 有 系统 资源 。 

2 void mark(int readAheadLimit) 这 种 方法 标记 流 中 的 当前 位 置 。 

3 Ama markSupported() 此 方法 通知 此 流 是 否 支 持 mark() 操 作 ， 这 确 


4 int read() 此 方法 读 取 单个 字符 。 
int read(char[] cbuf, int off, int len) 此 方法 读 取 字 符 到 一 个 数组 中 的 一 部 


o 


6 boolean ready() 此 方法 通知 此 流 是 否 已 准 各 好 被 读 取 。 


7 void reset() 此 方法 重 置 流 为 最 新 的 标记 ， 或 以 该 字符 串 的 开头 ， 如 果 它 
从 来 没有 被 标记 。 


8 long skip(long ns) 此 方法 跳 过 流 中 指定 的 字符 数 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e Java.io.Reader 


e Java.io.Object 


Java.io.Writer X - Java.io 包 
Java.io.Writer 类 是 一 个 抽象 类 ， 用 于 写 入 字符 流 。 
类 声明 

以 下 是 java.io.Writer 类 的 声明 : 


public abstract class Writer 
extends Object 
implements Appendable, Closeable, Flushable 


ri x 
字段 域 
以 下 是 java.io.Writer 类 中 的 字段 : 


e protected Object lock -- 这 是 用 于 同步 针对 此 流 的 操作 的 对 象 。 


类 构造 画 数 


S.N. ISAM & 描述 

1 protected Writer() 这 将 创建 一 个 新 的 字符 流 writer， 其 关键 部 分 将 在 
writer 本 身 同步 。 

2 protected Writer(Object lock) 这 将 创建 一 个 新 的 字符 流 writer， 其 关 


键 部 分 将 在 给 定 的 对 象 同步 。 
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S.N. 方法 & 描述 

1 Writer append(char c) 此 方法 将 指定 字符 追加 到 这 个 writer。 

Writer append(CharSequence csq) 此 方法 将 指定 的 字符 序列 到 这 个 
writer. 


Writer append(CharSequence csq, int start, int end) 此 方法 将 指定 的 字 
符 序 列 的 子 序 列 写 和 此 writer。 


4 abstract void close() 此 方法 丢失 流 ， 但 要 先 刷 新 它 。 
5 abstract void flush() 此 方法 刷新 流 。 
6 void write(char[] cbuf) 此 方法 写 入 字符 数组 。 


abstract void write(char[] cbuf, int off, int len) 此 方法 写 入 字符 数组 的 一 
部 分 。 


8 void write(int c) 此 方法 写 入 的 单个 字符 。 
9 void write(String str) 此 方法 写 入 一 个 字符 串 。 
10 void write(String str, int off, int len) 此 方法 将 写 入 一 个 字符 串 的 一 部 分 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e Java.io.Object 
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Java.io.Interfaces - Java.io 包 


java.io.Interfaces 提供 系统 输入 和 输出 通过 数据 流 ， 序 列 化 和 文件 系统 。 


接口 汇总 


S.N. 


1 


接口 与 说 明 
Closeable 这 是 一 个 源 或 数据 的 目的 地 ， 可 以 关闭 。 


Datalnput 这 提供 了 从 二 进 制 流 中 读 取 字 节 ， 并 从 他 们 在 任何 Java 基 本 
类 型 的 数据 重建 。 


DataOutput 这 提供 了 将 数据 从 任意 Java 基 本 类 型 的 一 系列 字 节 并 将 其 
写 入 字 节 的 二 进 制 流 。 


Externalizable 这 仅 提 供 该 类 一 个 Externalizable 实 例 的 标识 被 守 入 序列 
化 流 ， 它 是 类 来 保存 和 恢复 其 实例 的 内 容 。 


FileFilter 这 是 一 个 抽象 路 径 名 的 过 滤器 。 

FilenameFilter 这 是 实现 此 接口 是 用 来 过 滤 文 件 名 的 类 的 实例 。 
Flushable 这 是 数据 的 目的 地 ， 可 以 被 刷新 。 

Objectinput 这 扩展 了 的 Datalnput 接 口 以 包含 对 象 的 读 取 。 


ObjectinputValidation 这 是 回调 接口 ， 以 允许 一 个 图 中 的 对 象 的 验 
证 。 


ObjectOutput 这 是 objectOutput 扩 展 DataOutput 中 的 接口 ， 包 括 写 对 


o 


ObjectStreamConstants 写 入 的 对 象 序列 化 流 中 的 常量 。 


Serializable 这 是 启用 由 类 实现 java.io.Serializable 接 口 。 


java.lang 


java.util 包 中 包含 有 基本 的 Java 编 程 语言 程序 设计 的 类 。 本 教程 引用 将 采用 简单 实 
用 的 例子 引导 您 完成 所 有 的 java.lang 包 中 可 用 的 方法 。 


读者 


D OUO 帮助 他 们 了 解 相关 的 java.lang 包 中 所 有 可 用 的 方法 的 
功能 


fe BU SRE 


通过 做 练习 ， 拥 有 在 此 引用 给 定 各 种 类 的 例子 之 前 ， 假 设 你 已 经 知道 基本 的 Java 编 
程 。 


java.lang.Boolean 2: - java.lang 


java.lang.Boolean 类 封装 在 一 个 对 象 基 本 布尔 型 的 值 。 Boolean 类 型 的 对 象 包 含 
一 个 字段 ， 它 的 类 型 是 布尔 值 。 


J^ Œ 
A RR HH 
以 下 是 java.lang.Boolean 类 的 声明 : 


public final class Boolean 
extends Object 
implements Serializable, Comparable<Boolean> 


ri s 
字段 域 
以 下 是 java.lang.Boolean 类 的 字段 : 
e static Boolean FALSE -- 这 是 对 应 于 原始 的 Boolean 对 象 的 值 false。 


e static Boolean TRUE -- 这 是 对 应 于 Boolean 对 象 的 原始 值 true 。 
e static Class<Boolean> TYPE -- 这 是 代表 基本 布尔 型 的 Class 对 象 。 


类 构造 图 数 
S.N. Hie SX & 描述 
1 Boolean(boolean value) 这 代表 分 配 值 参数 的 Boolean 对 象 。 


2 Boolean(String s) 这 表示 分 配 Boolean 对 象 的 值 为 tue， 如 果 字 符 串 参 
数 不 为 nul， 等 于 忽略 大 小 写 的 字符 串 "true”。 
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S.N. 方法 & 描述 
1 boolean booleanValue() 此 方法 将 返回 此 布尔 对 象 为 布尔 原始 值 
int compareTo(Boolean b) 此 方法 将 此 Boolean 实 例 与 另 一 个 对 象 实例 进 


? — fis. 

3 boolean equals(Object obj) 当 且 仅 当 参数 不 为 null， 并 且 是 一 个 布尔 对 
象 ， 表 示 同 样 的 布尔 值 作为 此 对 象 时 ， 此 方法 返回 true。 

4 static boolean getBoolean(String name) 当 且 仅 当 存在 以 参数 命名 的 系 
统 属性 和 等 于 该 字符 串 “true” 此 方法 返回 true。 

5 int hashCode() 此 方法 将 返回 这 个 布尔 对 象 的 哈 希 码 。 

static boolean parseBoolean(String s) 此 方法 解析 字符 串 参 数 为 布尔 
值 。 


7 String toString() 此 方法 将 返回 表示 该 布尔 值 的 String 对 象 。 
static String toString(boolean b) 此 方法 将 返回 一 个 表示 指定 布尔 的 


8 String xt &, 

9 static Boolean valueOf(boolean b) 此 方法 将 返回 一 个 表示 指定 布尔 值 的 
Boolean 实 例 。 

10 static Boolean valueOf(String s) 此 方法 返回 一 个 布尔 与 指定 字符 串 表 示 


的 值 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Byte # - java.lang 


java.lang.Byte 类 包装 基本 类 型 字 节 的 对 象 的 值 。 Byte 类 型 的 对 象 包含 一 个 字段， 
它 的 类 型 是 字 节 。 


44 ob 
类 瑞明 
以 下 是 java.lang.Byte 类 的 声明 : 


public final class Byte 
extends Number 
implements Comparable<Byte> 


ri x 
字段 域 
以 下 是 java.lang.Byte 类 中 的 字段 : 


e static byte MAX_VALUE -- 持 有 常数 一 个 字 节 可 以 有 最 大 值 , 2<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">7</sup>-1. 


e static byte MIN_VALUE -- 此 常数 持 有 的 一 个 字 节 的 最 小 值 -2<sup 
style="margin: Opx; padding: Opx; font-size: 13px; background-color: 
initial;">7</sup>. 

e static int SIZE -- 此 是 用 来 表示 于 二 进 制 补 码 形式 的 字 节 值 的 比特 数 。 


二 进 
e static Class<Byte> TYPE -- 这 是 类 实例 ， 表 示 基 本 类 型 字 节 。 


类 构造 图 数 


S.N. Wis HX & 描述 

1 Byte(byte value) 此 构造 一 个 新 分 配 的 字 节 对 象 ， 表 示 指 定 的 字 节 值 。 

2 Byte(String s) 此 构造 一 个 新 分 配 的 字 节 对 象 ， 表 示 String 参 数 指定 的 
字 节 值 。 
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S.N. 方法 & 描述 

1 byte byteValue() 此 方法 返回 字 节 一 个 字 节 的 值 。 

int compareTo(Byte anotherByte) 此 方法 数值 比较 两 个 字 节 的 对 象 。 
static Byte decode(String nm) 此 方法 解码 字符 串 转 换 为 字 节 。 
double doubleValue() 此 方法 将 返回 此 字 节 为 double 值 。 

boolean equals(Object obj) 此 方法 将 此 对 象 与 指定 对 象 比较 。 

float floatValue() 此 方法 将 返回 此 字 节 为 float 的 值 。 

int hashCode() 此 方法 将 返回 这 个 字 节 Byte 的 哈 希 码 。 

int intValue() 此 方法 将 返回 此 字 节 Byte 为 一 个 int 值 。 

long longValue() 此 方法 将 返回 此 字 节 作为 一 个 long 的 值 。 

static byte parseByte(String s) 此 方法 将 字符 串 参 数 作 为 符号 的 十 进 制 


CO A N O a A CO ND 


10 = 让 
字 节 。 

» static byte parseByte(String s, int radix) 此 方法 解析 字符 串 参数 作为 第 
二 个 参数 指定 的 基数 符号 的 字 节 。 

12 short shortValue() 此 方法 返回 字 节 Byte 的 short 的 值 。 

13 String toString() 此 方法 返回 一 个 代表 此 字 节 的 值 的 String 对 象 。 

A static String toString(byte b) 此 方法 将 返回 一 个 表示 指定 字 节 一 个 新 的 
String 对 象 。 

15 static Byte valueOf(byte b) 此 方法 将 返回 一 个 表示 指定 的 字 节 值 的 字 节 
实例 。 

16 static Byte valueOf(String s) 此 方法 将 返回 一 个 字 节 对 象 持 有 指定 的 字 
符 串 中 给 定 的 值 。 


17 static Byte valueOf(String s, int radix) 该 方法 返回 一 个 字 节 的 对 象 保持 
从 指定 的 String 中 提取 的 值 时 ， 由 第 二 个 参数 给 出 的 基数 进行 分 析 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Character - java.lang 


java.lang.Character 类 封装 在 一 个 对 象 的 基本 类 型 char 值 。 字 符 类 型 的 对 象 包含 一 
个 字段 ， 它 的 类 型 为 char。 


JA Œ 
AX BH 
以 下 是 java.lang.Character 类 的 声明 : 


public final class Character 
extends Object 
implements Serializable, Comparable<Character> 


TE 
S.N. MS HX & 描述 
1 Character(char value) 此 构造 一 个 新 分 配 字 符 对 象 ， 表 示 指 定 的 char 
值 。 


类 方法 


S.N. 方法 & 描述 
static int charCount(int codePoint) 此 方法 确定 表示 指定 字符 所 需 的 字符 


的 值 的 数目 (Unicode 代 码 点 )。 
2 char charValue() 此 方法 返回 字符 对 象 的 值 。 


3 static int codePointAt(char[] a, int index) 此 方法 返回 char 数 组 的 给 定 索 
引 上 的 代码 点 。 

4 static int codePointAt(char[] a, int index, int limit) 此 方法 返回 的 字符 数 
组 ， 只 能 用 于 数组 元 素 与 指数 低 于 上 限 的 定 素 引 上 的 代码 点 。 

5 static int codePointAt(CharSequence seq, int index) 此 方法 返回 
CharSequence2^ 3E RSI E BAN o 

6 static int codePointBefore(char[] a, int index) 此 方法 返回 char 数 组 的 给 


定 索 引 前 面 的 代码 点 。 


static int codePointBefore(char[] a, int index, int start) 此 方法 返回 字符 
7 数组 ， 其 中 仅 可 用 于 数组 元 素 与 指数 大 于 或 等 于 开始 的 给 定 素 引 前 面 的 
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代码 点 。 
static int codePointBefore(CharSequence seq, int index) 此 方法 返回 


CharSequence 给 定 索 引 前 面 的 代码 点 。 
9 static int codePointCount(char[] a, int offset, int count) 该 方法 在 char 数 


组 参数 的 一 个 子 返 回 的 Unicode 代 码 点 的 数量 


static int codePointCount(CharSequence seq, int beginIndex, int 
10 endIndex) 该 方法 在 指定 的 字符 序列 的 文本 范围 返回 的 Unicode 代 码 点 的 
数量 。 


int compareTo(Character anotherCharacter) 该 方法 在 数字 上 比较 两 个 
字符 的 对 象 。 


12 static int digit(char ch, int radix) 此 方法 返回 指定 基数 字符 ch 的 数值 。 


static int digit(int codePoint, int radix) 此 方法 返回 指定 基数 指定 字符 
(Unicode 代 码 点 ) 的 数值 。 


14 boolean equals(Object obj) 该 方法 此 对 象 与 指定 对 象 比 较 
static char forDigit(int digit, int radix) 此 方法 确定 的 指定 基数 的 特定 数字 


的 字符 表示 。 
static byte getDirectionality(char ch) 此 方法 返回 给 定 字符 的 Unicode 的 
16 
方向 属性 。 
17 static byte getDirectionality(int codePoint) 该 方法 返回 给 定 字符 
(Unicode 代 码 点 ) 的 Unicode 方 向 属性 。 
18 static int getNumericValue(char ch) 此 方法 返回 指定 的 Unicode 字 符 表 
示 的 int 值 。 
19 static int getNumericValue(int codePoint) 此 方法 返回 int 值 指定 的 字符 
(Unicode 代 码 点 ) 表示 。 
20 static int getType(char ch) 此 方法 返回 一 个 值 ， 表 明 一 个 字符 的 普通 
类 
Fo 
21 static int getType(int codePoint) 此 方法 返回 一 个 值 ， 表 明 一 个 字符 的 普 


通 类 。 
22 int hashCode() 此 方法 返回 这 个 字符 的 哈 希 码 。 


static boolean isDefined(char ch) 此 方法 确定 字符 是 否 为 Unicode 定 
义 。 

static boolean isDefined(int codePoint) 该 方法 确定 的 字符 (Unicode 代 
码 点 ) 在 Unicode 中 定义 。 

25 static boolean isDigit(char ch) 此 方法 确定 指定 字符 是 否 一 个 数字 。 


static boolean isDigit(int codePoint) 此 方法 确定 指定 字符 (Unicodett 


= 
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static boolean isHighSurrogate(char ch) 该 方法 判断 给 定 char 值 是 高 代 
理 项 代码 单元 (也 称 为 主导 代理 项 代码 单元 ) 。 


static boolean isldentifierlgnorable(char ch) 此 方法 确定 指定 字符 是 否 应 
该 被 视 为 一 个 可 忽略 的 字符 在 Java 标 识 符 或 Unicode 标 识 符 。 


static boolean isldentifierlgnorable(int codePoint) 此 方法 确定 指定 字符 
29 (Unicode 代 码 点 ) 应 被 视 为 一 个 可 忽略 的 字符 在 Java 标 识 符 或 


27 


28 


Unicode 标 识 符 。 
30 static boolean isISOControl(char ch) 此 方法 确定 指定 字符 是 否 ISO 控 制 
字符 。 
31 static boolean islISOControl(int codePoint) 此 方法 确定 引用 的 字符 
(Unicode 代 码 点 ) 是 一 家 通过 ISO 控 制 字符 。 
32 static boolean isJavaldentifierPart(char ch) 该 方法 确定 指定 的 字符 可 能 
是 Java 标 识 符 中 除 首 字符 以 外 的 部 分 。 
33 static boolean isJavaldentifierPart(int codePoint) 该 方法 确定 的 字符 
(Unicode 代 码 点 ) 可 能 是 Java 标 识 符 中 除 首 字 符 以 外 的 部 分 。 
34 static boolean isJavaldentifierStart(char ch) 此 方法 确定 指定 字符 是 否 
允许 在 Java 标 识 符 的 第 一 个 字符 。 
35 static boolean isJavaldentifierStart(int codePoint) 该 方法 确定 的 字符 


(Unicode 代 码 点 ) 是 否 人 允许 在 Java 标 识 符 的 第 一 个 字符 。 
36 static boolean isLetter(char ch) 此 方法 确定 指定 字符 是 否 一 个 字母 。 


static boolean isLetter(int codePoint) 此 方法 确定 指定 字符 (Unicodett 


57 ^ wu) 是 一 个 字母 。 
38 static boolean isLetterOrDigit(char ch) 此 方法 确定 指定 字符 是 字母 或 数 
字 。 
39 static boolean isLetterOrDigit(int codePoint) 此 方法 确定 指定 字符 
(Unicode 代 码 点 ) 是 一 个 字母 或 数字 。 
40 static boolean isLowerCase(char ch) 此 方法 确定 指定 字符 是 否 为 小 写 
字母 。 
41 static boolean isLowerCase(int codePoint) 此 方法 确定 指定 字符 
(Unicode 代 码 点 ) 是 否 为 小 写字 母 。 
42 static boolean isLowSurrogate(char ch) 该 方法 判断 给 定 char 值 是 低 代 
理 项 代码 单元 〈 也 称 为 尾部 代理 项 代码 单元 ) 。 
static boolean isMirrored(char ch) 此 方法 确定 按照 Unicode 规 范 的 字符 
43 EA LIA 
ZED A 镜像 。 
A4 static boolean isMirrored(int codePoint) 此 方法 确定 指定 字符 (Unicode 


代码 点 ) 是 否 按照 Unicode 规 范 镜像 。 


static boolean isSpaceChar(char ch) 此 方法 确定 指定 字符 是 否 为 
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Unicode 空 白字 符 。 


static boolean isSpaceChar(int codePoint) 此 方法 确定 指定 字符 
(Unicode 代 码 点 ) 是 一 个 Unicode 空 格 字符 。 


static boolean isSupplementaryCodePoint(int codePoint) 此 方法 确定 指 
定 字 符 (Unicode 代 码 点 ) 是 否 在 补充 字符 范围 。 


48 static boolean isSurrogatePair(char high, char low) 此 方法 确定 指定 对 
char 值 是 否 一 个 有 效 的 代理 对 。 


static boolean isTitleCase(char ch) 此 方法 确定 指定 字符 是 否 是 首 字 


46 


47 


Vr 


^ (| 大 写字 符 。 
50 static boolean isTitleCase(int codePoint) 此 方法 确定 指定 字符 
(Unicode 代 码 点 ) 是 一 个 首 字 母 大 写字 符 。 

54 static boolean isUnicodeldentifierPart(char ch) 此 方法 确定 指定 字符 可 
以 是 Unicode 标 识 符 中 除 首 字 符 以 外 的 部 分 。 

52 static boolean isUnicodeldentifierPart(int codePoint) 此 方法 确定 指定 字 
符 (Unicode 代 码 点 ) 可 能 是 Unicode 标 识 符 中 除 首 字 符 以 外 的 部 分 。 

53 static boolean isUnicodeldentifierStart(char ch) 此 方法 确定 指定 字符 是 
否 是 允许 作为 Unicode 标 识 符 的 第 一 个 字符 。 

54 static boolean isUnicodeldentifierStart(int codePoint) 此 方法 确定 指定 
字符 (Unicode 代 码 点 ) 是 允许 作为 Unicode 标 识 符 的 第 一 个 字符 。 

55 static boolean isUpperCase(char ch 此 方法 确定 指定 字符 是 否 是 大 写字 
符 。 

56 static boolean isUpperCase(int codePoint) 此 方法 确定 指定 字符 


(Unicode 代 码 点 ) 是 一 个 大 写字 母 。 


static boolean isValidCodePoint(int codePoint) 此 方法 确定 指定 的 代码 
57 点 是 否 为 0x0000~0x10FFFF 之 间 包 容 的 范围 内 有 效 的 Unicode 代 码 点 


值 。 

58 static boolean isWhitespace(char ch) 此 方法 确定 指定 字符 是 否 是 根据 
Java 的 空白 符 。 

59 static boolean isWhitespace(int codePoint) 此 方法 确定 指定 字符 


(Unicode 代 码 点 ) 是 根据 Java 的 空白 符 。 


static int offsetByCodePoints(char[] a, int start, int count, int index, int 
60 codePointOffset) 此 方法 返回 从 给 定 指数 codePointOffset 码 点 的 偏 移 给 
定 的 字符 子 数组 中 的 索引 


static int offsetByCodePoints(CharSequence seq, int index, int 
61 codePointOffset) 此 方法 返回 给 定 字符 序列 从 给 定 的 指数 
codePointOffset 码 点 偏 移 中 的 索引 。 


2 static char reverseBytes(char ch) 此 方法 返回 通过 反 转 指定 char 值 的 字 
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io 


62 节 的 顺序 而 获得 的 值 。 

63 static char[] toChars(int codePoint) 该 方法 将 指定 字符 (Unicode 代 三 
点 ) 到 其 存储 在 一 个 字符 数组 的 UTF-16 表 示 形 式 。 

64 static int toChars(int codePoint, char[] dst, int dstlndex) 该 方法 将 指定 
字符 〈Unicode 代 码 点 ) 其 UTF-16 表 示 形 式 。 

65 static int toCodePoint(char high, char low) 该 方法 指定 的 代理 对 到 其 增 
补 代 码 点 值 转换 。 

66 static char toLowerCase(char ch) 该 方法 的 参数 字符 使 用 来 自 
UnicodeData 文 件 的 大 小 写 上 映射 信息 转换 成 小 写 。 

67 static int toLowerCase(int codePoint) 此 方法 转换 的 字符 (Unicode 
m) 参数 使 用 来 自 UnicodeData 文 件 的 大 小 写 上 映射 信息 为 小 写 。 

68 String toString() 该 方法 返回 一 个 代表 该 字符 的 值 的 String 对 象 。 

69 static String toString(char c) 此 方法 返回 一 个 表示 指定 字符 的 String 对 
象 。 

70 static char toTitleCase(char ch) 该 方法 的 参数 字符 使 用 来 自 
UnicodeData 文 件 的 大 小 写 映 射 信息 标题 字符 转换 。 

71 static int toTitleCase(int codePoint) 此 方法 转换 的 字符 (Unicodett = 
m) 参数 使 用 来 自 UnicodeData 文 件 的 大 小 写 映 射 信息 标题 字符 。 

72 static char toUpperCase(char ch) 该 方法 的 参数 字符 使 用 来 自 
UnicodeData 文 件 的 大 小 写 上 映射 信息 转换 为 大 写 。 

73 static int toUpperCase(int codePoint) 此 方法 转换 的 字符 (UnicodefX 4 
m) 参数 使 用 来 自 UnicodeData 文 件 的 大 小 写 上 映射 信息 为 大 写 。 

74 static Character valueOf(char c) 此 方法 返回 一 个 表示 指定 字符 值 的 字符 
实例 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Character.Subset 类 实例 表示 Unicode 字 符 集 的 特定 子 集 。 在 字符 类 中 
定义 子 集 的 唯一 的 关联 关系 是 UnicodeBlock。 


we ob 
AX Fa HH 
以 下 是 java.lang.Character.Subset 类 的 声明 : 


public static class Character.Subset 
extends Object 


X Ie WA 
S.N. Mis ES & 描述 


protected Character.Subset(String name) 这 构造 了 一 个 新 的 子 集 实 
例 。 


一 人 


类 方法 


S.N. 方法 & 描述 
1 boolean equals(Object obj) 此 方法 比较 两 个 子 集 的 对 象 相等 对 。 
2 int hashCode() 此 方法 返回 的 是 Object.hashCode() 方 法 中 定义 的 标准 的 


3 String toString() 此 方法 返回 该 子 集 的 名 称 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Character.UnicodeBlock 类 是 一 个 代表 Unicode 规 范 的 字符 块 字符 子 
集 。 字 符 块 通常 定义 用 于 特定 的 脚本 或 目的 字符 。 


wo 
类 两 明 
以 下 是 java.lang.Character.UnicodeBlock 类 的 声明 : 


public static final class Character.UnicodeBlock 
extends Character.Subset 


类 方法 


S.N. 方法 & 描述 

1 static Character.UnicodeBlock forName(String blockName) 此 方法 返回 
具有 指定 名 称 的 UnicodeBlock。 

2 static Character.UnicodeBlock of(char c) 此 方法 返回 表示 包含 给 定 字 


符 ， 则 返回 null 如 果 字 符 不 是 定义 块 的 成 员 的 Unicode 块 的 对 象 。 


static Character.UnicodeBlock of(int codePoint) 此 方法 返回 表示 包含 给 
3 定 字符 (Unicode 代 码 点 ) 的 Unicode 块 的 对 象 ， 或 者 为 null， 如 果 该 字符 
不 是 定义 块 的 成 员 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.lang.Character Subset 


e java.lang.Object 
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java.lang.Class 类 的 实例 表示 正在 运行 的 Java 应 用 程序 中 的 类 和 接口 。 它 没有 公共 
的 构造 画 数 。 


JA Œ 
类 两 明 
以 下 是 java.lang.Class 类 的 声明 : 


public final class Class<T> 
extends Object 
implements Serializable, GenericDeclaration, Type, AnnotatedEl: 


RSS — — RR 
类 方法 


S.N. 方法 & 描述 

<U> Class<? extends U> asSubclass(Class<U> clazz) 此 方法 投射 此 

Class 对 象 ， 以 表示 指定 的 Class 对 象 所 表示 的 类 的 子 类 。 

2 T cast(Object obj) 此 方法 投射 的 目的 是 通过 此 Class 对 象 所 表示 的 类 或 
接口 。 

3 boolean desiredAssertionStatus() 此 方法 返回 将 被 分 配 到 这 个 类 ， 如 果 

它 在 调用 此 方法 时 被 初始 化 的 断言 状态 。 

static Class<?> forName(String className) 此 方法 返回 的 类 或 接口 与 

给 定 的 字符 串 名 称 相 关联 的 Class 对 象 。 


static Class<?> forName(String name, boolean initialize, ClassLoader 
5 loader) 此 方法 返回 的 类 或 接口 与 给 定 的 字符 串 名 称 相关 联 的 Class 对 
象 ， 使 用 给 定 的 类 加 载 器 。 


<A extends Annotation> A getAnnotation(Class<A> annotationClass) 
6 此 方法 返回 这 个 元 素 的 注解 指定 类 型 ， 如 果 存 在 这 样 的 注释 ， 否 则 返回 





1 


null, 
7 Annotation[] getAnnotations() 此 方法 返回 当前 这 个 元 素 上 的 所 有 注释 。 
8 String getCanonicalName() 此 方法 返回 底层 类 的 Java 语 言 规范 中 定义 
的 标准 名 称 。 


9 Class<?>[] getClasses() 此 方法 返回 一 个 包含 代表 所 有 的 公共 类 ， 并 且 
是 此 Class 对 象 所 表示 的 类 的 成 员 接 口 的 Class 对 象 的 数组 。 
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15 


16 


17 


18 


19 


20 


21 


22 
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ClassLoader getClassLoader() 此 方法 返回 类 加 载 器 的 类 。 
Class<?> getComponentType() 此 方法 返回 类 表示 数组 的 组 件 类 型 。 


Constructor<T> getConstructor(Class<?>... parameterTypes) 该 方法 返 
回 一 个 Constructor 对 象 ， 它 反映 此 Class 对 象 所 表示 的 类 的 指定 公共 构 


Constructor<?>[] getConstructors() 此 方法 返回 一 个 包含 某 些 
Constructor 对 象 反 映 此 Class 对 象 所 表示 类 的 所 有 公共 构造 一 个 数组 。 


Annotation[] getDeclaredAnnotations() 此 方法 返回 直接 存在 于 此 元 素 上 
的 所 有 注释 。 

Class<?>[] getDeclaredClasses() 此 方法 返回 Class 对 象 反 映 声 明 此 
Class 对 象 所 表示 类 成 员 的 类 和 接口 组 成 的 数组 。 


Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes) 
该 方法 返回 一 个 Constructor 对 象 ， 它 反映 此 Class 对 象 所 表示 的 类 或 接 
Df Hie 

Constructor<?>[] getDeclaredConstructors() 此 方法 返回 Constructor 对 
象 的 所 有 Class 对 象 表示 类 声明 的 构造 画 数 的 数组 。 

Field getDeclaredField(String name) 该 方法 返回 一 个 Field 对 象 ， 它 反 
映 此 Class 对 象 所 表示 的 类 或 接口 指定 已 声明 字段 。 

Field[] getDeclaredFields() 此 方法 返回 Field 对 象 的 所 有 Class 对 象 表 示 
的 类 或 接口 中 声明 的 字段 的 数组 。 


Method getDeclaredMethod(String name, Class<?>... 
parameterTypes) 该 方法 返回 一 个 Method 对 象 ， 它 反映 此 Class 对 象 所 
表示 的 类 或 接口 的 指定 已 声明 方法 。 


Method[] getDeclaredMethods() 此 方法 返回 Method 对 象 的 所 有 Class 对 
象 表 示 的 类 或 接口 中 声明 的 方法 的 数组 。 

Class<?> getDeclaringClass() 如 果 此 Class 对 象 所 表示 的 类 或 接口 是 另 
一 个 类 的 成 员 ， 返 回 被 声明 的 类 的 Class 对 象 。 

Class<?> getEnclosingClass() 此 方法 返回 直接 封闭 类 的 底层 类 。 
Constructor<?> getEnclosingConstructor() 如 果 此 Class 对 象 表示 一 个 
构造 函数 中 的 一 个 本 地 或 匿名 类 ， 则 返回 一 个 代表 底层 类 的 立即 封闭 构 
造 函 数 构造 对 象 。 


Method getEnclosingMethod() 如 果 此 Class 对 象 表示 的 方法 中 的 一 个 本 
地 或 匿名 类 ， 则 返回 一 个 代表 底层 类 的 立即 封闭 方法 的 Method 对 象 。 

T[] getEnumConstants() 此 方法 返回 枚 举 类 ， 如 果 此 Class 对 象 不 表示 枚 
举 类 型 返回 空 元 素 。 


Field getField(String name) 该 方法 返回 一 个 Field 对 象 ， 它 反映 此 Class 
对 象 所 表示 的 类 或 接口 的 指定 公共 成 员 字 段 。 


NO 
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44 


45 


Field[] getFields() 此 方法 返回 一 个 包含 Field 对 象 反 映 此 Class 对 象 所 表 

示 的 类 或 接口 的 所 有 可 访问 公共 字段 的 数组 。 

Type[] getGenericlnterfaces() 此 方法 返回 表示 由 该 对 象 表示 的 类 或 接口 

直接 实现 的 接口 类 型 。 

Type getGenericSuperclass() 此 方法 返回 表示 此 Class 所 表示 的 实体 
(类 ， 接 口 ， 基 本 类 型 或 void) 的 直接 超 类 的 类 型 。 

Class<?>[] getInterfaces() 此 方法 确定 由 该 对 象 表示 的 类 或 接口 实现 的 

接口 。 


Method getMethod(String name, Class<?>... parameterTypes) 该 方法 
返回 一 个 Method 对 象 ， 它 反映 此 Class 对 象 所 表示 的 类 或 接口 的 指定 公 
共 成 员 方法 。 

Method[] getMethods() 此 方法 返回 一 个 包含 对 象 的 方法 反映 的 类 或 接口 
的 所 有 公共 成 员 方 法 此 Class 对 象 所 表示 ， 包 括 那 些 由 类 或 接口 以 及 那 
些 从 父 类 继承 声明 数组 。 

int getModifiers() 此 方法 返回 Java 语 言 修饰 符 为 这 个 类 或 者 接口 ， 编 码 
为 一 个 整数 。 

String getName() 此 方法 返回 此 Class 对 象 所 表示 的 实体 (类 ， 接 口 ， 数 
组 类 ， 基 本 类 型 或 void) 的 名 字 ， 作 为 一 个 字符 串 。 

Package getPackage() 此 方法 获取 这 个 类 的 包 。 


ProtectionDomain getProtectionDomain() 此 方法 返回 这 个 类 
ProtectionDomain。 

URL getResource(String name) 此 方法 找到 具有 给 定名 称 的 资源 。 
InputStream getResourceAsStream(String name) 此 方法 找到 具有 给 定 
名 称 的 资源 。 

Object[] getSigners() 此 方法 得 到 这 个 类 的 签名 。 

String getSimpleName() 此 方法 返回 底层 类 的 简单 名 称 在 源 代 码 中 给 
出 。 


Class<? super T» getSuperclass() 此 方法 返回 的 类 来 表示 此 Class 所 表 
示 的 实体 (类 ， 接 口 ， 基 本 类 型 或 void) 的 超 类 。 
TypeVariable<Class<T>>[] getTypeParameters() 此 方法 返回 一 个 代表 
由 GenericDeclaration 对 象 表示 的 一 般 声 明 ， 在 声明 的 顺序 声明 的 类 型 
变量 TypeVariable 对 象 的 数组 。 


boolean isAnnotation() 如 果 此 Class 对 象 表示 一 个 注释 类 型 此 方法 返回 
true。 


boolean isAnnotationPresent(Class<? extends Annotation> 
annotationClass) 如 果 一 个 注解 指定 类 型 是 存在 于 此 元 素 上 此 方法 返回 
true, Gi lElfalse. 
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boolean isAnonymousClass() 当 且 人 久 当 底层 类 是 匿名 类 此 方法 返回 
true。 


boolean isArray() 此 方法 确定 该 Class 对 象 表示 一 个 数组 类 。 


boolean isAssignableFrom(Class<?> cls) 此 方法 判定 此 Class 对 象 所 表 
示 的 类 或 接口 可 以 是 一 样 的 ， 或 者 说 是 一 个 超 类 或 超 接 口 ， 由 指定 
Class 参 数 所 表示 的 类 或 接口 。 


boolean isEnum() 当 且 仅 当 这 个 类 被 声明 为 在 源 代 码 中 的 枚 举 此 方法 返 
回 true。 


boolean isInstance(Object obj) 此 方法 确定 指定 的 对 象 赋值 兼容 与 此 
Class 所 表示 的 对 象 。 


boolean isInterface() 此 方法 判定 指定 Class 对 象 表示 一 个 接口 类 型 。 
boolean isLocalClass() 当 且 仅 当 底层 类 是 局 部 类 此 方法 返回 true。 
boolean isMemberClass() 当 且 仅 当 诡 层 类 是 成 员 类 此 方法 返回 true。 
boolean isPrimitive() 此 方法 确定 指定 的 Class 对 象 表 示 一 个 基本 类 型 。 


boolean isSynthetic() 如 果 这 个 类 是 合成 的 类 此 方法 返回 true; 否 则 返回 
false。 


T newlnstance() 此 方法 创建 此 Class 对 象 所 表示 类 的 新 实例 。 
String toString() 此 方法 的 对 象 转 换 为 字符 串 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.ClassLoader 2: - java.lang 


java. uA ClassLoader 类 是 一 个 对 象 ， 它 负责 加 载 类 。 这 个 类 是 一 个 抽象 类 。 它 
可 用 于 通过 安全 管理 器 ， 以 指 示 安 全 域 。 
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以 下 是 java.lang.ClassLoader 类 的 声明 : 


public abstract class ClassLoader 
extends Object 


ME una x 
X M SZ 
S.N. 构造 函数 & 描述 
1 protected ClassLoader() 这 将 创建 使 用 该 getSystemClassLoader() 方 
法 作为 父 类 加 载 器 返回 ClassLoader 一 个 新 的 类 加 载 器 。 
2 protected ClassLoader(ClassLoader parent) 这 将 创建 使 用 指定 的 父 


类 加 载 器 委派 一 个 新 的 类 加 载 器 。 


类 方法 


S.N. 方法 & 描述 

void clearAssertionStatus() 此 方法 设置 这 个 类 加 载 器 的 默认 断言 状态 设 
置 为 false， 并 放弃 与 类 加 载 器 相关 的 任何 包 默 认 值 或 类 断言 状态 设置 。 

2 protected Class<?> defineClass(String name, byte[] b, int off, int len) 


此 方法 将 字 节 数 组 转换 为 Class 类 的 一 个 实例 。 


protected Class<?> defineClass(String name, byte[] b, int off, int len, 
3 ProtectionDomain protectionDomain) 此 方法 将 字 节 数组 转换 为 Class 类 
的 一 个 实例 ， 一 个 可 选 ProtectionDomain 


protected Class<?> defineClass(String name, ByteBuffer b, 
4 ProtectionDomain protectionDomain) 此 方法 转换 ByteBuffer 为 Class 类 
的 一 个 实例 ， 并 带 一 个 可 选 的 ProtectionDomain。 


protected Package definePackage(String name, String specTitle, 
String specVersion, String specVendor, String implTitle, String 
implVersion, String implVendor, URL sealBase) 此 方法 在 这 个 类 加 载 器 
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定义 了 一 个 包 。 
6 protected Class<?> findClass(String name) 此 方法 找到 的 类 使 用 指定 的 
二 进 制 名 称 。 
protected String findLibrary(String libname) 此 方法 返回 的 本 地 库 的 绝对 
7 
路 径 名 。 
protected Class<?> findLoadedClass(String name) 此 方法 返 如 


GLH Rati se B JovalA dL — x RB Cie ERN EAN 
载 器 给 定 二 进 制 名 称 。 


protected URL findResource(String name) 此 方法 找到 具有 给 定名 称 的 


资源 。 


10 protected Enumeration<URL> findResources(String name) 此 方法 返回 
表示 所 有 具有 给 定名 称 的 资源 的 URL 对 象 的 枚 举 。 


protected Class<?> findSystemClass(String name) 此 方法 找到 的 类 使 


”用 指定 的 二 进 制 名 称 ， 如 果 有 必要 加 载 它 。 

42 protected Package getPackage(String name) 此 方法 返回 一 个 已 经 被 这 
个 类 装载 器 ， 或 任何 其 祖先 定义 的 包 。 

13 protected Package[] getPackages() 此 方法 返回 所 有 由 这 个 类 装载 器 和 


它 的 祖先 定义 的 包 。 
14 ClassLoader getParent() 此 方法 返回 父 类 加 载 器 委派 。 
15 URL getResource(String name) 此 方法 找到 具有 给 定名 称 的 资源 。 


16 InputStream getResourceAsStream(String name) 该 方法 用 于 读 出 指定 
的 资源 返回 一 个 输入 流 。 


Enumeration<URL> getResources(String name) 此 方法 找到 的 所 有 资 


源 与 给 定 的 名 字 Foy 

18 static ClassLoader getSystemClassLoader() 此 方法 返回 系统 类 加 载 器 
zz. 

19 static URL getSystemResource(String name) 此 方法 找到 的 用 来 加 载 类 


的 搜索 路 径 指定 名 称 的 资源 。 


20 static InputStream getSystemResourceAsStream(String name) 此 方法 
是 打开 用 于 读 取 ， 从 用 来 加 载 类 的 搜索 路 径 指定 名 称 的 


21 static Enumeration<URL> getSystemResources(String name) 此 方法 


找到 的 用 来 加 载 类 的 搜索 路 径 指 定名 称 的 所 有 资源 。 
22 Class<?> loadClass(String name) 此 方法 加 载 类 指定 二 进 制 名 称 。 


23 Em Class<?> loadClass(String name, boolean resolve) 此 方法 加 


类 指定 二 进 制 名 称 。 
24 protected void resolveClass(Class<?> c) 此 方法 连接 指定 的 类 。 
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void setClassAssertionStatus(String className, boolean enabled) Itt 
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断言 状态 。 

26 void setDefaultAssertionStatus(boolean enabled) 此 方法 设置 这 个 类 加 
载 器 的 默认 断言 状态 。 

27 void setPackageAssertionStatus(String packageName, boolean 


enabled) 此 方法 设置 为 指定 包 的 包 默 认 断 言 状态 。 


28 protected void setSigners(Class<?> c, Object[] signers) 此 方法 设置 一 
个 类 的 签名 
| ENS AE o 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Compiler 类 提供 支持 Java 到 本 机 代码 编译 器 和 相关 服务 。 在 设计 上 ， 它 
作为 一 个 占 位 符 在 JIT 编 译 器 实现 。 
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以 下 是 java.lang.Compiler 类 的 声明 : 


public final class Compiler 
extends Object 


类 方法 


S.N. 方法 & 描述 

static Object command(Object any) 此 方法 检查 参数 类 型 及 其 字段 ， 并 
执行 一 些 文档 操作 。 

2 static boolean compileClass(Class<?> clazz) 此 方法 编译 指定 的 类 。 

3 static void disable() 此 方法 使 编译 器 停止 运作 。 

4 static boolean compileClasses(String string) 此 方法 编译 ， 其 名 称 与 指 
定 字符 串 匹 配 的 所 有 类 。 

5 static void enable() 此 方法 会 导致 编译 器 恢复 运行 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.Double # - java.lang 


java.lang.Double 类 包装 了 一 个 基本 类 型 double 在 对 象 中 的 值 。 Double 类 型 的 对 
象 包含 一 个 字段 ， 它 的 类 型 是 double。 


JA —- 
类 两 明 
以 下 是 java.lang.Double 类 的 声明 : 


public final class Double 
extends Number 
implements Comparable<Double> 


S.N. Wis HX & 描述 

Double(double value) 此 构造 一 个 新 分 配 的 Double 对 象 ， 表 示 原 始 
double 参 数 。 

2 Double(String s) 此 构造 一 个 新 分 配 的 Double 对 象 ， 表 示 double 类 型 的 
字符 串 表 示 的 浮 点 值 。 


类 方法 


S.N. 方法 & 描述 

byte byteValue() 此 方法 (通过 转换 成 一 个 字 节 ) 返 回 此 Double 为 一 个 字 节 
的 值 。 

2 static int compare(double d1, double d2) 此 方法 比较 两 个 指定 的 double 
{Bo 

3 int compareTo(Double anotherDouble) 此 方法 比较 两 个 指定 的 double 
值 。 

" static long doubleToLongBits(double value) 此 方法 返回 根据 IEEE754 浮 


点 " 双 精 度 格 式 " 位 布局 ， 返 回 指定 浮 点 值 的 表示 。 


static long doubleToRawLongBits(double value) 此 方法 返回 根据 
5 IEEE754 浮 点 “ 双 精 度 格式 "位 布局 ， 不 是 非 数 字 (NaN) 值 ， 返 回 指定 
浮 点 值 的 表示 。 
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6 double doubleValue() 此 方法 返回 根据 IEEE754 浮 点 “ 双 精 度 格式 ”位 布 
局 ， 不 是 非 数 字 (NaN) 值 ， 返 回 指定 浮 点 值 的 表示 。 


7 boolean equals(Object obj) 此 方法 比较 这 个 对 象 与 指定 对 象 。 
8 float floatValue() 此 方法 返回 当前 Double 对 象 的 浮 点 值 。 
9 int hashCode() 此 方法 返回 此 Double 对 象 的 哈 希 码 。 


10 int intValue() 此 方法 (通过 转换 成 int 类 型 ) 返回 此 Double 为 一 个 int 值 。 
boolean isInfinite() 如 果 这 个 Double 值 是 无 限 大 此 方法 返回 true， 否 则 


" i&[Blfalse, 

42 static boolean isInfinite(double v) 如 果 指 定 的 数 是 无 限 大 此 方法 返回 
true， 人 否则 返回 false。 

13 boolean isNaN() 如 果 这 Double 值 不 是 非 数 字 (NAN) 此 方法 返回 
true， 人 否则 退回 false。 

A static boolean isNaN(double v) 如 果 指 定 的 数 不 是 非 数字 (NAN) 的 值 
此 方法 返回 true， 人 否则 返回 false。 

15 static double longBitsToDouble(long bits) 此 方法 返回 对 应 于 给 定 的 位 表 
示 double 值 。 

16 long longValue() 此 方法 (通过 转换 成 long 类 型 ) 返回 此 Double 作 为 
long 值 。 

17 static double parseDouble(String s) 该 方法 返回 一 个 新 的 double 初 始 化 
为 指定 字符 串 表 示 的 值 ， 通 过 Double 类 的 valueOf 方 法 的 执行 。 

18 short shortValue() 此 方法 (通过 转换 成 short) 返回 此 Double 作 为 short 
的 值 。 

19 static String toHexString(double d) 此 方法 返回 double 参 数 的 十 六 进 制 
字符 串 表示 形式 。 


20 String toString() 此 方法 返回 此 Double 对 象 的 字符 串 表 示 形 式 。 
static String toString(double d) 此 方法 返回 double 参 数 的 字符 串 表示 形 


式 。 
22 static Double valueOf(double d) 此 方法 返回 一 个 表示 指定 的 double 值 的 
Double 实 例 。 
23 static Double valueOf(String s) 此 方法 返回 持 有 参数 字符 串 s 表 示 double 
值 的 Double 对 象 。 
方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


NO 
Oo 
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e java.lang.Object 


java.lang.Double # - java.lang 1282 
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java.lang.Enum 类 是 所 有 Java 语 言 枚 举 类 型 的 公共 基 类 。 


以 下 是 java.lang.Enum 类 的 声明 : 


public abstract class Enum<E extends Enum<E>> 
extends Object 
implements Comparable<E>, Serializable 


S.N. 构造 函数 & 描述 
1 protected Enum(String name, int ordinal) ix é— T 443& WR. 
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S.N. 方法 & 描述 

1 protected Object clone() 此 方法 将 抛 出 CloneNotSupportedException 异 
常 。 

2 int compareTo(E o) 此 方法 比较 此 枚 举 与 指定 对 象 的 顺序 。 

3 boolean equals(Object other) 如 果 指 定 的 对 象 等 于 此 枚 举 常 量 此 方法 返 
回 true。 

4 protected void finalize() 此 方法 返回 枚 举 类 不 能 有 finalize 方 法 。 

5 Class<E> getDeclaringClass() 此 方法 返回 对 应 于 此 枚 举 常 量 的 枚 举 类 
型 的 Class 对 象 。 

6 int hashCode() 此 方法 返回 枚 举 常 量 的 哈 希 码 。 

7 ee name() 此 方法 返回 枚 举 常 量 的 名 称 ， 正 是 因为 在 枚 举 声 明 中 声 

8 int ordinal() 此 方法 返回 枚 举 常 量 的 序数 ( 它 在 枚 举 声 明 ， 其 中 初始 常量 
5) BOE FF fiz). 

9 String toString) 此 方法 返回 枚 举 常 量 的 名 称 ， 它 包含 在 声明 中 。 

10 static <T extends Enum<T>> T valueOf(Class<T> enumType, String 
name) 此 方法 返回 具有 指定 名 称 的 指定 枚 举 类 型 的 枚 举 常 量 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.Float# - java.lang 


java.lang.Float 类 包装 float 基 本 类 型 的 对 象 的 值 。 Float 类 型 的 对 象 包含 一 个 字 
段 ， 它 的 类 型 为 float。 
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类 两 明 
以 下 是 java.lang.Float 类 的 声明 : 


public final class Float 
extends Number 
implements Comparable<Float> 


S.N. His AR & 描述 

Float(double value) 此 构造 一 个 新 分 配 的 Float 对 象 ， 表 示 转 换 为 float 
类 型 的 参数 。 

2 Float(float value) 此 构造 一 个 新 分 配 的 Float 对 象 ， 它 表示 基本 float 参 
数 。 

3 Float(String s) 此 构造 一 个 新 分 配 的 Float 对 象 ， 表 示 float 类 型 的 字符 串 
表示 的 浮 点 值 。 


类 方法 


S.N. 方法 & 描述 


byte byteValue() 此 方法 (通过 转换 成 一 个 字 节 ) 返 回 当 前 Float 为 一 个 字 节 
的 值 。 


static int compare(float f1, float f2) 此 方法 比较 两 个 指定 的 float 值 。 

int compareTo(Float anotherFloat) 此 方法 比较 两 个 浮 点 数 的 对 象 数值 。 
double doubleValue() 此 方法 返回 该 Float 对 象 的 double 值 。 

boolean equals(Object obj) 此 方法 比较 与 指定 对 象 与 这 个 对 象 。 


6 static int floatToIntBits(float value) 此 方法 返回 根据 IEEE754 浮 点 “单一 
格式 "位 布局 ， 返 回 指定 浮 点 值 的 表示 。 
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7 static int floatToRawlntBits(float value) 此 方法 返回 根据 IEEE754 浮 
点 “单一 格式 "位 布局 ， 不 是 非 数 字 (NaN) 值 ， 返 回 表示 指定 浮 点 值 。 
8 float floatValue() 此 方法 返回 该 Float 对 象 的 浮 点 
9 int hashCode() 此 方法 返回 rm 
10 static float intBitsToFloat(int bits) 此 方法 返回 对 应 于 给 定 的 位 表示 的 
float 值 。 
» int intValue() 此 方法 (通过 转换 成 int 类 型 ) 返回 当前 Float 对 象 对 应 的 整 
型 值 。 
12 boolean isInfinite() 如 果 这 个 Float 值 是 无 限 大 此 方法 返回 true， 否 则 返回 
false。 
13 static boolean isInfinite(float v) 如 果 指 定 的 数字 是 无 限 大 此 方法 返回 
true， 人 否则 返回 false。 
44 boolean isNaN() 如 果 这 个 浮 点 值 不 是 非 数字 (NAN) 此 方法 返回 true， 
否则 返回 false。 
45 static boolean isNaN(float v) 如 果 指 定 的 数字 不 是 非 数 字 (NAN) 值 此 
方法 返回 true， 否 则 返回 false。 
16 long longValue() 此 方法 (通过 转换 成 long 类 型 ) 返回 当前 Float 的 long 
17 static float parseFloat(String s) 此 方法 返回 指定 String 表 示 的 初始 化 新 
的 float， 通 过 Float 类 的 valueOf 方 法 执行 结果 的 值 。 
18 short shortValue() 此 方法 (通过 转换 成 short) 返回 此 Float 的 short 值 。 
19 static String toHexString(float f) 此 方法 返回 float 参 数 的 十 六 进 制 字符 串 
表示 形式 。 
20 String toString() 此 方法 返回 该 Float 对 象 的 字符 串 表 示 形 式 。 
21 static String toString(float f) 此 方法 返回 float 参 数 的 字符 串 表 示 形 式 
22 static Float valueOf(float f) 此 方法 返回 一 个 Float 实 例 表 示 指 定 浮 点 值 。 
23 static Float valueOf(String s) 该 方法 返回 一 个 Float 对 象 持 有 参数 字符 串 
s 表 示 的 float 值 。 
方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.InheritableThreadLocal # - java.lang 


java.lang.InheritableThreadLocal 类 扩展 了 ThreadLocal 从 父 线程 提供 的 值 来 继承 
子 线程 : 创建 一 个 子 线程 的 时 候 ， 子 的 所 有 可 继承 线程 局 部 变量 可 以 是 其 父 有 接收 
值 的 初始 值 。 
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以 下 是 java.lang.InheritableThreadLocal 类 的 声明 : 


public class InheritableThreadLocal<T> 
extends ThreadLocal<T> 


S.N. 构造 画 数 & 描述 


public class InheritableThreadLocal<T>extends ThreadLocal<T> 
这 是 一 个 构造 加 数 。 


类 方法 


S.N. 方法 & 描述 
protected T childValue(T parentValue) 此 方法 计算 ， 子 类 在 这 个 可 继承 


线程 局 部 变量 的 父 级 的 值 在 创建 子 线程 时 酌 数 的 初始 值 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.lang. ThreadLocal 


e java.lang.Object 


java.lang.Integer # - java.lang 


java.lang.Integer 类 封装 了 基本 类 型 int 的 值 在 一 个 对 象 。 Integer 类 型 的 对 象 包含 一 
个 字段 ， 它 的 类 型 是 int。 
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public final class Integer 
extends Number 
implements Comparable<Integer> 


S.N. HSH & 描述 
1 Integer(int value) 此 构造 一 个 新 分 配 的 Integer 对 象 ， 它 表示 指定 的 int 
2 Integer(String s) 此 构造 一 个 新 分 配 的 Integer 对 象 ， 它 表示 String 参 数 


指定 int 值 。 


类 方法 


S.N. 方法 & 描述 

static int bitCount(int i) 此 方法 返回 一 个 位 在 指定 的 int 值 的 二 进 制 补 码 表 
示 的 数 。 

2 byte byteValue() 此 方法 返回 这 个 整数 作为 一 个 字 节 的 值 。 

3 j compareTo(Integer anotherlnteger) 此 方法 比较 两 个 整数 对 象 的 数 

4 static Integer decode(String nm) 此 方法 解码 字符 串 转换 为 整数 。 

5 double doubleValue() 此 方法 返回 这 个 整数 作为 double 值 。 

6 boolean equals(Object obj) 此 方法 将 此 对 象 与 指定 对 象 作 比 较 。 

7 float floatValue() 此 方法 返回 这 个 整数 作为 一 个 float 值 。 


static Integer getlnteger(String nm) 此 方法 确定 具有 指定 名 称 的 系统 属 
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性 的 整数 值 。 


static Integer getlnteger(String nm, int val) 此 方法 确定 具有 指定 名 称 的 
系统 属性 的 整数 值 。 


static Integer getlnteger(String nm, Integer val) 此 方法 返回 具有 指定 名 
称 的 系统 属性 的 整数 值 。 


int hashCode() 此 方法 返回 这 个 整数 的 哈 希 码 。 


static int highestOneBit(int i) 此 方法 返回 一 个 位 在 指定 的 int 值 ， 一 个 int 
多 单个 1 位 ， 在 最 高 位 (“RA”) 的 位 置 。 


int intValue() 此 方法 返回 这 个 整数 作为 一 个 int 值 。 
long longValue() 此 方法 返回 这 个 整数 作为 Iong 值 。 


static int lowestOneBit(int i) 此 方法 返回 一 个 位 在 指定 的 int 值 ， 一 个 int 
值 至 多 单个 1 位 ， 在 最 低 阶 CRA) 的 位 置 。 


static int numberOfLeadingZeros(int i) 此 方法 返回 需 位 的 最 高 位 (“最 左 
Ji") 之 前 的 数 指定 的 int 值 的 二 进 制 补 码 表 示 1 上 比特 。 


static int numberOfTrailingZeros(int i) 此 方法 返回 需 位 以 下 的 最 低 阶 
(“最 右 ”) 的 数 在 指定 的 int 值 的 二 进 制 补 码 表 示 一 比特 。 


static int parselnt(String s) 此 方法 将 字符 串 参 数 作 为 有 符号 十 进 制 整 


o 


static int parselnt(String s, int radix) 此 方法 解析 字符 串 参数 作为 第 二 个 
参数 指定 的 基数 有 符号 整数 。 


static int reverse(int i) 此 方法 返回 通过 反 转 的 比特 的 顺序 中 指定 的 int 值 
的 二 进 制 补 码 表示 法 得 到 的 值 。 


static int reverseBytes(int i) 此 方法 返回 通过 反 转 指定 int 值 的 二 进 制 补 码 
表示 的 字 节 的 顺序 而 获得 的 值 。 


static int rotateLeft(int i, int distance) 此 方法 返回 通过 旋转 由 位 的 指定 数 
左 移 指定 的 int 值 的 二 进 制 补 码 表示 法 得 到 的 值 。 


static int rotateRight(int i, int distance) 此 方法 返回 由 右 由 位 的 指定 数 的 
旋转 指定 的 int 值 的 二 进 制 补 码 表示 法 得 到 的 值 。 


short shortValue() 此 方法 返回 这 个 整数 作为 short 值 。 
static int signum(int i) 此 方法 返回 指定 的 int 值 的 正 负 号 函数 。 


static String toBinaryString(int i) 此 方法 返回 一 个 整数 参数 作为 基数 为 2 
的 无 符号 整数 的 字符 串 表 示 形 式 。 


static String toHexString(int i) 此 方法 返回 一 个 整数 参数 作为 基数 为 16 的 
无 符号 整数 的 字符 串 表 示 形 式 。 


static String toOctalString(int i) 此 方法 返回 一 个 整数 参数 作为 基数 为 8 无 
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符号 整数 的 字符 串 表 示 形 式 。 


String toString() 此 方法 返回 一 个 代表 该 整数 的 值 的 String 对 象 。 

static String toString(int i) 此 方法 返回 一 个 表示 指定 整数 的 String 对 象 。 
static String toString(int i, int radix) 此 方法 返回 由 第 二 个 参数 指定 的 基 
数 ， 第 一 个 参数 的 字符 串 表 示 形 式 。 

oe Integer valueOf(int i) 该 方法 返回 一 个 整数 实例 ， 表 示 指 定 的 int 


static Integer valueOf(String s) 此 方法 返回 一 个 Integer 对 象 持 有 指定 字 
符 串 的 值 。 


static Integer valueOf(String s, int radix) 此 方法 返回 一 个 Integer 对 象 保 
持 从 指定 的 String 中 提取 的 值 时 ， 由 第 二 个 参数 给 出 的 基数 进行 分 析 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Long X - java.lang 


java.lang.Long 类 封装 了 基本 类 型 long 对 象 的 值 。 long 类 型 的 对 象 包含 单个 字段 类 
8! Jj long. 


JA Œ 
类 两 明 
以 下 是 java.lang.Long 类 的 声明 : 


public final class Long 
extends Number 
implements Comparable<Long> 


类 构造 函数 
S.N. Wis HX & 描述 
1 Long(long value) 此 构造 一 个 新 分 配 Long 对 象 ， 表 示 指 定 long 参 数 。 
2 Long(String s) 此 构造 一 个 新 分 配 的 Long 对 象 ， 表 示 String 参 数 所 指定 
BYlong 值 。 


类 方法 


S.N. 方法 & 描述 


static int bitCount(long i) 此 方法 返回 一 个 位 在 指定 long 值 的 二 进 制 补 码 
表示 的 数 。 


byte byteValue() 此 方法 返回 Long 对 象 的 字 节 的 值 。 

int compareTo(Long anotherLong) 这 种 方法 数值 比较 两 个 long 的 对 象 。 
static Long decode(String nm) 这 种 方法 解码 字符 串 转 换 为 long。 
double doubleValue() 这 个 方法 返回 这 个 Long 值 作为 double 值 。 
boolean equals(Object obj) 此 方法 将 此 对 象 与 指定 对 象 比较 。 

float floatValue() 此 方法 返回 这 个 Long 值 为 float 值 。 


3 static Long getLong(String nm) 此 方法 确定 具有 指定 名 称 的 系统 属性 的 
long 值 。 
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统 属性 的 long 值 。 

static Long getLong(String nm, Long val) 此 方法 返回 县 有 指定 名 称 的 系 
统 属性 的 long 值 。 

int hashCode() 此 方法 返回 这 个 long 的 哈 希 码 。 


static long highestOneBit(long i) 此 方法 返回 一 个 long 值 至 多 单个 1 位 ， 
在 最 高 位 (“mz”) 的 位 置 的 一 个 位 在 指定 long 值 。 


int intValue() 此 方法 返回 这 个 Long 作为 一 个 int 值 。 
long longValue() 此 方法 返回 这 个 Long 作为 Ilong 值 。 


static long lowestOneBit(long i) 此 方法 返回 一 个 long 值 至 多 单个 1 位 ， 
在 最 低 阶 CRA) 的 位 置 的 一 个 位 在 指定 long 值 。 


static int numberOfLeadingZeros(long i) 此 方法 返回 雾 位 的 最 高 位 (“mR 
左 侧 ”) 之 前 的 数 指 定 long 值 的 二 进 制 补 码 表示 一 比特 。 


static int numberOfTrailingZeros(long i) 此 方法 返回 需 位 以 下 的 最 低 阶 
(“RRA”) 的 数 指定 long 值 的 二 进 制 补 码 表示 一 比特 。 


static long parseLong(String s) 此 方法 解析 为 有 符号 十 进 制 long 的 字符 
串 参 数 。 


static long parseLong(String s, int radix) 此 方法 解析 为 在 第 二 个 参数 指 
定 的 基数 有 符号 long 字 符 串 参数 。 


static long reverse(long i) 此 方法 返回 通过 反 转 位 的 顺序 在 指定 long 值 的 
二 进 制 补 码 表示 形式 而 得 到 的 值 。 


static long reverseBytes(long i) 此 方法 返回 通过 反 转 指定 long 值 的 二 进 
制 补 码 表 示 的 字 节 的 顺序 而 获得 的 值 。 


static long rotateLeft(long i, int distance) 此 方法 返回 通过 旋转 的 由 位 的 
指定 数 左 移 指定 的 long 值 的 二 进 制 补 码 表示 法 得 到 的 值 。 


static long rotateRight(long i, int distance) 此 方法 返回 右键 按 位 指定 数 
量 的 旋转 的 指定 long 值 的 二 进 制 补 码 表 示 形 式 而 得 到 的 值 。 


short shortValue() 此 方法 返回 这 个 Long 的 一 个 short 值 。 
static int signum(long i) 此 方法 返回 指定 long 值 的 正 负 号 函数 。 


static String toBinaryString(long i) 此 方法 返回 long 参 数 作为 基数 为 2 的 
无 符号 整数 的 字符 串 表 示 形 式 。 


static String toHexString(long i) 此 方法 返回 long 参 数 作为 基数 为 16 无 符 
号 整数 的 字符 串 表 示 形 式 。 


static String toOctalString(long i) 此 方法 返回 long 参 数 作为 基数 8 无 符号 
整数 的 字符 串 表 示 形 式 。 


String toString() 此 方法 返回 一 个 代表 该 Long 值 的 String 对 象 。 
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static String toString(long i) 此 方法 返回 一 个 表示 指定 long 的 String 对 


o 


static String toString(long i, int radix) 此 方法 返回 由 第 二 个 参数 指定 的 基 
数 ， 第 一 个 参数 的 字符 串 表 示 形 式 。 


static Long valueOf(long |) 此 方法 返回 一 个 Long 实 例 ， 表 示 指 定 的 long 
{Bo 


static Long valueOf(String s) 该 方法 返回 一 个 Long 对 象 持 有 指定 字符 串 
的 值 。 


static Long valueOf(String s, int radix) 此 方法 返回 一 个 Long 对 象 从 指定 
String 中 提取 的 值 ， 由 第 二 个 参数 给 出 的 基数 进行 分 析 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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3X FAA 
以 下 是 java.lang.Math 类 的 声明 : 


public final class Math 
extends Object 


字段 域 
以 下 是 java.lang.Math 类 的 字段 : 
e static double E -- 这 个 double 值 比 任何 其 他 值 更 接近 于 e， 自 然 对 数 的 底数 。 


e static double PI -- 这 个 double 值 ， 该 值 是 比 任何 其 他 更 靠近 圆周 率 ， 圆 其 直径 
的 圆周 的 比率 。 


类 方法 
S.N. 方法 & 描述 
1 static double abs(double a) 此 方法 返回 double 值 的 绝对 值 。 


2 static float abs(float a) 该 方法 返回 一 个 浮 点 数值 的 绝对 值 。 

3 static int abs(int a) 此 方法 返回 一 个 int 值 的 绝对 值 。 

4 static long abs(long al) 此 方法 返回 一 个 long 值 的 绝对 值 。 

static double acos(double a) 此 方法 返回 一 个 值 的 反 余 弦 ; 返 回 的 角度 范 


a 在 0.0 到 pi。 

6 static double asin(double a) 此 方法 返回 一 个 值 的 反正 弦 ; 返 回 的 角度 范 
为 -pi/ 2 到 pi/ 2。 

7 static double atan(double a) 此 方法 返回 一 个 值 的 反正 切 ;返回 的 角度 范 
为 -pi/ 2 到 pi/ 2。 

static double atan2(double y, double x) 此 方法 返回 从 直角 坐标 (X, 


Y) 为 极 坐标 (r, theta) 转 化 率 角 度 29。 
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static double cbrt(double a) 此 方法 返回 double 值 的 立方 根 。 


static double ceil(double a) 此 方法 返回 最 小 的 (最 接近 负 无 穷 大 ) 
double 值 ， 该 值 大 于 或 等 于 参数 ， 并 等 于 某 个 整数 。 


static double pale a eie magnitude, double sign) 此 方法 返回 第 
二 学 所 点 参数 符号 及 第 一 FF 孚 点 参数 。 


static float cu magnitude, float sign) 此 方法 返回 第 二 浮 点 参 
数 符 号 及 第 一 个 浮 点 参数 。 


static double cos(double a) 此 方法 返回 一 个 角度 的 三 角 余 弦 值 。 
static double cosh(double x) 此 方法 返回 double 值 的 双 曲 余弦 值 。 


static double exp(double al) 此 方法 返回 欧 拉 数 e 为 底 的 一 个 double 值 的 
RF 


static double expm1 (double x) 此 方法 返回 e<sup style="margin: Opx; 
padding: Opx; font-size: 13px;">x</sup> -1. 


static double floor(double a) 此 方法 返回 最 大 的 (最 接近 正 无 穷 大 ) 
double 值 ， 该 值 小 于 或 等 于 参数 ， 并 等 于 某 个 整数 。 


static int getExponent(double d) 此 方法 返回 double 代 表 使 用 的 无 偏 指 
数 。 


static int getExponent(float f) 该 方法 返回 一 个 浮 点 数 的 表示 所 使 用 的 无 
偏 指 数 。 


static double hypot(double x, double y) 此 方法 返回 sqrt(x<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">2</sup> +y<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">2</sup>) 没有 中 间 
XX Riu. 

static double IEEEremainder(double f1, double f2) 此 方法 计算 的 规定 的 
IEEE 754 标 准 的 两 个 参数 的 余数 运算 。 


static double log(double a) 此 方法 返回 double 值 的 自然 对 数 (以 e 为 
[EI 


static double log10(double a) 此 方法 返回 以 10 为 底 的 对 数 的 double 
值 。 


static double log1p(double x) 此 方法 返回 参数 与 1 之 和 的 自然 对 数 。 


static double max(double a, double b) 此 方法 返回 两 个 double 值 之 中 的 
较 大 值 。 


static float max(float a, float b) 此 方法 返回 两 个 float 值 的 较 大 那个 值 。 
static int max(int a, int b) 此 方法 返回 两 个 int 值 的 较 大 值 。 
static long max(long a, long b) 此 方法 返回 两 个 long 值 的 较 大 值 。 
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static double min(double a, double b) 此 方法 返回 两 个 double 的 较 小 
值 。 


static float min(float a, float b) 此 方法 返回 两 个 float 的 较 小 值 。 
static int min(int a, int b) 此 方法 返回 两 个 int 的 较 小 值 。 
static long min(long a, long b) 此 方法 返回 两 个 long 的 较 小 值 。 


static double nextAfter(double start, double direction) 此 方法 返回 相 邻 
第 二 个 参数 的 方向 上 的 第 一 个 参数 的 浮 点 数 。 


static float nextAfter(float start, double direction) 此 方法 返回 相 邻 第 二 
个 参数 的 方向 上 的 第 一 个 参数 的 浮 点 数 。 


static double nextUp(double d) 此 方法 返回 正 无 穷 大 的 方向 靠近 d 中 的 浮 
点 值 。 


static float nextUp(float f) 此 方法 返回 毗邻 f 在 正 无 穷 大 的 方向 浮 点 值 。 


static double pow(double a, double b) 此 方法 返回 第 一 个 参数 提高 到 第 
—^T 838 P] 3 [à 


static double random() 该 方法 返回 一 个 double 值 ， 正 号 并 大 于 或 等 于 
0.0 并 且 小 于 1.0。 


static double rint(double a) 此 方法 返回 参数 最 接近 的 double 值 ， 并 等 于 
基 个 整数 。 


static long round(double a) 此 方法 返回 最 接近 long 的 参数 。 
static int round(float a) 此 方法 返回 最 接近 参数 的 整数 。 


static double scalb(double d, int scaleFactor) 此 方法 返回 d x 2<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">scaleFactor</sup> 


舍 入 好 像 由 一 个 单一 的 执行 正确 舍 入 的 浮 点 乘法 的 double 值 集合 的 成 


已 
Wo 


static float scalb(float f, int scaleFactor) 此 方法 返回 fx 2<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">scaleFactor</sup> 


舍 入 好 像 由 一 个 单一 的 执行 正确 舍 入 的 浮 点 乘法 的 浮 点 值 集合 的 成 员 。 


static double signum(double d) 此 方法 返回 参数 的 符号 函数 ;返回 0 如 果 
该 参数 为 0 ; 返回 1.0 如 果 参 数 大 于 0， 返 回 -1.0 如 果 参 数 小 于 震 。 


static float signum(float f) 此 方法 返回 参数 的 符号 函数 ;返回 0 如 果 该 参数 
AO ; 返回 1.0f 如 果 参 数 大 于 0， 返 回 -1.0 如 果 参 数 小 于 需 。 


static double sin(double a) 这 个 方法 返回 double 值 的 双 曲 正弦 值 。 
static double sinh(double x) 该 方法 返回 一 个 double 值 的 双 曲 正弦 值 。 
static double sqrt(double a) 此 方法 返回 double 值 的 正确 舍 人 正平 方 根 。 
static double tan(double a) 此 方法 返回 一 个 角 的 三 角 正 切 值 。 
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50 static double tanh(double x) 此 方法 返回 double 值 的 双 曲 正切 值 。 
static double toDegrees(double angrad) 此 方法 转换 以 弧度 为 单位 ， 以 


31 度数 浏 量 的 近似 相等 的 角 的 角度 。 
52 static double toRadians(double angdeg) 此 方法 转换 为 度 ， 以 弧度 为 单 


位 的 近似 等 效 角 的 角度 。 
53 static double ulp(double d) 此 方法 返回 参数 的 ulp 的 大 小 。 
54 static double ulp(float f) 此 方法 返回 参数 的 ulp 的 大 小 。 
方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Number 类 是 BigDecimal, BigInteger, Byte, Double, Float, Integer, 
Long, Short 类 的 超 类 子 类 必须 提供 的 方法 所 代表 的 数值 转换 为 byte, double, float, 
int, long, 和 short。 
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以 下 是 java.lang.Number 类 的 声明 : 


public abstract class Number 
extends Object 
implements Serializable 


类 构造 函数 
S.N. MESZ & 描述 
1 Number() 这 是 一 个 构造 男 数 。 
类 方法 
S.N. 方法 & 描述 
1 byte byteValue() 此 方法 返回 指定 数 的 字 节 的 值 。 
2 abstract double doubleValue() 此 方法 返回 指定 数量 的 double 值 。 
3 abstract float floatValue() 此 方法 返回 指定 数 为 float 的 值 。 
4 abstract int intValue() 此 方法 返回 指定 数字 的 整 型 值 。 
5 abstract long longValue() 此 方法 返回 指定 数字 作为 一 个 long 值 。 
6 short shortValue() 此 方法 返回 指定 数 的 short 值 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.Object # - java.lang 


java.lang.Object 类 为 类 层次 结构 的 根 。 每 个 类 都 将 对 象 作为 超 类 。 所 有 对 象 ， 包 
括 数组 ， 都 实现 这 个 类 的 方法 。 
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x a BH 
以 下 是 java.lang.Object 类 的 声明 : 


public class Object 


类 MX EN BL 
S.N. Hye & 描述 
1 Object() 3x zà — ^ 443& HR, 
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S.N. 


方法 & 描述 
protected Object clone() 此 方法 创建 并 返回 此 对 象 的 一 个 副本 。 
boolean equals(Object obj) 此 方法 指示 某 个 其 他 对 象 是 否 “ 等 于 ”这 一 


项 。 


protected void finalize() 调用 此 方法 在 一 个 对 象 在 垃圾 回收 时 ， 垃 圾 回 
收 器 确定 不 存在 对 该 对 象 的 更 多 引用 。 


Class<?> getClass() 此 方法 返回 运行 时 此 类 对 象 。 

int hashCode() 此 方法 返回 该 对 象 的 哈 希 码 值 。 

void notify() 此 方法 唤醒 正在 等 待 此 对 象 的 监视 器 上 的 单个 线程 。 
void notifyAll() 此 方法 唤醒 正在 等 待 此 对 象 监 视 器 上 的 所 有 线程 。 
String toString() 此 方法 返回 该 对 象 的 字符 串 表 示 形 式 。 


void wait() 此 方法 导致 当前 线程 等 待 ， 直 到 其 他 线程 调用 notify() 方 法 或 
notifyAll() 方 法 。 


void wait(long timeout) 此 方法 导致 当前 线程 等 待 ， 直 到 其 他 线程 调用 此 
对 象 的 notify() 方法 或 notifyAll() 方 法 ， 或 在 指定 已 经 过 去 的 时 间 。 


void wait(long timeout, int nanos) 此 方法 导致 当前 线程 等 待 ， 直 到 其 他 
线程 调用 此 对 象 的 notify() 方法 或 notifyAll() 方 法 ， 或 者 其 他 某 个 线程 中 
断 当前 线程 ， 或 者 一 定量 已 过 的 实时 时 间 。 


java.lang.Package 类 - java.lang 
java.lang.Package 类 包含 有 关 Java 包 的 实现 和 规范 版 本 信息 
类 声明 

以 下 是 java.lang.Package 类 的 声明 : 


public class Package 
extends Object 
implements AnnotatedElement 
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S.N. 方法 & 描述 


<A extends Annotation> A getAnnotation(Class<A> annotationClass) 
1 此 方法 返回 这 个 元 素 的 注解 指定 类 型 ， 如 果 这 样 的 注释 ， 否 则 返回 


null, 
2 Annotation[] getAnnotations() 此 方法 返回 当前 这 个 元 素 上 的 所 有 注释 。 
3 Annotation[] getDeclaredAnnotations() 此 方法 返回 直接 存在 于 此 元 素 上 
的 所 有 注释 。 


4 String getlmplementationTitle() 此 方法 返回 这 个 包 的 名 称 


String getImplementationVendor() 此 方法 返回 提供 该 实现 的 组 织 ， 供 应 
商 或 公司 的 名 称 。 


6 String getlmplementationVersion() 此 方法 返回 这 个 实现 的 版 本 。 
7 String getName() 此 方法 返回 这 个 包 的 名 称 。 


static Package getPackage(String name) 此 方法 通过 在 调用 方 的 
ClassLoader 实 例 名 称 找 到 包 。 


static Package[] getPackages() 此 方法 得 到 所 有 目前 已 知 的 调用 方 的 
ClassLoader 实 例 的 软件 包 。 


10 String getSpecificationTitle() 此 方法 返回 这 个 包 实 现 该 规范 的 名 称 
String getSpecificationVendor() 此 方法 返回 的 组 织 ， 供 应 商 或 公司 拥有 


”并 维护 实现 此 包 的 类 的 规范 的 名 称 。 
42 String getSpecificationVersion() 此 方法 返回 这 个 包 实 现 该 规范 的 版 本 


Tio 
13 int hashCode() 此 方法 返回 从 包 名 称 计 算 的 哈 希 码 。 


boolean isAnnotationPresent(Class<? extends Annotation> 
14 annotationClass) 如 果 一 个 注解 指定 类 型 是 存在 于 此 元 素 上 ， 此 方法 返 
回 true， 人 否则 返回 false。 


boolean isCompatibleWith(String desired) 此 方法 比较 这 包 的 规范 版 本 
与 所 需 的 版 本 。 


16 boolean isSealed() 如 果 这 个 包 是 密封 此 方法 返回 true。 


boolean isSealed(URL url) 如 果 这 个 包 是 密封 的 ， 对 于 指定 的 代码 源 
URL 此 方法 返回 true。 


18 String toString() 此 方法 返回 这 个 包 的 字符 串 表示 形式 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


java.lang.Package # - java.lang 1302 
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e java.lang.Object 


java.lang.Package # - java.lang 1303 


java.lang.Process X - java.lang 


java.lang.Process 类 提供 了 从 进程 进行 输入 ， 执 行 输出 到 进程 ， 等 待 进程 完成 ， 检 
查 进程 的 退出 状态 ， 并 摧毁 ( 杀 死 ) 进 程 的 方法 。 


JA Œ 
类 两 明 
以 下 是 java.lang.Process 类 的 声明 : 


public abstract class Process 
extends Object 


类 构造 回 数 
S.N. Wis HX & 描述 
1 Process() 这 是 一 个 构造 男 数 。 
类 方法 
S.N. 方法 & 描述 
1 abstract void destroy() 这 种 方法 杀 死 子 进程 。 
2 abstract int exitValue() 此 方法 返回 子 进程 的 退出 值 。 
3 abstract InputStream getErrorStream() 此 方法 获取 子 进程 的 错误 流 。 
4 abstract InputStream getInputStream() 此 方法 获取 子 进程 的 输入 流 。 


5 abstract OutputStream getOutputStream() 此 方法 获取 子 进程 的 输出 


到 
Abo 


6 abstract int waitFor() 此 方法 导致 当前 线程 等 待 ， 如 果 有 必要 ， 直 到 由 该 
Process 对 象 表 示 的 进程 已 经 终止 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.ProcessBuilder# - java.lang 
java.lang.ProcessBuilder 类 用 于 创建 操作 系统 进程 。 此 类 是 不 同步 的 。 
类 声明 

以 下 是 java.lang.ProcessBuilder 类 的 声明 : 


public final class ProcessBuilder 
extends Object 


S.N. ERA & 描述 

1 ProcessBuilder(List<String> command) 此 构造 一 个 进程 生成 器 指定 
的 操作 系统 程序 和 参数 。 

2 ProcessBuilder(String... command) 此 构造 一 个 进程 生成 器 指定 的 操 


作 系统 程序 和 参数 。 
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S.N. 方法 & 描述 
List<String> command() 此 方法 返回 此 进程 生成 器 的 操作 系统 程序 和 参 


o 


ProcessBuilder command(List<String> command) 此 方法 设置 此 进程 生 


^ ”成 器 的 操作 系统 程序 和 参数 。 
3 ProcessBuilder command(String... command) 此 方法 设置 此 进程 生成 


器 的 操作 系统 程序 和 参数 。 
4 File directory() 此 方法 返回 此 进程 生成 器 的 工作 目录 。 
ProcessBuilder directory(File directory) 此 方法 设置 此 进程 生成 器 的 工 


> WER. 

6 Map<String,String> environment() 此 方法 返回 此 进程 生成 器 环境 的 字符 
串 映 射 视 图 。 

7 boolean redirectErrorStream() 这 个 方法 告诉 此 进程 生成 器 是 否 合并 标 
准 错误 和 标准 输出 。 

8 ProcessBuilder redirectErrorStream(boolean redirectErrorStream) 此 方 


法 设置 此 进程 生成 器 redirectErrorStream 的 属性 。 
9 Process start() 这 种 方法 使 用 此 进程 生成 器 的 属性 一 个 新 的 进程 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Runtime # - java.lang 
java.lang.Runtime 以 下 是 java.lang.Runtime 类 的 声明 : 
类 声明 

以 下 是 java.lang.Runtime 类 的 声明 : 


public class Runtime 
extends Object 


类 方法 


S.N. 方法 & 描述 

void addShutdownHook(Thread hook) 此 方法 注册 一 个 新 的 虚拟 机 关闭 
挂钩。 

2 int availableProcessors() 此 方法 返回 可 用 处理 器 的 Java 虚 拟 机 的 数量 。 

3 Process exec(String command) 此 方法 在 一 个 单独 的 进程 中 执行 指定 的 
字符 串 命 倒 。 

4 Process exec(String[] cmdarray) 此 方法 在 一 个 单独 的 进程 中 执行 指定 
的 命令 和 参数 。 


Process exec(String[] cmdarray, String[] envp) 此 方法 指定 环境 独立 进 
程 中 执行 指定 的 命令 和 参数 。 


6 Process exec(String[] cmdarray, String[] envp, File dir) 此 方法 指定 环境 
和 工作 目录 的 独立 进程 中 执行 指定 的 命令 和 参数 。 


Process exec(String command, String[] envp) 此 方法 在 指定 环境 的 独立 
进程 中 执行 指定 的 字符 串 命 邻 。 


3 Process exec(String command, String[] envp, File dir) 此 方法 在 指定 环 
境 和 工作 目录 的 独立 进程 中 执行 指定 的 字符 串 命 邻 。 


void exit(int status) 此 方法 通过 发 起 关闭 序列 ， 终 止 当前 正在 运行 的 
Java 虚 拟 机 。 


10 long freeMemory() 此 方法 返回 可 用 内 存在 Java 虚 拟 机 的 数量 。 
11 void gc() 这 种 方法 运行 垃圾 回收 器 。 
static Runtime getRuntime() 此 方法 返回 与 当前 Java 应 用 程序 相关 的 运 


ang.Runtime 类 - java.lang 
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S.N. 方法 & 描述 

void addShutdownHook(Thread hook) 此 方法 注册 一 个 新 的 虚拟 机 关闭 
挂钩。 

2 int availableProcessors() 此 方法 返回 可 用 处 理 器 的 Java 虚 拟 机 的 数量 。 

3 Process exec(String command) 此 方法 在 一 个 单独 的 进程 中 执行 指定 的 
字符 串 命 令 。 

4 Process exec(String[] cmdarray) 此 方法 在 一 个 单独 的 进程 中 执行 指定 
的 命 信 和 参数 。 


Process exec(String[] cmdarray, String[] envp) 此 方法 指定 环境 独立 进 
程 中 执行 指定 的 命令 和 参数 。 


6 Process exec(String[] cmdarray, String[] envp, File dir) 此 方法 指定 环境 
和 工作 目录 的 独立 进程 中 执行 指定 的 命 售 和 参数 。 


Process exec(String command, String[] envp) 此 方法 在 指定 环境 的 独立 
进程 中 执行 指定 的 字符 串 命 令 。 


3 Process exec(String command, String[] envp, File dir) 此 方法 在 指定 环 
境 和 工作 目录 的 独立 进程 中 执行 指定 的 字符 串 命 邻 。 


void exit(int status) 此 方法 通过 发 起 关闭 序列 ， 终 止 当前 正在 运行 的 
Java 虚 拟 机 。 


10 long freeMemory() 此 方法 返回 可 用 内 存在 Java 虚 拟 机 的 数量 。 
11 void gc() 这 种 方法 运行 垃圾 回收 器 。 


12 static Runtime getRuntime() 此 方法 返回 与 当前 Java 应 用 程序 相关 的 运 
行 时 对 象 。 


13 void halt(int status) 此 方法 强行 终止 当前 正在 运行 的 Java 虚 拟 机 。 

14 void load(String filename) 此 方法 加 载 指定 的 文件 名 作为 一 个 动态 库 。 
15 void loadLibrary(String libname) 此 方法 加 载 指 定 的 库 名 的 动态 库 。 
long maxMemory() 此 方法 返回 内 存 ，Java 虚 拟 机 将 尝试 使 用 的 最 大 


(0 ow, 

17 boolean removeShutdownHook(Thread hook) 此 方法 去 注册 一 个 以 前 
注册 的 虚拟 机 关闭 挂钩 。 

18 人 

19 long totalMemory() 此 方法 返回 存储 器 中 的 Java 虚 拟 机 的 总 量 。 

20 void tracelnstructions(boolean on) 此 方法 允许 /禁止 跟踪 指 今 。 


21 void traceMethodCalls(boolean on) 此 方法 允许 /禁止 的 方法 调用 跟踪 。 
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方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.RuntimePermission # - java.lang 


java.lang.RuntimePermission 类 是 运行 时 的 权限 。 通 过 RuntimePermission 包 合 
一 个 名 称 (也 称 为 “目标 名 称 ”)， 但 没有 动作 列表 ; 要 么 有 指定 权限 ， 也 可 以 不 用 指 
定 。 


xy oe 
A FAR 
以 下 是 java.lang.RuntimePermission 类 的 声明 : 


public final class RuntimePermission 
extends BasicPermission 


SHE T7 z 
3 7A TE EN BL 
S.N. Mieke & 描述 
RuntimePermission(String name) 这 种 构造 一 个 新 的 


RuntimePermission 具 有 指定 名 称 。 


2 RuntimePermission(String name, String actions) 该 构造 具有 指定 名 
称 的 新 RuntimePermission 对 象 . 


类 方法 

这 个 类 继承 了 下 面 的 类 方法 : 
e java.lang.BasicPermission 
e java.lang.Permission 


e java.lang.Object 


java.lang.SecurityManager X: - java.lang 
java.lang.SecurityManager 类 人 允许 应 用 程序 实现 安全 策略 。 它 允许 一 个 应 用 程序 来 


确定 ， 执 行 可 能 不 安全 或 敏感 的 操作 前 ， 操 作 是 什么 ， 它 是 否 正在 试图 在 安全 范围 
内 ， 人 允许 执行 的 操作 。 该 应 用 程序 可 以 允许 或 茶 止 该 操作 。 


Sa = 
类 两 明 
以 下 是 java.lang.SecurityManager 类 的 声明 : 


public class SecurityManager 
extends Object 


类 构造 图 数 
S.N. His AR & 描述 
1 SecurityManager() 这 构造 了 一 个 新 的 安全 管理 器 。 


类 方法 


S.N. 方法 & 描述 
void checkAccept(String host, int port) 此 方法 将 抛 出 一 个 

1 SecurityException 如 果 调 用 线程 不 允许 接受 来 自 指 定 的 主机 和 端口 号 的 
套 接 字 连 接 。 

2 void checkAccess(Thread t) 此 方法 将 抛 出 一 个 SecurityException 如 果 


调用 线程 不 允许 修改 线程 的 参数 。 


3 void checkAccess(ThreadGroup g) 此 方法 将 抛 出 一 个 
SecurityException 如 果 调 用 线程 不 允许 修改 线程 组 参数 。 


4 void checkAwtEventQueueAccess() 此 方法 将 抛 出 一 个 
SecurityException 如 果 调 用 线程 不 允许 访问 AWT 事 件 队列 。 


void checkConnect(String host, int port) 此 方法 将 抛 出 一 个 
5 SecurityException 如 果 调 用 线程 不 允许 打开 套 接 字 连 接 到 指定 的 主机 和 
端口 号 。 
void checkConnect(String host, int port, Object context) 此 方法 将 抛 出 
6 一 个 SecurityException 如 果 指 定 的 安全 上 下 文 不 允许 打开 套 接 字 连 接 到 
指定 的 主机 和 端口 号 。 


Tutorie 
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15 


16 


17 


18 


19 


20 


21 


22 


23 
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void checkCreateClassLoader() 此 方法 将 抛 出 一 个 SecurityException 如 
果 调 用 线程 不 允许 创建 新 的 类 加 载 器 。 

void checkDelete(String file) 此 方法 将 抛 出 一 个 SecurityException 如 果 
调用 线程 不 允许 删除 指定 的 文件 。 

void checkExec(String cmd) 此 方法 将 抛 出 一 个 SecurityException 如 果 
调用 线程 不 允许 创建 子 进程 。 

void checkExit(int status) 此 方法 将 抛 出 一 个 SecurityException 如 果 调 用 
线程 不 允许 使 Java 虚 拟 机 暂停 指定 的 状态 代码 。 

void checkLink(String lib) 此 方法 将 抛 出 一 个 SecurityException 如 果 调 用 
线程 不 允许 动态 链接 由 字符 串 参 数 文件 指定 的 库 代 码 。 


void checkListen(int port) 此 方法 将 抛 出 一 个 SecurityException 如 果 调 用 
线程 不 允许 等 待 指 定 的 本 地 端口 号 的 连接 请 求 。 


void checkMemberAccess(Class<?> clazz, int which) 此 方法 将 抛 出 一 
个 SecurityException 如 果 调 用 线程 不 允许 访问 的 成 员 。 


void checkMulticast(InetAddress maddr) 此 方法 将 抛 出 一 个 
SecurityException 如 果 调 用 线程 不 允许 使 用 (加 入 /离开 /发 送 /接收 ) IP 
多 播 。 


void checkPackageAccess(String pkg) 此 方法 将 抛 出 一 个 
SecurityException 如 果 调 用 线程 不 允许 访问 由 参数 指定 的 包 。 


void checkPackageDefinition(String pkg) 此 方法 将 抛 出 一 个 
SecurityException 如 果 调 用 线程 不 允许 在 由 参数 指定 的 包 中 定义 类 。 


void checkPermission(Permission perm) 此 方法 将 抛 出 一 个 
SecurityException， 如 果 所 请 求 的 访问 ， 由 给 定 权 限 所 指定 ， 不 是 基于 
当前 生效 的 安全 策略 不 允许 的 。 

void checkPermission(Permission perm, Object context) 如 果 指 定 的 安 
全 上 下 文 被 拒绝 访问 的 获准 指定 的 资源 ， 此 方法 将 抛 出 一 个 
SecurityException. 

void checkPrintJobAccess() 此 方法 将 抛 出 一 个 SecurityException 如 果 
调用 线程 不 允许 初始 化 打印 作业 请 求 。 

void checkPropertiesAccess() 此 方法 将 抛 出 一 个 SecurityException 如 
果 调 用 线程 不 允许 访问 或 修改 系统 属性 。 

void checkPropertyAccess(String key) 此 方法 将 抛 出 一 个 
SecurityException 如 果 调 用 线程 不 允许 与 指定 的 键 名 来 访问 系统 属性 。 
void checkRead(FileDescriptor fd) 此 方法 将 抛 出 一 个 SecurityException 
如 果 调 用 线程 不 允许 从 指定 的 文件 描述 符 读 取 。 


void checkRead(String file) 此 方法 将 抛 出 一 个 SecurityException 如 果 调 
用 线程 不 允许 读 字符 串 参 数 指定 的 文件 。 


NO 
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void checkRead(String file, Object context) 此 方法 将 抛 出 一 
24 SecurityException 如 果 指 定 的 安全 上 下 文 不 允许 读 取 字 符 串 参数 指定 的 


o 


void uoo target) 该 方法 确定 与 指定 的 权限 目标 
名 称 权 限 是 否 应 该 被 授予 或 拒绝 。 


void checkSetFactory() 此 方法 将 抛 出 一 个 SecurityException 如 果 调 用 
26 线程 不 允许 设置 由 ServerSocket 或 Socket， 或 使 用 URL 中 的 流 义 理 程序 
工厂 的 套 接 字 工 厂 。 


void checkSystemClipboardAccess() 此 方法 将 抛 出 一 


25 


a SecurityException 如 果 调 用 线程 不 允许 访问 系统 剪贴 板 。 

28 boolean checkTopLevelWindow(Object window) 如 果 调 用 线程 不 被 信 
任 ， 弹 出 的 窗口 参数 指出 的 顶层 窗口 ， 此 方法 返回 false。 

29 void checkWrite(FileDescriptor fd) 此 方法 将 抛 出 一 个 SecurityException 
如 果 调 用 线程 不 允许 宇 入 指定 的 文件 描述 符 。 

30 void checkWrite(String file) 此 方法 将 抛 出 一 个 SecurityException 如 果 调 
用 线程 不 允许 写字 符 串 参数 指定 的 文件 。 

31 protected Class[] getClassContext() 此 方法 返回 当前 执行 堆栈 类 的 数 
组 。 

32 Object getSecurityContext() 此 方法 创建 一 个 对 象 来 封装 当前 执行 环 
境 。 


33 ThreadGroup getThreadGroup() 此 方法 返回 线程 组 的 实例 在 这 个 被 调 
用 的 时 候 被 创建 的 新 线程 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.SecurityManager # - java.lang 1919 


java.lang.Short# - java.lang 


java.lang.Short 类 包 基 本 类 型 为 short 对 象 的 值 。 short 类 型 的 对 象 包含 一 个 字段 
的 类 型 为 short。 


JA —- 
3 FAR 
以 下 是 java.lang.Short 类 的 声明 : 


public final class Short 
extends Number 
implements Comparable<Short> 


S.N. Hie aX & 描述 

1 Short(short value) 此 构造 一 个 新 分 配 的 Short 对 象 ， 表 示 指 定 的 short 
值 。 

2 Short(String s) 此 构造 一 个 新 分 配 的 Short 对 象 ， 表 示 String 参 数 指定 
的 short 值 。 


x EN PE Aint pu t+ p HA TO 
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S.N. 方法 & 描述 

1 byte byteValue() 此 方法 返回 这 个 Short 为 一 个 字 节 的 值 。 

2 int compareTo(Short anotherShort) 此 方法 在 数字 上 比较 两 个 Short 对 

3 static Short decode(String nm) 这 种 方法 解码 字符 串 转 换 为 Short。 

4 double doubleValue() 此 方法 返回 这 个 Short 为 double 类 型 的 值 。 

5 boolean equals(Object obj) 此 方法 比较 此 对 象 与 指定 对 象 。 

6 float floatValue() 此 方法 返回 这 个 Short 为 浮 点 数 的 值 。 

7 int hashCode() 此 方法 返回 这 个 Short 的 哈 希 码 。 

8 int intValue() 此 方法 返回 这 个 Short 的 int 类 型 的 值 。 

9 long longValue() 此 方法 返回 这 个 Short 为 Jong 类 型 的 值 。 

10 static short parseShort(String s) 该 方法 将 字符 串 参 数 作为 符号 的 十 进 制 
short 类 型 。 

» static short parseShort(String s, int radix) 该 方法 将 字符 串 参 数 作 为 有 符 
号 short 并 以 第 二 个 参数 指定 为 基数 。 

12 static short reverseBytes(short i) 此 方法 返回 通过 反 转 指定 short 值 的 2 的 
补 码 表示 的 字 节 的 顺序 而 获得 的 值 。 

13 short shortValue() 此 方法 返回 这 个 Short 为 short 的 值 。 

14 String toString() 此 方法 返回 一 个 代表 该 Short 值 的 String 对 象 。 

15 static String toString(short s) 此 方法 返回 一 个 表示 指定 short 的 一 个 新 的 
String 对 象 。 

16 static Short valueOf(short s) 此 方法 返回 一 个 表示 指定 short 值 的 Short 实 
例 。 

17 static Short valueOf(String s) 此 方法 返回 一 个 表示 指定 short 值 的 Short 
实例 。 

18 static Short valueOf(String s, int radix) 此 方法 返回 保持 从 指定 的 String 
中 提取 的 值 时 ， 由 第 二 个 参数 给 出 的 基数 进行 分 析 short 的 对 象 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.StackTraceElement# - java.lang 


java.lang.StackTraceElement 类 元 素 代 表 一 个 堆栈 帧 。 除 了 一 个 在 堆栈 的 顶部 所 
有 的 栈 帧 代表 一 个 方法 调用 。 在 堆栈 顶部 的 帧 表示 在 将 其 生成 的 堆栈 跟踪 的 执行 
E 


JNO 


J^ —-L 
AX Fa HH 
以 下 是 java.lang.StackTraceElement 类 的 声明 : 


public final class StackTraceElement 
extends Object 
implements Serializable 


S.N. Mish & 描述 
StackTraceElement(String declaringClass, String methodName, 

1 String fileName, int lineNumber) ix 5% 6) & — T &zsTRXE 4461 AE 
栈 跟踪 元 素 。 
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S.N. 


方法 & 描述 


boolean equals(Object obj) 如 果 指 定 对 象 的 实例 与 该 另 一 个 
StackTraceElement 实 例 代 表 相 同 的 执行 点 ， 此 方法 返回 true。 


String getClassName() 此 方法 返回 一 个 包含 由 该 堆栈 跟踪 元 素 所 表示 的 
执行 点 类 的 完全 限定 名 。 


String getFileName() 此 方法 返回 一 个 包含 由 该 堆栈 跟踪 元 素 所 表示 的 
执行 点 的 源 文件 的 名 称 。 


int getLineNumber() 此 方法 返回 一 个 包含 由 该 堆栈 跟踪 元 素 所 表示 的 执 
行 点 源 行 的 行 号 。 


String getMethodName() 此 方法 返回 一 个 包含 由 该 堆栈 跟踪 元 素 所 表示 
的 执行 点 的 方法 的 名 称 。 


int hashCode() 此 方法 返回 该 堆栈 跟踪 元 素 的 哈 希 码 值 。 


boolean isNativeMethod() 如 果 包 含 由 该 堆栈 跟踪 元 素 所 表示 的 执行 点 
的 方法 是 一 个 本 地 方法 ， 此 方法 返回 true。 


String toString() 此 方法 返回 该 堆栈 跟踪 元 素 的 字符 串 表示 形式 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.StrictMath # - java.lang 


java.lang.StrictMath 类 包含 用 于 执行 基本 数字 运算 ， 如 指数 ， 对 数 ， 平 方 根 和 三 
f& Eq 2 9575 3, 


JA Œ 
AX Fa AR 
以 下 是 java.lang.StrictMath 类 的 声明 : 


public final class StrictMath 
extends Object 


字段 域 
以 下 是 java.lang.StrictMath 类 的 字段 : 
e static double E -- 这 是 double 值 比 任何 其 他 值 更 接近 于 e， 自 然 对 数 的 底数 。 


e static double PI -- 这 就 是 double 值 ， 该 值 是 比 任何 其 他 更 靠近 圆周 率 ， 圆 其 直 
径 的 圆周 的 比率 。 


类 方法 
S.N. 方法 & 描述 
1 static double abs(double a) 此 方法 返回 double 值 的 绝对 值 。 


2 static float abs(float a) 该 方法 返回 一 个 浮 点 数值 的 绝对 值 。 

3 static int abs(int a) 此 方法 返回 一 个 int 值 的 绝对 值 。 

4 static long abs(long al) 此 方法 返回 一 个 long 值 的 绝对 值 。 

static double acos(double a) 此 方法 返回 一 个 值 的 反 余 弦 ; 返 回 的 角度 范 


a 在 0.0 到 pi。 

6 static double asin(double a) 此 方法 返回 一 个 值 的 反正 弦 ; 返 回 的 角度 范 
为 -pi/2 到 pi/ 2。 

7 static double atan(double a) 此 方法 返回 一 个 值 的 反正 切 ;返回 的 角度 范 
为 -pi/ 2 到 pi/ 2。 

8 static double atan2(double y, double x) 此 方法 返回 从 直角 坐标 (x, y) 为 


极 坐 标 (r, theta) 的 转化 率 角 度 26。 
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19 


20 


21 


22 


23 
24 


29 


26 
27 
28 


29 


static double cbrt(double a) 此 方法 返回 double 值 的 立方 根 。 


static double ceil(double a) 此 方法 返回 最 小 的 (最 接近 负 无 穷 大 ) 
double 值 ， 该 值 大 于 或 等 于 参数 ， 并 等 于 某 个 整数 。 


static double copySign(double magnitude, double sign) 此 方法 返回 第 
一 个 浮 FF 点 参数 与 第 二 浮 点 参数 符号 。 


static float copySign(float magnitude, float sign) 此 方法 返回 第 一 
参数 与 第 二 浮 点 参数 符号 。 


static double cos(double a) 此 方法 返回 一 个 角 的 三 角 余 弦 值 。 
static double cosh(double x) 这 个 方法 返回 double 值 的 双 曲 余弦 值 。 
static double exp(double a) 此 方法 返回 欧 拉 数 e 为 底 的 双 精 度 值 的 篆 。 


static double expm1(double x) 这 个 方法 返回 e<sup style="margin: 
Opx; padding: Opx; font-size: 13px;">x</sup> -1. 


static double floor(double a) 此 方法 返回 最 大 的 (最 接近 正 无 穷 大 ) 
double 值 ， 该 值 小 于 或 等 于 参数 ， 并 等 于 某 个 整数 。 


static int getExponent(double d) 此 方法 返回 double 代 表 使 用 的 无 偏 指 


o 


static int getExponent(float f) 该 方法 返回 一 个 浮 点 数 的 表示 所 使 用 的 无 
偏 指 数 。 


static double hypot(double x, double y) 此 方法 返回 sqrt(x<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">2</sup> +y<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">2</sup>) 没有 中 间 
aX P8. 


static double IEEEremainder(double f1, double f2) 此 方法 返回 double 值 
的 自然 对 数 〈 以 e 为 底 ) 。 


static double log(double a) 此 方法 返回 double 值 的 自然 对 数 〈 以 e 为 
JEN 


static double log10(double a) 此 方法 返回 以 10 为 底 的 对 数 的 double 值 。 
static double log1p(double x) 此 方法 返回 参数 与 1 之 和 的 自然 对 数 。 


static double max(double a, double b) 此 方法 返回 两 个 double 值 的 最 大 
值 。 


static float max(float a, float b) 此 方法 返回 两 个 float 值 的 最 大 值 。 
static int max(int a, int b) 此 方法 返回 两 个 int 值 的 最 大 值 。 
static long max(long a, long b) 此 方法 返回 两 个 long 值 的 最 大 值 。 


static double min(double a, double b) 此 方法 返回 两 个 double 值 的 最 小 
值 。 


java.lang.StrictMath # - java.lang 1319 
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java.lang.StrictMath # - java.lang 1320 


static float min(float a, float b) 此 方法 返回 两 个 float 值 的 最 小 值 。 
static int min(int a, int b) 此 方法 返回 两 个 int 值 的 最 小 值 。 
static long min(long a, long b) 此 方法 返回 两 个 long 值 的 最 小 值 。 


static double nextAfter(double start, double direction) 此 方法 返回 相 邻 
的 第 二 个 参数 的 方向 的 第 一 个 参数 的 浮 点 数 。 


static float nextAfter(float start, double direction) 此 方法 返回 相 邻 第 一 
个 参数 的 第 二 个 参数 的 方向 上 的 浮 点 数 。 


static double nextUp(double d) 此 方法 返回 正 无 穷 大 的 方向 靠近 d 的 浮 点 
值 。 


static float nextUp(float f) 此 方法 返回 紫 邻 f 在 正 无 穷 大 的 方向 浮 点 


static double pow(double a, double b) 此 方法 返回 第 一 个 参数 提高 到 第 
—T 238873 [8 , 


static double random() 该 方法 返回 一 个 正 号 double 值 ， 大 于 或 等 于 0.0 
并 且 小 于 1.0。 


static double rint(double a) 此 方法 返回 最 接近 参数 的 double 值 ， 并 等 于 
基 个 整数 。 


static long round(double a) 此 方法 返回 最 接近 long 参 数 。 
static int round(float a) 此 方法 返回 最 接近 参数 的 整数 。 


static double scalb(double d, int scaleFactor) 此 方法 返回 d x 2<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">scaleFactor</sup> 
舍 和 好像 由 一 个 单一 的 执行 正确 舍 入 的 浮 点 乘法 的 double 值 集合 的 成 


i4 
Wo 


static float scalb(float f, int scaleFactor) 此 方法 返回 fx 2<sup 
style="margin: Opx; padding: Opx; font-size: 13px;">scaleFactor</sup> 


舍 入 好 像 由 一 个 单一 的 执行 正确 舍 入 的 浮 点 乘法 的 float 值 集合 的 成 员 。 


static double signum(double d) scaleFactor) 此 方法 返回 参数 的 符号 函 
数 ;如 果 该 参数 为 0 则 返回 9， 如 果 参 数 大 于 震 则 返回 1.0， 如 果 参 数 小 于 
需 则 返回 -1 0: 


static float signum(float f) 此 方法 返回 参数 的 符号 函数 ; 如 果 该 参数 为 0 
则 返回 9?， 如 果 参 数 大 于 需 则 返回 1.0f， 如 果 参 数 小 于 需 则 返回 -1.0f。 


static double sin(double a) 此 方法 返回 一 个 角度 的 正弦 值 。 

static double sinh(double x) 这 个 方法 返回 double 值 的 双 曲 正弦 值 。 
static double sqrt(double a) 这 个 方法 返回 dgouble 值 的 舍 人 正平 方 根 。 
static double tan(double a) 此 方法 返回 一 个 ang 三 角 正 切 值 

static double tanh(double x) 这 个 方法 返回 double 值 的 双 曲 正切 值 。 
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54 static double toDegrees(double angrad) 此 方法 转换 以 弧度 为 单位 ， 以 
度数 测量 的 近似 相等 的 角 的 角度 。 


static double toRadians(double angdeg) 此 方法 转换 为 度 ， 以 弧度 为 单 
位 的 近似 等 效 角 的 角度 。 


53 static double ulp(double d) 此 方法 返回 参数 的 ulp 的 大 小 。 
54 static float ulp(float f) 此 方法 返回 参数 的 ulp 的 大 小 。 


52 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.StrictMath # - java.lang 1321 


java.lang.String # - java.lang 


java.lang.String 类 代表 字符 串 。 在 Java 程 序 中 ， 如 “abc” 的 所 有 字符 串 常量 ， 实 现 
为 这 个 类 的 实例 。 字 符 串 是 常量 ， 它 们 的 值 被 创建 后 不 能 修改 。 


J^ —-L 
类 两 明 
以 下 是 java.lang.String 类 的 声明 : 


public final class String 
extends Object 
implements Serializable, Comparable<String>, CharSequence 


ri x 
字段 域 
以 下 是 为 java.lang.String 类 的 字段 : 


e static Comparator<String> CASE INSENSITIVE ORDER -- 这 是 一 个 由 
compareTolgnoreCase 比 较 器 的 顺序 字符 串 对 象 。 


类 构造 画 数 


S.N. HERZ & 描述 

1 String() 这 将 初始 化 一 个 新 创建 的 String 对 象 ， 它 表示 一 个 空 字 符 序 
列 。 

2 String(byte[] bytes) 这 通过 使 用 平台 的 默认 字符 集 指 定 的 字 节 数组 解 
码 构 造 一 个 新 的 String。 

3 String(byte[] bytes, Charset charset) 这 通过 使 用 指定 的 字符 集 解 码 
指定 的 字 节 数组 构造 一 个 新 的 String。 

4 String(byte[] bytes, int offset, int length) 这 通过 使 用 平台 的 默认 字符 
集 的 字 节 的 指定 子 数 组 解码 构造 一 个 新 的 String 

5 String(byte[] bytes, int offset, int length, Charset charset) 这 通过 使 
用 指定 的 字符 集 指 定 的 字 节 子 数组 解码 构造 一 个 新 的 String。 

6 String(byte[] bytes, int offset, int length, String charsetName) 这 通 
过 使 用 指定 的 字符 集 指定 的 字 节 子 数组 解码 构造 一 个 新 的 String。 

7 String(byte[] bytes, String charsetName) 这 通过 使 用 指定 的 字符 集 
解码 指定 的 字 节 数组 构造 一 个 新 的 String。 

8 String(char[] value) 这 种 分 配 一 个 新 的 String， 它 表示 当前 包含 在 字符 
数组 参数 的 字符 序列 。 

9 String(char[] value, int offset, int count) 此 方法 分 配 一 个 新 的 
String， 它 包含 字符 的 字符 数组 参数 的 子 数组 。 

10 String(int[] codePoints, int offset, int count) 此 方法 分 配 一 个 新 的 
String， 它 包含 字符 的 Unicode 代 码 点 数组 参数 的 子 数 组 。 
String(String original) 这 将 初始 化 一 个 新 创建 的 String 对 象 ， 它 代表 字 

11 符 作 为 参数 相同 的 序列 ; 换 名 话说 ， 新 创建 的 字符 串 是 该 参数 字符 串 的 一 
个 副本 。 

12 String(StringBuffer buffer) 此 分 配 一 个 包含 字符 当前 包含 在 字符 串 缓 
冲 区 参数 的 顺序 一 个 新 的 字符 串 。 

13 String(StringBuilder builder) 此 分 配 一 个 包含 字符 当前 包含 在 字符 串 
生成 器 参数 的 顺序 一 个 新 的 字符 串 。 

类 方法 

S.N. 方法 & 描述 

1 char charAt(int index) 此 方法 返回 指定 索引 处 的 char 值 。 

int codePointAt(int index) 此 方法 返回 指定 索引 你 的 字符 (Unicode 代 三 
点 ) 


o 


int codePointBefore(int index) 此 方法 在 指定 索引 之 前 返回 的 字符 
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(Unicode 代 码 点 )。 
int codePointCount(int beginIndex, int endIndex) 此 方法 在 该 字符 串 的 
指定 文本 范围 返回 Unicode 代 码 点 的 数 。 
5 int compareTo(String anotherString) 此 方法 按 字典 顺序 比较 两 个 字符 
6 int compareTolgnoreCase(String str) 此 方法 按 字典 顺序 比较 两 个 字符 


串 ， 不 区 分 大 小 写 的 差异 。 
7 String concat(String str) 此 方法 串 连 指定 字符 串 到 该 字符 串 的 结尾 。 
boolean contains(CharSequence s) 当 且 入 当 此 指定 序列 字符 串 包 含 


: char 值 此 方法 返回 true。 

9 boolean contentEquals(CharSequence cs) 此 方法 比较 该 字符 串 与 指定 
的 CharSequence。 

10 boolean contentEquals(StringBuffer sb) 此 方法 比较 该 字符 串 与 指定 的 
StringBuffer。 

» static String copyValueOf(char[] data) 此 方法 返回 一 个 表示 指定 的 数组 
字符 序列 的 字符 串 。 

42 static String copyValueOf(char[] data, int offset, int count) 此 方法 返回 
一 个 表示 指定 的 数组 中 的 字符 序列 的 字符 串 。 

13 boolean endsWith(String suffix) 此 方法 测试 此 字符 串 是 否 以 指定 的 后 级 
结束 。 

44 boolean equals(Object anObject) 此 方法 让 该 字符 串 与 指定 的 对 象 进行 
[age 

15 boolean equalslgnoreCase(String anotherString) 此 方法 让 这 个 字符 串 


与 另 一 个 字符 串 进 行 比较 ， 忽 略 大 小 写 的 考虑 。 


16 static String format(Locale |, String format, Object... args) 此 方法 返回 
使 用 指定 的 语言 环境 ， 格 式 字 符 串 和 参数 将 格式 化 字符 串 。 


static String format(String format, Object... args) 此 方法 返回 使 用 指定 


”格式 字符 串 和 参数 的 格式 化 字符 串 。 

18 byte[] getBytes() 此 方法 将 此 String 解 码 使 用 平台 的 默认 字符 集 的 字 节 序 
列 ， 并 将 结果 存储 到 一 个 新 的 字 节 数组 。 

19 byte[] getBytes(Charset charset) 此 方法 将 此 String 解 码 使 用 给 定 的 字符 
集 的 字 节 序列 ， 并 将 结果 存储 到 一 个 新 的 字 节 数组 。 

20 byte[] getBytes(String charsetName) 此 方法 将 此 String 解 码 使 用 的 字符 
集 命 名 为 字 节 序列 ， 并 将 结果 存储 到 一 个 新 的 字 节 数组 。 

21 void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) 此 方法 


从 此 字符 串 复 制 的 字符 到 目标 字符 数组 。 
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22 int hashCode() 此 方法 返回 该 字符 串 的 哈 希 码 。 


23 int indexOf(int ch) 此 方法 返回 该 字符 串 指定 字符 第 一 次 出 现 处 的 索引 。 
int indexOf(int ch, int fromIndex) 此 方法 返回 的 索引 此 字符 串 指 定 字 符 


24 第 一 次 出 现 处 ， 指 定 开始 搜索 的 索引 处 。 

25 int indexOf(String str) 此 方法 返回 该 字符 串 指定 的 子 串 中 第 一 次 出 现 处 
的 索引 。 

26 int indexOf(String str, int fromlndex) HLA 3&3 [B] M TS XE B] 98 8 | 4e 558 8| LEE 


字符 串 指定 的 子 字符 串 的 第 一 次 出 现 位 置 。 

27 String intern() 此 方法 返回 的 字符 串 对 象 的 规范 化 表示 。 

28 boolean isEmpty() 此 方法 返回 true， 当 且 仅 当 length() 为 0。 

int lastlIndexOf(int ch) 此 方法 返回 该 字符 串 指定 字符 最 后 一 次 出 现 处 的 


?9 RL. 

30 int lastIndexOf(int ch, int fromlndex) 此 方法 返回 的 索引 此 字符 串 指 定 字 
符 最 后 出 现 处 ， 向 后 搜索 从 指定 的 索引 你 。 

31 int lastIndexOf(String str) 此 方法 返回 该 字符 串 指 定 的 子 串 的 最 右边 出 现 
处 的 索引 。 

32 int lastIndexOf(String str, int fromIndex) 此 方法 返回 向 后 搜索 从 指定 的 


索引 位 置 ， 此 字符 串 指 定 的 子 字 符 串 的 最 后 出 现 处 的 索引 。 
33 int length() 这 个 方法 返回 这 个 字符 串 的 长 度 。 
boolean matches(String regex) 此 方法 确定 这 个 字符 串 是 否 匹 配给 定 正 


a 则 表达 式 。 

35 int offsetByCodePoints(int index, int codePointOffset) 此 方法 返回 这 个 
字符 串 ， 是 给 定 codePointOffset 码 点 偏 移 的 索引 。 

36 boolean regionMatches(boolean ignoreCase, int toffset, String other, 
int ooffset, int len) 此 方法 测试 如 果 两 个 字符 串 区 域 是 相等 忽略 大 小 写 。 

37 boolean regionMatches(int toffset, String other, int ooffset, int len) 此 方 
法 测试 如 果 两 个 字符 串 区 域 都 是 相等 。 

38 String replace(char oldChar char newChar) 此 方法 返回 通过 用 


newChar 更 换 所 有 oldChar 出 现在 此 字符 串 ， 产 生 一 个 新 的 字符 串 。 


String replace(CharSequence target, CharSequence replacement) 此 
39 方法 将 替换 该 字符 串 相 匹 配 的 文字 目标 序列 与 指定 的 文字 替换 序列 中 的 
每 个 子 字符 串 。 


String replaceAll(String regex, String replacement) 此 方法 将 替换 此 字 
符 串 匹配 ， 用 给 定 的 正则 表达 式 蔡 换 每 个 子 字符 串 。 


String replaceFirst(String regex, String replacement) 此 方法 将 替换 此 字 


40 


41 
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61 


String[] split(String regex) 这 种 分 割 方 法 根据 给 定 的 正则 表达 式 匹 配 这 


个 字符 串 。 


String[] split(String regex, int limit) 此 分 割 方法 根据 给 定 的 正则 表达 式 匹 
配 这 个 字符 串 。 


boolean startsWith(String prefix) 此 方法 测试 此 字符 串 是 否 在 开头 使 用 
指定 的 前 级 。 


boolean startsWith(String prefix, int toffset) 此 方法 测试 此 字符 串 开头 的 
指定 素 引 处 的 子 字符 串 ， 开 始 是 否 使 用 指定 的 前 级 。 


CharSequence subSequence(int beginIndex, int endIndex) 此 方法 返回 
一 个 新 的 字符 序列 ， 这 个 序列 的 子 序 列 。 


String substring(int beginIndex) 此 方法 返回 一 个 新 的 字符 串 ， 它 是 此 字 
符 串 的 一 个 子 字符 串 。 


String substring(int beginIndex, int endlndex) 此 方法 返回 一 个 新 的 字符 
串 ， 它 是 此 字符 串 的 一 个 子 字符 串 。 


char[] toCharArray() 此 方法 这 个 字符 串 到 一 个 新 的 字符 数组 转换 。 


String toLowerCase() 此 方法 将 所 有 在 此 字符 串 中 的 字符 使 用 默认 语言 
环境 的 规则 为 小 写 。 


String toLowerCase(Locale locale) 此 方法 将 所 有 在 此 字符 串 中 的 字 
符 ， 以 使 用 给 定 Locale 的 规则 的 小 写 形 式 。 


String toString() 此 方法 返回 的 字符 串 本 身 。 


String toUpperCase() 此 方法 使 用 默认 语言 环境 的 规则 将 这 个 字符 串 所 
有 的 字 转 为 大 写 。 


String toUpperCase(Locale locale) 此 方法 将 所 有 在 这 个 字符 串 的 字符 
使 用 给 定 的 语言 环境 的 规则 转换 为 大 写 。 


String trim() 此 方法 返回 字符 串 的 副本 ， 有 开头 和 结尾 的 空格 省 略 。 


static String valueOf(boolean b) 此 方法 返回 boolean 参 数 的 字符 串 表 示 
形式 。 


static String valueOf(char c) 此 方法 返回 char 参 数 的 字符 串 表 示 形 式 。 


static String valueOf(char[] data) 此 方法 返回 将 char 数 组 参数 的 字符 串 
表示 形式 。 

static String valueOf(char[] data, int offset, int count) 此 方法 返回 将 char 
数组 参数 的 特定 子 数 组 的 字符 串 表 示 形 式 。 


static String valueOf(double d) 此 方法 返回 dgouble 参 数 的 字符 串 表 示 形 


zo 


static String valueOf(float f) 此 方法 返回 float 参 数 的 字符 串 表 示 形 式 。 
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61 static String valueOf(float f) 此 方法 返回 float 参 数 的 字符 串 表 示 形 式 。 

62 static String valueOf(int i) 此 方法 返回 int 参 数 的 字符 串 表 示 形 式 。 

63 static String valueOf(long I) 此 方法 返回 long 参 数 的 字符 串 表 示 形 式 。 

64 static String valueOf(Object obj) 此 方法 返回 Object 参数 的 字符 串 表 示 形 


mos 
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java.lang.StringBuffer 类 是 字符 的 线程 安全 的 ， 可 变 序列 。 以 下 是 关于 
StringBuffer 的 要 点 : 

字符 串 缓冲 区 就 像 是 一 个 字符 串 ， 但 可 以 修改 。 


e 它 包含 某 些 特定 的 字符 序列 ， 但 该 序列 的 长 度 和 内 容 可 以 通过 某 些 方法 调用 来 
改变 。 


e 它们 是 安全 的 多 线程 应 用 。 
e 每 个 字符 串 有 缓冲 区 容量 。 


JA Œ 
3X Fa BH 
以 下 是 java.lang.StringBuffer 类 的 声明 : 


public final class StringBuffer 
extends Object 
implements Serializable, CharSequence 


SN. ISA & 描述 

StringBuffer() 此 构造 一 个 不 带 字符 和 16 个 字符 初始 容量 的 字符 串 缓 冲 
区 。 

2 StringBuffer(CharSequence seq) 该 构造 包含 指定 CharSequence 字 
符 串 缓冲 区 的 字符 相同 。 

3 StringBuffer(int capacity) 此 构造 一 个 不 带 字符 ， 指 定 初 始 容量 的 字符 
E IX, 

4 StringBuffer(String str) 此 构造 一 个 字符 串 缓 冲 区 初始 化 为 指定 字符 串 
的 内 容 。 


类 方法 


S.N. 方法 & 描述 
StringBuffer append(boolean b) 此 方法 追加 布尔 boolean 参数 到 序列 的 
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1 字符 串 表 示 形 式 


2 StringBuffer append(char c) 此 方法 追加 char 参 数 到 这 一 序列 的 字符 串 
表示 形式 。 

3 StringBuffer append(char[] str) 此 方法 追加 char 数 组 参数 到 这 一 序列 的 
字符 串 表 示 形 式 。 

4 StringBuffer append(char[] str, int offset, int len) 此 方法 追加 char 数 组 参 


数 来 到 此 序列 的 子 数 组 的 字符 串 表 示 形 式 。 


StringBuffer append(CharSequence s) 此 方法 追加 指定 的 
CharSequence 到 这 个 序列 。 


StringBuffer append(CharSequence s, int start, int end) 此 方法 追加 指 
定 的 CharSequence 到 这 个 序列 的 子 序列 。 


7 StringBuffer append(double d) 此 方法 追加 double 参 数 到 序列 的 字符 串 


表示 形式 。 

8 StringBuffer append(float f) 此 方法 追加 float 参 数 到 此 序列 的 字符 串 表示 
EN 

9 StringBuffer append(int i) 此 方法 追加 int 参 数 到 此 序列 的 字符 串 表示 形 
工 vo 

10 StringBuffer append(long Ing) 此 方法 的 附加 参数 long 到 这 个 序列 的 字符 
串 表 示 形 式 。 

1 StringBuffer append(Object obj) 此 方法 追加 对 象 参数 的 字符 串 表 示 形 
工 vo 

42 StringBuffer append(String str) 此 方法 将 指定 的 字符 串 追 加 到 此 字符 序 
列 。 

13 StringBuffer append(StringBuffer sb) 此 方法 将 指定 的 StringBuffer 追 加 
此 序列 。 

14 StringBuffer appendCodePoint(int codePoint) 此 方法 附加 参数 代码 点 到 


这 个 序列 的 字符 串 表示 形式 。 

15 int capacity() 此 方法 返回 当前 容量 。 

16 char charAt(int index) 此 方法 返回 此 序列 中 指定 索引 处 的 char 值 。 

17 l index) 此 方法 返回 指定 索引 处 的 字符 (Unicode 代 码 


18 int codePointBefore(int index) 此 方法 返回 指定 索引 之 前 的 字符 
(Unicode 代 码 点 ) 


int codePointCount(int beginIndex, int endIndex) 此 方法 在 这 个 序列 中 
的 指定 文本 范围 内 返回 Unicode 代 码 点 数 
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33 


34 


35 


36 


37 


38 


StringBuffer deleteCharAt(int index) 此 方法 删除 在 该 序列 指定 位 置 的 
char 


void ensureCapacity(int minimumCapacity) 此 方法 确保 了 容量 至 少 等 于 
指定 的 最 小 值 。 


void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) 此 方法 
从 这 个 序列 到 目标 字符 数组 dst 复 制 字 符 。 


int indexOf(String str) 此 方法 返回 该 字符 串 指 定 的 子 串 中 第 一 次 出 现 处 
的 索引 。 


int indexOf(String str, int ffomlndex) 此 方法 返回 的 索引 此 字符 串 指定 的 
子 字符 串 的 第 一 次 出 现 的 ， 从 指定 的 索引 你 。 


StringBuffer insert(int offset, boolean b) 这 种 方法 插入 boolean 交 量 进入 
这 个 序列 的 字符 串 表 示 形 式 。 


StringBuffer insert(int offset, char c) 此 方法 将 char 参 数 插入 到 这 个 序列 
的 字符 串 表 示 形 式 。 


StringBuffer insert(int offset, char[] str) 此 方法 将 char 数 组 参数 插入 到 这 
个 序列 的 字符 串 表示 形式 。 


StringBuffer insert(int index, char[] str, int offset, int len) 此 方法 插入 str 
数组 参数 此 序列 的 一 个 子 字符 串 表 示 形 式 。 


StringBuffer insert(int dstOffset, CharSequence s) 此 方法 插入 指定 的 
CharSequence 到 这 个 序列 。 


StringBuffer insert(int dstOffset, CharSequence s, int start, int end) 此 
方法 插入 指定 的 CharSequence 子 序列 到 此 序列 。 


StringBuffer insert(int offset, double d) 此 方法 插入 double 参 数 到 这 个 序 
列 的 字符 串 表示 形式 。 


StringBuffer insert(int offset, float f) 此 方法 插入 float 参 数 到 这 个 序列 的 
字符 串 表 示 形 式 。 


StringBuffer insert(int offset, int i) 此 方法 插入 第 二 个 int 参 数 到 这 个 序列 
的 字符 串 表 示 形 式 。 


StringBuffer insert(int offset, long I) 此 方法 插入 long 参 数 到 这 个 序列 的 
字符 串 表 示 形 式 。 


StringBuffer insert(int offset, Object obj) 此 方法 插入 对 象 参 数 到 这 个 字 
符 序列 的 字符 串 表 示 形 式 。 


StringBuffer insert(int offset, String str) 此 方法 插入 字符 串 到 这 个 字符 序 
列 。 


int lastlndexOf(String str) 此 方法 返回 该 字符 串 指 定 的 子 串 的 最 右边 出 现 
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38 处 的 索引 。 

int lastlndexOf(String str, int fromIndex) 此 方法 返回 该 字符 串 指 定 的 子 
字符 串 的 最 后 出 现 处 的 索引 。 

40 int length() 此 方法 返回 长 度 (字符 数 ) 。 

int offsetByCodePoints(int index, int codePointOffset) 此 方法 返回 该 序 


39 


i 列 是 从 给 定 的 索引 由 codePointOffset 代 码 点 偏 移 中 的 索引 。 
42 StringBuffer replace(int start, int end, String str) 此 方法 替换 这 个 序列 中 


的 特定 字符 串 的 子 字 符 串 。 

43 StringBuffer reverse() 此 方法 使 该 字符 序列 的 序列 反 向 替换 。 

44 void setCharAt(int index, char ch) 指定 索引 处 的 字符 设置 为 ch。 

45 void setLength(int newLength) 此 方法 将 字符 序列 设置 长 度 。 
CharSequence subSequence(int start, int end) 此 方法 返回 一 个 新 的 字 


46 — 符 序 列 ， 为 这 个 序列 的 子 序列 。 

47 String substring(int start) 此 方法 返回 一 个 新 的 String， 它 包含 的 字符 目 
前 包含 在 此 字符 序列 子 序 列 

48 String substring(int start, int end) 此 方法 返回 一 个 新 的 String， 它 包含 目 


前 包含 在 此 序列 的 子 序 列 的 字符 。 
49 String toString() 此 方法 返回 表示 此 序列 中 数据 的 字符 串 。 
50 void trimToSize() 此 方法 试图 减少 用 于 字符 序列 的 存储 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.StringBuilder 类 是 字符 的 可 变 序 列 。 这 提供 了 一 个 API 和 StringBuffer 兼 
容 ， 但 不 保证 同步 。 


= 
AX BH 
以 下 是 java.lang.StringBuilder 类 的 声明 : 


public final class StringBuilder 
extends Object 
implements Serializable, CharSequence 


A HS ERR 

S.N. MESZ & 描述 

1 StringBuilder() 此 构造 一 个 字符 串 生成 器 ， 在 没有 字符 和 16 个 字符 的 初 
始 容量 

2 StringBuilder(CharSequence seq) 此 构造 一 个 字符 串 生 成 器 包含 相同 


字符 作为 指定 的 CharSequence。 


3 StringBuilder(int capacity) 此 构造 一 个 字符 串 生 成 器 ， 在 没有 字符 ， 
由 容量 参数 指定 的 初始 容量 。 


4 StringBuilder(String str) 此 构造 一 个 字符 串 生 成 器 初始 化 为 指定 字符 
串 的 内 容 。 


类 方法 


S.N. 方法 & 描述 

1 StringBuilder append(boolean b) 此 方法 追加 布尔 参数 到 序列 的 字符 串 
表示 形式 。 

2 StringBuilder append(char c) 此 方法 追加 char 参 数 到 这 一 序列 的 字符 串 
表示 形式 。 

3 StringBuilder append(char[] str) This method appends the string 


representation of the char array argument to this sequence. 


4 StringBuilder append(char[] str, int offset, int len) 此 方法 追加 char 数 组 
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4 参数 到 此 序列 的 子 数 组 的 字符 串 表 示 形 式 。 


StringBuilder append(CharSequence s) 此 方法 将 指定 的 字符 附加 到 该 


” 序列 。 

6 StringBuilder append(CharSequence s, int start, int end) 此 方法 追加 指 
定 的 CharSequence 追 加 到 这 个 序列 的 子 序列 。 

7 StringBuilder append(double d) 此 方法 追加 double 参 数 到 序列 的 字符 串 
表示 形式 。 

8 StringBuilder append(float f) 此 方法 追加 float 参 数 到 序列 的 字符 串 表 示 
形式 。 

9 StringBuilder append(int i) 此 方法 追加 int 参 数 到 序列 的 字符 串 表 示 形 
式 。 

10 StringBuilder append(long Ing) 此 方法 追加 long 参 数 到 序列 的 字符 串 表 
示 形 式 。 

1 StringBuilder append(Object obj) 此 方法 追加 对 象 参数 到 序列 的 字符 串 
表示 形式 。 

42 StringBuilder append(String str) 此 方法 将 指定 的 字符 串 追 加 到 此 字符 序 
列 。 

13 StringBuilder append(StringBuffer sb) 此 方法 将 指定 的 StringBuffer 追 加 
到 此 序列 。 

14 StringBuilder appendCodePoint(int codePoint) 此 方法 附加 参数 


codePoint 到 这 个 序列 的 字符 串 表示 形式 。 
15 int capacity() 此 方法 返回 当前 容量 。 
16 char charAt(int index) 此 方法 返回 此 序列 中 指定 索引 处 的 char 值 。 


17 int codePointAt(int index) 此 方法 返回 指定 素 引 多 的 字符 (Unicodett 4 
点 o 

18 int codePointBefore(int index) 此 方法 在 指定 索引 之 前 返回 的 字符 

(Unicode 代 码 点 ) 。 

19 int codePointCount(int beginlndex, int endlndex) 此 方法 在 这 个 序列 中 
的 指定 文本 范围 内 返回 Unicode 代 码 点 的 数量 。 

20 StringBuilder delete(int start, int end) 此 方法 删除 这 个 序列 中 的 一 个 子 
串 的 字符 。 

21 StringBuilder deleteCharAt(int index) 此 方法 移 除 在 此 序列 中 的 指定 位 
置 的 字符 。 

22 void ensureCapacity(int minimumCapacity) 此 方法 确保 了 容量 至 少 等 于 
指定 的 最 小 值 。 
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33 
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41 


序列 到 目标 字符 数组 dst 复 制 的 字符 。 
int indexOf(String str) 此 方法 返回 该 字符 串 指定 的 子 字符 串 中 第 一 次 出 
现 处 的 索引 。 


int indexOf(String str, int fromIndex) 此 方法 返回 此 字符 串 指 定 的 子 字 符 
捉 的 第 一 次 出 现 的 索引 ， 从 指定 的 索引 处 。 


StringBuilder insert(int offset, boolean b) 这 种 方法 插入 boolean 变 量 到 
这 个 序列 的 字符 串 表 示 形 式 。 


StringBuilder insert(int offset, char c) 此 方法 将 char 参 数 插入 到 这 个 序列 
的 字符 串 表 示 形 式 。 


StringBuilder insert(int offset, char[] str) 此 方法 将 char 数 组 参数 插入 到 
这 个 序列 的 字符 串 表 示 形 式 。 


StringBuilder insert(int index, char[] str, int offset, int len) 此 方法 插入 str 
数组 参数 到 此 序列 的 一 个 子 字符 串 表 示 形 式 。 


StringBuilder insert(int dstOffset, CharSequence s) 此 方法 插入 指定 的 
CharSequence 到 这 个 序列 。 


StringBuilder insert(int dstOffset, CharSequence s, int start, int end) 此 
方法 插入 指定 CharSequence 的 子 序列 到 此 序列 。 


StringBuilder insert(int offset, double d) 此 方法 插入 double 参 数 到 这 个 
序列 的 字符 串 表 示 形 式 。 


StringBuilder insert(int offset, float f) This method inserts the string 
representation of the float argument into this sequence. 


StringBuilder insert(int offset, int i) 此 方法 插入 第 二 个 int 参 数 到 这 个 序列 
的 字符 串 表示 形式 。 


StringBuilder insert(int offset, long I) 此 方法 插入 long 参 数 到 这 个 序列 的 
字符 串 表示 形式 。 


StringBuilder insert(int offset, Object obj) 此 方法 插入 的 对 象 参 数 到 这 个 
字符 序列 的 字符 串 表示 形式 。 


StringBuilder insert(int offset, String str) 此 方法 插入 字符 串 到 这 个 字符 
序列 。 


int lastlndexOf(String str) 此 方法 返回 该 字符 串 指 定 的 子 串 的 最 右边 出 现 
处 的 索引 。 


int lastIndexOf(String str, int fromIndex) 此 方法 返回 该 字符 串 指 定 的 子 
字符 串 的 最 后 出 现 处 的 索引 。 


int length() 此 方法 返回 长 度 〈 字 符 数 ) 。 


int offsetByCodePoints(int index, int codePointOffset) 此 方法 返回 该 序 
列 是 从 给 定 的 索引 由 codePointOffset 代 码 点 偏 移 中 的 索引 。 
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StringBuilder replace(int start, int end, String str) 此 方法 在 这 个 序列 中 


““ 的 特定 字符 串 中 的 字符 的 子 字 符 串 蔡 换 字符 。 

43 StringBuilder reverse() 此 方法 使 该 字符 序列 的 序列 的 反 向 替换 。 

44 void setCharAt(int index, char ch) 指定 索引 处 设置 为 字符 ch。 

45 void setLength(int newLength) 此 方法 将 字符 序列 的 长 度 。 

AG CharSequence subSequence(int start, int end) 此 方法 返回 一 个 新 的 字 
符 序列 ， 这 个 序列 的 子 序列 。 

47 String substring(int start) 此 方法 返回 一 个 新 的 String， 它 包含 的 字符 目 
前 包含 在 此 字符 序列 子 序列 。 

48 String substring(int start, int end) 此 方法 返回 一 个 新 的 String， 它 包含 的 
字符 目前 包含 在 此 序列 的 子 序 列 。 

49 String toString() 此 方法 返回 表示 此 序列 中 数据 的 字符 串 。 

50 void trimToSize() 此 方法 试图 减少 字符 序列 的 存储 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


e java.lang.CharSequence 
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java.lang.System # - java.lang 
java.lang.System 类 包含 一 些 有 用 的 类 字段 和 方法 。 它 不 能 被 实例 化 。 通 过 系统 提 
供 的 工具 : 

e 标准 输出 

e 错误 输出 流 

e. 标准 输入 和 访问 外 部 定义 的 属性 和 环境 变量 。 

e 一 种 实用 程序 方法 ， 用 于 快速 复制 数组 的 一 部 分 。 


。 加 载 文件 和 库 文件 的 方法 
类 声明 


以 下 是 java.lang.System 类 的 声明 : 


public final class System 
extends Object 


mo F 几 二 
字段 域 
以 下 是 java.lang.System 类 的 字段 : 
e static PrintStream err -- 这 是 “标准 "错误 输出 流 。 
e static InputStream in -- 这 是 在 “标准 "的 输入 流 。 


e static PrintStream out -- 这 是 在 “标准 ”的 输出 流 。 


类 方法 


S.N. 方法 & 描述 
static void arraycopy(Object src, int srcPos, Object dest, int destPos, 
1 int length) 此 方法 会 复制 从 指定 源 数 组 的 数组 ， 开 始 在 指定 的 位 置 ， 到 


目标 数组 的 指定 位 置 。 


static String clearProperty(String key) 此 方法 可 删除 指定 键 指示 的 系统 
属性 。 


static Console console() 此 方法 返回 与 当前 Java 虚 拟 机 关联 的 唯一 
Console 对 象 (HORA) 。 
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4 static long currentTimeMillis() 此 方法 返回 当前 时 间 ， 单 位 为 毫秒 。 

5 static void exit(int status) 此 方法 终止 当前 正在 运行 的 Java 虚 拟 机 。 

6 static void gc() 此 方法 运行 垃圾 回收 器 。 

static Map<String,String> getenv() 此 方法 返回 当前 系统 环境 的 不 可 改 


变 的 字符 串 映 射 视图 。 

8 static String getenv(String name) 此 方法 获取 指定 的 环境 变量 的 值 。 

9 static Properties getProperties() 此 方法 确定 当前 系统 性 能 。 

10 String getProperty(String key) 此 方法 获取 指定 键 指示 的 系统 属 

1 static String getProperty(String key, String def) 此 方法 获取 指定 键 指定 
的 系统 属性 。 

42 E SecurityManager getSecurityManager() 此 方法 得 到 了 系统 的 安全 


static int identityHashCode(Object x) 此 方法 返回 相同 的 哈 希 代码 为 给 
13 定 的 对 象 会 由 默认 hashCode 方 法 ORE) ， 给 定 对 象 的 类 是 否 重 写 


hashCode(). 

14 static Channel inheritedChannel() 此 方法 返回 从 创建 此 Java 虚 拟 机 的 实 
体 中 继承 的 通道 。 

15 static void load(String filename) 此 方法 加 载 使 用 从 本 地 文件 系统 中 的 指 
定 文件 名 作为 一 个 动态 库 中 的 代码 文件 。 

16 static void loadLibrary(String libname) 此 方法 加 载 libname 指 示 参 数 指 
定 的 系统 库 。 

17 static String mapLibraryName(String libname) 此 方法 映射 库 名 称 为 表 


示 本 机 库 的 平台 特定 的 字符 串 。 
18 static long nanoTime() 此 方法 返回 最 精确 的 可 用 系统 计时 器 的 当前 值 ， 


以 毫 微 秒 。 
19 static void runFinalization() 此 方法 运行 最 后 审定 的 任何 对 象 最 后 确定 方 
法 。 


20 static void setErr(PrintStream err) 此 方法 重新 分 配 “ 标 准 " 错 误 输 出 流 。 
21 static void setin(InputStream in) 此 方法 重新 分 配 “ 标 准 " 输 入 流 。 
22 static void setOut(PrintStream out) 此 方法 重新 分 配 “ 标 准 ” 输 出 流 。 


static void setProperties(Properties props) 此 方法 设置 系统 属性 的 属性 
参数 。 


static String setProperty(String key, String value) 此 方法 设置 指定 键 指 
示 的 系统 属性 。 


23 


24 
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static void setSecurityManager(SecurityManager s) 此 方法 设置 系统 的 


25 安全 性 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang.Thread # - java.lang 
java.lang.Thread 类 是 执行 程序 中 的 线程 。Java 虚 拟 机 人 允许 应 用 程序 具有 执行 同时 
运行 多 个 线程 。 以 下 是 关于 主题 的 要 点 : 
e 每 个 线程 都 有 一 个 优先 级 。 线 程 具有 更 高 的 优先 级 优先 执行 线程 优先 级 较 低 
e 每 个 线程 都 可 以 或 不 可 以 也 被 标记 为 一 个 守护 程序 。 
e 有 两 种 方法 来 创建 新 的 执行 线程 。 一 种 声明 一 个 类 Thread 的 子 类 
e 另 一 种 方式 来 创建 一 个 线程 是 声明 实现 Runnable 接 口 的 类 


xy -—- 
类 两 明 
以 下 是 java.lang.Thread 类 的 声明 : 


public class Thread 
extends Object 
implements Runnable 


ri * 

字段 域 

以 下 是 java.lang.Thread 类 的 字段 : 
e static int MAX_PRIORITY -- 这 是 一 个 线程 可 以 有 最 低 的 优先 级 。 
e static int NORM PRIORITY -- 这 是 分 配给 一 个 线程 的 缺 省 优先 级 。 


类 构造 画 数 


构造 函数 & 描述 
Thread() 这 种 分 配 新 的 Thread 对 象 。 
Thread(Runnable target) 这 种 分 配 新 的 Thread 对 象 。 
Thread(Runnable target, String name) 这 种 分 配 新 的 Thread 对 象 。 
Thread(String name) 这 个 构造 分 配 新 的 Thread 对 象 。 


Thread(ThreadGroup group, Runnable target) 这 种 分 配 新 的 Thread 
Xt Ro 


Thread(ThreadGroup group, Runnable target, String name) 这 种 分 
配 新 的 Thread 对 象 ， 以 便 将 target 作 为 其 运行 对 象 ， 将 指定 的 name 作 为 
其 名 称 ， 而 属于 由 组 所 指 的 线程 组 。 


Thread(ThreadGroup group, Runnable target, String name, long 
stackSize) 这 种 分 配 新 的 Thread 对 象 ， 以 便 将 target 作 为 其 运行 对 象 ， 
将 指定 的 name 作 为 其 名 称 ， 所 属 组 所 提 到 的 线程 组 ， 并 具有 指定 的 堆 
栈 大 小 。 


Thread(ThreadGroup group, String name) 这 种 分 配 新 的 Thread 对 
象 。 


类 方法 


S.N. 


方法 & 描述 
static int activeCount() 此 方法 返回 活动 线程 的 当前 线程 的 线程 组 中 的 数 
量 。 
void checkAccess() 此 方法 确定 当前 运行 的 线程 是 否 有 权 修 改 该 线程 。 
protected Object clone() 此 方法 返回 一 个 克隆 ， 如 果 此 对 象 的 类 是 可 复制 


o 


static Thread currentThread() 此 方法 返回 一 个 引用 到 当前 正在 执行 的 线程 
对 象 。 


static void dumpStack() 此 方法 打印 当前 线程 的 堆栈 跟踪 到 标准 错误 流 。 


static int enumerate(Thread[] tarray) 此 方法 会 复制 到 指定 的 数组 当前 线程 
的 线程 组 及 其 子 组 中 的 每 一 个 活动 线程 。 


static Map<Thread,StackTraceElement[]> getAllStackTraces() 此 方法 返 
回 的 堆栈 跟踪 的 所 有 活动 线程 的 映射 。 


ClassLoader getContextClassLoader() 此 方法 返回 该 线程 的 上 下 文 类 加 载 
器 。 


static Thread.UncaughtExceptionHandler 


TutorialsPoint Java 技术 教程 


28 


29 


30 


31 


getDefaultUncaughtExceptionHandler() 此 方法 返回 调用 默认 的 义理 程 
序 ， 当 一 个 线程 突然 终止 由 于 未 捕获 到 异常 。 


long getld() 此 方法 返回 该 线程 的 标识 符 。 
String getName() 此 方法 返回 该 线程 的 名 称 。 
int getPriority() 此 方法 返回 该 线程 的 优先 级 。 


StackTraceElement[] getStackTrace() 此 方法 返回 一 个 表示 该 线程 的 堆栈 
转 储 堆栈 跟踪 元 素 的 数组 。 


Thread.State getState() 此 方法 返回 该 线程 的 状态 
ThreadGroup getThreadGroup() 此 方法 返回 此 线程 所 属 的 线程 组 。 


Thread. UncaughtExceptionHandler getUncaughtExceptionHandler() 此 方 
法 返回 调用 的 义理 时 该 线程 突然 终止 ， 由 于 未 捕获 到 异常 。 


static boolean holdsLock(Object obj) 当 且 仅 当当 前 线程 在 指定 的 对 象 上 保 
持 监视 器 锁 此 方法 返回 true。 


void interrupt() 此 方法 会 中 断 该 线程 。 

static boolean interrupted() 此 方法 测试 是 否 当前 线程 已 被 中 断 。 
boolean isAlive() 此 方法 测试 该 线程 是 否 活着 。 

boolean isDaemon() 此 方法 测试 该 线程 是 否 为 守护 线程 。 
boolean isInterrupted() 此 方法 测试 是 否 该 线程 已 被 中 断 。 

void join() 等 待 该 线程 终止 。 

void join(long millis) 等 待 在 最 长 为 millis 室 秒 终 止 这 个 线程 。 


void join(long millis, int nanos) FFER X X millis&& f? *nonos3& ^ ;; x FE 
SEL. 


void run() 如 果 该 线程 是 使 用 独立 的 Runnable 运 行 对 象 构 造 的 ， 则 该 
Runnable 对 象 的 run 方 法 被 调用 ;否则 ， 此 方法 不 执行 任何 操作 并 返回 
void setContextClassLoader(ClassLoader cl) 此 方法 设置 该 线程 的 上 下 文 
类 加 载 器 。 


void setDaemon(boolean on) 此 方法 将 该 线程 标记 为 守护 线程 或 用 户 线 
程 。 


Static void 
setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandle 
eh) 此 方法 设 入 置 的 默认 处 理 程序 时 调用 线程 突然 终止 ， 由 于 未 捕获 到 异 
常 ， 并 没有 其 他 的 处 理 程 序 被 定义 为 该 线程 。 


void setName(String name) 此 方法 更 改 为 等 于 参数 名 该 线程 的 名 称 。 


void setPriority(int newPriority) This method changes the priority of this 
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31 thread. 


32 void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler 
eh) 此 方法 设置 时 调用 的 义理 这 个 线程 突然 终止 由 于 未 捕获 到 异常 。 

33 static void sleep(long millis) 此 方法 使 当前 执行 线程 休眠 (暂停 执行 ) 指定 
的 毫秒 数 ， 受 制 于 精度 和 系统 计时 器 和 调度 程序 精度 。 
static void sleep(long millis, int nanos) 此 方法 使 当前 执行 的 线程 休眠 (47 

34 停 执行 ) 为 指定 的 之 秒 数 加 纳 秒 指定 数量 ， 受 制 于 精度 和 系统 计时 器 和 调 


35 void start() 此 方法 使 该 线程 开始 执行 ; Java 虚 拟 机 调用 该 线程 的 run 方 法 。 


36 String toString() 此 方法 返回 该 线程 的 字符 串 表 示 形 式 ， 包 括 线程 名 称 ， 优 


先 级 和 线程 组 。 
37 static void yield() 此 方法 使 当前 执行 的 线程 对 象 来 暂停 并 人 允许 其 他 线程 执 
Te 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.ThreadLocal X: - java.lang 
java.lang. ThreadLocal 类 提供 线程 局 部 变量 。 

类 声明 

以 下 是 java.lang.ThreadLocal 类 的 声明 : 


public class ThreadLocal<T> 
extends Object 


3 Apis ER 
S.N. 构造 函数 & 描述 
1 ThreadLocal() 创建 一 个 线程 局 部 变量 。 


类 方法 


S.N. 方法 & 描述 
1 Tget() 此 方法 返回 此 线程 局 部 变量 的 当前 线程 副本 中 的 值 。 
2 protected T initialValue() 此 方法 返回 当前 线程 的 “初始 值 "此 线程 局 部 变 


量 。 
3 void remove() 此 方法 删除 该 线程 局 部 变量 的 当前 线程 的 值 。 


4 void set(T value) 此 方法 设置 此 线程 局 部 变量 的 当前 线程 副本 中 指定 的 
值 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 


java.lang. Throwable X: - java.lang 


java.lang. Throwable 类 是 在 Java 语 言 中 所 有 错误 和 异常 的 超 类 。 只 有 在 这 个 类 (或 
它 的 一 个 子 类 ) 的 实例 对 象 由 Java 虚 拟 机 抛 出 ， i osos throw 语 句 抛 出。 


J^ Œ 
类 两 明 
以 下 是 java.lang.Throwable 类 的 声明 : 


public class Throwable 
extends Object 
implements Serializable 


S.N. TG ES & 描述 

1 Throwable() 这 种 构造 一 个 新 的 Throwable null 作 为 其 详细 消息 。 

2 Throwable(String message) 构造 一 个 新 的 Throwable 指 定 详 细 消 息 。 
3 Throwable(String message, Throwable cause) 构造 一 个 新 的 


Throwable 指 定 详 细 消 息 和 原因 。 


Throwable(Throwable cause) 定 的 原因 和 
4 详细 消息 (cause==null ? null : cause.toString())( 它 通常 包含 cause 的 类 


和 详细 消息 )。 
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方法 & 描述 
Throwable filllnStackTrace() 该 方法 弥补 了 执行 堆栈 跟踪 。 


Throwable getCause() 此 方法 返回 此 的 throwable 或 空 的 原因 ， 如 果 原 
因 不 存在 或 未 知 。 


String getLocalizedMessage() 此 方法 创建 这 个 Throwable 的 本 地 化 描 


String getMessage() 此 方法 返回 这 个 的 throwable 的 详细 消息 字符 串 。 


StackTraceElement[] getStackTrace() 此 方法 提供 编程 访问 由 
printStackTrace() 打 印 堆栈 跟踪 信息 。 


Throwable initCause(Throwable cause) 这 个 方法 初始 化 此 抛 出 为 指定 
值 的 原因 。 


void printStackTrace() 此 方法 打印 此 抛 出 其 回溯 到 标准 错误 流 。 


void printStackTrace(PrintStream s) 此 方法 打印 此 抛 出 其 回溯 到 指定 的 
打印 流 。 


void printStackTrace(PrintWriter s) 此 方法 打印 此 抛 出 其 回溯 到 指定 的 
打印 writer。 


void setStackTrace(StackTraceElement[] stackTrace) 此 方法 设置 将 返 
回 getStackTrace() 由 printStackTrace() 相 关 方 法 打印 堆栈 跟踪 元 素 。 


String toString() 此 方法 返回 这 个 的 throwable 的 简单 描述 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.lang.Object 
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java.lang.Void 类 是 一 个 不 可 实例 化 的 占 位 符 类 来 保存 一 个 引用 代表 了 Java 关 键 字 
void 的 Class 对 象 。 


44 ob 
A FAR 
以 下 是 java.lang.Void 类 的 声明 : 


public final class Void 
extends Object 


ri ` 
字段 域 
以 下 是 java.lang.Void 类 的 字段 : 


e static Class<Void> TYPE -- 此 类 对 象 代 表 伪 类 型 对 应 于 所 述 关 键 字 void。 


Class Methods 


This class inherits methods from the following class: 


e java.lang.Object 


java.lang.Errors - java.lang 


java.lang.Errors 提供 了 在 Java lang 包 抛 出 不 同 的 错误 。 


Error 总 结 


S.N. 


1 
2 


Error & 描述 
AbstractMethodError 当 应 用 程序 试图 调用 一 个 抽象 方法 此 异常 引发 。 
AssertionError 这 被 抛 出 的 异常 表明 断言 失败 。 


ClassCircularityError 当 一 个 圆 度 被 检测 到 ， 初 始 化 一 个 类 此 异常 引 
发 。 


ClassFormatError 当 Java 虚 拟 机 试图 读 取 类 文件 并 确定 该 文件 存在 格 
式 错 误 或 无 法 解释 为 类 文件 时 ， 此 异常 引发 。 

Error 这 是 一 个 错误 是 Throwable 的 子 类 ， 表 示 严 重 的 问题 ， 合 理 的 应 用 
程序 不 应 该 试图 捕获 。 

ExceptionInInitializerError 这 是 一 个 意外 的 异常 发 生 在 一 个 静态 初始 
化 的 信号 。 

lllegalAccessError 此 被 抛 出 ， 如 果 一 个 点 用 程序 试图 访问 或 修改 字 
段 ， 或 调用 它 不 能 访问 的 方法 

IncompatibleClassChangeError 这 被 抛 出 时 ， 不 兼容 的 类 变化 已 经 发 
生 了 一 些 类 定义 。 

InstantiationError 当 应 用 程序 试图 使 用 Java 的 new 结 构 来 实例 化 一 个 
抽象 类 或 接口 此 异常 引发 。 

InternalError 这 是 异常 指示 发 生 在 Java 虚 拟 机 的 一 些 意外 的 内 部 错 

IRo 

LinkageError LinkageError 类 的 子 类 指示 一 个 类 对 另 一 个 类 的 一 些 依 
Fio 

NoClassDefFoundError 如 果 Java 虚 拟 机 或 ClassLoader 实 例 试 图 在 类 
的 定义 和 类 没有 定义 负载 可 以 发 现 此 异常 引发 。 

NoSuchFieldError 如 果 一 个 应 用 程序 试图 访问 一 个 对 象 或 修改 指定 字 
段 此 异常 引发 ， 并 且 该 对 象 不 再 包含 该 字段 。 


NoSuchMethodError 如 果 一 个 应 用 程序 试图 调用 指定 一 个 类 (静态 或 实 
例 ) 的 方法 ， 此 异常 被 抛 出 ， 而 该 类 已 不 再 具有 该 方法 的 定义 。 


OutOfMemoryError 这 被 抛 出 时 ，Java 虚 拟 机 无 法 分 配 一 个 对 象 ， 


StackOverflowError 4X EHER AH, AAD FH FR 36 Ja AN RD UG 
E 


ThreadDeath 这 是 ThreadDeath 的 一 个 实例 被 扔 在 事主 线程 时 停止 方 
法 ，Thread 类 的 雳 参数 被 调用 。 


UnknownError 这 时 候 抛 出 一 个 未 知 但 严重 的 异常 发 生 在 Java 虚 拟 机 。 


UnsatisfiedLinkError 这 被 抛 出 ， 如 果 Java 虚 拟 机 无 法 找到 一 个 方法 的 
适当 本 地 语言 定义 时 声明 为 native。 

UnsupportedClassVersionError 当 Java 虚 拟 机 试图 读 取 一 个 类 文件 ， 
并 确定 不 支持 文件 中 的 主要 和 次 要 版 本 号 此 异常 引发 。 

VerifyError “4°36 23" oe. 文件 ， 但 良好 的 ， 包 含 着 一 些 内 部 
不 一 致 性 或 安全 性 问题 ， 异常 被 抛 出 


VirtualMachineError 这 被 抛 出 ， RESCUE IM 
需要 它 继续 工作 。 


java.lang.Interfaces - java.lang 


java.lang.Interfaces 提供 了 在 Java lang 包 使 用 不 同 的 接口 。 


Interface Summary 


S.N. 


1 
2 


Interface & 描述 
Appendable 此 是 一 个 对 象 ， 其 中 char 序 列 和 值 可 以 附加 
CharSequence 这 是 一 个 CharSequence 为 char 值 的 读 取 顺序 。 


Cloneable 这 是 一 个 类 实现 了 Cloneable 接 口 ， 以 指示 Object.clone() 方 
法 ， 它 是 合法 的 ， 该 方法 使 这 个 类 的 实例 的 字段 换取 字段 副本 。 


Comparable<T> 这 就 对 实现 它 的 每 个 类 的 对 象 进行 整体 排序 。 
Iterable«T» 实现 此 接口 允许 一 个 对 象 是 “foreach” 语 句 的 目标 。 
Readable 这 是 一 个 可 读 的 字符 的 来 源 。 


Runnable 这 是 Runnable 接 口 应 该 由 任何 类 的 实例 ， 旨 在 通过 一 个 线程 
执行 来 实现 。 


Thread.UncaughtExceptionHandler 这 是 调用 义理 程序 的 接口 ， 当 一 
个 线程 突然 终止 由 于 未 捕获 到 异常 。 


Java.math 包 教 程 


java.math 中 包 提 供用 于 执行 任意 精度 整数 算法 〈Biglnteger) 和 任意 精度 小 数 算法 
(BigDecimal) 。 


本 参考 教程 将 通过 java.math 中 封装 简单 实用 的 方法 实例 演示 使 用 。 


读者 


参考 是 为 初学 者 而 准备 的 ， 帮 助 他 们 了 解 相 关 的 java.math 中 封装 的 所 有 方法 的 基本 
功能 。 


必 备 条 件 


在 开始 做 练习 与 使 用 在 此 引用 给 定 的 各 类 例子 ， 需 要 了 解 基本 的 Java 编 程 。 


Java.math.BigDecimal X - Java.math 包 
java.math.BigDecimal 类 提供 用 于 算术 ， 刻 度 操 作 ， 舍 入 ， 上 比较 ， 哈 希 算 法 和 格 
式 转 换 操 作 。 

toString() 方 法 提供 BigDecimal 的 规范 表示 。 它 使 用 户 可 以 完全 控制 舍 人 行为 。 
提供 用 于 操作 BigDecimal 规 模 两 种 类 型 的 操作 : 


e 缩放 / 舍 人 操作 
e 小 数 点 移动 操作 。 


此 类 及 其 迭代 器 实现 Comparable 接 口 的 所 有 可 选 方法 。 


J^ = 
类 两 明 
以 下 是 声明 java.math.BigDecimal 类 : 


public class BigDecimal 
extends Number 
implements Comparable<BigDecimal> 


字段 域 
以 下 是 java.math.BigDecimal 类 中 的 字段 : 
e static BigDecimal ONE -- 值 为 1， 使 用 刻度 为 0。 
e static int ROUND CEILING -- 舍 入 模式 舍 向 正 无 穷 。 
e static int ROUND DOWN -- 舍 入 模式 为 向 需 舍 入 。 
e static int ROUND FLOOR -- 舍 入 模式 接近 负 无 穷 大 。 


static int ROUND HALF DOWN -- 伟人 模式 伟人 到 "最 近 相 邻 ?如 果 与 两 个 相 邻 
数字 的 距离 相等 ， 在 这 种 情况 下 ， 向 下 取 整 。 


static int ROUND HALF. EVEN -- 舍 入 模式 舍 对 “近邻 ”如果 和 与 两 个 相 令 数字 的 
距离 相等 ， 在 这 种 情况 下 ， 舍 入 向 着 更 加 相 邻 。 


static int ROUND HALF UP -- 伟人 模式 舍 人 到 “最 近 相 邻 ? 如 果 与 两 个 相 邻 数 
字 的 距离 相等 ， 在 这 种 情况 下 范围 。 


static int ROUND UNNECESSARY -- 舍 和 人 模式 断言 请 求 的 操作 具有 精确 的 结 
果 ， 因 此 不 需要 舍 入 。 


e static int ROUND UP -- S AJSSXS A X, 
e static BigDecimal TEN -- 值 为 0， 使 用 刻度 为 0。 
e static BigDecimal ZERO -- 值 为 0， 使 用 刻度 为 0。 


x M35 ERR 


S.N. 


1 


BigDecimal(BigInteger val) 3x ic WA FH k REBigInteger£z ik 77 
BigDecimal. 


BigDecimal(BigInteger unscaledVal, int scale) ix Sia WAAFH 
换 为 Biglnteger 非 标 度 值 和 一 个 int 尺 度 成 一 个 BigDecimal。 


BigDecimal(Biglnteger unscaledVal, int scale, MathContext mc) 这 
个 构造 函数 用 于 转换 为 Biglnteger 非 标 度 值 和 一 个 int 尺 度 转换 为 
BigDecimal， 有 根据 上 下 文 设置 进行 舍 入 。 


BigDecimal(BigInteger val, MathContext mc) 此 构造 函数 用 于 根据 上 
下 文 设置 将 Biglnteger 转 换 为 BigDecimal 舍 入 。 


BigDecimal(char[ ] in) 此 构造 画 数 用 于 将 BigDecimal 字 符 数组 表示 转 
化 为 BigDecimal， 接 受 相同 的 字符 序列 与 BigDecimal (String) 43788 
数 。 


BigDecimal(char[ ] in, int offset, int len) 此 构造 函数 用 于 将 
BigDecimal 的 字符 数组 表示 转化 为 BigDecimal， 接受 字符 与 
BigDecimal (String) 构造 方法 相同 的 字符 序列 ， 同 时 允许 指定 子 数 
组 。 


BigDecimal(char[ ] in, int offset, int len, MathContext mc) 此 构造 函 
数 用 于 将 BigDecimal 的 字符 数组 表示 转化 为 BigDecimal， 接 受 字符 与 
BigDecimal (String) 构造 方法 相同 的 字符 序列 ， 同 时 允许 指定 子 数 
组 ， 并 与 根据 上 下 文 设置 进行 舍 入 。 


BigDecimal(char[ ] in, MathContext mc) 此 构造 画 数 用 于 将 
BigDecimal 的 字符 数组 表示 转化 为 BigDecimal， 接受 相同 的 字符 序列 与 
BigDecimal (String) 构造 和 根据 上 下 文 设置 进行 伟人。 


BigDecimal(double val) 这 个 构造 画 数 是 用 来 转换 double 为 一 个 
BigDecimal， 它 是 双 的 二 进 制 浮 点 值 的 精确 十 进 制 表 示 。 


BigDecimal(double val, MathContext mc) 这 个 构造 画 数 是 用 来 转换 
double 为 一 个 BigDecimal， 有 根据 上 下 文 设置 进行 舍 入 。 


BigDecimal(int val) 这 个 构造 本 数 是 用 来 转换 一 个 int 转 换 为 
BigDecimal。 


BigDecimal(int val, MathContext mc) ix N ENA EA 3E 4: 4 — 
int 4 7; BigDecimal, ARE FOCik IB SETT SS A, 
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13 BigDecimal(long val) 这 个 构造 画 数 用 于 转换 long 为 一 个 BigDecimal。 

14 BigDecimal(long val, MathContext mc) 这 个 构造 画 数 是 将 Biglnteger 
转换 为 BigDecimal。 

45 BigDecimal(String val) 此 构造 函数 用 于 一 个 BigDecimal 的 字符 串 表示 
形式 转换 为 BigDecimal。 

BigDecimal(String val, MathContext mc) 此 构造 函数 用 于 将 

16 BigDecimal 的 字符 串 表 示 形 式 转 换 为 BigDecimal， 接 受 相同 的 字符 串 作 

为 与 BigDecimal (String) 构造 ， 并 根据 上 下 文 设置 进行 舍 和 人。 
类 方法 

S.N. 方法 & 描述 

1 BigDecimal abs() 此 方法 返回 一 个 BigDecimal， 其 值 是 此 BigDecimal 的 
绝对 值 ， 其 标 度 是 this.scale()。 

2 BigDecimal abs(MathContext mc) 此 方法 返回 一 个 BigDecimal， 其 值 是 
此 BigDecimal 的 绝对 值 ， 与 根据 上 下 文 设置 进行 伟人 。 

3 BigDecimal add(BigDecimal augend) 此 方法 返回 一 个 BigDecimal， 其 
值 为 (this + augend)， 其 标 度 为 max(this.scale(), augend.scale())。 

4 BigDecimal add(BigDecimal augend, MathContext mc) 此 方法 返回 一 
“BigDecimal, #44 % (this + augend)， 与 根据 上 下 文 设置 进行 伟人 。 

5 byte byteValueExact() 这 种 方法 的 BigDecimal 转 换 为 一 个 字 节 ， 检 查 丢 
失 的 信息 。 

6 int compareTo(BigDecimal val) 这 种 方法 比较 BigDecimal 与 指定 的 
BigDecimal。 

BigDecimal divide(BigDecimal divisor) 此 方法 返回 一 个 BigDecimal， 其 

7 值 为 〈this/ 除 数 ) ， 且 其 首选 标 度 为 (this.scale() - divisor.scale()) ;如 
果 准 确 的 商 不 能 表示 〈 因 为 它 有 无 穷 的 十 进 制 扩展 ) ， 则 抛 出 
ArithmeticException。 

8 BigDecimal divide(BigDecimal divisor, int roundingMode) 此 方法 返回 一 
个 BigDecimal， 其 值 为 (this/ 除 数 ) ， 其 标 度 是 this.scale()。 

9 BigDecimal divide(BigDecimal divisor, int scale, int roundingMode) 此 
方法 返回 一 个 BigDecimal， 其 值 为 〈this/ 除 数 ) ， 其 标 度 如 指定 。 
BigDecimal divide(BigDecimal divisor, int scale, RoundingMode 

10 roundingMode) 此 方法 返回 一 个 BigDecimal， 其 值 为 (this/ 除 数 ) ， 其 
标 度 为 指定 。 

" BigDecimal divide(BigDecimal divisor, MathContext mc) 此 方法 返回 一 


BigDecimal, H44% (this/ 除 数 ) ， 和 与 根据 上 下 文 设置 进行 舍 入 。 


ANEN 


TutorialsPoint Java 技术 教程 


BigDecimal divide(BigDecimal divisor, RoundingMode roundingMode) 
12 此 方法 返回 一 个 BigDecimal， 其 值 为 〈this/ 除 数 ) ， 其 标 度 是 
this.scale()。 


BigDecimal[ ] divideAndRemainder(BigDecimal divisor) 这 o 
13 一 个 包含 divideTolntegralValue 结 果 ， 其 次 是 剩 下 的 两 个 操 "iin 
的 结果 由 两 个 元 素 组 成 的 BigDecimal 数 组 。 


BigDecimal[ ] divideAndRemainder(BigDecimal divisor, MathContext 
mc) 这 个 方法 返回 一 个 包含 divideTolntegralValue 的 结果 ， 随 后 其 余 与 


和 4 。 ”上 根据 上 下 文 设置 进行 舍 入 计算 两 个 操作 数 的 结果 的 结果 由 两 个 元 素 组 
成 的 BigDecimal 数 组 。 

15 BigDecimal divideTolntegralValue(BigDecimal divisor) 此 方法 返回 一 个 
BigDecimal， 其 值 为 商 〈 这 /除数 ) 的 整数 部 分 四 舍 五 入 。 

16 BigDecimal Salo uit i Ca dad t usua divisor, MathContext 


mc) 此 方法 返回 一 个 BigDecimal， 其 值 是 (这 /除数 ) 的 整数 部 分 。 
17 double doubleValue() 此 方法 将 BigDecimal 转 换 为 double。 
18 boolean equals(Object x) 这 种 方法 比较 BigDecimal 与 指定 对 象 是 否 相 


o 


19 float floatValue() 这 种 方法 将 BigDecimal 转 换 为 float。 

20 int hashCode() 此 方法 返回 BigDecimal 的 哈 希 代 码 。 

21 int intValue() 这 种 方法 将 BigDecimal 转 换 为 int。 

int intValueExact() 这 种 方法 将 BigDecimal 转 换 为 int， 检 查 丢 失 的 信 


/PNO 


22 


23 long longValue() 这 种 方法 将 BigDecimal 转 换 为 long。 
long longValueExact() 这 种 方法 将 BigDecimal 转 换 为 Iong， 检 查 丢 失 的 


^ BR. 

25 BigDecimal max(BigDecimal val) 此 方法 返回 此 BigDecimal 和 val 的 最 大 
{Bo 

26 BigDecimal min(BigDecimal val) 此 方法 返回 此 BigDecimal 和 val 的 最 小 

27 BigDecimal movePointLeft(int n) 此 方法 返回 一 个 BigDecimal， 它 等 效 
于 将 该 值 的 小 数 点 移动 n 位 到 左边 。 

28 BigDecimal movePointRight(int fi 此 方法 返回 一 个 BigDecimal， 它 等 效 


于 将 该 值 的 小 数 点 移动 n 位 到 右边 


BigDecimal multiply(BigDecimal multiplicand) 此 方法 返回 一 个 
29 BigDecimal， 其 值 为 (thisx 被 乘 数 ) ， 其 标 度 为 (this. le 
multiplicand.scale()) 。 


BigDecimal multiply(BigDecimal multiplicand, MathContext mc) 此 方法 
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44 


45 


va.math.BigDecimal X - Java.n 


返回 一 个 BigDecimal， 其 值 为 (thisx 乘 数 ) ， 以 根据 上 下 文 设置 进行 舍 
ING 


BigDecimal negate() 此 方法 返回 一 个 BigDecimal， 其 值 是 (this) , 
其 标 度 是 this.scale()。 


BigDecimal negate(MathContext mc) 此 方法 返回 一 个 BigDecimal， 其 
值 是 Cthis) ， 根 据 上 下 文 设置 进行 舍 入 。 


BigDecimal plus() 此 方法 返回 一 个 BigDecimal， 其 值 是 (+this) ， 其 标 
度 是 this.scale()。 


BigDecimal plus(MathContext mc) 此 方法 返回 一 个 BigDecimal， 其 值 
是 (+this) ， 根 据 上 下 文 设置 进行 舍 人 。 


BigDecimal pow(int n) 此 方法 返回 一 个 BigDecimal， 其 值 是 (this<sup 
style="margin: 0px; padding: Opx; font-size: 13px;">n</sup>), FIRMI 
计算 ， 使 其 具有 无 限 精 度 。 


BigDecimal pow(int n, MathContext mc) 此 方法 返回 一 个 BigDecimal， 
其 值 是 (this<sup style="margin: 0px; padding: Opx; font-size: 
13px;">n</sup>). 


int precision() 此 方法 返回 此 BigDecimal 的 精度 。 


BigDecimal remainder(BigDecimal divisor) 此 方法 将 BigDecimal 转 换 为 
一 个 byte， 检 查 丢 失 的 信息 。 


BigDecimal erate Ie ne divisor, MathContext mc) 此 方法 返 
回 一 个 BigDecimal， 其 值 为 (this% 除 数 ) ， 根 据 上 下 文 设置 进行 舍 
Au 


BigDecimal round(MathContext mc) 此 方法 返回 根据 MathContext 设 置 
舍 入 一 个 BigDecimal。 


int scale() 此 方法 返回 此 BigDecimal 的 标 度 。 


BigDecimal scaleByPowerOfTen(int n) 此 方法 返回 一 个 BigDecimal， 其 
数值 等 于 (this * 10<sup style="margin: Opx; padding: Opx; font-size: 
13px;">n</sup>). 


BigDecimal setScale(int newScale) 此 方法 返回 一 个 BigDecimal， 其 标 
度 为 指定 值 ， 其 值 在 数值 上 等 于 该 BigDecimal。 


BigDecimal setScale(int newScale, int roundingMode) 此 方法 返回 一 个 
BigDecimal， 其 标 度 为 指定 值 ， 其 非 标 度 值 乘 以 或 除 以 此 BigDecimal 的 
FEE ERRATA, 以 保持 其 整体 值 决定 。 


BigDecimal setScale(int newScale, RoundingMode roundingMode) 此 
方法 返回 一 个 BigDecimal， 其 标 度 为 指定 值 ， 其 非 标 度 值 乘 以 或 除 以 此 
BigDecimal 的 非 标 度 值 除 以 十 的 次 早 ， 以 保持 其 整体 价 决定 。 


short shortValueExact() 3x $175 A RE BigDecimal£ 4& 2; short, 4$ & & 
的 信息 。 
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int signum() 此 方法 返回 此 BigDecimal 的 正 负 号 函数 。 


BigDecimal stripTrailingZeros() 此 方法 返回 一 个 BigDecimal， 它 在 数值 
上 等 于 这 一 个 ， 但 与 从 表示 形式 移 除 所 有 尾部 堆 。 


BigDecimal subtract(BigDecimal subtrahend) 此 方法 返回 一 个 
BigDecimal， 其 值 为 (this - 减 数 ) ， 其 标 度 为 max (this.scale(), 
subtrahend.scale()) 。 


BigDecimal subtract(BigDecimal subtrahend, MathContext mc) 此 方法 
返回 一 个 BigDecimal， 其 值 为 (this - AM) ， 与 根据 上 下 文 设置 进行 
BA. 


BigInteger toBigInteger() 这 种 方法 将 BigDecimal 转 换 为 Biglnteger。 


BigInteger toBiglntegerExact() 这 种 方法 将 BigDecimal 转 换 为 
BigInteger, @HFAM(R. 


String toEngineeringString() 此 方法 返回 此 BigDecimal 的 字符 串 表 示 形 
式 ， 使 用 工程 计数 法 ， 如 果 需 要 指数 。 


String toPlainString() 此 方法 返回 此 BigDecimal 的 字符 串 表 示 形 式 不 带 
指数 字段 。 

String toString() 此 方法 返回 此 BigDecimal 的 字符 串 表 示 形 式 ， 用 科学 记 
数 法 ， 如 果 需 要 指数 。 

BigDecimal ulp() 此 方法 返回 一 个 ULP 的 此 BigDecimal 的 大 小 ， 在 最 后 
— fi BY # fir. 

BigInteger unscaledValue() 此 方法 返回 一 个 Biglnteger， 其 值 是 此 
BigDecimal 的 非 标 度 值 。 


static BigDecimal valueOf(double val) 这 种 方法 转换 double 为 一 个 
BigDecimal， 使 用 Double.toString (double) 方法 提供 的 double 的 规范 
化 字符 串 表 示 形 式 。 


static BigDecimal valueOf(long val) 这 种 方法 将 一 个 long 值 转换 为 
BigDecimal # AWE NS 4. 


static BigDecimal valueOf(long unscaledVal, int scale) 这 种 方法 转换 
long 的 非 标 度 值 和 一 个 int 尺 度 成 一 个 BigDecimal。 
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Java.math.BiglInteger 3: 3: 4 - Java.math 包 
java.math.BigInteger 类 提供 操作 类 似 所 有 Java 的 基本 整数 运算 符 和 
java.lang.Math 中 的 所 有 相关 的 方法 。 


它 还 提供 了 模 运 算 ，GCD 计 算 ， 素 性 测试 ， 素 数 生 成 ， 位 操作 ， 和 一 些 其 他 杂项 业 
务 操作 。 所 有 的 操作 行为 ， 如 果 Biglnteger 的 二 进 制 补 码 委托 表示 法 。 


算术 运算 和 按 位 逻辑 运算 的 语义 分 别 类 似 于 那些 Java 的 整数 算术 运算 符 和 Java 的 按 
位 整数 运算 符 。 移 位 操作 的 语义 扩展 那些 Java 的 移 位 运算 符 的 允许 负 移 的 距离 。 


比较 操作 执行 有 符号 整数 的 比较 。 提 供 模 块 化 的 算术 运算 来 计算 残留 ， 执 行 早 运算 
和 计算 乘法 逆 。 位 运算 操作 对 他 们 的 操作 数 的 二 进 制 补 码 表示 的 单个 位 。 


在 这 个 类 将 抛 出 NullPointerException， 在 所 有 方法 和 构造 酌 数 使 用 时 ， 通 过 输入 任 
何 参数 提供 一 个 空 的 对 象 引用 。 

类 声明 

以 下 是 java.math.Biglnteger 类 的 声明 : 


public class BigInteger 
extends Number 
implements Comparable<BigInteger> 


ra FEN 二 

字段 域 

以 下 是 java.math.Biglnteger 类 中 的 字段 : 
e static Biglnteger ONE -- Biglnteger 的 常量 1。 
e static Biglnteger TEN -- Biglnteger 的 常量 10。 
e static Biglnteger ZERO -- Biglnteger 的 常量 0。 


x AE 


S.N. Mis HR & 描述 

1 BigInteger(byte[] val) 3x N EKAA Fi — T 5e PRUE 
Biglnteger 的 二 进 制 补 码 ， 以 二 进 制 表 示 成 一 个 Biglnteger。 

2 BigInteger(int signum, byte[] magnitude) II nE HAAS 
Biglnteger 的 符号 大 小 表示 法 转换 成 一 个 Biglnteger 值 。 

3 Biginteger(int bitLength, int certainty, Random rnd) this HAA 
于 构造 一 个 随机 生成 正 Biglnteger 的 可 能 是 以 指定 的 bitLength 的 素数 。 
BigInteger(int numBits, Random rnd) 此 构造 画 数 用 于 构造 一 个 随机 

4 生成 的 Biglnteger， 均 匀 分 布 在 范围 0 到 (2<sup style="margin: 0px; 
padding: Opx; font-size: 13px;">numBits</sup> - 1), 包括 . 

5 BigInteger(String val) I 14535 WA T EBigIntegerBS + zt ell FHA BR 
示 形 式 转换 成 一 个 Biglnteger 值 。 

6 BigInteger(String val, int radix) 3x 4 43& BF 44 48 77 BigInteger 
的 指定 基数 为 一 个 Biglnteger 的 字符 串 表 示 形 式 。 

类 方法 

S.N. 方法 & 描述 

BigInteger abs() 此 方法 返回 一 个 Biglnteger， 其 值 是 此 Biglnteger 的 绝 
对 值 。 

2 BigInteger add(BigInteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 (this 
+ val). 

3 BigInteger and(BigInteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 (this 
& val). 

4 Biglnteger andNot(Biglnteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 
(this & ~vall. 

5 int bitCount() 此 方法 返回 此 Biglnteger 的 二 进 制 补 码 表 示 的 位 ， 从 符号 
位 不 同 的 数字 。 

6 int bitLength() 此 方法 返回 位 在 此 Biglnteger 的 最 小 的 二 进 制 补 码 表示 的 
数 ， 不 包括 符号 位 。 

7 BigInteger clearBit(int n) 此 方法 返回 一 个 Biglnteger， 其 值 相 当 于 此 
BigintegerSi8 EAS. 

3 int compareTo(BigInteger val) 此 方法 比较 此 Biglnteger 与 指定 的 
Biglnteger。 

9 BigInteger divide(BigInteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 


(this / val). 
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math.BigInteger # % f 


BigInteger[ ] divideAndRemainder(BigInteger val) 此 方法 返回 一 个 包含 
两 个 Biglntegers : (this / val) 和 (this % val)， 其 次 是 一 个 数组 。 


double doubleValue() 此 方法 此 Biglnteger 转 换 为 双 精 度 double。 
boolean equals(Object x) 此 方法 比较 此 Biglnteger 与 指定 对 象 是 否 相 


o 


BigInteger flipBit(int n) 此 方法 返回 一 个 Biglnteger， 其 值 相 当 于 此 
Biglnteger 与 指定 位 翻转 。 


float floatValue() 此 方法 将 Biglnteger 转 换 为 float。 


Biglnteger gcd(Biglnteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 绝对 
值 的 最 大 公约 数 : abs(this) 和 abs(val)。 


int getLowestSetBit() 此 方法 返回 最 右边 的 (最 低 阶 ) 的 索引 在 此 
Biglnteger1 上 比特 ( 需 比 特 的 数量 ， 以 最 右 侧 的 1 位 的 右 侧 )。 


int hashCode() 此 方法 返回 此 Biglnteger 的 哈 希 代码 。 
int intValue() 此 方法 此 Biglnteger 转 换 为 int。 


boolean isProbablePrime(int certainty) 此 方法 返回 true， 如 果 此 
Biglnteger 是 素数 ， 其 绝对 复合 数 则 返回 false。 


long longValue() 些 方法 将 Biglnteger 转 换 为 long。 


Biglnteger max(Biglnteger val) 此 方法 返回 此 Biglnteger 和 val 的 最 大 
值 。 


Biglnteger min(Biglnteger val) 此 方法 返回 此 Biglnteger 和 val 的 最 小 值 。 


BigInteger mod(Biglnteger m) 此 方法 返回 一 个 Biglnteger， 其 值 是 (this 
mod m). 


BigInteger modInverse(BigInteger m) 此 方法 返回 一 个 Biglnteger， 其 值 
是 (this<sup style="margin: 0px; padding: Opx; font-size: 
13px;">-1</sup> mod m). 


BigInteger modPow(Biglnteger exponent, BigInteger m) 此 方法 返回 一 
BigInteger, #442 (this<sup style="margin: Opx; padding: Opx; font- 
size: 13px;">exponent</sup> mod m). 


BigInteger multiply(BigInteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 
(this * val). 


BigInteger negate() 此 方法 返回 一 个 Biglnteger， 其 值 是 (-this). 


Biglnteger nextProbablePrime() 此 方法 返回 一 个 整数 大 于 该 Biglnteger 
的 可 能 是 素数 。 


BigInteger not() 此 方法 返回 一 个 Biglnteger， 其 值 是 (~this). 
Biglnteger or(Biglnteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 (this | 


3| - Java.math 包 135: 
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val). 


BigInteger pow(int exponent) 此 方法 返回 一 个 Biglnteger， 其 值 是 
(this<sup style="margin: Opx; padding: Opx; font-size: 
13px;">exponent</sup>). 


static BigInteger probablePrime(int bitLength, Random rnd) 此 方法 返回 
一 个 正 Biglnteger 的 可 能 是 素数 ， 以 指定 的 bitLength。 


BigInteger remainder(Biglnteger val) 此 方法 返回 一 个 Biglnteger， 其 值 
= (this % val). 


BigInteger setBit(int n) 此 方法 返回 一 个 Biglnteger， 其 值 相当 于 此 
Biglnteger 与 指定 的 位 设置 。 


BigInteger shiftLeft(int n) 此 方法 返回 一 个 Biglnteger， 其 值 是 (this << 
n). 


BigInteger shiftRight(int n) 此 方法 返回 一 个 Biglnteger， 其 值 是 (this >> 
n). 


int signum() This method returns the signum function of this BigInteger. 


BigInteger subtract(BigInteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 
(this - val). 


boolean testBit(int n) 此 方法 


byte[ ] toByteArray() 此 方法 
示 的 字 节 数组 。 


String toString() 此 方法 返回 此 Biglnteger 的 十 进 制 字 符 串 表示 形式 。 


String toString(int radix) 此 方法 返回 在 给 定 的 基数 以 Biglnteger 的 字符 串 
表示 形式 。 

static Biglnteger valueOf(long val) 此 方法 返回 一 个 Biglnteger， 其 值 等 
于 指定 long。 


BigInteger xor(BigInteger val) 此 方法 返回 一 个 Biglnteger， 其 值 是 (this 
^ val). 


i 


返回 当 且 仅 当 所 指定 的 位 被 设置 为 真 。 
回 一 个 包含 此 Biglnteger 的 二 进 制 补 码 表 


Isi 
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Java.math.MathContext X: 32 l| - Java.math@ 


java.math.MathContext 类 提供 了 封装 上 下 文 设置 的 不 可 变 对 象 ， 并 描述 数字 运算 
符 的 某 些 规则 ， 例 如 BigDecimal 类 的 实现 。 


基于 独立 设置 如 下 : 

1. 精度 : 用 于 操作 的 位 数 ; 结 果 四 舍 五 入 到 这 个 精度 。 

2. RoundingMode : 一 个 对 象 的 RoundingMode 它 指定 要 用 于 舍 入 的 算法 。 
类 声明 


以 下 是 java.math.MathContext 类 的 声明 : 


public final class MathContext 


extends Object 
implements Serializable 


= EJL 
字段 
以 下 是 java.math.MathContext 类 中 的 字段 : 
e static MathContext DECIMAL128 -- MathContext 对 象 与 精度 设置 相 匹 配 的 是 
文 是 


` 
FIN 


RR 


IEEE 754R Decimal128 格 式 ，34 位 数字 ， 并 HALF_EVEN， 3 
默认 舍 入 模式 。 


static MathContext DECIMAL32 -- MathContext 对 象 与 精度 设置 相 匹 配 的 是 
IEEE 754R Decimal32 格 式 ，7 位 数 和 HALF_EVEN， 这 是 IEEE 754R 的 默认 使 
和 人 模式 。 
static MathContext DECIMAL64 -- MathContext 对 象 与 精度 设置 相 匹 配 的 是 

文 是 


IEEE 754R Decimal64 格 式 ，16 位 数字 ， 并 HALF_EVEN， 这 是 IEEE 754R 的 
默认 舍 入 模式 。 


static MathContext UNLIMITED -- MathContext 对 象 ， 其 设置 有 需要 的 无 限 精 
度 运 算 的 值 。 


IEEE 754R 的 


类 构造 豆 数 


S.N. 138 HS i, BH 


MathContext(int setPrecision) 这 个 构造 画 数 ， 构 造 一 个 新 的 
MathContext 与 指定 的 精度 和 HALF_UP 舍 入 模式 。 


2 MathContext(int setPrecision, RoundingMode setRoundingMode) 
这 个 构造 画 数 ， 构 造 一 个 新 的 MathContext 与 指定 的 精度 和 舍 入 模式 。 
3 MathContext(String val) z N EKN, M- T FAB MIS — TATA 
MathContext, 
类 方法 
S.N. 方法 & 描述 


boolean equals(Object x) 此 方法 比较 MathContext 与 指定 对 象 是 否 相 


o 


int getPrecision() 此 方法 返回 设置 的 精度 。 

RoundingMode getRoundingMode() 此 方法 返回 RoundingMode 设 置 。 
int hashCode() 此 方法 返回 MathContext 的 哈 希 代 码 。 

String toString() 此 方法 返回 当前 MathContext 的 字符 串 表 示 形 式 。 


a 上 O N 


Java.util 包 教程 


java.util 包 中 包含 集合 框架 ，collection 类 ， 事 件 模型 ， 日 期 和 时 间 ， 国 际 化 和 各 种 
实用 工具 类 。 


该 参考 将 引导 学 习 java.util 包 中 的 实例 应 用 ， 并 提供 简单 ， 实 用 的 方法 使 用 示例 。 
读者 

该 参考 为 初学 者 准备 ， 帮 助 他 们 了 解 有 关 java.util 包 中 可 用 的 所 有 方法 的 基本 功能 。 
必 备 条 件 


在 开始 做 各 类 在 此 引用 给 定 的 例子 ， 在 这 里 假设 读者 已 经 知道 了 解 基本 Java 编 程 。 


Java.util.ArrayDeque X - Java.util 包 
java.util.ArrayDeque 类 提供 了 可 调整 大 小 的 阵列 ， 并 实现 了 Deque 接 口 。 以 下 是 
关于 阵列 双 端 队列 的 要 点 : 

e 数组 双 端 队列 没有 容量 限制 ， 使 他 们 增长 为 必要 支持 使 用 。 

。 它们 不 是 线程 安全 的 ;如 果 没 有 外 部 同步 。 

e. 不 支持 多 线程 并 发 访问 。 

e null 元 素 被 禁止 使 用 在 数组 deques。 

e 它们 要 比 堆栈 Stack 和 LinkedList 快 。 
此 类 及 其 迭代 器 实现 Collection 和 |lteratorinterfaces 方 法 可 选 。 


yp (p 
类 的 声明 
以 下 是 java.util.ArrayDeque 类 的 声明 : 


public class ArrayDeque<E> 
extends AbstractCollection<E> 
implements Deque<E>, Cloneable, Serializable 


这 里 <E> 代 表 一 个 元 素 ， 它 可 以 是 任何 类 。 例 如 ， 如 果 你 正在 构建 一 个 整数 数组 列 
表 ， 那 么 初始 化 可 为 


ArrayList<Integer> list = new ArrayList<Integer>(); 


S.N. 构造 画 数 & 描述 


ArrayDeque() 此 构造 画 数 用 于 创建 一 个 空 数组 双 羡 队列 容纳 16 个 元 素 
的 初始 容量 。 

2 ArrayDeque(Collection<? extends E» c) 此 构造 东 数 用 于 创建 一 个 包 
含 指定 集合 的 元 素 的 双 端 队列 。 


3 ArrayDeque(int numElements) 此 构造 画 数 用 于 创建 一 个 空 数组 与 双 
端 队 列 的 初始 容量 足以 容纳 指定 的 元 素数 。 
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类 方法 


S.N. 


Java.ull | .ArravDeque > - Java.uti | C 


方法 & 描述 
boolean add(E e) 此 方法 将 添加 指定 的 元 素 ， 在 此 deque 队 列 的 末尾 。 
void addFirst(E e) 此 方法 将 添加 指定 的 元 素 ， 在 此 deque 队 列 的 前 面 。 
void addLast(E e) 此 方法 将 插入 指定 的 元 素 ， 在 此 deque 队 列 的 末尾 。 
void clear() 此 方法 移 除 此 deque 队 列 的 元 素 。 
ArrayDeque<E> clone() 此 方法 返回 此 deque 队 列 的 副本 。 


boolean contains(Object o) 如 果 此 deque 队列 包含 指定 的 元 素 ， 此 方法 
返回 true。 


lterator<E> descendinglterator() 此 方法 返回 一 个 迭代 器 在 此 deque 队 列 
以 逆向 顺序 的 元 素 。 


E element() 此 方法 检索 ， 但 是 不 移 除 此 deque 队 列表 示 的 队列 的 头 部 。 
E getFirst() 此 方法 检索 ， 但 是 不 移 除 此 deque 队 列 的 第 一 个 元 素 。 

E getLast() 此 方法 检索 ， 但 是 不 移 除 此 deque 队 列 的 最 后 一 个 元 素 。 
boolean isEmpty() 如 果 此 deque 队 列 不 包含 元 素 ， 此 方法 返回 true。 
lterator<E> iterator() 此 方法 返回 一 个 迭代 器 在 此 deque 队 列 的 元 素 。 
boolean offer(E e) 此 方法 将 指定 的 元 素 ， 在 此 deque 队 列 的 末尾 。 
boolean offerFirst(E e) 此 方法 将 指定 的 元 素 ， 在 此 deque 队 列 的 前 面 。 
boolean offerLast(E e) 此 方法 将 指定 的 元 素 ， 在 此 deque 队 列 的 末尾 。 


E peek() 此 方法 检索 ， 但 是 不 移 除 此 deque 队 列表 示 的 队列 的 头 部 ， 如 
果 此 deque 队 列 为 空 ， 则 返回 null。 


E peekFirst() 此 方法 检索 ， 但 是 不 移 除 此 deque 队列 的 第 一 个 元 素 ， 或 
者 如 果 此 deque 队列 为 空 ， 则 返回 null。 


E peekLast() 此 方法 检索 ， 但 是 不 移 除 此 deque 队 列 的 最 后 一 个 元 素 ， 
如 果 此 deque 队 列 为 空 ， 则 返回 null。 


E poll() 此 方法 检索 并 移 除 此 deque 队 列表 示 的 队列 的 头 部 ， 如 果 此 
deque 队 列 为 空 ， 则 返回 null。 


E pollFirst() 此 方法 检索 并 移 除 此 deque 队 列 的 第 一 个 元 素 ， 或 者 如 果 此 
deque 队 列 为 空 ， 则 返回 null。 


E pollLast() 此 方法 检索 并 移 除 此 deque 队 列 的 最 后 一 个 元 素 ， 如 果 此 
deque 队 列 为 空 ， 则 返回 null。 


E pop() 这 种 方法 的 此 deque 队 列 所 表示 的 堆栈 漳 出 一 个 元 素 。 
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void push(E e) 这 种 方法 将 元 素 推 人 此 deque 队 列 所 表示 的 堆栈 。 
E remove() 此 方法 检索 并 移 除 此 deque 队 列表 示 的 队列 的 头 部 。 


boolean remove(Object o) 此 方法 从 此 deque 队 列 中 移 除 指定 元 素 的 单 
个 实例 。 


E removeFirst() 此 方法 检索 并 移 除 此 deque 队 列 的 第 一 个 元 素 。 


boolean removeFirstOccurrence(Object o) 此 方法 移 除 此 deque 队 列 的 
指定 元 素 的 第 一 个 匹配 。 


E removeLast() 此 方法 检索 并 移 除 此 deque 队 列 的 最 后 一 个 元 素 。 


boolean removeLastOccurrence(Object o) 此 方法 移 除 此 deque 队 列 的 
指定 元 素 的 最 后 一 次 出 现 。 


int size() 此 方法 返回 在 此 deque 队 列 的 元 素 个 数 。 


object[] toArray() 这 个 方法 返回 一 个 包含 所 有 在 此 deque 队 列 在 适当 的 
序列 中 元 素 的 数组 。 
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Java.util.ArrayListz: - Java.utile 


java.util.ArrayList 类 提供 了 可 调整 大 小 的 数组 ， 并 实现 了 List 接 口 。 以 下 是 关于 
ArrayList 中 的 要 点 : 


e 它 实 现 了 所 有 可 选 的 列表 操作 ， 并 且 还 允许 所 有 元 素 ， 包 括 空 值 null。 
e 它 提供 了 一 些 方法 来 操作 内 部 用 来 存储 列表 的 数组 的 大 小 。 
e 相 较 于 LinkedList 实 现 的 常数 因子 较 低 。 

类 声明 

以 下 是 java.util.ArrayList 类 的 声明 : 


public class ArrayList<E> 
extends AbstractList<E> 
implements List<E>, RandomAccess, Cloneable, Serializable 


这 里 <E> 代 表 元 素 。 例 如 ， 如 果 正 在 构建 一 个 整数 数组 列表 ， 那 么 初始 化 为 


ArrayList<Integer> list = new ArrayList<Integer>(); 
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1 ArrayList() biG SAF 6]$& — ZEB Az, BL 10 7638 BAR 
容量 。 

2 ArrayList(Collection«? extends E» c) Ite R MAF 613 — 7 8L 


指定 集合 的 元 素 的 列表 。 
3 ArrayList(int initialCapacity) bt ERRA F 6] — T Z2 ARN 
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1 boolean add(E e) 此 方法 将 指定 元 素 追 加 到 此 列表 的 末尾 。 
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void add(int index, E element) 此 方法 将 在 此 列表 中 指定 位 置 的 指定 元 


INO 


boolean addAll(Collection<? extends E» c) 此 方法 会 季 所 有 指定 集合 中 
的 元 素 添 加 到 此 列表 的 结尾 ， 因 为 它们 是 由 指定 collection 的 迭代 器 返回 
的 顺序 


boolean addAll(int index, Collection<? extends E» c) 此 方法 将 所 有 指 
定 集合 中 的 元 素 插 入 此 列表 ， 在 指定 的 位 置 开始 。 


void clear() 此 方法 删除 所 有 来 自 此 列表 中 的 元 素 。 
Object clone() 这 个 方法 返回 当前 ArrayList 实 例 的 浅 表 副本 。 


boolean contains(Object o) 如 果 此 列表 包含 指定 的 元 素 ， 此 方法 返回 
true。 


void ensureCapacity(int minCapacity) 增加 此 ArrayList 的 容量 。 
E get(int index) 此 方法 返回 的 元 素 在 此 列表 中 的 指定 位 置 。 


int indexOf(Object o) 此 方法 返回 指定 元 素 的 第 一 个 匹配 项 的 索引 在 此 
列表 中 ， 或 者 如 果 此 列表 中 不 包含 该 元 素 返 回 -1。 


boolean isEmpty() 如 果 此 列表 不 包含 元 素 ， 此 方法 返回 true。 


int lastIndexOf(Object o) 此 方法 返回 指定 元 素 的 最 后 一 个 匹配 项 的 索引 
在 此 列表 中 ， 或 者 -1， 如 果 此 列表 中 不 包含 该 元 素 。 


E remove(int index) 此 方法 删除 的 元 素 在 此 列表 中 的 指定 位 置 。 


boolean remove(Object 0) 此 方法 从 该 列表 中 首次 出 现 的 指定 元 素 ， 如 
果 它 存在 。 


protected void removeRange(int fromIndex, int tolndex) 此 方法 从 该 列 
表 中 删除 所 有 的 素 引 fromlndex (包括 ) Stolndex (不 包括 ) 之 间 的 元 


“IO 


E set(int index, E element) 此 方法 取代 在 与 指定 元 素 在 此 列表 中 指定 位 
置 的 元 素 。 


int size() 此 方法 返回 此 列表 中 的 元 素数 。 


Object[] toArray() 此 方法 返回 一 个 包含 所 有 在 此 列表 中 正确 的 序列 中 元 
素 的 数组 〈 从 第 一 个 到 最 后 一 个 元 素 ) 。 


«T» T[] toArray(T[] a) 此 方法 返回 一 个 包含 所 有 在 此 列表 中 正确 的 序列 
中 的 元 素 〈 从 第 一 个 到 最 后 一 个 元 素 ) 数组 ;返回 数组 的 运行 时 类 型 是 指 
定数 组 。 

void trimToSize() 此 方法 修整 此 ArrayList 实 例 的 是 列表 的 当前 大 小 的 容 


Eo 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractList 
e java.lang.AbstractCollection 
e java.util.Object 


e java.util.List 


Java.util.Arrays X - Java.utila 
java.util.Arrays 类 包含 一 个 静态 的 工厂 ， 人 允许 数组 被 视 为 列表 。 以 下 是 关于 数组 的 
要 点 : 


e 这 个 类 包含 了 各 种 方法 来 操作 数组 (比如 排序 和 搜索 )。 
e 在 这 个 类 中 的 方法 抛 出 NullPointerException 如 果 指 定数 组 引用 为 null。 


J^ —L 
类 两 明 
以 下 是 java.util.Arrays 类 的 声明 : 


public class Arrays 
extends Object 


类 方法 


S.N. 方法 & 描述 
1 static «T» List<T> asList(T a) 此 方法 返回 一 个 受 指 定数 组 支持 的 固定 大 
小 的 列表 。 


static int binarySearch(byte[] a, byte key) 此 方法 搜索 指定 的 字 节 数组 使 
用 二 进 制 搜索 算法 来 指定 值 。 


3 static int binarySearch(byte[] a, int fromIndex, int tolndex, byte key) 此 
方法 搜索 范围 指定 的 字 节 数组 使 用 二 进 制 搜索 算法 来 指定 值 。 


static int binarySearch(char[] a, char key) 此 方法 搜索 指定 字符 数组 ， 


4 使 用 二 进 制 搜索 算法 来 指定 值 。 

5 static int binarySearch(char[] a, int fromIndex, int tolndex, char key) 此 
方法 搜索 一 个 范围 内 的 指定 字符 数组 ， 使 用 二 进 制 搜索 算法 来 指定 值 。 

6 static int binarySearch(double[] a, double key) 此 方法 搜索 指定 double 
数组 ， 使 用 二 进 制 搜索 算法 来 指定 值 。 

7 static int binarySearch(double[] a, int fromlndex, int tolndex, double 
key) 此 方法 搜索 范围 double 指 定数 组 ， 使 用 二 进 制 搜索 算法 来 指定 值 。 

8 static int binarySearch(float[] a, float key) 此 方法 搜索 浮 点 数 的 指定 数 


组 ， 使 用 二 进 制 搜索 算法 来 指定 值 。 


9 static int binarySearch(float[] a, int fromIndex, int tolndex, float key) 此 


方法 搜索 范围 指定 浮 点 数 的 数组 ， 使 用 二 进 制 搜索 算法 来 指定 值 。 
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static int binarySearch(int[] a, int key) 此 方法 搜索 指定 的 int 型 数组 使 用 
二 进 制 搜索 算法 来 指定 值 。 


static int binarySearch(int[] a, int ffomlndex, int tolndex, int key) 此 方法 
搜索 范围 指定 的 int 型 数组 使 用 二 进 制 搜索 算法 来 指定 值 。 


static int binarySearch(long[] a, int fromIndex, int tolndex, long key) 此 


方法 搜索 范围 指定 long 数 组 ， 使 用 二 进 制 搜索 算法 来 指定 值 。 


static int binarySearch(long[] a, long key) 此 方法 搜索 指定 long 数 组 ， 使 
用 二 进 制 搜索 算法 来 指定 值 。 


static int binarySearch(Object[] a, int fromIndex, int tolndex, Object 


key) 此 方法 搜索 范围 指定 数组 ， 使 用 二 进 制 搜索 算法 来 指定 对 象 。 


static int binarySearch(Object[] a, Object key) 此 方法 搜索 指定 数组 ， 使 
用 二 进 制 搜索 算法 来 指定 对 象 。 


static int binarySearch(short[] a, int fromIndex, int tolndex, short key) 


此 方法 搜索 范围 指定 short 数 组 ， 使 用 二 进 制 搜索 算法 来 指定 值 。 


static int binarySearch(short[] a, short key) 此 方法 搜索 指定 short 数 组 ， 
使 用 二 进 制 搜索 算法 来 指定 值 。 


static «T» int binarySearch(T[] a, int fromlndex, int tolndex, T key, 
Comparator«? super T» c) 此 方法 搜索 范围 指定 数组 ， 使 用 二 进 制 搜索 
算法 来 指定 对 象 。 


static «T» int binarySearch(T[] a, T key, Comparator<? super T» c) 此 


方法 搜索 指定 数组 ， 使 用 二 进 制 搜索 算法 来 指定 对 象 。 


static boolean[] copyOf(boolean[] original, int newLength) 此 方法 复制 
指定 的 数组 ， 截 取 或 填充 false (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 
度 。 


static byte[] copyOf(byte[] original, int newLength) 此 方法 复制 指定 的 数 
组 ， 截 取 或 填充 用 需 (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static char[] copyOf(char[] original, int newLength) 此 方法 复制 指定 的 数 
组 ， 截 取 或 填充 用 null (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static double[] copyOf(double[] original, int newLength) 此 方法 复制 指定 
的 数组 ， 截 取 或 填充 用 震 (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static float[] copyOf(float[] original, int newLength) 此 方法 复制 指定 的 数 
组 ， 截 取 或 填充 用 需 (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static int[] copyOf(int[] original, int newLength) 此 方法 复制 指定 的 数 
组 ， 截 取 或 填充 用 需 (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static long[] copyOf(long[] original, int newLength) 此 方法 复制 指定 的 数 
组 ， 截 取 或 填充 用 震 (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static short[] copyOf(short[] original, int newLength) 此 方法 复制 指定 的 
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Ba, SXHXSXIBJCHISS (如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static «T» T[] copyOf(T[] original, int newLength) 此 方法 复制 指定 的 数 
组 ， 截 取 或 用 null 填 充 〈 如 有 必要 ) ， 以 使 副本 具有 指定 的 长 度 。 


static <T,U> T[] copyOf(U[] original, int newLength, Class<? extends 
TI]> newType) 此 方法 复制 指定 的 数组 ， 截 取 或 用 null 填 充 (如 有 必 

32) ， 以 使 副本 具有 指定 的 长 度 。 

static boolean[] copyOfRange(boolean[] original, int from, int to) 此 方法 
复制 指定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 

static byte[] copyOfRange(byte[] original, int from, int to) 此 方法 复制 指 
定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 

static char[] copyOfRange(char[] original, int from, int to) 此 方法 复制 指 
定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 

static double[] copyOfRange(double[] original, int from, int to) 此 方法 复 
制 指定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 

static float[] copyOfRange(float[] original, int from, int to) 此 方法 复制 指 
定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 

static int[] copyOfRange(int[] original, int from, int to) 此 方法 复制 指定 的 
数组 到 一 个 新 的 数组 的 指定 范围 。 

static long[] copyOfRange(long[] original, int from, int to) 此 方法 复制 指 
定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 

static short[] copyOfRange(short[] original, int from, int to) 此 方法 复制 
旨 定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 

static «T» T[] copyOfRange(T[] original, int from, int to) 此 方法 复制 指 
定 的 数组 到 一 个 新 的 数组 的 指定 范围 。 


static <T,U> T[] copyOfRange(U[] original, int from, int to, Class<? 
extends T[]> newType) 此 方法 复制 指定 的 数组 到 一 个 新 的 数组 的 指定 


static boolean deepEquals(Object[] a1, Object[] a2) 如 果 两 个 指定 数组 
相等 此 方法 返回 true。 


static int deepHashCode(Obiject[] a) 此 方法 返回 基于 指定 数组 的 “深层 
内 容 " 返 回 哈 希 码 。 


static String deepToString(Object[] a) 此 方法 返回 指定 数组 的 “深层 内 

容 " 的 字符 串 表 示 形 式 。 

static boolean equals(boolean[] a, boolean[] a2) 如 果 布 尔 值 的 两 个 指定 
数组 相互 相等 此 方法 返回 true。 


static boolean equals(byte[] a, byte[] a2) 如 果 两 个 指定 字 节 数组 相互 相 
等 此 方法 返回 true。 
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等 此 方法 返回 true。 


static boolean equals(char[] a, char[] a2) 如 果 两 个 指定 字符 数组 相互 相 
等 此 方法 返回 true。 


static boolean equals(double[] a, double[] a2) 如 果 两 个 指定 double 数 组 
相互 相等 此 方法 返回 true。 


static boolean equals(float[] a, float[] a2) 如 果 浮 点 数 的 两 个 指定 数组 相 
互相 等 此 方法 返回 true。 


static boolean equals(int[] a, int[] a2) 如 果 整 数 的 两 个 指定 数组 相互 相等 
此 方法 返回 true。 


static boolean equals(long[] a, long[] a2) 如 果 两 个 指定 long 数 组 相互 相 
等 此 方法 返回 true。 


static boolean equals(Object[] a, Object[] a2) 如 果 两 个 指定 对 象 数 组 相 
互相 等 此 方法 返回 true。 


static boolean equals(short[] a, short[] a2) 如 果 两 个 指定 对 象 数组 相互 
相等 此 方法 返回 true。 


static void fill(boolean[] a, boolean val) 此 方法 分 配 指 定 指定 布尔 值 数 组 
的 每 个 元 素 。 


static void fill(boolean|] a, int fromIndex, int tolndex, boolean val) 此 方 
法 分 配 指定 指定 布尔 值 数组 的 指定 范围 中 的 每 个 元 素 的 布尔 值 。 

static void fill(byte[] a, byte val) 此 方法 分 配 指定 指定 的 字 节 数组 的 每 个 
元 素 的 字 节 值 。 

static void fill(byte[] a, int fromIndex, int tolndex, byte val) 此 方法 分 配 指 
定 的 字 节 数组 指定 范围 中 的 每 个 元 素 的 字 节 值 。 

static void fill(char[] a, char val) 此 方法 分 配 指定 的 char 值 到 指定 数组 的 
每 个 元 素 的 字符 。 

static void fill(char[] a, int ffomlndex, int tolndex, char val) 此 方法 分 配 
指定 的 char 值 的 指定 数组 的 指定 范围 中 的 每 个 元 素 的 字符 。 

static void fill(double[] a, double val) 此 方法 分 配 一 个 指定 的 double 值 到 
指定 数组 的 每 个 元 素 的 double 值 。 


static void fill(double[] a, int fromIndex, int tolndex, double val) 此 方法 
分 配 一 个 指定 的 double 值 到 指定 的 double 数 组 的 指定 范围 中 的 每 个 元 
素 。 


static void fill(float[] a, float val) 此 分 配方 法 指定 float 值 数 指定 数组 的 每 
个 元 素 的 浮 点 值 。 


static void fill(float[] a, int fromIndex, int tolndex, float val) 此 分 配方 法 指 
定 float 值 数 指定 数组 的 指定 范围 中 的 每 个 元 素 的 浮 点 值 。 


static void fill(int[] a, int val) 此 分 配方 法 指定 数组 的 指定 范围 中 的 每 个 元 
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static void fill(int[] a, int fromIndex, int tolndex, int val) 此 分 配方 法 指定 
数组 的 指定 范围 中 的 每 个 元 素 的 int 值 。 


static void fill(long[] a, int fromIndex, int tolndex, long val) 此 分 配方 法 指 
定数 组 的 指定 范围 中 的 每 个 元 素 的 long 值 。 


static void fill(long[] a, long val) 此 分 配方 法 指定 long 指 定数 组 的 每 个 元 
素 的 long 值 。 


static void fill(Object[] a, int fromIndex, int tolndex, Object val) 此 方法 分 
配 指 定 的 Object 引用 的 对 象 的 指定 数组 的 指定 范围 中 的 每 个 元 素 。 


static void fill(Object[] a, Object val) 此 方法 分 配 指定 的 Object 引用 的 对 
象 指 定 的 数组 中 的 每 个 元 素 。 


static void fill(short[] a, int fromIndex, int tolndex, short val) 此 方法 分 配 
指定 数组 的 指定 范围 中 的 每 个 元 素 的 short 值 。 


static void fill(short[] a, short val) 此 方法 分 配 指定 short 数 组 的 每 个 元 素 
的 short 值 。 


static int hashCode(boolean[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 


码 。 


static int hashCode(byte[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 
码 。 


static int hashCode(char[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 
码 。 


static int hashCode(double[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 
码 。 


static int hashCode(float[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 
码 。 


static int hashCode(int[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 码 。 


static int hashCode(long[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 
码 。 


static int hashCode(Object[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 
码 。 


static int hashCode(short[] a) 此 方法 返回 基于 指定 数组 的 内 容 的 哈 希 
码 。 


static void sort(byte[] a) 此 方法 指定 的 字 节 数组 排序 按 数字 升序 顺序 。 


static void sort(byte[] a, int fromIndex, int tolndex) 此 方法 对 指定 范围 内 
指定 的 字 节 数组 按 数字 升序 顺序 。 


static void sort(char[] a) 此 方法 将 char 型 数组 排序 按 数字 升序 顺序 。 
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static void sort(char[] a) 此 方法 将 char 型 数组 排序 按 数字 升序 顺序 。 


static void sort(char[] a, int fromIndex, int tolndex) 此 方法 对 指定 范围 内 
指定 的 字符 数组 按 数 字 升 序 顺 序 。 


static void sort(double[] a) 此 方法 指定 double 数 组 排序 按 数字 升序 顺 
序 。 


static void sort(double[] a, int fromIndex, int tolndex) 此 方法 对 指定 范围 
的 指定 double 数组 按 数字 升序 顺序 。 


static void sort(float[] a) 此 方法 指定 浮 点 数 数组 排序 按 数字 升序 顺序 。 


static void sort(float[] a, int fromIndex, int tolndex) 此 方法 对 指定 范围 内 
的 指定 float 数 组 按 数 字 升 序 顺 序 。 


static void sort(int[] a) 此 方法 指定 的 int 型 数组 排序 按 数字 升序 顺序 。 


static void sort(int[] a, int fromIndex, int tolndex) 此 方法 对 指定 范围 内 指 
定 的 int 型 数组 按 数字 升序 顺序 。 


static void sort(long[] a) 此 方法 指定 的 long 数 组 排序 按 数 字 升 序 顺序 。 


static void sort(long[] a, int fromIndex, int tolndex) 此 方法 对 指定 范围 内 
指定 long 数 组 按 数字 升序 顺序 。 


static void sort(Object[] a) 根据 其 元 素 的 自然 顺序 ， 此 方法 对 指定 对 象 
数组 按 升 序 进 行 。 


static void sort(Object[] a, int fromIndex, int tolndex) 根据 其 元 素 的 自然 
顺序 ， 此 方法 对 指定 对 象 数 组 按 升序 顺序 的 指定 范围 。 


static void sort(short[] a) 此 方法 指定 的 short 数组 排序 按 数字 升序 顺 
序 。 


static void sort(short[] a, int fromIndex, int tolndex) 此 方法 对 指定 范围 
内 的 short 指 定数 组 按 数字 升序 顺序 。 


static <T> void sort(T[] a, Comparator<? super T> c) 此 方法 的 对 象 进行 
排序 根据 引起 的 指定 比较 顺序 指定 数组 。 


static «T» void sort(T[] a, int fromIndex, int tolndex, Comparator<? 
super T» c) 根据 引起 由 指定 比较 器 的 顺序 此 方法 排序 对 象 的 指定 数组 的 
指定 范围 。 


static String toString(boolean[] a) 此 方法 返回 指定 的 boolean 数 组 内 容 的 
字符 串 表 示 形 式 。 


static String toString(byte[] a) 此 方法 返回 指定 的 byte 数 组 内 容 的 字符 串 
表示 形式 。 


static String toString(char[] a) 此 方法 返回 指定 的 char 数 组 内 容 的 字符 串 
表示 形式 。 


static String toString(double[] a) 此 方法 返回 指定 的 double 数 组 内 容 的 字 
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static String toString(float[] a) 此 方法 返回 指定 的 float 数 组 内 容 的 字符 串 
表示 形式 。 


static String toString(int[] a) 此 方法 返回 指定 的 int 数 组 内 容 的 字符 串 表 示 
形式 。 


static String toString(long[] a) 此 方法 返回 指定 的 long 数 组 内 容 的 字符 串 
表示 形式 。 


static String toString(Object[] a) 此 方法 返回 指定 的 对 象 数组 内 容 的 字符 
串 表 示 形 式 。 


static String toString(short[] a) 此 方法 返回 指定 的 short 数 组 内 容 的 字符 
串 表 示 形 式 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 
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Java.util.BitSet # - Java.util 包 


java.util.BitSet 类 实现 位 向 量 作为 一 个 按 需 增长 。 以 下 是 关于 BitSet 中 的 要 点 : 
e BitSet 是 不 安全 的 ， 除 非 外 部 同步 多 线程 使 用 。 
。 集合 中 的 所 有 位 的 初始 值 false。 
e 传递 一 个 null 参 数 到 BitSet 中 的 任何 方法 会 导致 一 个 NullPointerException。 


xy - 
AX Fa HH 
以 下 是 java.util.BitSet 类 的 声明 : 


public class BitSet 
extends Object 
implements Cloneable, Serializable 


3 M ES 
S.N. AME ARM & 描述 


1 BitSet() tt 143& P425 6) E& — fr B) fur S, 


2 BitSet(int nbits) Ub wie B323:6] ENE, CHMMRA) EBA, A 
以 通过 0 到 nbits-1 范 围 显 式 表示 索引 。 


类 方法 


S.N. 方法 & 描述 

1 void and(BitSet set) 此 方法 执行 一 个 逻辑 这 个 目标 位 ， 并 设置 参数 位 集 
aS 
Oo 


2 void andNot(BitSet set) 此 方法 清除 所 有 的 位 ， 其 相应 的 位 在 指定 BitSet 
中 设置 此 BitSet 中 的 位 。 


3 int cardinality() 此 方法 返回 设置 为 true， 此 BitSet 中 的 比特 数 。 
4 void clear() 此 方法 将 此 BitSet 中 的 所 有 的 位 设置 为 false。 


void clear(int bitlndex) 此 方法 设置 由 index 指 定 的 位 为 false。 
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括 ) 设置 位 到 指定 tolndex (不 包括 ) 为 false。 
Object clone() 此 方法 克隆 该 BitSet 中 ， 并 产生 一 个 新 的 等 于 它 的 


BitSet, 

8 boolean equals(Object obj) 这 个 方法 是 比较 这 个 对 象 与 指定 对 象 。 

9 void flip(int bitIndex) 这 种 方法 在 指定 索引 到 它 的 当前 值 的 补 码 在 设置 
位 。 

10 void flip(int fromIndex, int tolndex) 此 方法 设置 每 个 位 将 指定 的 


fromlndex (包括 ) 到 指定 的 tolndex (不 包括 ) 为 其 当前 值 的 补 码 。 
11 boolean get(int bitIndex) 此 方法 返回 具有 指定 索引 的 位 的 值 。 


BitSet get(int fromIndex, int tolndex) 此 方法 返回 的 位 组 成 一 个 新 BitSet 
中 此 BitSet 中 从 fromlndex (包括 ) 到 tolndex (不 包括 ) 。 


13 int hashCode() 此 方法 返回 县 有 指定 索引 的 位 的 值 。 
boolean intersects(BitSet set) 如 果 指 定 BitSet 中 有 设置 为 ttue， 此 BitSet 


1^ 中 的 任何 位 此 方法 返回 true。 

15 boolean isEmpty() 如 果 此 BitSet 中 没有 包含 位 被 设置 为 true， 此 方法 返 
回 true。 

16 int length() 此 方法 返回 此 BitSet 的 “逻辑 大 小 ”: 在 BitSet 中 最 高 设置 位 加 
一 的 索引 。 

17 int nextClearBit(int fromIndex) 此 方法 返回 被 设置 为 出 现 或 之 后 指定 的 
起 始 索 引 false 的 位 的 索引 。 

18 int nextSetBit(int fromIndex) 此 方法 返回 被 设置 为 出 现 或 之 后 指定 的 起 


始 索引 true 的 位 的 索引 。 
19 void or(BitSet set) 此 方法 执行 的 逻辑 该 位 或 设置 该 位 设置 参数 。 
20 void set(int bitIndex) 这 种 方法 在 指定 索引 设置 该 位 为 true。 


void set(int bitlndex, boolean value) 这 种 方法 指定 索引 到 指定 设置 该 位 


“| 的 值 。 

22 void set(int fromIndex, int tolndex) 此 方法 设置 的 位 将 指定 的 
fromlndex (包括 ) 到 指定 的 tolndex (不 包括 ) 为 true。 

23 void set(int fromIndex, int tolndex, boolean value) 此 方法 从 指定 的 


fromlndex (包括 ) 设置 位 到 指定 的 tolndex (不 包括 ) 到 指定 的 值 。 
24 int size() 此 方法 返回 实际 使 用 此 BitSet 表 示 位 值 的 空间 的 比特 数 。 
25 String toString() 此 方法 返回 此 位 set 的 字符 串 表示 形式 。 

26 void xor(BitSet set) 此 方法 执行 此 位 的 逻辑 异 或 设置 该 位 设置 参数 。 
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方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


Java.util.Calendar X: - Java.util@ 


java.util.calendar 类 是 一 个 抽象 类 ， 它 提供 了 和 与 在 某 一 特定 时 刻 和 一 组 日 历 字段 如 
YEAR, MONTH, DAY_ OF. MONTH, HOURS, 并 为 操作 日 历 字段 ， 如 获取 的 
日 期 转换 方法 下 周 。 以 下 是 关于 日 历 的 要 点 


e 这 个 类 还 提供 了 额外 的 字段 和 实施 具体 的 日 历 系 统 外 面包 的 方法 。 
e 日 历 定义 了 某 些 日 历 字段 返回 值 的 范围 。 


类 的 声明 
以 下 是 java.util.Calendar 类 的 声明 : 


public abstract class Calendar 
extends Object 
implements Serializable, Cloneable, Comparable<Calendar> 


ri 
字段 
以 下 是 java.util.Calendar 类 中 的 字段 : 


e static int ALL STYLES -- 这 个 风格 说 明 符 getDisplayNames 指 示 所 有 样式 的 名 
称 ， 如 "January" 和 "Jan"。 


e static int AM -- 这 是 AM_PM 字 上 段 指示 当天 的 期 限 从 半夜 到 中 午前 的 值 。 
e static int AM PM -- 这 个 字段 数 get 和 set 的 指示 HOUR 是 中 午 之 前 或 之 后 


e static int APRIL -- 这 个 MONTH 字 段 表 示 第 四 个 月 当年 在 格 里 高 利 历 和 罗马 儒 
略 历 中 的 值 。 


e protected boolean areFieldsSet -- 为 true， 如 果 fields[] 与 当前 设置 的 时 间 同 
步 。 


e static int AUGUST -- 这 是 一 个 MONTH 字 段 指示 第 八 个 年 度 在 格 里 高 利 万 和 有 罗 
z (85 88 75 FR BS fs 


e static int DATE -- e 和 set， 表 示 该 月 的 日 期 。 
e static int DAY OF MONTH -- 这 是 字段 数 为 get 和 set， 表 示 该 月 的 日 期 。 
e static int DAY OF WEEK -- Hie qae 


e static int DAY OF WEEK IN. MONTH -- 这 是 字段 数 为 get 和 set， 指 示 当 前 月 
中 的 序数 星期 。 


static int DAY_OF_YEAR -- 这 是 字段 数 为 get 和 set， 表 示 本 年 度 内 天 数 。 


static int DECEMBER -- 这 是 一 个 MONTH 字 段 指示 腊月 当年 在 格 里 高 利 万 和 
罗马 儒 略 万 中 的 值 。 


static int DST OFFSET -- 这 是 字段 数 get 和 set 的 指示 夏令 时 以 毫秒 为 单位 的 偏 
移 。 


static int ERA -- 这 是 字段 数 为 get 和 set 显 示 的 时 代 ， 例 如 ， 在 儒 略 万 中 的 AD 或 
BC。 


static int FEBRUARY -- 这 是 一 个 MONTH 字 段 指 示 第 二 个 年 度 在 格 里 高 利 万 和 
罗马 儒 略 万 中 的 值 。 


static int FIELD COUNT -- 这 是 通过 获取 确认 和 设置 不 同 的 字段 的 数量 。 
protected int[] fields -- 这 是 当前 设置 的 时 间 为 这 个 日 历 的 日 历 字 段 值 。 
static int FRIDAY -- 3x zéDAY OF WEEK 字段 的 说 明 周 五 的 值 。 

static int HOUR -- 这 是 字段 数 为 get 和 set， 表 示 上 午 或 下 午 的 时 间 。 

static int HOUR OF. DAY -- 这 是 字段 数 get 和 set 表 示 一 天 中 的 小 时 。 
protected boolean[] isSet -- 这 是 判断 该 日 历 某 一 指定 日 历 字段 设置 该 标志 。 
protected boolean isTimeSet -- 这 是 true 如 果 当 时 的 时 间 值 是 有 效 的 。 


static int JANUARY -- 这 是 一 个 MONTH 字 段 表示 第 一 个 月 ， 一 年 的 公历 和 罗 
马 儒 略 万 中 的 值 。 


static int JULY -- 这 是 一 个 MONTH 字 段 表 示 第 七 个 月 当年 在 格 里 高 利 历 和 罗马 
癸 略 历 中 的 值 。 


static int JUNE -- 这 是 一 个 MONTH 字 段 表 明了 第 六 个 月 ， 一 年 的 公历 和 罗马 
TR 77; FRE S 


static int LONG -- 这 是 风格 说 明 符 getDisplayName 和 getDisplayNames 表 示 长 
的 名 字 ， 如 “January”。 


static int MARCH -- 这 是 一 个 MONTH 字 段 指 示 第 三 个 年 度 在 格 里 高 利 历 和 罗 
马 儒 略 万 中 的 值 。 


static int MAY -- 这 是 一 个 MONTH 字 段 表 示 第 五 个 月 当年 在 格 里 高 利 历 和 罗马 
儒 略 历 中 的 值 。 


static int MILLISECOND -- 这 是 字段 数 get 和 set 指示 第 二 内 毫秒 。 
static int MINUTE -- 这 是 字段 数 get 和 set 指示 一 小 时 中 的 分 钟 。 
static int MONDAY -- ix &&DAY OF WEEK 字段 的 说 明 周 一 的 值 。 
static int MONTH -- 这 是 字段 数 为 get 和 set， 指 示 一 个 月 。 


static int NOVEMBER -- 这 是 一 个 MONTH 字 段 指示 第 十 一 个 月 当年 在 格 里 高 
利 历 和 罗马 儒 略 历 中 的 值 。 


static int OCTOBER -- 这 是 一 个 MONTH 字 段 指 示 第 十 一 个 月 ， 一 年 中 的 格 里 
高 利 历 和 罗马 儒 略 万 中 的 值 。 


static int PM -- 这 是 AM_PM 字 段 中 的 指示 当天 的 期 限 从 中 午 到 午夜 前 的 值 。 
static int SATURDAY -- ix DAY OF _ WEEK 字段 的 指示 周 六 的 值 。 
static int SECOND -- 这 是 字段 数 get 和 set 指 示 一 分 钟 中 的 秒 。 


static int SEPTEMBER -- 这 是 一 个 MONTH 字 段 表 示 第 九 个 月 当年 在 格 里 高 利 
历 和 罗马 儒 略 历 中 的 值 。 


static int SHORT -- 这 是 风格 说 明 符 getDisplayName 和 getDisplayNames 显 示 
一 个 简短 的 名 称 ， 如 "Jan"。 


static int SUNDAY -- 这 是 DAY_OF_WEEK 字 上 段 的 说 明 周 日 的 值 。 
static int THURSDAY -- 这 是 DAY_OF_WEEK 字 上 段 的 说 明 周 四 的 值 。 


protected long time -- 这 是 当前 设置 的 时 间 ， 这 个 日 历 ， 以 毫秒 表示 1970 年 1 
月 1 日 ，0:00:00 GMT 之 后 。 


static int TUESDAY -- 这 是 DAY_OF_WEEK 字 上 段 的 说 明星 期 二 的 值 。 
static int UNDECIMBER -- 这 是 一 个 MONTH 字 段 指示 一 年 第 十 三 个 月 的 值 。 
static int WEDNESDAY -- 这 是 DAY_OF WEEK 字段 说 明 周 三 的 值 。 


static int WEEK_OF_MONTH -- 这 是 字段 数 为 GET 和 SET， 指 示 当 前 月 中 的 星 
期 数 。 


static int WEEK OF. YEAR -- 这 是 字段 数 为 GET 和 SET， 表 示 在 本 年 度 内 的 周 


o o 


e static int YEAR -- lg ile UR 
e static int ZONE OFFSET -- 这 是 字段 数 为 GET 和 SET 指示 原 与 GMT 以 富 秒 为 
单位 的 偏 移 。 
~ SHE T7 M 
类 构造 回 数 
S.N. 构造 函数 & 描述 
protected Calendar() 这 个 构造 本 数 构造 一 个 日 历 使 用 默认 时 区 和 语言 
环境 。 
2 protected Calendar(TimeZone zone, Locale aLocale) 这 个 构造 画 数 


构造 一 个 日 历 指定 的 时 区 和 话 言 环境 。 


TutorialsPoint Java 技术 教程 


类 方法 
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方法 & 描述 


abstract void add(int field, int amount) 此 方法 添加 或 减 去 指定 的 时 间 
量 ， 以 给 定 日 历 字 段 ， 基 于 日 历 的 规则 。 


boolean after(Object when) 这 个 方法 返回 当前 日 历 是 否 代 表 在 指定 
Object 表示 的 时 间 之 后 的 时 间 。 


boolean before(Object when) 这 个 方法 返回 当前 日 历 是 否 代表 在 指定 
Object 表 示 的 时 间 之 前 的 时 间 。 


void clear() 此 方法 设置 此 Calendar 的 所 有 日 历 字 段 值 和 时 间 值 (毫秒 从 
历 元 至 偏 移 量 ) 未 定义 。 


void clear(int field) 此 方法 设置 给 定 日 历 字 段 值 和 本 日 历 不 确定 的 时 间 值 
(sb M mc AER). 


Object clone() 此 方法 创建 并 返回 此 对 象 的 一 个 副本 。 


int compareTo(Calendar anotherCalendar) 这 个 方法 比较 两 个 Calendar 
对 象 表 示 的 时 间 值 (从 历 元 至 毫秒 偏 移 量 ) 。 


protected void complete() 此 方法 填充 在 日 历 字 段 中 所 有 未 设置 的 字 


段 。 


protected abstract void computeFields() 这 种 方法 的 当前 毫秒 时 间 值 时 
间 日 历 fields[] 字 段 值 转换 。 


protected abstract void computeTime() 这 种 方法 在 fields[] 到 毫秒 的 时 间 
值 时 将 转换 当前 日 历 字 段 值 。 


boolean equals(Object obj) 这 个 方法 这 个 日 历 比 较 指 定 的 对 象 。 
int get(int field) 此 方法 返回 给 定 日 历 字 段 的 值 。 


int getActualMaximum(int field) 此 方法 返回 指定 日 历 字段 可 能 拥有 的 最 
大 值 ， 鉴 于 此 Calendar 时 间 值 。 


int getActualMinimum(int field) 此 方法 返回 指定 日 历 字段 可 能 拥有 的 最 
小 值 ， 鉴 于 此 Calendar 时 间 值 。 


static Locale[] getAvailableLocales() 此 方法 返回 所 有 语言 环境 ， 它 由 此 
类 的 getlnstance 方 法 可 为 之 返回 本 地 化 实例 的 数组 。 


String getDisplayName(int field, int style, Locale locale) 此 方法 返回 的 
日 历 字 段 值 在 给 定 的 风格 和 语言 环境 的 字符 串 表 示 形 式 。 
Map<String,Integer> getDisplayNames(int field, int style, Locale locale) 
这 个 方法 返回 一 个 Map 包 含 日 历 字 段 在 给 定 的 风格 和 语言 环境 和 相应 的 
字段 值 的 所 有 名 称 。 


int getFirstDayOfWeek() 这 种 方法 得 到 一 周 的 第 一 天 是 什么 ;例如 ， 在 美 
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18 国 为 SUNDAY， 在 法 国 为 MONDAY。 


abstract int getGreatestMinimum(int field) 此 方法 返回 此 Calendar 实 例 


19 给 定 日 历 字段 的 最 高 的 最 小 值 。 
static Calendar getlnstance() 使 用 默认 时 区 和 语言 环境 这 种 方法 获得 一 

20MM EE 

EIC 

21 static Calendar getlnstance(Locale aLocale) 使 用 默认 时 区 和 指定 的 区 
域 设置 此 方法 获取 一 个 日 历 。 

22 static Calendar getlnstance(TimeZone zone) 使 用 指定 的 时 区 和 默认 语 
言 环境 这 种 方法 得 到 一 个 日 历 。 

23 static Calendar getInstance(TimeZone zone, Locale aLocale) 这 种 方法 
得 到 一 个 日 历 指定 的 时 区 和 语言 环境 。 

24 abstract int getLeastMaximum(int field) 此 方法 返回 此 Calendar 实 例 给 
定 日 历 字 段 的 最 低 的 最 大 值 。 

25 abstract int getMaximum(int field) 此 方法 返回 此 Calendar 实 例 给 定 日 历 


字段 的 最 大 值 。 


int getMinimalDaysInFirstWeek() 这 种 方法 得 到 什么 在 今年 的 第 一 个 星 
26 期 所 需 的 最 少 天 数 ;例如 ， 如 果 第 一 周 被 定义 为 一 个 包含 在 第 一 个 月 的 一 
FRE- A, DARE 


abstract int getMinimum(int field) 此 方法 返回 此 Calendar 实 例 给 定 日 历 


27 字段 的 最 小 值 。 
28 Date getTime() 此 方法 返回 表示 此 Calendar 的 时 间 值 (从 历 元 至 “毫秒 偏 


移 量 ) 的 Date 对 象 。 

29 long getTimelnMillis() 该 方法 以 毫秒 为 单位 返回 此 Calendar 的 时 间 值 。 
30 TimeZone getTimeZone() 这 种 方法 获取 的 时 区 。 

31 int hashCode() 此 方法 返回 此 日 历 的 哈 希 码 。 

32 protected int internalGet(int field) 此 方法 返回 给 定 日 万 字段 的 值 。 

33 boolean isLenient() 这 个 方法 告诉 日 期 /时 间 的 解释 是 否 是 宽松 的 。 
boolean isSet(int field) 此 方法 可 确定 给 定 日 历 字 段 的 值 集 ， 包 括 案 件 的 


34 “和 值 被 设置 由 一 个 get 方 法 调用 触发 内 部 字段 计算 

35 abstract void roll(int field, boolean up) 此 方法 添加 或 减 去 (E/F) 的 时 
候 一 个 单元 在 给 定 的 时 间 字 段 不 更 改 更 大 的 字段 。 

36 void roll(int field, int amount) 此 方法 将 指定 的 (签署 ) 金额 至 指定 日 万 


字段 不 更 改 更 大 的 字段 。 
37 void set(int field, int value) 此 方法 设置 给 定 日 历 字段 为 给 定 值 。 
void set(int year, int month, int date) 此 方法 设置 为 日 历 字段 的 值 YEAR, 
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MONTH, and DAY OF MONTH.. 
void set(int year, int month, int date, int hourOfDay, int minute) 此 方法 


39 设置 为 日 万字 段 的 值 YEAR, MONTH, DAY. OF MONTH, 
HOUR OF. DAY, 和 MINUTE. 
void set(int year, int month, int date, int hourOfDay, int minute, int 

40 second) 此 方法 设置 的 字段 的 值 YEAR, MONTH, DAY. OF. MONTH, 
HOUR, MINUTE, 和 SECOND. 

41 void setFirstDayOfWeek(int value) 此 方法 设置 一 周 的 第 一 天 是 什么 ; 例 
如 ， 在 美国 为 SUNDAY， 在 法 国 为 MONDAY。 

42 void setLenient(boolean lenient) 此 方法 规定 日 期 /时 间 的 解释 是 否 是 宽 
松 的 。 
void setMinimalDaysInFirstWeek(int value) 此 方法 设置 在 哪 一 年 中 第 一 

43 个 星期 所 需 的 最 少 天 数 ;例如 ， 如 果 在 第 一 周 被 定义 为 一 个 包含 在 第 一 个 
月 的 一 年 的 第 一 天 ， 传 值 调 用 这 个 方法 。 

44 void setTime(Date date) 此 方法 设置 此 Calendar 时 间 与 给 定 的 日 期 。 

45 void setTimelnMillis(long millis) 这 个 方法 从 给 定 的 long 值 设置 此 
Calendar 的 当前 时 间 。 

46 void setTimeZone(TimeZone value) 此 方法 使 用 给 定 的 时 区 值 设置 时 
区 。 

47 String toString() 此 方法 返回 此 日 历 的 字符 串 表 示 形 式 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


Java.util.Calendar# - Java.util 包 
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java.util.Collections 类 专门 由 操作 上 或 返回 集合 的 静态 方法 。 以 下 是 关于 集合 的 要 


VAN 


e 它 包含 在 collection 上 , “包装 "， 它 会 返回 一 个 新 的 集合 由 一 个 指定 的 集合 操作 
支持 多 态 算法 。 


e. 这 个 类 的 方法 都 抛 出 NullPointerException 如 果 提 供给 他 们 的 集合 或 类 对 象 为 
null, 


ET + 
类 的 声明 
以 下 是 java.util.Collections 类 的 声明 : 


public class Collections 
extends Object 


ri * 

字段 域 

以 下 是 java.util.Collections 类 中 的 字段 : 
e static List EMPTY LIST -- 这 是 一 个 空 的 列表 (不 可 变 )。 
e static Map EMPTY MAP -- 这 是 空 映 射 (不 可 变 )。 
e static Set EMPTY SET -- 这 是 空 集 (不 可 变 )。 


类 方法 


S.N. 方法 & 描述 

static <T> boolean addAll(Collection<? super T> c, T... elements) 这 个 
方法 会 将 所 有 指定 的 元 素 到 指定 的 集合 。 

static <T> Queue<T> asLifoQueue(Deque<T> deque) 此 方法 返回 一 个 
deque 的 视图 ， 作 为 一 个 后 进 先 出 (LIFO) 队 列 。 


static <T> int binarySearch(List<? extends Comparable<? super T>> 


list, T key) 此 方法 搜索 指定 列表 ， 使 用 二 进 制 搜索 算法 来 指定 对 象 。 


static <T> int binarySearch(List<? extends T> list, T key, 
4 Comparator<? super T< c) 此 方法 搜索 指定 列表 ， 使 用 二 进 制 搜索 算法 
来 指定 对 象 。 


1 
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static «E» Collection<E> checkedCollection(Collection<E> c, 


? ClasscE» type) 此 方法 返回 指定 集合 的 动态 类 型 安全 视图 。 

6 static <E> List<E> checkedList(List<E> list, Class<E> type) 此 方法 返 
回 指定 列表 的 一 个 动态 类 型 安全 视图 。 
static «K, V» Map<K,V> checkedMap(Map<k,V> m, Class<K> 

7 keyType, Class<V> valueType) 此 方法 返回 指定 映射 的 一 个 动态 类 型 安 
全 视图 。 

8 static <E> Set<E> checkedSet(Set<E> s, Class<E> type) 此 方法 返回 


指定 set 的 一 个 动态 类 型 安全 视图 。 


static <K,V> SortedMap«K,V» checkedSortedMap(SortedMap<k,V> 
9 m, Class<K> keyType, Class<V> valueType) 此 方法 返回 指定 有 序 映 射 
的 一 个 动态 类 型 安全 视图 。 


static <E> SortedSet<E> checkedSortedSet(SortedSet<E> s, 
Class<E> type) 此 方法 返回 指定 有 序 set 的 一 个 动态 类 型 安全 视图 。 


11 static <T> void copy(List<? super T> dest, List<? extends T> src) 这 个 


方法 会 料 所 有 从 一 个 列表 中 的 元 素 到 另 一 个 。 


static boolean disjoint(Collection<?> c1, Collection«?» c2) 如 果 两 个 指 
定 collection 中 没有 相同 的 元 素 此 方法 返回 true。 


13 static <T> List<T> emptyList() 此 方法 返回 空 列表 (不 可 变 ) 。 
14 static <K,V> Map<K,V> emptyMap() 此 方法 返回 空 映射 (不 可 变 ) 。 
15 static «T» Set<T> emptySet() 此 方法 返回 空 集 (不 可 变 ) 。 


16 static <T> Enumeration<T> enumeration(Collection<T> c) 此 方法 返回 
一 个 枚 举 在 指定 的 collection。 


static «T» void fill(List<? super T» list, T obj) 此 方法 替换 所 有 指定 的 列 


I 胡 中 具有 指定 元 素 的 元 素 。 
18 static int frequency(Collection«?» c, Object o) 此 方法 返回 指定 元 素 集 


合 等 于 指定 对 象 的 数量 。 


static int indexOfSubList(List<?> source, List<?> target) 此 方法 返回 指 
19 EL DUE ee ee 或 者 -1， 如 果 没 
发 生 。 


static int lastlndexOfSubList(List«?» source, List<?> target) 此 方法 返 
20 回 指定 目标 列表 的 最 后 出 现 的 起 始 位 置 指定 源 列表 中 ， 或 者 -1， 如 果 没 
有 发 生 。 


static <T> ArrayList<T> list(Enumeration<T> e) 此 方法 返回 包含 由 指定 


21 枚 举 它们 是 由 枚 欠 返 回 的 顺序 返回 元 素 的 数组 列表 。 
static <T extends Object & Comparable<? super T> >T 
22 max(Collection<? extends T> coll) 此 方法 返回 给 定 collection 的 最 大 元 
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素 ， 根 据 其 元 素 的 自然 顺序 。 


static <T> T max(Collection<? extends T> coll, Comparator<? super 
23 T» comp) 此 方法 返回 给 定 collection 的 最 大 元 素 ， 根 据 诱 发 指定 的 比较 
器 的 顺序 。 


static <T extends Object & Comparable<? super T>>T 


24 min(Collection<? extends T> coll) 这 个 方法 返回 给 定 collection 的 最 小 元 
素 ， 根 据 其 元 素 的 自然 顺序 。 


static <T> T min(Collection<? extends T> coll, Comparator<? super T> 
25 comp) 此 方法 返回 给 定 collection 的 最 小 元 素 ， 根 据 诱发 指定 的 比较 器 的 
顺序 。 


static «T» List<T> nCopies(int n, T o) 此 方法 返回 一 个 不 可 变 列表 组 成 


76 的 n 个 拷贝 的 指定 对 象 

27 static «E» Set<E> newSetFromMap(Map<E,Boolean> map) 此 方法 返 
回 一 组 由 指定 映射 支持 。 

28 static <T> boolean replaceAll(List<T> list, T oldVal, T newVal) 这 种 方 


法 取代 了 和 与 另 一 个 列表 中 的 一 个 指定 值 的 所 有 匹配 。 
29 static void reverse(List<?> list) 这 种 方法 将 反 转 元 素 的 顺序 指定 列表 
static <T> Comparator<T> reverseOrder() 此 方法 返回 一 个 比较 器 ， 它 


30 强行 上 实现 Comparable 接 口 的 对 象 的 集合 的 自然 顺序 相反 。 

34 static <T> Comparator<T> reverseOrder(Comparator<T> cmp) 此 方法 
返回 一 个 比较 器 ， 它 强行 指定 比较 器 的 反 向 排序 。 

30 static void rotate(List<?> list, int distance) 此 方法 通过 指定 的 距离 旋转 
指定 列表 中 的 元 素 。 

33 static void shuffle(List<?> list) 此 方法 随机 进行 置换 使 用 随机 性 的 默认 源 
中 指定 的 列表 。 

34 static void shuffle(List<?> list, Random rnd) 此 方法 随机 排列 使 用 随机 
指定 源 指定 的 列表 。 

35 static «T» Set<T> singleton(T o) 此 方法 返回 一 个 不 可 变 的 集 只 包含 指 
定 对 象 。 

36 static <T> List<T> singletonList(T o) 此 方法 返回 一 个 只 包含 指定 对 象 的 
不 可 变 列表 。 

37 static <K,V> Map<K,V> singletonMap(K key, V value) 此 方法 返回 一 个 
不 可 变 的 映射 ， 映 射 只 有 指定 的 键 为 指定 的 值 。 

38 static <T extends Comparable<? super T>> void sort(List<T> list) 这 种 
方法 对 指定 列表 按 升序 顺序 ， 根 据 其 元 素 的 自然 顺序 。 

39 static <T> void sort(List<T> list, Comparator<? super T> c) 根据 诱导 由 


指定 比较 器 的 顺序 这 种 方法 排序 指定 列表 。 
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40 static void swap(List<?> list, int i, int j) 这 个 方法 在 交换 指定 列表 中 指定 
位 置 的 元 素 。 


44 static «T» Collection<T> synchronizedCollection(Collection<T> c) 这 个 


方法 返回 一 个 同步 的 (线程 安全 的 ) 集合 的 指定 集合 的 支持 。 
static <T> List<T> synchronizedList(List<T> list) 此 方法 返回 由 指定 列 


““ 表 支 持 的 同步 (线程 安全 的 ) 列表 。 

43 static <K,V> Map<K,V> synchronizedMap(Map<K,V> m) 这 个 方法 返回 
一 个 同步 的 (线程 安全 ) 地 图 由 指定 映射 支持 。 

44 static <T> Set<T> synchronizedSet(Set<T> s) 这 个 方法 返回 一 个 同步 


的 (线程 安全 的 ) 集 由 指定 set 支 持 。 


static <K,V> SortedMap<K,V> 
45 synchronizedSortedMap(SortedMap<K,V> m) 这 个 方法 返回 一 个 同步 
的 (线程 安全 的 ) 有 序 映射 所 指定 的 有 序 映射 支持 。 


static <T> SortedSet<T> synchronizedSortedSet(SortedSet<T> s) 这 


46 个 方法 返回 一 个 同步 的 〈 线 程 安全 的 ) 有 序 set 由 指定 的 有 序 set 支 持 。 

47 static <T> Collection<T> unmodifiableCollection(Collection<? extends 
T> c) 此 方法 返回 指定 collection 的 不 可 修改 视图 。 

48 static <T> List<T> unmodifiableList(List<? extends T> list) 此 方法 返回 
指定 列表 的 不 可 修改 视图 。 

49 static <K,V> Map<K,V> unmodifiableMap(Map<? extends K,? extends 
V> m) 此 方法 返回 指定 映射 的 不 可 修改 视图 。 

50 static <T> Set<T> unmodifiableSet(Set<? extends T> s) 此 方法 返回 指 


定 集合 的 不 可 修改 视图 。 


static <K,V> SortedMap«K,V» 
51 unmodifiableSortedMap(SortedMap«K,? extends V» m) 此 方法 返回 指 
定 有 序 映射 的 不 可 修改 视图 


static <T> SortedSet<T> unmodifiableSortedSet(SortedSet<T> s) 此 方 


52 法 返回 指定 有 序 集合 不 可 修改 视图 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 
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java.util.Currency 类 代表 货币 。 下 面 是 有 关 货 币 的 要 点 : 
e 货币 是 通过 它们 的 |SO4217 货 币 人 代码。 
e 类 的 设计 ， 使 从 未 有 任何 给 定 的 货币 多 于 一 个 Currency 实 例 ， 这 是 背后 没有 公 
共 的 构造 画 数 的 原因 。 


ay + 
类 的 声明 
以 下 是 声明 了 java.util.Currency 类 : 


public final class Currency 
extends Object 
implements Serializable 


类 方法 


S.N. 方法 & 描述 

1 String getCurrencyCode() ILA 2& 3k Hub K f 91804217 k m (V3, 

2 int getDefaultFractionDigits() 此 方法 得 到 的 分 数 与 此 货币 使 用 的 缺 省 小 
数位 数 。 

3 static Currency getinstance(Locale locale) 此 方法 返回 给 定语 言 环境 的 
国家 的 货币 实例 。 

4 static Currency getlnstance(String currencyCode) 此 方法 返回 给 定货 征 


代码 的 Currency 实 例 。 
5 String getSymbol() 此 方法 获取 此 货币 的 符号 为 默认 语言 环境 。 


6 String getSymbol(Locale locale) 此 方法 获取 此 货 币 的 符号 为 指定 的 语言 
环境 。 


7 String toString() 此 方法 返回 此 货币 的 ISO4217 货 币 代 码 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.Date # - Java.utila 
java.util.Date 类 表示 某 一 特定 时 刻 ， 精 确 到 毫秒 。 
类 的 声明 

以 下 是 java.util.Date 类 的 声明 : 


public class Date 
extends Object 
implements Serializable, Cloneable, Comparable<Date> 


类 构造 融 数 
S.N. HSH & 描述 


1 Date() 这 个 构造 阔 数 分 配 一 个 Date 对 象 并 将 它 初始 化 ， 使 它 表 示 其 被 分 
配 的 时 间 ， 精 确 到 坚 秒 。 


Date(long date) 这 个 构造 画 数 分 配 一 个 Date 对 象 并 初始 化 它 代 表 指 定 
2 的 毫秒 数 ， 因 为 被 称 为 "纪元 "”， 即 1970 年 1 月 1 日 00:00:00 GMT 标 准 基准 
时 间 。 
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nO 


方法 & 描述 
boolean after(Date when) 此 方法 测试 ， 此 日 期 是 否 在 指定 日 期 之 后 。 
boolean before(Date when) 此 方法 测试 ， 此 日 期 是 否 在 指定 日 期 之 前 。 
Object clone() 此 方法 返回 此 对 象 的 一 个 副本 。 
int compareTo(Date anotherDate) 此 方法 比较 两 个 日 期 的 顺序 。 
boolean equals(Object obj) 此 方法 比较 两 个 日 期 是 否 相等 。 


long getTime() 此 方法 返回 自 1970 年 1 月 1 日 00:00:00 GMT 此 Date 对 象 
RTEA. 


int hashCode() 此 方法 返回 此 对 象 的 哈 希 码 值 。 


void setTime(long time) 此 方法 设置 此 Date 对 象 1970 年 1 月 1 日 00:00:00 
GMT 以 后 ， 代 表 一 个 时 间 点 time 写 秒 。 


String toString() 此 方法 此 Date 对 象 转换 为 形式 的 字符 串 。 


方法 继承 


这 个 类 继承 自 以 下 类 方法 : 


e java.util.Object 


/ 
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java.util.Dictionary 类 是 任何 类 的 抽象 父 类 ， 如 哈 希 表 ， 其 中 键 映 射 到 相应 的 值 。 
以 下 是 关于 字典 的 要 点 : 


e 在 这 个 类 中 的 每 个 键 ， 每 个 值 都 是 一 个 对 象 。 

。 在 这 个 类 的 对 象 的 每 个 键 与 最 多 只 有 一 个 值 相关 联 。 
类 声明 
以 下 是 java.util.Dictionary 类 的 声明 : 


public abstract class Dictionary<K, V> 
extends Object 


3 Mg ERA 
S.N DERA & 描述 
1 Dictionary() 这 是 一 个 构造 画 数 。 
类 方法 
S.N. 方法 & 描述 
abstract Enumeration<V> elements() 这 种 方法 在 这 个 字典 中 返回 枚 举 
值 。 
2 abstract V get(Object key) 此 方法 返回 到 该 键 所 映射 在 这 个 字典 中 的 
值 。 
3 abstract boolean isEmpty() 如 果 这 此 字典 是 否 有 键 映 射 到 的 值 的 方法 测 
试 。 
4 abstract Enumeration<K> keys() 此 方法 返回 这 个 字典 中 的 键 的 枚 举 。 
5 abstract V put(K key, V value) 这 种 方法 映射 到 指定 键 在 此 字典 中 指定 
的 值 。 
6 abstract V remove(Object key) 这 个 方法 从 这 个 字典 中 删除 键 (及 其 相应 
的 值 )。 


7 abstract int size() 此 方法 在 此 字典 返回 条 目的 数量 (不 同 的 键 )。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.EnumMap X - Java.util 包 
java.util.EnumMap 类 是 一 种 专门 Map 实 现 与 枚 举 键 的 使 用 。 以 下 是 有 关 
EnumMap 要 点 : 

。 所 有 在 枚 举 映 射 的 键 都 必须 来 自 所 指定 ， 或 明 或 旱地 ， 创 建 映射 的 时 候 一 个 枚 


举 类 型 。 
。 枚 举 映射 保持 在 其 键 的 自然 顺序 。 
e EnumMap 是 不 同步 的 。 如 果 多 个 线程 同时 访问 一 个 榴 举 映射 并 发 和 线程 中 的 
至 少 一 个 修改 的 映射 ， 它 应 该 保持 外 部 同步 。 
类 声明 
以 下 是 java.util.EnumMap 类 的 声明 : 


public class EnumMap<K extends Enum<K>,V> 
extends AbstractMap<k, V» 
implements Serializable, Cloneable 


x Jp EROR 
S.N. Wis HR & 描述 
1 EnumMap(Class<K> keyType) IL 143& WX 6) 2S 6 TR XE 4t kB 
枚 举 映射 。 


EnumMap(EnumMap<K,? extends V» m) 此 构造 函数 创建 有 具有 相同 
2 的 键 类 型 与 指定 枚 举 映射 的 枚 举 映射 ， 最 初 包含 相同 的 映射 关系 (如 果 有 
Bi). 


3 EnumMap(Map«K,? extends V» m) Hby ERAM TE RE BUB ESTE SE TT 
初始 化 创建 一 个 枚 举 映射 。 
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S.N. 方法 & 描述 
1 void clear() 此 方法 从 此 映射 删除 所 有 了 映射。 
2 EnumMap<K,V> clone() 此 方法 返回 此 枚 举 映射 的 浅 表 副本 。 


3 boolean containsKey(Object key) 如 果 此 映射 包含 指定 键 的 映射 此 方法 
返回 true。 


boolean containsValue(Object value) 如 果 此 映射 一 个 或 多 个 键 映 射 到 


^ 指定 值 ， 该 方法 返回 true。 
5 Set<Map.Entry<K,V>> entrySet() 此 方法 返回 此 映射 中 包含 的 映射 关系 


的 Set 视 图 。 
6 boolean equals(Object o) 此 方法 将 指定 对 象 与 此 映射 比较 是 否 相 等 。 


7 V get(Object key) 这 个 方法 返回 指定 键 所 映射 的 值 ， 或 者 null， 如 果 此 
映射 不 包含 该 键 。 


8 Set<K> keySet() 此 方法 返回 此 映射 中 包含 的 键 的 Set 视 图 。 
9 V put(K key, V value) 这 种 方法 与 关联 此 映射 中 的 指定 键 指定 的 值 。 


void putAll(Map<? extends K,? extends V» m) 这 种 方法 将 所 有 从 指定 
映射 此 映射 中 的 映射 。 


1 V remove(Object key) 此 方法 从 该 映射 删除 映射 为 这 个 键 ， 如 果 存 在 的 
tho 


12 int size() 此 方法 返回 键 - 值 映射 关系 在 映射 的 大 小 。 


Collection<V> values() 此 方法 返回 此 映射 中 包含 的 值 的 Collection 视 
图 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractMap 


e java.util.Object 


java.util.EnumMap # - Java.util@ 1396 


java.util.EnumSet X - Java.utila 
java.util.EnumSet 类 是 一 种 专门 设置 实现 与 枚 举 类 型 的 使 用 。 以 下 是 关于 
EnumSet 这 重要 的 几 点 : 


e 所 有 的 枚 举 set 的 元 素 必 须 来 自 指定 的 ， 或 明 或 暗 地 ， 在 创建 时 设置 一 个 枚 举 类 
型 。 


e 枚 举 set 在 内 部 表示 为 位 向 量 。 
。 EnumSet 是 不 同步 的 。 如 果 多 个 线程 同时 访问 一 个 枚 举 同时 设置 ， 并 且 至 少 有 
一 个 线程 修改 的 设置 ， 它 应 该 保持 外 部 同步 。 
类 声明 
以 下 是 java.util.EnumSet 类 的 声明 : 


public abstract class EnumSet<E extends Enum<E>> 
extends AbstractSet<E> 
implements Cloneable, Serializable 
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S.N. 方法 & 描述 


static <E extends Enum<E>> EnumSet<E> allOf(Class<E> 
1 elementType) 此 方法 创建 一 个 包含 所 有 在 指定 元 素 类 型 的 元 素 的 枚 举 
set, 


2 EnumSet<E> clone() 此 方法 返回 这 个 集合 的 一 个 副本 。 


static <E extends Enum<E>> EnumSet<E> 
3 complementOf(EnumSet<E> s) 此 方法 创建 一 个 枚 举 设 置 相同 的 元 素 类 
型 与 指定 枚 举 set， 最 初 包含 此 类 型 的 所 有 未 包含 指定 集合 中 的 元 素 。 


4 static <E extends Enum<E>> EnumSet<E> copyOf(Collection<E> c) 
此 方法 创建 一 个 枚 举 集 从 指定 集合 初始 化 。 
static <E extends Enum<E>> EnumSet<E> copyOf(EnumSet<E> s) 此 

5 方法 创建 一 个 枚 举 设 置 相 同 的 元 素 类 型 与 指定 枚 举 set， 最 初 包含 相同 的 
元 素 (如 果 有 的 话 ) 。 

6 static <E extends Enum<E>> EnumSet<E> noneOf(Class<E> 
elementType) 此 方法 创建 一 个 空 的 枚 举 set 具 有 指定 元 素 类 型 。 


static «E extends Enum<E>> EnumSet<E> of(E e) 此 方法 创建 一 个 最 


和 ” 初 包 含 指定 元 素 的 枚 举 set。 

8 static <E extends Enum<E>> EnumSet<E> of(E first, E... rest) 此 方法 
创建 一 个 最 初 包含 指定 元 素 的 枚 举 set。 

9 static <E extends Enum<E>> EnumSet<E> of(E e1, E e2) 此 方法 创建 
一 个 最 初 包含 指定 元 素 的 枚 举 set。 

10 static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3) 此 方 
法 创建 一 个 最 初 包含 指定 元 素 的 枚 举 set。 

44 static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4) 
此 方法 创建 一 个 最 初 包含 指定 元 素 的 枚 举 set。 

12 static «E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4, 
E e5) 此 方法 创建 一 个 最 初 包含 指定 元 素 的 枚 举 set。 

13 static <E extends Enum<E>> EnumSet<E> range(E from, E to) 此 方法 


创建 最 初 包含 由 两 个 指定 端点 所 定义 范围 的 元 素 的 枚 举 set。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractSet 
e java.util.AbstractCollection 


e java.util.Object 


java.util.EnumSet 3: - Java.utila 1398 
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e java.util.Set 


java.util.EnumSet # - Java.util 包 1399 


java.util.Formatter # - Java.util@ 


java.util.Formatter 类 提供 了 布局 合理 性 和 对 齐 方式 ， 常 见 格式 为 数字 ， 字 符 串 和 
日 期 /时 间 数 据 ， 以 及 语言 环境 的 输出 的 支持 。 以 下 是 关于 格式 化 要 点 : 


e 格式 化 并 不 一 定 是 安全 的 多 线程 访问 。 线 程 安 全 是 可 选 的， 在 这 个 类 方法 由 用 
户 自己 定义 。 
类 声明 
以 下 是 java.util.Formatter 类 的 声明 : 


public final class Formatter 
extends Object 
implements Closeable, Flushable 


类 构造 画 数 


+ 


S.N. 


HSH & 描述 
Formatter() 这 个 构造 画 数 构造 一 个 新 的 格式 化 。 


Formatter(Appendable a) 这 个 构造 函数 构造 一 个 新 的 格式 化 与 指定 的 
目标 。 


Formatter(Appendable a, Locale |) 这 个 构造 本 数 构造 一 个 新 的 格式 
化 与 指定 的 目标 和 话 言 环境 。 


Formatter(File file) 这 个 构造 男 数 构造 一 个 新 的 格式 化 与 指定 的 文件 。 


Formatter(File file, String csn) 这 个 构造 男 数 构造 一 个 新 的 格式 化 与 
指定 文件 和 字符 集 。 


Formatter(File file, String csn, Locale I) ix 4 443& WA HIS — THY 
格式 化 与 指定 的 文件 ， 字 符 集 和 语言 环境 。 


Formatter(Locale 1) 这 个 构造 范 数 构造 一 个 新 的 格式 化 与 指定 的 语言 环 


境 。 
Formatter(OutputStream os) 这 个 构造 画 数 构造 一 个 新 的 格式 化 与 指 
定 的 输出 流 。 


Formatter(OutputStream os, String csn) 这 个 构造 男 数 构造 一 个 新 的 
格式 化 与 指定 的 输出 流 和 字符 集 。 


Formatter(OutputStream os, String csn, Locale I) ix #45 WA 


造 一 个 新 的 格式 化 与 指定 的 输出 流 ， 字 符 集 和 语言 环境 。 
Formatter(PrintStream ps) 这 个 构造 函数 构造 一 个 新 的 格式 化 与 指定 


的 打印 流 。 
Formatter(String fileName) 这 个 构造 男 数 构造 一 个 新 的 格式 化 与 指定 
的 文件 名 。 


Formatter(String fileName, String csn) 这 个 构造 男 数 构造 一 个 新 的 格 
式 化 与 指定 的 文件 名 和 字符 集 。 


Formatter(String fileName, String csn, Locale I) 这 个 构造 画 数 构造 


一 个 新 的 格式 化 与 指定 的 文件 名 ， 字 符 集 和 放言 环境 。 


[utorialsPoint Java fx xt 


S.N. 方法 & 描述 
1 void close() 此 方法 关闭 此 格式 化 程序 。 
2 void flush() 这 个 方法 刷新 此 格式 化 程序 。 


Formatter format(Locale |, String format, Object... args) 此 方法 写 入 一 
3 个 格式 化 字符 串 使 用 指定 的 语言 环境 ， 格 式 字 符 串 和 参数 ， 此 对 象 的 目 


标 。 


Formatter format(String format, Object... args) 此 方法 写 入 一 个 格式 化 


4 字符 串 使 用 指定 格式 字符 串 和 参数 此 对 象 的 目标 。 
5 IOException ioException() 此 方法 返回 的 最 后 一 个 IOException 异 常 被 抛 


出 此 格式 化 程序 的 附加 。 

6 Locale locale() 这 个 方法 返回 locale 这 个 格式 化 的 结构 设置 。 

7 Appendable out() 此 方法 返回 的 目的 地 的 输出 。 

8 String toString() 此 方法 返回 调用 toString() 方 法 在 目的 地 的 输出 结果 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.Formatter# - Java.util 包 1402 


java.util.GregorianCalendar X - Java.util 包 


java.util.GregorianCalendar 类 是 Calendar 的 一 个 具体 子 类 ， 提 供用 于 世界 上 大 多 
数 国家 的 标准 日 历 系统 。 以 下 是 关于 GregorianCalendar 的 要 点 : 


e 它 是 同时 支持 朱 利 安 和 公历 系统 的 一 个 不 连续 ， 这 相当 于 在 默认 情况 下 ， 当 公 
历 被 提起 的 公历 日 期 的 支持 混合 日 万 。 


e 儒 略 万 指定 半年 每 四 年 ， 而 公历 省 略 世纪 十 年 哪些 不 是 被 400 整 除 。 
we TE 
X Fa HH 
以 下 是 java.util.GregorianCalendar 类 的 声明 : 


public class GregorianCalendar 
extends Calendar 


字段 域 
以 下 是 java.util.GregorianCalendar 类 中 的 字段 : 
e static int AD -- 这 是 ERA 字 段 的 指示 共同 的 时 代 ( 公 元 )， 也 被 称 为 CE 的 值 。 
e static int BC -- 这 是 时 代 字 段 的 值 ， 表 示 共 同 的 时 代 之 前 的 期 间 ( 公 元 前 )， 也 被 
称 为 BCE。 


类 构造 画 数 


S.N. 


Mises & faut 


GregorianCalendar() 这 个 构造 使 用 当前 时 间 的 黑 认 时 区 与 默认 语言 环 
境 的 默认 的 GregorianCalendar。 


GregorianCalendar(int year, int month, int dayOfMonth) 这 个 构造 
一 个 GregorianCalendar 与 给 定 日 期 的 默认 时 区 设置 默认 语言 环境 。 


GregorianCalendar(int year, int month, int dayOfMonth, int 
hourOfDay, int minute) 这 个 构造 一 个 GregorianCalendar 用 给 定 的 日 
期 和 时 间 设 置 为 与 默认 语言 环境 的 默认 时 区 。 


GregorianCalendar(int year, int month, int dayOfMonth, int 
hourOfDay, int minute, int second) 这 个 构造 一 个 GregorianCalendar 
用 给 定 的 日 期 和 时 间 设 置 为 与 默认 语言 环境 的 默认 时 区 。 


GregorianCalendar(Locale aLocale) 这 构建 了 基于 当前 时 间 和 与 给 定语 
言 环境 的 默认 时 区 一 个 GregorianCalendar。 


GregorianCalendar(TimeZone zone) 这 构建 了 基于 当前 时 间 与 默认 语 
言 环境 的 给 定时 区 一 个 GregorianCalendar。 


GregorianCalendar(TimeZone zone, Locale aLocale) 这 构建 了 基于 
当前 时 间 与 给 定语 言 环境 的 给 定时 区 一 个 GregorianCalendar。 


类 方法 


S.N. 


方法 & 描述 


void add(int field, int amount) 此 方法 将 指定 (有 符号 的 ) 时 间 量 ， 以 给 定 
日 历 字段 ， 根 据 日 历 的 规则 。 


Object clone() 此 方法 创建 并 返回 此 对 象 的 一 个 副本 。 


protected void computeFields() 这 种 方法 的 时 间 值 (毫秒 从 历 元 至 偏 移 
量 )， 以 日 历 字段 值 转 换 。 


protected void computeTime() 这 种 方法 日 历 字段 值 转换 为 时 间 值 (从 历 
TEZE) 

boolean equals(Object obj) This method compares this 
GregorianCalendar to the specified Object. 


int getActualMaximum (int field) This method returns the maximum 
value that this calendar field could have, taking into consideration the 
given time value and the current values of the getFirstDayOfWeek, 
getMinimalDayslInFirstWeek, getGregorianChange and getTimeZone 
methods. 


int getActualMinimum(int field) This method returns the minimum value 
that this calendar field could have, taking into consideration the given 
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10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


time value and the current values of the getFirstDayOfWeek, 
getMinimalDayslInFirstWeek, getGregorianChange and getTimeZone 
methods. 


int getGreatestMinimum(int field) This method returns the highest 
minimum value for the given calendar field of this GregorianCalendar 
instance. 


Date getGregorianChange() This method gets the Gregorian Calendar 
change date. 


int getLeastMaximum(int field) This method returns the lowest 
maximum value for the given calendar field of this GregorianCalendar 
instance. 


int getMaximum(int field) This method returns the maximum value for 
the given calendar field of this GregorianCalendar instance. 


int getMinimum(int field) This method returns the minimum value for 
the given calendar field of this GregorianCalendar instance. 


TimeZone getTimeZone() This method gets the time zone. 


int hashCode() This method generates the hash code for this 
GregorianCalendar object. 


boolean isLeapYear(int year) This method determines if the given year 
is a leap year. 


void roll(int field, boolean up) This method adds or subtracts (up/down) 
a single unit of time on the given time field without changing larger 
fields. 


void roll(int field, int amount) This method adds a signed amount to the 
specified calendar field without changing larger fields. 


void setGregorianChange(Date date) This method sets the 
GregorianCalendar change date. 


setTimeZone(TimeZone zone) This method sets the time zone with the 
given time zone value. 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Calendar 


e java.util.Object 


E af alAAAaesk lox zx nati AANI 
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java.util.HashMap X - Java.util@ 


java.util. HashMap 类 是 基于 哈 希 表 的 Map 接 口 的 实现 。 以 下 是 关于 HashMap 的 要 


WS ot 


个 类 不 保证 为 向 映射 的 迭代 顺序 ;特别 是 ， 它 不 保证 该 顺序 将 继续 随时 间 恒 


o 


。 这 
定 


e. 这 个 类 人 允许 null 值 和 null 键 。 
J^ —L 
类 丙 明 
以 下 是 java.util.HashMap 类 的 声明 : 


public class HashMap<K,V> 
extends AbstractMap<K, V> 
implements Map<K,V>, Cloneable, Serializable 


参数 

以 下 是 java.util.HashMap 类 中 的 参数 : 
e。K -- 这 是 映射 保持 的 键 的 类 型 。 
e. V -- 这 是 映射 值 的 类 型 。 


类 构造 本 数 
S.N. 构造 函数 & 描述 


HashMap() 此 构造 一 个 空 的 HashMap 具 有 默认 初始 容量 (16) 和 默认 
加 载 因 子 (0.75) 。 


HashMap(Collection<? extends E> c) 此 构造 一 个 空 的 HashMap 具 有 


^? 指定 的 初始 容量 和 默认 加 载 因 子 (0.75) 。 

3 HashMap(int initialCapacity, float loadFactor) 此 构造 一 个 空 的 
HashMap 具 有 指定 的 初始 容量 和 加 载 因 子 。 

4 HashMap(Map<? extends K,? extends V> m) 这 种 构造 一 个 新 的 


HashMap 中 使 用 相同 的 映射 关系 与 指定 映射 。 
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类 方法 


S.N. 方法 & 描述 

1 void clear() 此 方法 删除 所 有 来 自 此 映射 中 的 映射 。 

2 Object clone() 此 方法 返回 此 HashMap 实 例 的 浅 表 副本 ， 键 和 值 本 身 不 
被 复制 。 

3 boolean containsKey(Object key) 如 果 此 映射 包含 指定 键 的 映射 此 方法 
返回 true。 

4 boolean containsValue(Object value) 如 果 此 映射 一 个 或 多 个 键 映 射 到 
指定 值 ， 该 方法 返回 true。 

5 Set<Map.Entry<K,V>> entrySet() 此 方法 返回 此 映射 中 包含 的 映射 关系 
的 Set 视 图 。 

6 V get(Object key) 这 个 方法 返回 指定 键 所 映射 的 值 ， 或 者 null， 如 果 此 
映射 不 包含 该 键 。 

7 boolean isEmpty() 如 果 此 映射 不 包含 键 - 值 映 射 ， 此 方法 返回 true。 

8 Set<K> keySet() 此 方法 返回 此 映射 中 包含 的 键 的 Set 祝 图 。 

9 V put(K key, V value) 这 种 方法 与 关联 此 映射 中 的 指定 键 指定 的 值 。 

10 void putAll(Map<? extends K,? extends V» m) 3x SAKA HAA MB 
定 映射 此 映射 中 的 映射 。 

1 V remove(Object key) 此 方法 删除 映射 对 于 指定 的 键 从 该 映射 ， 如 果 存 
在 的 话 。 

12 int size() 此 方法 返回 键 - 值 映 射 关 系 在 这 个 映射 的 数量 。 

13 Collection<V> values() 此 方法 返回 此 映射 中 包含 的 值 的 Collection 视 
图 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.AbstractMap 


e java.util.Object 


e java.util.Map 


inva til AohKNAan 3 lava itil AANT 
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java.util.HashSet# - Java.utila 


java.util. HashSet 类 实现 Set 接 口 ， 由 哈 希 表 支持 。 以 下 是 关于 HashSet 的 要 点 : 


e 这 个 类 不 做 任何 担保 ， 以 集合 的 迭代 顺序 ;特别 是 ， 它 不 保证 该 顺序 将 继续 随时 
间 恒 定 。 


e. 此 类 人 允许 null 元 素 。 
J^ —- 
类 两 明 
以 下 是 java.util.HashSet 类 的 声明 : 


public class HashSet<E> 
extends AbstractSet<E> 
implements Set<E>, Cloneable, Serializable 


参数 


以 下 是 java.util.HashSet 类 的 参数 : 
e E-- 这 是 此 set 保 留 元 素 的 类 型 。 


类 构造 画 数 


S.N. MIs HM & 描述 
HashSet() 这 种 构造 一 个 新 的 空 集 ; 其 底层 HashMap 实 例 具有 默认 初始 


l 容量 (16) 和 加 载 因子 (0.75)。 

2 HashSet(Collection«? extends E» c) 这 个 构造 一 个 包含 指定 集合 中 的 
元 素 的 新 集 。 

3 HashSet(int initialCapacity) 这 种 构造 一 个 新 的 空 集 ; 其 底层 HashMap 
实例 具有 指定 的 初始 容量 和 默认 加 载 因子 (0.75)。 

4 HashSet(int initialCapacity, float loadFactor) 这 种 构造 一 个 新 的 空 


集 ;其 底层 HashMap 实 例 具 有 指定 的 初始 容量 和 指定 加 载 因子 。 


S.N. 方法 & 描述 
boolean add(E e) 此 方法 将 指定 的 元 素 添加 到 此 集合 ， 如 果 它 是 不 存在 


s 
o 


2 void clear() 此 方法 删除 这 个 集合 中 的 所 有 元 素 。 
3 Object clone() 此 方法 返回 此 HashSet 实 例 的 浅 表 副 本 ， 元 素 本 身 没有 复 


制 。 

4 boolean contains(Object o) 如 果 此 set 包 含 指 定 的 元 素 ， 此 方法 返回 
true。 

5 boolean isEmpty() 如 果 此 set 不 包含 元 素 ( 空 集 )， 此 方法 返回 true。 

6 lterator<E> iterator() 此 方法 返回 一 个 迭代 器 在 此 set 的 元 素 。 

7 boolean remove(Object o) 此 方法 删除 指定 的 元 素 ， 从 这 组 (如 果 存 
在 )。 


8 int size() 此 方法 返回 返回 元 素 在 此 set 数 字 ( 它 的 基数 )。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractSet 
e java.util.AbstractCollection 
e java.util.Object 


e java.util.Set 


java.util.Hashtable # - Java.utila 
java.util.Hashtable 此 类 实现 一 个 哈 希 表 ， 该 键 映 射 到 相应 的 值 。 以 下 是 关于 
Hashtable 的 要 点 : 

e 在 此 任何 非 空 的 对 象 可 以 被 用 作 键 或 值 。 


e 如 果 很 多 条 目 将 被 制作 成 一 个 Hashtable， 具 有 足够 大 的 容量 创建 它 可 允许 条 
目 被 插入 的 效率 比 让 作为 生长 所 需 的 表 它 执行 自动 再 散 列 。 


= 
Ak FAA 
DA FB java.util. Hashtable 3€ B Æ Bj : 


public class Hashtable<K, V> 
extends Dictionary<K, V> 
implements Map<K,V>, Cloneable, Serializable 


X B 135 EAR 

S.N. His aX & 描述 

1 Hashtable() 这 种 构造 一 个 新 的 空 哈 希 表 用 默认 的 初始 容量 (11) 和 加 载 因 
子 (0.75)。 

2 Hashtable(int initialCapacity) 这 种 构造 一 个 新 的 空 哈 希 表 使 用 指定 的 初 
台 容量 和 默认 加 载 因 子 (0.75)。 

3 Hashtable(int initialCapacity, float loadFactor) 这 种 构造 一 个 新 的 空 哈 希 
表 与 指定 的 初始 容量 和 指定 的 加 载 因子 。 

4 Hashtable(Map<? extends K,? extends V» t) 这 种 构造 一 个 新 的 哈 希 表 


具有 相同 的 映射 给 定 的 Map。 


TutorialsPoint Java 技术 教程 
S.N. 方法 与 说 明 
1 void clear() 此 方法 清除 这 个 哈 希 表 ， 以 便 它 不 包含 任何 键 。 
2 Object clone() 此 方法 创建 此 哈 希 表 的 浅 表 副本 。 

boolean contains(Object value) 此 方法 测试 ， 如 果 一 些 键 映射 到 该 散 列 


表 中 指定 的 值 。 

4 boolean containsKey(Object key) 如 果 指 定 的 对 象 是 该 散 列 表 中 的 一 个 
关键 此 方法 测试 。 

5 boolean containsValue(Object value) 如 果 此 哈 希 表 的 一 个 或 多 个 键 映 


射 到 这 个 值 此 方法 返回 true。 
6 Enumeration<V> elements() 此 方法 在 该 散 列 表 中 返回 值 的 枚 举 。 


7 Set<Map.Entry<K,V>> entrySet() 此 方法 返回 此 映射 中 包含 的 映射 关系 
的 Set 视 图 。 


8 boolean equals(Object o) 此 方法 将 指定 对 象 与 此 映射 的 相等 性 比较 ， 
按照 Map 接 口 的 定义 。 


9 V get(Object key) 此 方法 返回 指定 键 所 映射 的 值 ， 或 者 null， 如 果 此 映 
射 不 包含 该 键 。 


10 int hashCode() 此 方法 返回 按 在 Map 接 口 的 定义 此 Map 的 哈 希 码 值 。 
11 boolean isEmpty() 这 如 果 此 哈 希 表 没 有 映射 到 按键 值 的 方法 测试 。 
12 Enumeration<K> keys() 此 方法 返回 此 哈 希 表 中 的 键 的 枚 举 。 

13 Set<K> keySet() 此 方法 返回 此 映射 中 包含 的 键 的 Set 视 图 。 

14 V put(K key, V value) 这 种 方法 映射 到 指定 键 在 此 哈 希 表 中 指定 的 值 。 


void putAll(Map<? extends K,? extends V» t) 这 个 方法 会 将 所 有 从 指定 
映射 到 这 个 哈 希 表 的 映射 。 


16 protected void rehash() 这 种 方法 增加 的 容量 和 内 部 对 其 进行 重组 这 个 
哈 希 表 ， 以 适应 和 更 有 效 地 访问 其 条 目 。 


17 V remove(Object key) 这 个 方法 从 哈 希 表 中 删除 键 (及 其 相应 的 值 )。 
18 int size() 此 方法 返回 此 哈 希 表 中 的 键 的 数量 。 


19 String toString() 这 种 方法 在 一 组 条 目的 形式 返回 此 Hashtable 对 象 的 字 
符 串 表示 形式 ， 括 在 括号 由 ASCIl 字 符 “"( 喜 号 加 空格 ) 分 隔 。 


Collection<V> values() 此 方法 返回 此 映射 中 包含 的 值 的 Collection 视 


20 
图 。 


方法 继承 


java.util.Hashtable 3€ - Java.util 包 1411 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.ldentityHashMap X - Java.util@ 
java.util.ldentityHashMap 类 实现 了 Map 接 口 的 哈 希 表 ， 比 较 键 (和 值 ) 时 使 用 引用 
相等 性 代替 对 象 相等 的 下 面 是 IdentityHashMap 有 关 的 要 点 : 

e 这 个 类 提供 了 所 有 可 选 的 映射 操作 ， 并 且 人 允许 null 值 和 null 键 。 

。 这 个 类 不 保证 为 向 地 图 的 顺序 ;特别 是 ， 它 不 保证 该 顺序 将 继续 随时 间 恒 定 。 

。 在 ldentityHashMap 中 ， 两 个 键 kK1 和 k2 被 认为 是 当 且 仅 当 (K1== K2) 相 等 ， 而 在 


Map 实 现 (如 HashMap 的 ) 两 个 键 k1 和 k2 被 认为 是 相等 当 且 仅 当 (K1== NULL? 
K2== NULL : k1.equals(K2)). 


yp —_ 
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以 下 是 java.util.ldentityHashMap 类 的 声明 : 


public class IdentityHashMap<K, V> 
extends AbstractMap<k, V» 
implements Map<K,V>, Serializable, Cloneable 


X iS ER ZA 
S.N. 构造 画 数 & 描述 
1 IdentityHashMap() 此 构造 一 个 新 的 空 标识 哈 希 映 射 具 有 默认 期 望 最 大 
尺寸 (21)。 
2 IdentityHashMap(int expectedMaxSize) 此 构造 一 个 新 的 空地 图 与 指 
定期 望 的 最 大 尺寸 。 
3 IdentityHashMap(Map<? extends K,? extends V» m) 这 个 构造 包含 


指定 映射 中 键 - 值 映 射 关 系 的 新 标识 哈 希 映射 。 
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S.N. 方法 & 描述 
1 void clear() 此 方法 删除 所 有 来 自 此 映射 中 的 映射 。 


Object clone() 此 方法 返回 此 标识 哈 希 映射 的 浅 表 副本 : AMARA 
“被 复制 。 


3 boolean containsKey(Object key) 此 方法 测试 指定 的 对 象 引 用 是 否 为 此 
标识 哈 希 映射 中 的 键 。 


boolean containsValue(Object value) 此 方法 测试 指定 的 对 象 引 用 是 否 
为 值 在 此 标识 哈 希 映射 。 


Set<Map.Entry<K,V>> entrySet() 此 方法 返回 此 映射 中 包含 的 映射 关系 
的 Set 视 图 。 


6 boolean equals(Object o) 此 方法 将 指定 对 象 与 此 映射 的 相等 性 比较 。 
7 V get(Object key) 这 个 方法 返回 指定 键 所 映射 的 值 ， 或 者 null， 如 果 此 


映射 不 包含 该 键 。 

8 int hashCode() 此 方法 返回 返回 这 个 映射 的 哈 希 码 值 。 

9 boolean isEmpty() 如 果 此 标识 哈 希 映 射 不 包含 键 - 值 映 射 关 系 ， 此 方法 
返回 true。 


10 Set<K>keySet() 此 方法 返回 此 映射 中 包含 的 键 的 基于 标识 的 set 视 图 。 


1 V put(K key, V value) 此 方法 将 指定 的 值 与 此 标识 哈 希 映射 中 的 指定 
键 。 


void putAll(Map<? extends K,? extends V» m) 这 个 方法 会 将 所 有 从 指 
定 映射 此 映射 中 的 映射 。 


13 V remove(Object key) 此 方法 删除 映射 为 这 个 键 从 该 映射 如 果 存 在 的 
Ibo 

14 int size() 此 方法 返回 键 - 值 映 射 关 系 在 此 标识 哈 希 映 射 的 数量 。 

Collection<V> values() 此 方法 返回 返回 此 映射 中 包含 的 值 的 Collection 


视图 。 
方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractMap 


e java.util.Object 


java.util.ldentityHashMap # 


- Java.util 包 1414 


java.util.LinkedHashMap X - Java.util@ 


java.util.LinkedHashMap 类 是 哈 希 表 和 链接 列表 实现 Map 接 口 ， 具 有 可 预知 的 和 迭 
代 顺 序 。 以 下 是 关于 LinkedHashMap 的 要 点 : 
e 这 个 类 提供 了 所 有 可 选 的 映射 操作 ， 并 且 人 允许 null 元 素 。 


e 在 一 个 HashMap 的 迭代 很 可 能 会 更 加 昂 


yp -L 
类 两 明 
以 下 是 java.util.LinkedHashMap 类 的 声明 : 


public class LinkedHashMap<K,V> 
extends HashMap<K, V> 
implements Map<K, V> 


参数 

以 下 是 java.util.LinkedHashMap 类 中 的 参数 : 
e K -- 这 是 映射 要 维护 的 键 的 类 型 。 
e. V -- 这 是 映射 值 的 类 型 。 


X Mr Et 
S.N. HG AM & 描述 
1 LinkedHashMap() 这 种 构造 具有 默认 初始 容量 (16) 和 加 载 因子 (0.75) 的 


空 插入 顺序 LinkedHashMap 实 例 。 


LinkedHashMap(int initialCapacity) 该 构造 带 指定 初始 容量 和 默认 加 
载 因子 (0.75) 的 空 插入 顺序 LinkedHashMap 实 例 。 


3 LinkedHashMapiint initialCapacity, float loadFactor) 该 构造 带 指定 
初始 容量 和 加 载 因子 的 空 插 入 顺序 LinkedHashMap 实 例 。 


LinkedHashMap(int initialCapacity, float loadFactor, boolean 


4 accessOrder) 该 构造 带 指定 初始 容量 ， 加 载 因子 和 排序 模式 的 空 
LinkedHashMap 实 例 。 
5 LinkedHashMap(Map<? extends K,? extends V» m) 这 与 构建 相同 


的 映射 关系 与 指定 映射 的 插入 顺序 LinkedHashMap 实 例 。 


类 方法 


S.N. 方法 & 描述 
1 void clear() 此 方法 删除 所 有 来 自 此 映射 中 的 映射 。 
2 boolean containsValue(Object value) 如 果 此 映射 的 一 个 或 多 个 键 映 射 


到 指定 值 ， 该 方法 返回 true。 


3 V get(Object key) 这 个 方法 返回 指定 键 所 映射 的 值 ， 或 者 null， 如 果 此 
映射 不 包含 该 键 。 


4 protected boolean removeEldestEntry(Map.Entry<K,V> eldest) 这 个 方 
法 如 果 此 映射 移 除 其 最 旧 的 条 目 返 回 true。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util. HashMap 
e java.util.AbstarctMap 
e java.util.Object 


e java.util.Map 


java.util. LinkedHashSet# - Java.utila 


java.util.LinkedHashSet 类 是 一 个 哈 希 表 和 链接 列表 实现 Set 接 口 ， 具 有 可 预知 的 
迭代 顺序 。 以 下 是 关于 LinkedHashSet 的 要 点 : 


e 这 个 类 提供 了 所 有 可 选 set 操 作 ， 并 且 人 允许 null 元 素 。 
J^ —L 
类 丙 明 
以 下 是 java.util.LinkedHashSet 类 的 声明 : 


public class LinkedHashSet<E> 
extends HashSet<E> 
implements Set<E>, Cloneable, Serializable 


以 下 是 java.util.LinkedHashSet 类 中 的 参数 : 
e E-- 这 是 此 set 维 护 元 素 的 类 型 。 


类 构造 画 数 
S.N. TG ES XC & fih 


LinkedHashSet() 这 种 构造 一 个 新 的 空 链 接 哈 希 集 合 具 有 默认 初始 容量 
(16) 和 加 载 因 子 (0.75) 。 


一 人 


2 LinkedHashSet(Collection<? extends E» c) 这 构造 了 一 个 新 的 链接 哈 希 
集合 具有 相同 元 素 的 指定 集合 。 

3 LinkedHashSet(int initialCapacity) 这 种 构造 一 个 新 的 空 链接 哈 希 集合 具 
有 指定 初始 容量 和 默认 加 载 因子 (0.75) 。 

4 LinkedHashSet(int initialCapacity, float loadFactor) 这 种 构造 一 个 新 的 


空 链接 哈 希 集合 具有 指定 初始 容量 和 加 载 因子 。 


类 方法 
这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.HashSet 


java.util.AbstractSet 
java.util.AbstractCollection 
java.util.Object 


java.util.Set 


java.util.LinkedList# - Java.util@ 


java.util.LinkedList 类 操作 执行 ， 我 们 可 以 预期 这 是 一 个 双向 链表 。 操 作 的 索引 列 
表 会 通 历 从 一 开始 或 结束 时 ， 取 其 靠近 指定 索引 的 列表 。 


JA Œ 
X PS BH 
以 下 是 java.util.LinkedList 类 的 声明 : 


public class LinkedList<E> 
extends AbstractSequentialList<E> 
implements List<E>, Deque<E>, Cloneable, Serializable 


以 下 是 java.util.LinkedList 类 的 参数 : 


e E -- 这 是 在 这 个 集合 所 持 元 素 的 类 型 。 
mo EL dob 
字段 域 
Mjava.util.AbstractLis 3€ tf^] F Ex 4k zK , 


A MEER A 


S.N. ISAM & 描述 
1 LinkedList() 这 种 构造 构造 一 个 空 的 列表 。 


LinkedList(Collection<? extends E> c) 这 个 构造 一 个 包含 指定 集合 中 的 


2 元 素 的 列表 ， 它 们 被 集合 的 迭代 器 返回 的 顺序 。 


类 方法 


S.N. 方法 & 描述 
1 boolean add(E e) 这 种 方法 将 指定 元 素 追 加 到 此 列表 的 末尾 。 


j void add(int index, E element) 此 方法 将 在 此 列表 中 指定 位 置 的 指定 元 
素 。 
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java.util.LinkedList# - Java.utiltJ 1420 


boolean addAll(Collection«? extends E» c) 此 方法 会 将 所 有 指定 集合 中 
的 元 素 添 加 到 此 列表 的 结尾 ， 因 为 它们 是 由 指定 collection 的 迭代 器 返回 
的 顺序 。 


boolean addAll(int index, Collection<? extends E» c) 此 方法 将 所 有 指 
定 集合 中 的 元 素 插入 此 列表 ， 开 始 在 指定 的 位 置 。 


void addFirst(E e) 此 方法 返回 插入 指定 的 元 素 ， 在 这 个 列表 的 开头 .… 
void addLast(E e) 此 方法 返回 指定 元 素 追 加 到 此 列表 的 末尾 。 

void clear() LEAK m IRPA BLL ANIC. 

Object clone() 此 方法 返回 返回 此 LinkedList 的 浅 表 副本 。 


boolean contains(Object o) 如 果 此 列表 包含 指定 的 元 素 ， 此 方法 返回 
true。 


lterator<E> descendinglterator() 此 方法 返回 一 个 迭代 器 在 此 双 端 队列 
以 逆向 顺序 的 元 素 。 


E element() 此 方法 检索 ， 但 是 不 移 除 此 列表 的 头 (第 一 个 元 素 ) © 
E get(int index) 此 方法 返回 的 元 素 在 此 列表 中 的 指定 位 置 。 

E getFirst() 此 方法 返回 此 列表 中 的 第 一 个 元 素 。 

E getLast() 此 方法 返回 此 列表 中 的 最 后 一 个 元 素 。 


int indexOf(Object o) 这 个 方法 返回 指定 元 素 的 第 一 个 匹配 项 的 索引 在 
此 列表 中 ， 或 者 -1， 如 果 此 列表 中 不 包含 该 元 素 。 


int lastIndexOf(Object o) 这 个 方法 返回 指定 元 素 的 最 后 一 个 匹配 项 的 索 
引 在 此 列表 中 ， 或 者 -1， 如 果 此 列表 中 不 包含 该 元 素 。 


Listlterator<E> listlterator(int index) 此 方法 返回 一 个 列表 迭代 器 在 此 列 
表 中 的 元 素 ( 按 适当 顺序 ) ， 从 列表 中 的 指定 位 置 。 


boolean offer(E e) 此 方法 将 指定 的 元 素 到 此 列表 的 末尾 (最 后 一 个 元 
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boolean offerFirst(E e) 此 方法 将 指定 元 素 在 此 列表 的 前 面 。 
boolean offerLast(E e) 此 方法 将 指定 的 元 素 ， 在 这 个 列表 的 末尾 。 
E peek() 此 方法 检索 ， 但 是 不 移 除 此 列表 的 头 (第 一 个 元 素 ) 。 


E peekFirst() 此 方法 检索 ， 但 是 不 移 除 此 列表 的 第 一 个 元 素 ， 或 者 如 果 
此 列表 为 空 ， 则 返回 null。 


E peekLast() 此 方法 检索 ， 但 是 不 移 除 此 列表 的 最 后 一 个 元 素 ， 或 者 如 
果 此 列表 为 空 ， 则 返回 null。 


E poll() 此 方法 检索 并 移 除 此 列表 的 关 〈 第 一 个 元 素 ) 。 
E pollFirst() 此 方法 检索 并 移 除 此 列表 的 第 一 个 元 素 ， 或 者 如 果 此 列表 为 


26 空 ， 则 返回 null。 

27 E pollLast() 此 方法 检索 并 移 除 此 列表 的 最 后 一 个 元 素 ， 或 者 如 果 此 列表 
为 空 ， 则 返回 null。 

28 E pop() 这 个 方法 从 该 列表 所 表示 的 堆栈 弹出 一 个 元 素 。 

29 void push(E e) 这 种 方法 将 元 素 推 人 此 列表 所 表示 的 堆栈 。 

30 E remove() 此 方法 检索 并 移 除 此 列表 的 关 (第 一 个 元 素 ) o 

31 E remove(int index) 此 方法 删除 的 元 素 在 此 列表 中 指定 位 置 . 

32 boolean remove(Object o) 此 方法 从 该 列表 中 首次 出 现 的 指定 元 素 ， 如 
果 它 存在 。 

33 E removeFirst() 此 方法 删除 并 返回 此 列表 的 第 一 个 元 素 。 

34 boolean removeFirstOccurrence(Object o) 此 方法 删除 指定 元 素 第 一 次 
出 现在 该 列表 中 ( 通 万 从 头 部 到 尾部 列表 时 ) 。 

35 E removeLast() 此 方法 删除 并 返回 此 列表 的 最 后 一 个 元 素 。 

36 boolean removeLastOccurrence(Object o) 此 方法 删除 指定 元 素 最 后 一 
次 出 现在 该 列表 中 〈 通 历 从 头 部 到 尾部 列表 时 ) 。 

37 E set(int index, E element) 这 种 方法 取代 在 与 指定 的 元 素 在 此 列表 中 指 
定位 置 的 元 素 。 

38 int size() 此 方法 返回 此 列表 中 的 元 素数 。 

39 Object[] toArray() 这 个 方法 返回 一 个 包含 所 有 在 此 列表 中 正确 的 序列 中 
元 素 的 数组 (从 第 一 个 到 最 后 一 个 元 素 ) 。 
«T» T[] toArray(T[] a) 这 个 方法 返回 一 个 包含 所 有 在 此 列表 中 正确 的 序 

40 列 中 的 元 素 〈 从 第 一 个 到 最 后 一 个 元 素 ) 一 个 数组 ， 返 回 数组 的 运行 时 
类 型 是 指定 数组 的 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.AbstractSequentialList 


java.util.AbstractList 
java.util.AbstractCollection 
java.util.Object 
java.util.List 


java.util.Deque 
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java.util.ListResourceBundle X - Java.util 包 


java.util.ListResourceBundle 类 是 资源 包 的 抽象 子 类 ， 在 一 个 方便 和 易于 使 用 列表 


Xe Se se mm tr 
管理 资源 语言 环境 。 


4 ob 
AX BH 
以 下 是 java.util.ListResourceBundle 类 的 声明 : 


public abstract class ListResourceBundle 
extends ResourceBundle 


字段 域 
字段 从 java.util.ResourceBundle 类 继承 
X BER 


S.N. MiG RM & 描述 
1 ListResourceBundle() 这 是 唯一 的 构造 函数 。 


类 方法 


S.N. 方法 & 描述 

protected abstract Object[][] getContents() 此 方法 返回 一 个 数组 ， 其 中 
每 个 项 目 是 一 个 对 对 象 的 Object 数组 。 

2 Enumeration«String» getKeys() 此 方法 返回 包含 在 此 的 
ResourceBundle 及 其 父 包 中 的 键 的 枚 举 。 

3 Object handleGetObject(String key) 这 种 方法 获取 的 对 象 从 这 个 资源 包 
的 给 定 键 。 

4 protected Set<String> handleKeySet() 此 方法 返回 一 个 Set 公 包含 在 此 
ResourceBundle 中 的 键 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.ResourceBundle 


e java.util.Object 


java.util.Locale X: - Java.util 包 
java.util.Locale 类 对 象 表 示 了 特定 的 地 理 ， 政 治 和 文化 地 区 。 以 下 是 有 关 区 域 设 
置 的 要 点 : 


e 需要 Locale 来 执行 其 任务 的 操作 称 为 语言 环境 敏感 ， 它 使 用 Locale， 形 成 信息 
的 用 户 。 


e Locale 是 一 种 机 制 ， 用 于 识别 对 象 ， 而 不 是 一 个 容器 对 象 本 身 。 
类 声明 
以 下 是 java.util.Locale 类 的 声明 : 


public final class Locale 
extends Object 
implements Cloneable, Serializable 


ron EL tt 
字段 域 
以 下 是 java.util.Locale 类 中 的 字段 : 

e static Locale CANADA -- 这 是 国家 的 常量 。 

e static Locale CANADA FRENCH -- 这 是 国家 的 常量 。 


e static Locale CHINA -- 这 是 国家 的 常量 。 

e static Locale CHINESE -- 这 是 语言 的 常量 。 
e static Locale ENGLISH -- 这 是 语言 的 常量 。 
e static Locale FRANCE -- 这 是 国家 的 常量 。 

e static Locale FRENCH -- 这 是 语言 的 常量 。 

e static Locale GERMAN -- 这 是 语言 的 常量 。 
e static Locale GERMANY 是 国家 的 常量 。 


e static Locale JAPAN -- 这 是 国家 的 常量 。 
e static Locale JAPANESE -- 这 是 语言 的 常量 。 


e static Locale KOREA -- 这 是 国家 的 常量 。 


e static Locale KOREAN -- 这 是 语言 的 常量 。 


e static Locale PRC -- 这 是 国家 的 常量 。 

e static Locale ROOT -- 这 是 不 变 的 根 语言 环境 。 

e static Locale SIMPLIFIED CHINESE -- 这 是 语言 的 常量 。 

e static Locale TAIWAN -- 这 是 国家 的 常量 。 

e static Locale TRADITIONAL CHINESE -- 这 是 语言 的 常量 。 


e static Locale UK -- 这 是 国家 的 常量 。 


e static Locale US -- 这 是 国家 的 常量 。 


类 构造 函数 


S.N. 


1 


构造 函数 & 描述 
Locale(String language) 这 个 构造 一 个 语言 环境 的 语言 代码 。 


Locale(String language, String country) 这 个 构造 一 个 语言 环境 的 语言 
代码 。 


Locale(String language, String country, String variant) 这 个 构造 一 个 语 
言 环境 的 语言 ， 国 家 ， 变 体 。 


类 方法 


S.N. 


方法 & 描述 
Object clone() 此 方法 重 写 了 Cloneable 


boolean equals(Object obj) 如 果 此 区 域 设置 为 等 于 另 一 个 对 象 ， 则 此 方 
法 返回 true。 


static Locale[] getAvailableLocales() 此 方法 返回 所 有 已 安装 的 语言 环境 
的 数组 。 


String getCountry() 此 方法 返回 国家 /地 区 代码 为 这 个 区 域 设置 ， 它 要 么 
是 空 字符 串 或 大 写 的 ISO3166 两 字母 代码 。 

static Locale getDefault() 此 方法 获取 默认 语言 环境 的 当前 值 的 Java 虚 
拟 机 实例 。 

String getDisplayCountry() 此 方法 返回 适合 显示 给 用 户 的 名 称 语言 环境 
的 国家 。 
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7 S String getDisplayCountry(Locale inLocale) 此 方法 返回 适合 显示 给 用 
户 的 名 称 语言 环境 的 国家 。 

8 String getDisplayLanguage() 此 方法 返回 的 语言 环境 语言 适合 于 显示 给 
用 户 的 名 称 。 


9 a getDisplayLanguage(Locale inLocale) 此 方法 返回 的 语言 环境 语 
适合 于 显示 给 用 户 的 名 称 。 


String getDisplayName() 此 方法 返回 的 语言 环境 ， 是 否 适 合 显示 给 用 户 
10 的 名 称 。 


" String getDisplayName(Locale inLocale) 此 方法 返回 的 语言 环境 ， 是 否 
适合 显示 给 用 户 的 名 称 。 


40 String getDisplayVariant() 此 方法 返回 的 语言 环境 变量 代码 ， 适 合 显示 
给 用 户 的 名 称 。 


13 String getDisplayVariant(Locale inLocale) 此 方法 返回 的 语言 环境 变量 
代码 ， 适 合 显示 给 用 户 的 名 称 。 


14 String getlSO3Country() 此 方法 返回 一 个 三 个 字母 的 缩写 本 地 区 的 国 
家 。 

45 String getlSO3Language() 此 方法 返回 返回 一 个 三 字母 缩写 在 这 个 地 方 
的 语言 Fo 


16 static String[] getlSOCountries() 这 个 方法 返回 ISO 3166 中 定义 的 所 有 2 
个 字母 的 国家 代码 的 列表 。 


static String[] getlSOLanguages() 这 个 方法 返回 ISO 639 中 定义 的 所 有 
两 字母 语言 代码 的 列表 。 


18 String getLanguage() 此 方法 返回 语言 代码 为 这 个 区 域 设置 ， 它 要 么 
空 字符 串 或 小 写 的 ISO639 代 码 。 


19 String getVariant() 此 方法 返回 的 变量 代码 为 这 个 区 域 设 置 。 
20 int hashCode() 这 个 方法 重 守 了 hashCode。 


21 static void setDefault(Locale newLocale) 此 方法 设置 的 默认 语言 环境 的 
Java 虚 拟 机 实例 。 


22 String toString() 这 种 方法 是 的 getter 整 个 语言 环境 的 编程 名 称 ， 由 下 划 
线 分 隔 的 语言 E 国家 和 变量 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 
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java.util.Observable ž - Java.util 包 


java.util.Observable 类 表示 Observable 的 对 象 ， 或 在 模型 视图 范例 “data"。 以 下 
是 关于 Observable 的 要 点 : 


e 这 个 类 可 以 被 子 类 化 表示 对 象 的 应 用 程序 要 观察 。 
e observable 的 对 象 可 以 具有 一 个 或 多 个 observers。 
J^ —- 
类 丙 明 
以 下 是 java.util.Observable 类 的 声明 : 


public class Observable 
extends Object 


s Ry L 
3& ME RN 
S.N. Hie ES AC & 描述 
1 Observable() ix 443& f — T ObservableB # 5 Observers. 
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S.N. 方法 & 描述 
void addObserver(Observer o) 这 种 方法 增加 了 observer 所 设 定 的 


observer 对 象 ， 只 要 它 是 不 同 于 一 些 observer 已 经 在 此 集合 。 
protected void clearChanged() 此 方法 指示 此 对 象 不 再 改变 ， 或 者 说 ， 

2 它 已 经 通知 其 所 有 的 最 新 变化 及 其 observers， 所 以 hasChanged 方 法 现 
在 将 返回 false。 

3 int countObservers() 这 个 方法 返回 当前 Observable 对 象 的 observers 数 
量 。 

4 void deleteObserver(Observer o) 此 方法 从 该 集合 对 象 的 observers 删 除 
一 个 observer。 

5 void deleteObservers() 此 方法 清除 observers 列表 ， 使 此 对 象 不 再 有 任 


何 observer 。 
6 boolean hasChanged() 此 方法 测试 ， 如 果 该 对 象 已 经 改变 。 


void notifyObservers() 如 果 该 对 象 已 经 改变 ， 由 hasChanged 方 法 指 
7 示 ， 则 通知 其 所 有 观察 者 ， 并 调用 clearChanged 方 法 来 指示 此 对 象 不 再 
LE 


void notifyObservers(Object arg) 如 果 该 对 象 已 经 改变 ， 由 hasChanged 
8 方法 指示 ， 则 通知 其 所 有 观察 者 ， 并 调用 clearChanged 方 法 来 指示 此 对 
象 不 再 改变 。 


9 protected void setChanged() 此 方法 返回 这 个 标记 Observable 对 象 为 已 
改变 ; hasChanged 方 法 现在 将 返回 true。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.PriorityQueue X - Java.utile 
java.util.PriorityQueue 类 是 基于 优先 级 堆 的 无 界 优先 级 队列 。 以 下 是 有 关 的 
PriorityQueue 的 要 点 : 


e. 优先 级 队列 中 的 元 素 根据 其 自然 顺序 进行 排序 ， 或 者 按照 队列 构造 时 提供 的 
Comparator， 这 取决 于 使 用 的 构造 方法 。 


e 优先 级 队列 不 允许 null 元 素 。 
e 优先 级 队列 依靠 自然 顺序 也 不 允许 插入 不 可 比较 的 对 象 。 


xy —- 
AX Fa HH 
以 下 是 java.util.PriorityQueue 类 的 声明 : 


public class PriorityQueue<E> 
extends AbstractQueue<E> 
implements Serializable 


参数 


以 下 是 java.util.PriorityQueue 类 的 参数 : 


e E- 这 是 在 这 个 集合 所 持 元 素 的 类 型 。 


S.N. 


MS & 描述 


PriorityQueue() 这 将 创建 一 个 具有 默认 初始 容量 (11)， 根 据 其 自然 顺序 
对 其 元 素 PriorityQueue。 


PriorityQueue(Collection<? extends E> c) 这 将 创建 一 个 包含 指定 集 
合 中 的 元 素 的 PriorityQueue。 


PriorityQueue(int initialCapacity) 这 将 创建 与 根据 其 自然 顺序 对 其 元 
素 指定 的 初始 容量 创建 一 个 PriorityQueue。 


PriorityQueue(int initialCapacity, Comparator<? super E> 
comparator) 这 将 创建 与 根据 指定 的 比较 器 对 其 元 素 指 定 的 初始 容量 创 
建 一 个 PriorityQueue。 


PriorityQueue(PriorityQueue<? extends E> c) 这 将 创建 一 个 包含 指 
定 优先 级 队列 中 的 元 素 一 个 PriorityQueue。 


PriorityQueue(SortedSet«? extends E» c) 这 将 创建 一 个 包含 指定 有 
序 set 的 元 素 一 个 PriorityQueue。 


S.N. 方法 & 描述 

1 boolean add(E e) 此 方法 将 指定 元 素 插 入 此 优先 级 队列 。 

2 void clear() 此 方法 删除 所 有 来 自 此 优先 级 队列 中 的 元 素 。 
Comparator<? super E> comparator() 此 方法 返回 用 于 排序 在 此 队列 


3 中 ， 或 者 为 null 的 元 素 ;如 果 此 队列 根据 其 元 素 的 自然 顺序 进行 排序 的 比 
较 器 。 

4 boolean contains(Object o) 如 果 此 队列 包含 指定 的 元 素 ， 此 方法 返回 
true。 


5 lterator<E> iterator() 此 方法 返回 一 个 迭代 器 在 此 队列 中 的 元 素 。 
6 boolean offer(E e) 此 方法 将 指定 元 素 插入 此 优先 级 队列 。 


7 E peek() 此 方法 检索 ， 但 是 不 移 除 此 队列 的 头 ， 如 果 此 队列 为 空 ， 则 返 
回 null。 


8 E poll) 此 方法 检索 并 移 除 此 队列 的 头 ， 如 果 此 队列 为 空 ， 则 返回 null。 


9 boolean remove(Object o) 这 个 方法 从 队列 中 移 除 指定 元 素 的 单个 实例 
(如 果 存 在 )。 


10 int size() 此 方法 返回 这 个 集合 中 元 素 的 个 数 。 
11 Object[] toArray() 这 个 方法 返回 一 个 包含 此 队列 所 有 元 素 的 数组 。 


12 <T> T[] toArray(T[] a) 这 个 方法 返回 一 个 包含 此 队列 所 有 元 素 的 数组 ; 返 
回 数组 的 运行 时 类 型 是 指定 数组 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractQueue 
e java.util.AbstractCollection 
e java.util.Object 


e java.util.Collection 


java.util.Properties 3: - Java.util 包 
java.util.Properties 类 是 代表 一 个 持久 的 一 套 详细 属性 ， 属 性 可 以 被 保存 到 一 个 流 
或 从 流 中 加 载 的 关 。 以 下 是 关于 属性 的 要 点 : 

e 属性 列表 中 每 个 键 及 其 对 应 值 是 一 个 字符 串 。 


。 一 个 属性 列表 可 包含 另 一 个 属性 列表 作为 它 的 “默认”， 第 二 个 属性 可 在 列表 中 
搜索 ， 如 果 没 有 在 原 有 的 属性 列表 中 找到 的 属性 键 。 


这 个 类 是 线程 安全 的 ;多 个 线程 可 以 共享 一 个 Properties 对 象 ， 而 不 需要 外 部 同 
步 。 


类 的 声明 
以 下 是 java.util.Properties 类 的 声明 : 


public class Properties 
extends Hashtable<Object, Object> 


ra EN 二 
字段 域 
下 面 是 一 个 java.util.Properties 类 中 的 字段 : 


e protected Properties defaults -- 这 是 包含 在 属性 列表 中 未 找到 任何 键 的 默认 值 
的 属性 列表 。 


类 构造 画 数 


S.N. is HA & 描述 

1 Properties() 这 种 构造 创建 一 个 空 的 属性 列表 ， 没 有 默认 值 。 

2 Properties(Properties defaults) 这 种 构造 创建 一 个 空 的 属性 列表 中 具 
有 指定 默认 值 。 
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S.N. 方法 & 描述 
1 String getProperty(String key) 该 方法 将 搜索 具有 此 属性 列表 中 指定 键 
的 属性 。 


String getProperty(String key, String defaultValue) 该 方法 将 搜索 具有 此 
属性 列表 中 指定 键 的 属性 。 


3 void list(PrintStream out) 这 种 方法 打印 属性 列表 输出 到 指定 的 输出 流 。 
4 void list(PrintWriter out) 这 种 方法 打印 属性 列表 输出 到 指定 的 输出 流 。 
void load(InputStream inStream) 此 方法 读 取 属 性 列表 ( 键 和 元 素 对 ) 从 输 


? ARES. 

6 void load(Reader reader) 这 个 方法 从 一 个 简单 的 面向 行 的 格式 输入 字符 
流 中 读 取 属性 列表 ( 键 和 元 素 对 )。 

7 void loadFromXML(InputStream in) 此 方法 加 载 所 有 指定 的 输入 流 中 到 


此 属性 表 中 的 XML 文档 所 表示 的 所 有 属性 。 


Enumeration<?> propertyNames() 此 方法 返回 属性 列表 中 所 有 键 ， 包 
8 括 黑 认 属 性 列表 中 不 同 的 键 的 枚 举 ， 如 果 尚 未 发 现 从 主 属 性 列表 中 名 称 


相同 的 键 。 

9 void save(OutputStream out, String comments) 此 方法 读 取 a 

10 Object setProperty(String key, String value) 此 方法 调用 Hashtable 的 
put() 方 法 。 


void store(OutputStream out, String comments) 该 方法 宇 入 此 属性 列表 
11 ( 键 和 元 素 对 ) 在 此 属性 表 中 适 于 装 成 一 个 属性 表 中 使 用 
load(InputStream) 方 法 的 格式 输出 流 。 


void store(Writer writer, String comments) 该 方法 写 入 此 属性 列表 ( 键 和 


10 元素 对 ) 在 此 属性 表 中 适合 使 用 load(Reader) 方 法 的 格式 输出 字符 流 。 
" void storeToXML(OutputStream os, String comment) 这 个 方法 会 发 出 


代表 所 有 包含 在 此 表 中 的 属性 的 XML 文档 。 
void storeToXML(OutputStream os, String comment, String encoding) 
12 这 个 方法 会 发 出 代表 所 有 包含 在 此 表 中 的 属性 的 XML 文档 ， 使 用 指定 的 
编码 。 
Set<String> stringPropertyNames() 此 方法 返回 一 组 键 在 此 属性 列表 ， 
13 其 中 的 键 及 其 对 应 值 是 字符 串 ， 包 括 默 认 属 性 列表 中 不 同 的 键 ， 如 果 尚 
未 发 现 从 主 属性 列表 中 同名 的 键 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
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e java.util. Hashtable 


e java.util.Object 


java.util. PropertyPermission X - Java.util@ 
java.util. PropertyPermission X 类 是 一 个 类 属性 的 权限 。 以 下 是 关于 
PropertyPermission 要 点 

e 该 名 称 是 属性 的 名 称 ("java.home", "os.name", etc). 


。 命名 约定 遵守 层次 结构 属性 命名 约定 。 星 号 可 以 出 现在 名 称 的 结尾 ， 有 一 
个 “”， 或 者 本 身 以 表示 通配符 。 例 如 : "java." or" 是 有 效 的 , 而 "java" 或 “9b" 
是 无 效 的 


3 ob 
类 两 明 
以 下 是 java.util.PropertyPermission 类 的 声明 : 


public final class PropertyPermission 
extends BasicPermission 


S.N. ISAM & 描述 


PropertyPermission(String name, String actions) 这 将 创建 具有 指 
定名 称 的 新 PropertyPermission 对 象 。 


— 


类 方法 


S.N. 方法 & 描述 

1 equals(Object obj) 此 方法 检查 相等 的 两 个 PropertyPermission 

2 String getActions() 此 方法 返回 动作 的 “规范 化 字符 串 表 示 形 式 ”。 

3 int hashCode() 此 方法 返回 此 对 象 的 哈 希 码 值 。 

4 boolean ss tbh p) 此 方法 检查 ， 如 果 这 PropertyPermission 
对 象 是 否 “ 暗 含 "指定 的 权限 。 

5 PermissionCollection newPermissionCollection() 此 方法 返回 一 个 用 于 


存储 PropertyPermission 对 象 返回 一 个 新 的 PermissionCollection 对象 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.Permission 


e java.util.Object 


java.util.PropertyResourceBundle # - Java.util 


a 


java.util.PropertyResourceBundle 类 是 资源 包 的 具体 子 类 使 用 一 组 从 一 个 属性 文 
件 的 静态 字符 串 ， 用 于 管理 一 个 本 地 化 的 资源 。 以 下 是 有 关 的 
PropertyResourceBundle 要 点 : 


e 这 个 类 可 以 从 InputStream 或 Reader， 该 代表 一 个 属性 文件 来 构建 。 


xy -—- 
类 两 明 
以 下 是 java.util.PropertyResourceBundle 类 的 声明 : 


public class PropertyResourceBundle 
extends ResourceBundle 


字段 域 


字段 从 类 java.util.ResourceBundle 继承 


类 构造 画 数 


S.N. 构造 函数 & 描述 

1 PropertyResourceBundle(InputStream stream) 这 将 从 InputStream 
属性 创建 资源 包 。 

2 PropertyResourceBundle(Reader reader) 这 将 从 读 取 器 的 属性 创建 
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S.N. 方法 & 描述 

1 Enumeration<String> getKeys() 此 方法 返回 包含 在 此 ResourceBundle 
及 其 父 包 中 的 键 的 枚 举 。 

2 Object handleGetObject(String key) 这 个 方法 从 这 个 资源 包 的 给 定 键 获 
取 对 象 。 

3 protected Set<String> handleKeySet() 此 方法 返回 一 个 Set 公 包含 在 此 


ResourceBundle 中 的 键 。 


方法 继承 
这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.ResourceBundle 


e java.util.Object 
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java.util.Random 类 实例 用 于 生成 伪 随 机 数 。 下 面 是 有 关 Random 要 点 : 
。 这 个 类 使 用 一 个 48 位 的 种 子 ， 这 是 一 个 线性 同 余 公 式 修改 。 
。 该 算法 通过 Random 类 的 使 用 在 每 次 调用 时 可 以 提供 高 达 32 生 成 的 伪 随 机 位 受 
保护 的 实用 方法 来 实现 。 
类 声明 
以 下 是 java.util.Random 类 的 声明 : 


public class Random 
extends Object 
implements Serializable 


S.N. MESA & 描述 
1 Random() 这 将 创建 一 个 新 的 随机 数 生成 器 。 
2 Random(long seed) 这 会 使 用 单个 long 种 子 一 个 新 的 随机 数 发 生 器 。 
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S.N. 方法 & 描述 
1 protected int next(int bits) 此 方法 生成 下 一 个 伪 随 机 数 。 
boolean nextBoolean() 此 方法 返回 下 一 个 伪 从 这 个 随机 数 生 成 器 的 序列 


中 均匀 分 布 的 boolean 值 。 

3 void nextBytes(byte[] bytes) 此 方法 生成 随机 字 节 并 将 其 置 于 用 户 提供 
的 字 节 数组 。 

double nextDouble() 此 方法 返回 下 一 个 伪 从 这 个 随机 数 生成 器 的 序列 中 
均匀 分 布 的 0.0 和 1.0 之 间 的 double 值 。 

5 float nextFloat() 此 方法 返回 下 一 个 伪 从 这 个 随机 数 生成 器 的 序列 中 均匀 
分 布 的 0.0 和 1.0 之 间 的 float 值 。 

6 double nextGaussian() 此 方法 返回 下 一 个 盆 高 斯 (“正常 地 ”) 分 布 的 均值 
为 0.0， 标 准 差 为 1.0 从 此 随机 数 生成 器 的 序列 的 double 值 。 

7 int nextInt() 此 方法 返回 下 一 个 伪 从 这 个 随机 数 生成 器 的 序列 中 均匀 分 布 
的 int 值 。 

8 int nextInt(int n) 此 方法 返回 一 个 伪 随 机 ， 均 匀 分 布 在 0( 含 )int 值 和 指定 
值 (不 包括 )， 从 此 随机 数 生成 器 的 序列 中 取出 的 。 

9 long nextLong() 此 方法 返回 下 一 个 伪 从 这 个 随机 数 生 成 器 的 序列 中 均匀 
分 布 的 long 值 。 

10 void setSeed(long seed) 此 方法 设置 此 随机 数 生成 器 的 使 用 单个 long 种 
子 的 种 子 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 
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java.util.ResourceBundle 类 包含 特定 于 语言 环境 的 对 象 。 下 面 是 有 关 资 源 包 的 要 


VAN o" 


e 该 类 允许 您 轻松 编写 地 本 地 化 或 翻译 成 不 同 语 言 开发 的 程序 。 
e 该 类 程序 处 理 多 个 语言 环境 以 后 可 以 轻松 进行 修改 ， 以 支持 更 多 的 语言 环境 。 


e Java 平 台 提 供 ResourceBundle，ListResourceBundle 和 
PropertyResourceBundle 两 个 


xy -—- 
类 两 明 
以 下 是 java.util.ResourceBundle 类 的 声明 : 


public abstract class ResourceBundle 
extends Object 


ra EN 二 
字段 域 
以 下 是 java.util.ResourceBundle 类 中 的 字段 : 


e protected ResourceBundle parent -- 这 是 此 包 的 父 包 。 


类 构造 函数 


S.N. 构造 函数 & 描述 
1 ResourceBundle() ix zé — 4 443& NX 


类 方法 


S.N. 方法 & 描述 

static void clearCache() 此 方法 从 已 经 使 用 调用 者 的 类 加 载 器 加 载 的 缓 
存 中 的 所 有 资源 包 。 

2 static void clearCache(ClassLoader loader) 此 方法 从 已 经 使 用 给 定 的 类 


加 载 器 加 载 的 缓存 中 移 除 所 有 资源 包 。 
3 boolean containsKey(String key) 此 方法 确定 给 定 键 是 否 包含 在 这 个 ; 


sy 


~ 
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源 包 或 它 的 父 包 。 


static ResourceBundle getBundle(String baseName) 此 方法 使 用 指定 
的 基本 名 称 ， 默 认 的 语言 环境 和 调用 者 的 类 加 载 器 获取 资源 包 。 


static ResourceBundle getBundle(String baseName, Locale locale) 此 


方法 使 用 指定 的 基本 名 称 和 语言 环境 和 调用 者 的 类 加 载 器 获取 资源 包 。 


static ResourceBundle getBundle(String baseName, Locale locale, 
ClassLoader loader) 此 方法 使 用 指定 的 基本 名 称 ， 语 言 环境 和 类 加 载 器 
获取 资源 包 。 

static ResourceBundle getBundle(String baseName, Locale 
targetLocale, ClassLoader loader, ResourceBundle.Control control) 此 
方法 返回 一 个 使 用 指定 基本 名 称 ， 目 标语 言 环境 ， 类 加 载 器 和 控件 返回 
static ResourceBundle getBundle(String baseName, Locale 


targetLocale, ResourceBundle.Control control) 此 方法 返回 使 用 指定 的 
基本 名 称 ， 目 标语 言 环境 和 控制 ， 以 及 调用 者 的 类 加 载 器 获取 资源 包 。 


static ResourceBundle getBundle(String baseName, 
ResourceBundle.Control control) 此 方法 返回 使 用 指定 的 基本 名 称 ， 默 
认 的 语言 环境 和 指定 控件 的 资源 包 。 


abstract Enumeration<String> getKeys() 此 方法 返回 键 的 枚 举 。 
Locale getLocale() 此 方法 返回 此 资源 包 的 语言 环境 。 


Object getObject(String key) 此 方法 获取 一 个 对 象 给 定 键 从 此 资源 包 或 

它 的 某 个 父 类 。 

String getString(String key) 此 方法 获取 一 个 字符 串 给 定 键 从 此 资源 包 或 
它 的 某 个 父 类 。 

String[] getStringArray(String key) 此 方法 得 到 的 字符 串 数组 给 定 键 从 此 
资源 包 或 它 的 某 个 父 类 。 

protected abstract Object handleGetObject(String key) 此 方法 获取 的 对 
象 从 这 个 资源 包 的 给 定 键 。 

protected Set<String> handleKeySet() 此 方法 查询 ， 如 果 给 定 的 日 期 是 
ES TH EAH EK, 

Set<String> keySet() 此 方法 返回 一 个 Set 包 含 在 这 个 资源 包 及 其 父 包 中 
的 所 有 键 。 


protected void setParent(ResourceBundle parent) 此 方法 设置 此 包 的 父 
me 


方法 继承 


java.util.ResourceBundle # - Java.util 包 
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这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.ResourceBundle.Control # - Java.util 


a 


java.util.ResourceBundle.Control 类 县 有 协作 的 工厂 方法 用 于 加 载 次 源 包 。 以 下 
是 有 关 ResourceBundle.Control 要 点 


。 类 实例 必须 是 线程 安全 的 ， 如 果 它 同时 使 用 多 个 线程 。 


J^ —L 
A FAR 
以 下 是 java.util.ResourceBundle.Control 类 的 声明 : 


public static class ResourceBundle.Control 
extends Object 


ri s 
字段 域 
iis aD RR MINUM 中 的 字段 : 
e static int STANDARD TIME -- 常量 的 开始 或 结束 时 间 的 规定 为 标准 时 间 
的 模式 。 


e static List<String> FORMAT. CLASS -- 这 是 一 个 包含 “fava.class” 的 格式 列 


o 


e static List<String> FORMAT. DEFAULT -- 这 是 默认 的 格式 列表 ， 其 中 包含 字 
符 串 “ 的 java.class"” 和 ”java.properties”， 在 这 个 秩序 。 


e static List<String> FORMAT PROPERTIES -- 这 是 一 个 包 
含 java.properties"” 的 属性 ， 唯 一 格式 列表 。 


e static long TTL_DONT_CACHE -- 这 是 时 间 的 生存 常数 不 缓存 加 载 资源 包 实 
例 。 


e static long TTL_NO_EXPIRATION_CONTROL -- 这 是 时 间 的 生存 常数 禁用 到 
期 控制 在 缓存 中 加 载 资源 包 实 例 。 


x SM 
S.N. ISAM & 描述 


1 List<Locale> getCandidateLocales(String baseName, Locale 
locale) 这 是 一 个 构造 男 数 。 
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类 方法 


S.N. 方法 & 描述 


List<Locale>getCandidateLocales(String baseName, Locale locale) 此 
方法 返回 的 区 域 设置 列表 作为 候选 语言 环境 的 baseName 和 话 言 环境 。 


static ResourceBundle.Control getControl(List<String> formats) 此 方法 


2 返回 一 个 的 ResourceBundle.Control 其 中 getFormats 方 法 返回 指定 格 
m 


Locale getFallbackLocale(String baseName, Locale locale) 此 方法 返回 
3 ee getBundle 工 广 方法 被 用 来 作为 一 个 各 用 的 区 域 进 行 
一 步 资 源 包 搜索 一 个 区 域 设 置 


List<String> getFormats(String baseName) 这 个 方法 返回 一 个 包含 格式 


可 以 用 来 加 载 资 源 包 为 给 定 baseName 字 符 串 列 表 。 
static ResourceBundle.Control getNoFallbackControl(List<String> 

5 formats) 此 方法 返回 一 个 ResourceBundle.Control， 其 中 getFormats 方 
法 返回 指定 的 格式 和 getFallbackLocale 方 法 返回 null。 

6 long getTimeToLive(String baseName, Locale locale) 此 方法 返回 的 时 


间 到 现场 (TTL) 值 此 项 下 ResourceBundle.Control 加 载 资源 包 。 


boolean needsReload(String baseName, Locale locale, String format, 

7 ClassLoader loader, ResourceBundle bundle, long loadTime) 该 方法 确 
定 是 否 需要 在 高 速 缓存 中 过 期 束 根据 loadTime 或 一 些 其 它 标准 给 出 的 加 
载 时 间 来 重新 加 载 。 


ResourceBundle newBundle(String baseName, Locale locale, String 
format, ClassLoader loader, boolean reload) 此 方法 实例 化 给 定 的 格式 


8 和 语言 环境 的 给 定 包 名 称 的 资源 包 ， 使 用 给 定 的 关 加 载 器 ， 如 果 必要 
的 。 

9 String toBundleName(String baseName, Locale locale) 该 方法 给 出 
baseName 和 话 言 环境 的 包 名 称 转换 。 
String toResourceName(String bundleName, String suffix) 这 种 方法 给 

10 定 的 bundleName 的 转换 为 通过 蔡 换 所 有 出 现 所 需 的 


ClassLoader.getResource 法 的 形式 .在 bundleName 以 /， 并 附加 一 
个 '' 和 给 定 的 文件 后 级 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 
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java.util. Scanner 类 是 一 个 简单 的 文本 扫描 器 可 以 分 析 基 本 类 型 和 字符 串 使 用 正则 
表达 式 。 以 下 是 关于 扫描 器 的 要 点 : 

。 一 个 扫描 器 使 用 分 隔 符 模式 分 解 它 的 输入 ， 默 认 情况 下 与 空白 匹配 。 

。 扫 描 操作 可 能 阻塞 等 待 输入 。 

。 扫描 器 是 不 是 安全 的 ， 无 需 外 部 同步 多 线程 使 用 。 


J^ —L 
A Fa BH 
以 下 是 java.util.Scanner 类 的 声明 : 


public final class Scanner 
extends Object 
implements Iterator<String> 


X M3 KM 

S.N. 构造 画 数 & 描述 

1 Scanner(File source) 此 构造 产生 从 指定 文件 扫描 值 的 新 扫描 器 。 

2 Scanner(File source, String charsetName) 此 构造 产生 从 指定 文件 扫 
描 值 的 新 打 描 器 。 

3 Scanner(InputStream source) 此 构造 产生 从 指定 的 输入 流 打 描 值 的 新 
扫描 器 。 

4 Scanner(InputStream source, String charsetName) 此 构造 产生 从 指 


定 的 输入 流 打 描 值 的 新 扫描 器 。 
5 Scanner(Readable source) 此 构造 产生 从 指定 源 扫描 值 的 新 扫描 器 。 


Scanner(ReadableByteChannel source) 此 构造 产生 从 指定 通道 扫描 
值 的 新 扫描 器 。 


7 Scanner(ReadableByteChannel source, String charsetName) 此 构 
造 产 生 从 指定 通道 扫描 值 的 新 扫描 器 。 


8 Scanner(String source) 此 构造 产生 从 指定 字符 串 扫 描 值 的 新 扫描 器 。 
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S.N. 方法 & 描述 

1 void close() 此 方法 关闭 此 扫描 器 。 

2 Pattern delimiter() 此 方法 返回 当前 扫描 器 使 用 相 匹 配 的 分 隔 符 的 模式 。 

3 String findInLine(Pattern pattern) 此 方法 试图 找到 指定 的 模式 在 忽略 分 
隔 符 的 下 一 次 出 现 。 

String findInLine(String pattern) 此 方法 试图 找到 从 指定 字符 串 构 造 的 模 

式 在 未 来 发 生 ， 忽 略 分 隔 符 。 

String findWithinHorizon(Pattern pattern, int horizon) 此 方法 试图 找到 

指定 模式 的 下 一 次 出 现 。 

String findWithinHorizon(String pattern, int horizon) 此 方法 试图 找到 从 

指定 字符 串 构 造 的 模式 在 未 来 发 生 ， 在 忽略 分 隔 符 。 

7 boolean hasNext() 如 果 此 扫描 器 有 另 一 个 标记 在 其 输入 此 方法 返回 
true。 


boolean hasNext(Pattern pattern) 如 果 下 一 个 完整 标记 与 指定 模式 匹 
配 ， 该 方法 返回 true。 


9 boolean hasNext(String pattern) 如 果 下 一 个 标记 与 从 指定 字符 串 构 造 
的 模式 此 方法 返回 true。 


boolean hasNextBigDecimal() 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标 
10 记 可 以 通过 使 用 nextBigDecimal() 方 法 被 解释 为 一 个 BigDecimal， 该 方 
法 返回 true。 


boolean hasNextBiglnteger() 如 果 在 此 打 描 器 输入 信息 中 的 下 一 个 标记 
11 可 以 使 用 nextBiglnteger() 方 法 被 解释 为 一 个 Biglnteger 的 默认 基数 ， 此 
方法 返回 true。 


boolean hasNextBigInteger(int radix) 如 果 在 此 扫描 器 输入 信息 中 的 下 
12 一 个 标记 可 以 使 用 nextBiglnteger() 方 法 被 解释 为 一 个 Biglnteger 指 定 基 
数 此 方法 返回 true。 


boolean hasNextBoolean() 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标记 可 
13 以 解释 为 使 用 从 字符 串 “truelfalse” 创 造 了 一 个 不 区 分 大 小 写 模 式 的 布尔 
值 ， 此 方法 返回 true。 


44 boolean hasNextByte() 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标记 可 以 
使 用 nextByte() 方 法 被 解释 为 一 个 字 节 值 的 默认 基数 此 方法 返回 true。 


boolean hasNextByte(int radix) 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标 
15 记 可 以 使 用 nextByte() 方 法 被 解释 为 一 个 字 节 值 指定 基数 ， 此 方法 返回 
true。 


16 boolean hasNextDouble() 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标记 可 
以 解释 为 使 用 nextDouble() 方 法 的 一 个 double 值 ， 此 方法 返回 true。 


boolean hasNextFloat() 此 方法 返回 true， 如 果 在 此 扫描 器 输入 信息 的 下 
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一 个 标记 可 以 使 用 nextFloat() 方 法 解释 为 浮 点 值 。 


boolean hasNextlnt() 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标记 可 以 使 
用 nextlnt() 方 法 被 解释 为 一 个 int 值 的 默认 基数 ， 此 方法 返回 true。 


boolean hasNextInt(int radix) 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标记 
可 以 使 用 nextlnt() 方 法 被 解释 为 一 个 int 值 指定 基数 ， 此 方法 返回 true。 


boolean hasNextLine() 如 果 有 另 一 行 在 此 扫描 器 的 输入 ， 此 方法 返回 
true。 


boolean hasNextLong() 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标记 可 以 
使 用 nextLong() 方 法 被 解释 为 一 个 long 值 的 默认 基数 ， 此 方法 返回 true。 


boolean hasNextLong(int radix) 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标 
记 可 以 使 用 nextLong() 方 法 被 解释 为 一 个 long 值 指定 基数 ， 此 方法 返回 
true。 


boolean hasNextShort() 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标记 可 以 
使 用 nextShort() 方 法 被 解释 为 一 个 short 值 的 默认 基数 ， 此 方法 返回 


true。 


boolean hasNextShort(int radix) 如 果 在 此 扫描 器 输入 信息 中 的 下 一 个 标 
记 可 以 使 用 nextShort() 方 法 被 解释 为 一 个 short 值 指定 基数 ， 此 方法 返回 
true。 


IOException ioException() 此 方法 返回 的 最 后 一 个 IOException 异 常 抛 出 
此 扫描 器 的 基本 可 读 。 


Locale locale() 此 方法 返回 此 扫描 器 的 语言 环境 。 


MatchResult match() 此 方法 返回 此 打 描 器 所 执行 的 最 后 打 描 操作 的 匹 
配 结果 。 


String next() 此 方法 查找 并 返回 来 自 此 扫描 器 的 下 一 个 完整 标记 。 


String next(Pattern pattern) 此 方法 返回 下 一 个 标记 ， 如 果 它 与 指定 模式 
匹配 。 


String next(String pattern) 此 方法 返回 下 一 个 标记 ， 如 果 它 匹配 从 指定 
字符 串 构 造 的 模式 。 


BigDecimal nextBigDecimal() 此 方法 扫描 输入 的 下 一 个 标记 为 一 个 
BigDecimal。 


BigInteger nextBigInteger() 此 方法 扫描 输入 的 下 一 个 标记 为 一 个 
Biglnteger。 


BigInteger nextBigInteger(int radix) 此 方法 扫描 输入 的 下 一 个 标记 为 一 
个 Biglnteger。 


boolean nextBoolean() 此 方法 扫描 输入 的 下 一 个 标记 成 一 个 布尔 值 并 返 
回 该 值 。 


byte nextByte() 此 方法 扫 摘 输入 的 下 一 个 标记 为 一 个 字 节 。 
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byte nextByte() 此 方法 扫描 输入 的 下 一 个 标记 为 一 个 字 节 。 

byte nextByte(int radix) 此 方法 扫描 输入 的 下 一 个 标记 为 一 个 字 节 。 
double nextDouble() 此 方法 扫描 输入 的 下 一 个 标记 为 double。 

float nextFloat() 此 方法 扫描 输入 的 下 一 个 标记 为 float。 

int nextlnt() 此 方法 扫 摘 输入 的 下 一 个 标记 为 int。 

int nextInt(int radix) 此 方法 扫描 输入 的 下 一 个 标记 为 int。 

String nextLine() 此 方法 前 进 此 扫 拉 器 执行 当前 行 ， 并 返回 跳 过 的 输入 


信息 。 

long nextLong() 此 方法 扫描 输入 的 下 一 个 标记 为 一 个 long。 

long nextLong(int radix) 此 方法 扫描 输入 的 下 一 个 标记 为 一 个 long。 
short nextShort() 此 方法 打 描 输入 的 下 一 个 标记 为 一 个 long。 

short nextShort(int radix) 此 方法 打 描 输入 的 下 一 个 标记 为 short。 
int radix() 此 方法 返回 此 扫描 器 的 默认 基数 。 

void remove() 不 受 此 实现 迭代 器 所 支持 的 删除 操作 。 

Scanner reset() 此 方法 重 冒 该 扫描 仪 。 


Scanner skip(Pattern pattern) 此 方法 跳 过 输入 相 匹 配 的 指定 模式 ， 在 忽 
略 分 隔 符 。 


Scanner skip(String pattern) 此 方法 跳 过 输入 匹配 从 指定 字符 串 构造 的 
模式 。 
String toString() 此 方法 返回 当前 扫描 器 的 字符 串 表 示 形 式 。 


Scanner useDelimiter(Pattern pattern) 此 方法 设置 此 扫描 器 的 分 隔 模 
式 ， 以 指定 的 模式 。 

Scanner useDelimiter(String pattern) 此 方法 设置 此 扫描 器 的 分 隔 模 

式 ， 以 从 指定 字符 串 构 造 的 模式 。 

Scanner useLocale(Locale locale) 此 方法 设置 此 扫描 器 的 语言 环境 ， 以 
指定 的 语言 环境 。 


Scanner useRadix(int radix) 此 方法 设置 此 扫描 器 的 默认 基数 为 指定 基 


o 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.Scanner ž - Java.util& 1450 


java.util.ServiceLoader X - Java.utila 


java.util. n PE 类 是 一 个 简单 的 服务 提供 者 加 载 设施 。 以 下 是 关于 
ServiceLoader 


° dye RAM SEA iA FS eS EPC HT. 受信 任 的 系统 代码 通常 应 该 调 
用 这 个 类 的 方法 ， 而 他 们 返回 ， 优 越 的 安全 上 下 文中 的 迭代 器 的 方法 。 


。 这 个 类 实例 多 个 并 发 线程 使 用 是 不 安全 的 。 
类 声明 
以 下 是 java.util.ServiceLoader 类 的 声明 : 


public final class ServiceLoader<S> 
extends Object 
implements Iterable<S> 


参数 


以 下 是 java.util.ServiceLoader 类 参数 : 
e S -- 这 是 服务 于 这 个 加 载 器 加 载 的 类 型 。 


类 方法 
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S.N. 方法 & 描述 
1 lterator<S> iterator() 此 方法 加 载 这 个 加 载 器 的 服务 提供 者 。 


public static <S> ServiceLoader<S> load(Class<S> service) 此 方法 创 
2 建 一 个 新 的 服务 加 载 器 给 定 服务 类 型 ， 使 用 当前 线程 的 上 下 文 类 加 载 
AB. 
public static «S» ServiceLoader<S> load(Class<S> service, 
3 ClassLoader loader) 此 方法 创建 一 个 新 的 服务 加 载 器 给 定 服 务 类 型 和 类 
加 载 器 。 


public static «S» ServiceLoader<S> loadlnstalled(Class<S> service) 


^ 此 方法 创建 一 个 新 的 服务 加 载 器 给 定 服务 类 型 ， 使 用 扩展 类 加 载 器 。 
5 void reload() 此 方法 清除 该 加 载 器 的 服务 者 缓存 ， 所 有 的 提供 者 将 被 重 


新 加 载 。 
6 String toString() 此 方法 返回 描述 此 服务 的 字符 串 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.ServiceLoader# - Java.util 包 1452 


java.util. SimpleTimeZone X - Java.util 包 
java.util.SimpleTimeZone 类 是 时 区 的 具体 子 类 ， 它 表示 和 与 公历 使 用 的 时 区 。 以 下 
是 有 关 SimpleTimeZone 的 要 点 : 

e 这 个 类 持 有 GMT 的 偏 移 ， 称 为 原始 偏 移 。 

e. 这 个 类 还 拥有 开始 和 结束 的 夏 合 时 安排 的 规则 。 


3 -—- 
类 两 明 
以 下 是 java.util.SimpleTimeZone 类 的 声明 : 


public class SimpleTimeZone 
extends TimeZone 


ri * 
字段 域 
以 下 是 java.util.SimpleTimeZone 类 中 的 字段 : 


e static int STANDARD_TIME -- 这 是 不 变 的 开始 或 结束 时 间 的 规定 为 标准 时 间 
的 模式 。 


e static int UTC_TIME -- 这 是 不 变 的 开始 或 结束 时 间 指 定 为 UTC 的 模式 。 
e static int WALL_TIME -- 这 是 不 变 的 开始 或 结束 时 间 指 定 为 挂钟 时 间 的 模式 。 
它 还 包括 从 类 TimeZone 继承 的 字段 。 


S.N. Hie HAN & 描述 
SimpleTimeZone(int rawOffset, String ID) 此 构造 

1 SimpleTimeZone 与 给 RE COM TR DBD Ree 令 有 时 间 
表 偏 移 。 
SimpleTimeZone(int rawOffset, String ID, int startMonth, int 
startDay, int startDayOfWeek, int startTime, int Saeko int 

2 endDay, int endDayOfWeek, int endTime) 此 构造 
SimpleTimeZone-S24 xE En KGMT fais, B} EID, 以 及 启动 和 结 
RETA LM 
SimpleTimeZone(int rawOffset, String ID, int startMonth, int 
startDay, int startDayOfWeek, int startTime, int endMonth, int 

3 endDay, int endDayOfWeek, int endTime, int dstSavings) 此 构造 一 
个 SimpleTimeZone 与 给 定 基准 时 区 GMT 偏 移 量 ， 时 区 ID， 以 及 启动 和 
结束 夏令 时 规则 。 
SimpleTimeZone(int rawOffset, String ID, int startMonth, int 
startDay, int startDayOfWeek, int startTime, int startTimeMode, int 

4 endMonth, int endDay, int endDayOfWeek, int endTime, int 
endTimeMode, int dstSavings) 此 构造 一 个 SimpleTimeZone 与 给 定 基 
准时 区 GMT 偏 移 量 ， 时 区 ID， 以 及 启动 和 结束 夏令 时 规则 。 

类 方法 

S.N. 方法 & 描述 

1 Object clone() 此 方法 返回 当前 的 SimpleTimeZone 实 例 的 一 个 副本 。 

2 boolean equals(Object obj) 此 方法 比较 两 个 的 SimpleTimeZone 对 象 是 
否 相等 。 

3 int getDSTSavings() 此 方法 返回 以 毫秒 为 单位 的 时 钟 是 在 夏 合 时 提前 的 
时 间 量 。 
int getOffset(int era, int year, int month, int day, int dayOfWeek, int 

4 millis) 此 方法 返回 本 地 时 间 与 UTC 之 间 以 毫秒 为 单位 的 差异 ， 同 时 考虑 
到 原始 偏 移 量 和 夏令 时 的 效果 ， 对 于 指定 的 日 期 和 时 间 。 

5 int getOffset(long date) 此 方法 返回 当前 时 区 从 UTC 偏 移 量 在 给 定 的 时 
间 。 

6 int getRawOffset() 此 方法 获取 GMT 这 个 时 区 偏 移 量 。 

7 int hashCode() 此 方法 生成 SimpleDateFormat 对 象 的 哈 希 代码 。 

boolean hasSameRules(TimeZone other) 如 果 此 区 域 具有 相同 的 规则 


和 偏 移 量 为 另 一 个 区 域 ， 此 方法 返回 true。 
boolean inDaylightTime(Date date) 此 方法 查询 ， 如 果 给 定 的 日 期 是 在 
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EN. 
void setDSTSavings(int millisSavedDuringDST) 此 方法 以 毫秒 为 单位 的 


10 时钟 是 在 夏令 时 提前 设 定 的 时 间 量 。 

" void setEndRule(int endMonth, int endDay, int endTime) 此 方法 设置 夏 
使 时 结束 规则 设置 为 某 个 月 份 的 固定 日 期 。 

12 void setEndRule(int endMonth, int endDay, int endDayOfWeek, int 


endTime) 此 方法 设置 夏令 时 结束 规则 。 


void setEndRule(int endMonth, int endDay, int endDayOfWeek, int 
13 endTime, boolean after) 此 方法 设置 夏令 时 结束 规则 到 平日 在 一 个 月 内 
给 定 日 期 之 前 或 之 后 ， 如 第 一 个 星期 一 或 以 后 的 第 8 位 。 


14 void setRawOffset(int offsetMillis) 此 方法 设置 的 基准 时 区 偏 移 为 GMT。 


void setStartRule(int startMonth, int startDay, int startTime) 此 方法 设置 
夏 合 时 开始 规则 设置 为 某 个 月 份 的 固定 日 期 。 


void setStartRule(int startMonth, int startDay, int startDayOfWeek, int 
startTime) 此 方法 设置 夏令 时 开始 规则 。 


void setStartRule(int startMonth, int startDay, int startDayOfWeek, int 
17 startTime, boolean after) 此 方法 之 前 或 之 后 指定 的 日 期 在 一 个 月 之 内 ， 
例如 ， 在 第 一 个 星期 一 或 以 后 的 第 8 位 。 设 置 夏 令 时 开始 规则 工作 日 


18 void setStartYear(int year) 此 方法 设置 夏令 时 的 开始 年 份 。 
19 String toString() 此 方法 返回 当前 时 区 的 字符 串 表 示 形 式 。 
20 boolean useDaylightTime() 此 方法 查询 ， 如 果 此 时 区 使 用 夏令 时 。 


15 


16 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util. TimeZone 


e java.util.Object 


java.util.SimpleTimeZone # - Java.util& 1455 


java.util.Stack X - Java.utila 


java.util.Stack 3: (xxt BI FH (LIFO o 

e 当 创建 一 个 堆栈 ， 它 不 包含 任何 项 。 

。 在 这 个 类 中 ， 插 入 的 最 后 一 个 元 素 会 是 第 一 个 被 访问 。 
类 声明 
以 下 是 java.util.Stack 类 的 声明 : 


public class Stack<E> 
extends Vector<E> 


类 构造 函数 
S.N. HISAR & 描述 
1 Stack() 此 构造 画 数 创建 一 个 空 栈 。 
类 方法 
S.N. 方法 & 描述 
1 boolean empty() 此 方法 测试 堆栈 是 否 为 空 。 


2 E peek() 此 方法 会 查看 该 对 象 在 该 堆栈 的 顶部 而 不 从 栈 中 删除 。 


3 aaa 此 方法 会 删除 在 该 堆栈 的 顶部 的 对 象 ， 并 返回 该 对 象 作为 该 函 
效 的 值 。 


4 E push(E item) 此 方法 推 的 项 目 到 这 个 堆栈 的 顶部 。 
5 int search(Object o) 此 方法 返回 从 1 开始 的 位 置 ， 一 个 对 象 在 栈 中 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Vector 


e java.util.AbstractList 
e java.util.Object 


e java.util.List 


java.util.StringTokenizer # - Java.util 包 
java.util.StringTokenizer 类 人 允许 应 用 程序 将 字符 串 分 解 合 牌 。 

。 由 于 类 保留 兼容 性 的 原因 ， 不 鼓励 使 用 新 的 代码 遗留 下 来 的 关 。 
。 其 方法 不 识别 ， 数 字 和 引用 字符 串 中 区 分 开 来 。 

。 这 个 类 的 方法 甚至 不 承认 和 跳 过 注释 。 


J^ TE 
类 两 明 
以 下 是 java.util.StringTokenizer 类 的 声明 : 


public class StringTokenizer 
extends Object 
implements Enumeration<Object> 


S.N. SBM & 描述 

1 StringTokenizer(String str) LE iS RMF Ee AE PX ds 79 TRAE BJ 
符 串 。 

2 StringTokenizer(String str, String delim) 这 个 构造 范 数 构 造 字符 串 标 
记 为 指定 的 字符 串 。 

3 StringTokenizer(String str String delim, boolean returnDelims) 这 


个 构造 本 数 构造 一 个 字符 串 标 记 为 指定 的 字符 串 。 
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S.N. 方法 & 描述 


int countTokens() 此 方法 计算 的 时 候 ， 这 个 标记 生成 器 的 nextToken 方 
法 可 以 前 它 生成 一 个 异常 被 调用 的 次 数 。 

2 boolean hasMoreElements() 此 方法 返回 hasMoreTokens 方 法 的 相同 的 
值 。 


3 boolean hasMoreTokens() 如 果 此 方法 测试 是 否 有 从 此 标记 生成 的 字符 
串 提 供 更 多 的 标记 。 


4 Object nextElement() 此 方法 返回 nextToken 方 法 相同 的 值 ， 不 同 之 处 在 
于 它 的 声明 的 返回 值 是 Object 而 不 是 String 类 型 。 


5 String nextToken() 此 方法 从 这 个 字符 串 标 记 生 成 器 返回 下 一 个 标记 。 


String nextToken(String delim) 此 方法 返回 这 个 字符 串 标 记 生 成 的 字符 
串 中 的 下 一 个 标记 。 


方法 继承 
这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util.String Tokenizer # - Java.util@ 1459 


java.util. Timer X: - Java.utila 


java.util. Timer 类 提供 了 工具 ， 线 程 调 度 任 务 在 后 台 线 程 中 将 来 执行 。 
e 这 个 类 是 线程 安全 的 ， 即 多 个 线程 可 以 无 需 进 行 外 部 同步 共享 单个 Timer 对 


此 类 安排 任务 执行 一 次 ， 或 者 定期 重复 执行 。 
所 有 构造 函数 启动 一 个 计时 器 线程 。 
类 声明 


以 下 是 java.util.Timer 类 的 声明 : 


public class Timer 
extends Object 


S.N. ISAM & 描述 
1 Timer() 此 构造 本 数 创建 一 个 新 的 计时 器 。 


2 Timer(boolean isDaemon) Lbs Me) E& — Xr; HAAR 
线程 可 以 被 指定 作为 守护 程序 运行 。 


3 Timer(String name) 此 构造 画 数 创建 一 个 新 计时 器 ， 其 相关 的 线程 具 
有 指定 的 名 称 。 


4 Mu ea name, boolean isDaemon) It 4435 E23 6] & — 4 Afri t 
器 ， 其 相关 的 线程 具有 指定 的 名 称 ， 并 且 可 以 指定 作为 守护 程序 运行 。 
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S.N. 方法 & 描述 

1 void cancel() 此 方法 终止 此 计时 器 ， 丢 弃 所 有 当前 已 安排 的 任务 。 

2 int purge() 此 方法 从 这 个 计时 器 的 任务 队列 中 移 除 所 有 已 取消 的 任务 。 
void schedule(TimerTask task, Date time) 此 方法 的 时 间 表 执行 指定 的 


3 任务 在 指定 的 时 间 。 

4 void schedule(TimerTask task, Date firstTime, long period) 此 方法 的 时 
间 表 进行 重复 的 固定 延迟 执行 ， 开 始 指定 的 任务 在 指定 的 时 间 。 

5 void schedule(TimerTask task, long delay) 此 方法 的 时 间 表 指定 的 任务 
在 指定 的 延迟 后 执行 。 

6 void schedule(TimerTask task, long delay, long period) 此 方法 的 时 间 表 


进行 重复 的 固定 延迟 执行 ， 在 指定 的 延迟 后 开始 指定 的 任务 。 
void scheduleAtFixedRate(TimerTask task, Date firstTime, long period) 
7 此 方法 的 时 间 表 进行 重复 的 固定 速率 执行 ， 开 始 在 指定 的 时 间 指 定 的 任 
务 。 
void scheduleAtFixedRate(TimerTask task, long delay, long period) 此 
8 方法 时 间 表 进行 重复 的 固定 速率 执行 ， 在 指定 的 延迟 后 开始 指定 的 任 
务 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util. Timer # - Java.util&J 1461 


java.util. TimerTask X - Java.util@ 


java.util. TimerTask class represents a task that can be scheduled for one-time or 
repeated execution by a Timer. 


xy -—- 
类 两 明 
Following is the declaration for java.util. TimerTask class: 


public abstract class TimerTask 
extends Object 
implements Runnable 


S.N. Hie BM & 描述 
1 protected TimerTask() This constructor creates a new timer task. 


类 方法 


S.N. 方法 & 描述 
1 boolean cancel() 此 方法 将 取消 此 计时 器 任务 。 
2 abstract void run() 此 方法 表示 要 由 该 定时 任务 执行 的 动作 。 


3 long scheduledExecutionTime() 此 方法 返回 当前 任务 最 近 实 际 执行 的 安 
排 执行 时 间 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util. TimeZone X - Java.utila 
java.util.TimeZone 类 表示 时 区 偏 移 量 ， 也 可 以 计算 夏令 时 。 以 下 是 关于 时 区 的 要 
m: 


e 它 考虑 到 了 不 同 的 时 区 。 


。 通过 此 类 别 下 使 用 的 方法 在 任何 一 个 国家 运行 的 程序 ， 获 取 基 于 特定 国家 的 时 
区 的 时 区 对 象 。 


xy = 
AX Fa HH 
LAF java.util. TimeZone 3: WFAA : 


public abstract class TimeZone 
extends Object 
implements Serializable, Cloneable 


ra FEN 二 
字段 域 
以 下 是 java.util.TimeZone 类 中 的 字段 : 


e static int LONG -- 这 是 风格 说 明 符 getDisplayName() 表 示 长 的 名 字 ， 如 “太平 洋 
标准 时 间 ”。 


e static int SHORT -- 这 是 风格 说 明 符 getDisplayName()， 表 示 一 个 简短 的 名 
称 ， 如 “太平 洋 标 准时 间 ”。 


3 M ER BM 
S.N. HIGH & 描述 
1 TimeZone() 3x ^ Mis BAAS RK MD Y — 1 Hew 


类 方法 


S.N. 方法 & 描述 
1 Object clone() 此 方法 创建 这 个 TimeZone 副 本 


2 static String[] getAvailablelDs() 此 方法 获取 所 有 支持 的 可 用 的 ID。 
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3 static String[] getAvailablelDs(int rawOffset) 根据 给 定 的 时 区 以 毫秒 为 
单位 抵消 此 方法 获取 可 用 的 ID。 


4 static TimeZone getDefault() 此 方法 获取 的 默认 为 这 台 主 机 的 时 区 。 
String getDisplayName() 此 方法 返回 适合 于 展示 该 时 区 的 名 称 ， 在 默认 


” ”区域 的 用 户 。 

6 String getDisplayName(boolean daylight, int style) 此 方法 返回 适合 于 展 
示 该 时 区 的 名 称 ， 在 默认 区 域 的 用 户 。 

7 String getDisplayName(boolean daylight, int style, Locale locale) 此 方 
法 返回 适合 于 展示 该 时 区 的 名 称 ， 在 指定 的 区 域 的 用 户 。 

8 String getDisplayName(Locale locale) 此 方法 返回 适合 于 展示 该 时 区 的 
名 称 ， 在 指定 的 区 域 的 用 户 。 

9 int getDSTSavings() 此 方法 返回 的 时 间 为 要 添加 到 本 地 标准 时 间 以 获取 


本 地 挂钟 时 间 。 
10 String getlD() 此 方法 获取 该 时 区 的 ID 


abstract int getOffset(int era, int year, int month, int day, int 
11 dayOfWeek, int milliseconds) 此 方法 获取 的 时 区 偏 移 量 ， 为 当前 日 期 ， 


修改 夏令 时 情况 下 。 

42 int getOffset(long date) 此 方法 返回 从 UTC 偏 移 量 在 指定 的 日 期 的 当前 
时 区 。 

13 abstract int getRawOffset() 此 方法 返回 的 时 间 以 窗 秒 为 单位 添加 到 UTC 
以 获取 标准 时 间 在 这 个 时 区 。 

44 static TimeZone getTimeZone(String ID) 此 方法 获取 的 时 区 为 给 定 的 
ID。 

15 boolean hasSameRules(TimeZone other) 如 果 此 区 域 具有 相同 的 规则 
和 偏 移 量 为 另 一 个 区 域 ， 此 方法 返回 true。 

16 abstract boolean inDaylightTime(Date date) 此 方法 查询 ， 给 定 的 日 期 
是 否 在 夏 合 时 在 该 时 区 。 

17 static void setDefault(TimeZone zone) 此 方法 由 getDefault 方 法 设置 时 


区 ， 方 法 返回 设置 的 时 区 。 
18 void setID(String ID) 此 方法 设置 的 时 区 ID 
abstract void setRawOffset(int offsetMillis) 此 方法 为 GMT 设 置 的 基准 时 


19 ERE. 
20 abstract boolean useDaylightTime() 此 方法 查询 ， 此 时 区 是 否 使 用 夏 兮 
时 。 
方法 继承 
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这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util. TreeMap X - Java.util@ 
java.util. TreeMap 类 是 Red-Black 树 实现 基于 Map 接 口 。 以 下 是 关于 TreeMap 中 重 
要 的 几 点 : 

e TreeMap 类 保证 该 映射 将 是 升序 键 顺序 。 


e 该 映射 是 按照 自然 排序 方法 的 关键 类 ， 或 者 根据 创建 映射 时 提供 的 比较 器 ， 这 
将 取决 于 其 构造 画 数 中 使 用 排序 。 


J^ —L 
A FAR 
DA FB java.util. TreeMap 3: BUF Bj : 


public class TreeMap<K, V> 
extends AbstractMap<k, V» 
implements NavigableMap<K,V>, Cloneable, Serializable 


参数 


以 下 是 java.util.TreeMap 类 的 参数 : 
o K -- 这 是 此 映射 维护 的 键 的 类 型 。 
e. V -- 这 是 映射 值 的 类 型 。 


S.N. 构造 画 数 & 描述 


m ONARI 这 个 构造 画 数 构造 一 个 新 的 ， 空 的 树 映射 ， 使 用 键 的 自然 顺 
Fo 


2 TreeMap(Comparator«? super K> comparator) ix hia WA 438 — 
个 新 的 ， 空 的 树 映射 ， 根 据 给 定 的 比较 器 进行 排序 。 


TreeMap(Map<? extends K,? extends V» m) 这 个 构造 画 数 构造 一 个 


3 新 的 树 映 射 具 有 相同 映射 关系 为 给 定 的 上 映射， 根据 其 键 的 自然 顺序 进行 
排序 。 
4 TreeMap(SortedMap«K,? extends V» m) ix 4 443& BA 4438 — THT 


树 映射 具有 相同 映射 关系 ， 并 使 用 相同 的 顺序 在 指定 的 有 序 映 射 。 


| 
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类 方法 

S.N. 方法 & 描述 

1 Map.Entry«K, V» ceilingEntry(K key) 此 方法 返回 的 最 小 键 大 于 等 于 给 定 
键 ， 则 返回 null 关 联 的 键 - 值 映 射 关 系 ， 如 果 不 存在 这 样 的 键 。 

K ceilingKey(K key) 此 方法 返回 大 于 最 小 键 大 于 或 等 于 给 定 键 ， 或 
null， 如 果 不 存 在 这 样 的 键 。 

3 void clear() 此 方法 移 除 此 映射 中 的 所 有 项 。 

4 Object clone() 此 方法 返回 这 个 TreeMap 实 例 的 浅 表 副本 。 

5 Comparator<? super K> comparator() 此 方法 返回 用 于 排序 的 关键 在 此 
映射 的 比较 器 ， 则 返回 null， 如 果 此 映射 使 用 键 的 自然 顺序 。 

6 boolean containsKey(Object key) 如 果 此 映射 包含 指定 键 的 映射 ， 此 方 
法 返回 true。 

7 boolean containsValue(Object value) 如 果 此 映射 将 一 个 或 多 个 键 映射 
到 指定 值 ， 该 方法 返回 true。 

8 NavigableSet<K> descendingKeySet() 此 方法 返回 此 映射 中 包含 的 键 的 
逆序 NavigableSet 祝 图 。 

9 NavigableMap«K,V» descendingMap() 此 方法 返回 此 映射 中 包含 的 映 
射 关 系 的 逆序 视图 。 

10 Set<Map.Entry<K,V>> entrySet() 此 方法 返回 此 映射 中 包含 的 映射 关系 
的 Set 视 图 。 

1 Map.Entry«K, V» firstEntry() 此 方法 返回 的 最 小 键 在 这 个 映射 中 的 键 - 值 
映射 关系 ， 如 果 映 射 为 空 ， 返 回 null。 

12 K firstKey() 该 方法 返回 此 映射 第 一 个 (最低) 键 。 

13 Map.Entry<K,V> floorEntry(K key) 此 方法 返回 的 最 大 键 小 于 等 于 给 定 键 
关联 的 键 - 值 映 射 关 系 ， 则 返回 null， 如 果 不 存在 这 样 的 键 

14 K floorKey(K key) 此 方法 返回 比 最 大 键 小 于 或 等 于 给 定 键 ， 或 null， 如 
果 不 存 在 这 样 的 键 

15 V get(Object key) 此 方法 返回 指定 键 所 映射 的 值 ， 则 返回 null 如 果 此 了 映 
射 不 包含 该 键 。 

16 SortedMap«K, V» headMap(K toKey) 此 方法 返回 此 映射 的 键 严 格 小 于 
toKey 的 部 分 视图 。 

17 NavigableMap<K,V> headMap(K toKey, boolean inclusive) 此 方法 返回 
此 映射 ， 其 键 小 于 toKey 的 部 分 视图 (或 等 于 ， 如 果 inclusive 为 true) 。 
Map.Entry<K,V> higherEntry(K key) 此 方法 返回 的 返回 具有 最 小 键 严格 

18 大 于 给 定 键 的 关联 的 键 - 值 映 射 关系 ， 则 返回 null， 如 果 不 存 在 这 样 的 
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键 


K higherKey(K key) 此 方法 返回 最 小 键 严格 大 于 给 定 键 ， 则 返回 nul， 
如 果 不 存 在 这 样 的 键 


Set<K> keySet() 此 方法 返回 此 映射 中 包含 的 键 的 Set 视 图 。 


Map.Entry<K,V> lastEntry() 此 方法 返回 此 映射 中 的 最 大 键 的 关联 的 键 - 
值 映射 关系 ， 如 果 映 射 为 空 ， 返 回 null。 


K lastKey() 该 方法 返回 此 映射 最 后 一 个 (最 高 ) 键 。 


Map.Entry<K,V> lowerEntry(K key) 此 方法 返回 的 最 大 键 严格 小 于 给 定 
键 的 关联 的 键 - 值 映 射 关 系 ， 则 返回 null， 如 果 不 存在 这 样 的 键 。 


K lowerKey(K key) 此 方法 返回 的 最 大 键 严 格 小 于 给 定 键 ， 如 果 不 存 在 
这 样 的 键 , 则 返回 null。 

NavigableSet<K> navigableKeySet() 此 方法 返回 此 映射 中 包含 的 键 的 
NavigableSet# 4. 


Map.Entry<K,V> pollFirstEntry() 此 方法 删除 ， 并 返回 具有 最 小 键 在 此 映 
射 中 关联 的 键 - 值 映射 关系 。 如 果 映 射 为 空 ， 返 回 null。 


Map.Entry<K,V> pollLastEntry() 该 方法 移 除 并 返回 与 此 映射 中 的 最 大 键 
的 关联 的 键 - 值 映 射 和 关系 ， 如 果 映 射 为 空 ， 返 回 null。 

V put(K key, V value) 该 方法 将 指定 值 与 此 映射 中 的 指定 键 。 

void putAll(Map<? extends K,? extends V» map) A AKA HAA MB 
定 映射 到 此 映射 中 。 


V remove(Object key) 该 方法 移 除 了 映射 关系 ， 如 果 TreeMap 中 存在 该 
键 。 


int size() 此 方法 返回 此 映射 中 的 键 - 值 映 射 关系 的 数量 。 


NavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K 
toKey, boolean tolnclusive) 此 方法 返回 此 映射 的 键 的 部 分 视图 ， 范 围 从 
fromKey 到 toKey 


SortedMap<K,V> subMap(K fromKey, K toKey) 此 方法 返回 此 映射 的 键 
值 从 fromKey (包括 ) 到 toKey (不 包括 ) 的 部 分 视图 。 


SortedMap<K,V> tailMap(K fromKey) 此 方法 返回 此 映射 ， 其 键 大 于 或 
等 于 fromKey 的 部 分 视图 。 


NavigableMap<K,V> tailMap(K fromKey, boolean inclusive) 此 方法 返 
回 此 映射 ， 其 键 大 于 fromKey 的 部 分 视图 (或 等 于 ， 如 果 inclusive 为 
true) 。 


Collection<V> values() 此 方法 返回 此 映射 中 包含 的 值 的 Collection 视 
Blo 


java.util. TreeMap # - Java.util 包 1468 


方法 继承 

这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractMap 
e java.util.Object 


e java.util.Map 


java.util. TreeSet# - Java.util 包 


java.util.TreeSet 类 实现 Set 接 口 。 以 下 是 关于 TreeSet 的 要 点 : 
TreeSet 类 保证 该 映射 将 在 升序 键 顺序 ， 由 TreeMap 支 持 。 


该 映射 是 按照 自然 排序 方法 该 键 类 ， 或 在 集 创建 时 提供 的 比较 器 ， 这 将 取决 于 
其 构造 图 数 中 使 用 排序 。 


顺序 必须 是 总 为 了 使 树 到 功能 属性 。 


类 声明 


以 下 是 java.util.TreeSet 类 声明 : 


public class TreeSet<E> 
extends AbstractSet<E> 
implements NavigableSet<E>, Cloneable, Serializable 


参数 


以 下 是 java.util.TreeSet 中 类 参数 : 
e E -- 这 是 由 该 组 保持 元 件 的 类 型 。 


KAS WA 


S.N. jie HAN & 描述 

1 TreeSet() 此 构造 一 个 新 的 空 树 集 ， 根 据 其 元 素 的 自然 顺序 进行 排序 。 

2 TreeSet(Collection<? extends E» c) 这 个 构造 画 数 构造 一 个 包含 指定 
合 ， 根 据 其 元 素 的 自然 顺序 进行 排序 的 元 素 的 新 树 集 。 

3 TreeSet(Comparator<? super E> comparator) 此 构造 一 个 新 的 空 树 


集 ， 根 据 指定 的 比较 器 进行 排序 。 


4 TreeSet(SortedSet«E» s) 此 构造 包含 相同 的 元 素 ， 并 使 用 相同 的 顺序 
与 指定 有 序 集 的 新 树 集 。 


ThitnrianleDnint ATA LL 本 xia 
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方法 & 描述 
boolean add(E e) 此 方法 将 指定 的 元 素来 添加 此 set， 如 果 它 是 不 存在 。 


boolean addAll(Collection<? extends E> c) 此 方法 将 所 有 指定 collection 
到 此 set 元 素 。 


E ceiling(E e) 此 方法 返回 的 最 小 元 素 此 设 定 为 大 于 或 等 于 给 定 的 元 素 ， 
或 null， 如 果 不 存 在 这 样 的 元 素 。 


void clear() 此 方法 移 除 此 集合 中 的 元 素 。 
Object clone() 此 方法 返回 这 个 TreeSet 的 实例 的 浅 表 副 本 。 


Comparator<? super E> comparator() 此 方法 返回 用 于 排序 在 此 set 中 ， 
或 返回 null， 如 果 此 set 使 用 其 元 素 的 自然 顺序 比较 。 


boolean contains(Object o) 如 果 此 set 包 含 指 定 的 元 素 此 方法 返回 true。 


lterator<E> descendinglterator() 此 方法 返回 一 个 迭代 器 在 此 set 降 序 排 
列 的 元 素 。 


NavigableSet<E> descendingSet() 此 方法 返回 包含 在 这 个 集合 中 元 素 
的 逆序 视图 。 


E first() 此 方法 在 此 set 目 前 正在 返回 第 一 个 〈 最 低 ) 元 素 。 


E floor(E e) 此 方法 返回 在 此 的 最 大 元 素 设 置 为 小 于 或 等 于 给 定 的 元 素 ， 
或 null， 如 果 不 存 在 这 样 的 元 素 。 


SortedSet<E> headSet(E toElement) 这 个 方法 返回 这 个 集合 ， 其 元 素 
严格 小 于 toElement 的 部 分 视图 。 


NavigableSet<E> headSet(E toElement, boolean inclusive) 此 方法 返回 
这 个 集合 的 元 素 是 小 于 toElement 的 部 分 视图 (或 等 于 ， 如 果 inclusive 为 
true) 。 


E higher(E e) 此 方法 返回 的 最 小 元 素 此 设 定 严格 大 于 给 定 的 元 素 ， 或 
null， 如 果 不 存 在 这 样 的 元 素 。 


boolean isEmpty() 如 果 此 set 不 包含 元 素 ， 此 方法 返回 true。 
lterator<E> iterator() 此 方法 返回 一 个 迭代 器 在 此 set 升 序 排列 元 素 。 
E last) 这 种 方法 在 这 组 目前 正在 返回 最 后 一 个 (最高) 元素。 


E lower(E e) 此 方法 返回 此 set 中 严格 小 于 给 定 的 最 大 元 素 ， 返 回 nul， 
如 果 没 有 这 样 的 元 素 。 


E pollFirst() 此 方法 检索 并 移 除 第 一 个 〈 最 低 ) 元 素 ; 如 果 此 set 为 空 ， 则 
返回 null。 


E pollLast() 此 方法 检索 并 移 除 最 后 一 个 〈 最 高 ) 元 素 ; 如 果 此 set 为 空 ， 


则 返回 null。 


boolean remove(Object o) 该 方法 将 删除 该 组 指定 元 素 (如 果 存 在 ) 。 
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22 int size() 这 个 方法 返回 这 个 集合 〈 其 容量 ) 的 元 素 个 数 。 


NavigableSet<E> subSet(E fromElement, boolean fromlnclusive, E 
23 toElement, boolean tolnclusive) 这 个 方法 返回 这 个 集合 ， 其 元 素 范 围 从 
fromElement 到 toElement 的 部 分 视图 。 


SortedSet<E> subSet(E fromElement, E toElement) 这 个 方法 返回 这 个 
24 集合 ， 其 元 素 范 围 从 fromElement (包括 ) 到 toElement (不 包括 ) 的 部 
分 视图 。 
SortedSet<E> tailSet(E fromElement) 这 个 方法 返回 这 个 集合 ， 其 元 素 
大 于 或 等 于 fromElement 的 部 分 视图 。 


NavigableSet<E> tailSet(E fromElement, boolean inclusive) 这 个 方法 
26 返回 这 个 集合 ， 其 元 素 大 于 fromElement 的 部 分 视图 (或 等 于 ， 如 果 
inclusive 为 true) 。 
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方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractSet 
e java.util.AbstractCollection 
e java.util.Object 


e java.util.Set 


java.util. T. 
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java.util. UUID X - Java.util 包 
java.util.UUID 类 表示 一 个 不 变 的 通用 唯一 标识 符 (UUID)。 以 下 是 有 关 UUID 的 要 
点 : 


e 一 个 UUID 表 示 一 个 128 位 的 值 。 
e 它 是 用 于 创建 随机 文件 名 ， 在 Web 应 用 程序 的 会 话 ID， 事 务 ID 等 。 


e 还 有 UUID 四 种 不 同 的 基本 类 型 : 基于 时 间 ，DCE 安 全 性 ， 基 于 名 称 ， 并 随机 
生成 的 UUID。 


we —L 
类 两 明 
以 下 是 java.util.UUID 类 的 声明 : 


public final class UUID 
extends Object 
implements Serializable, Comparable<UUID> 


S.N. IG AR & 描述 
1 UUID(long mostSigBits, long leastSigBits) 此 构造 使 用 指定 的 数据 一 


个 新 的 UUID。 


oe nint laua F$ ipic 
TutorialsPoint Java 技术 教程 


no 


S.N. 方法 & 描述 

1 int clockSequence() 此 方法 显示 了 与 此 UUID 相 关联 的 时 钟 序列 值 。 

2 int compareTo(UUID val) 此 方法 比较 此 UUID 与 指定 的 UUID。 

3 boolean equals(Object obj) 此 方法 比较 此 对 象 与 指定 对 象 。 

4 Yi CMM fromString(String name) 此 方法 创建 的 字符 串 标准 表示 一 个 

5 E 此 方法 返回 此 UUID 的 128 位 至 少 显著 64 

6 getMostSignificantBits() 此 方法 返回 此 UUID 的 128 位 最 显著 64 位 

7 int hashCode() This method returns a hash code for this UUID. 

8 static UUID nameUUIDFromBytes(byte[] name) 静态 工厂 来 获取 一 个 类 
型 3 (基于 名 称 的 ) ， 根 据 指定 的 字 节 数组 的 UUID。 

9 long node() 此 方法 返回 与 此 UUID 相 关联 的 节点 值 。 

10 Static UUID randomUUID() 静态 工厂 来 获取 一 个 类 型 4〔 伪 随机 生成 ) 
的 UUID。 

11 long timestamp() 此 方法 返回 与 此 UUID 相 关联 的 时 间 惟 值 。 

12 String toString() 此 方法 返回 表示 此 UUID 的 String 对 象 。 

13 int variant() 此 方法 返回 与 此 UUID 相 关联 的 变型 数量 。 

14 int version() 此 方法 消除 了 与 此 UUID 相 关联 的 版 本 号 。 

方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 


e java.util.Object 


java.util. 
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java.util. WeakHashMap X - Java.util@ 


java.util.WeakHashMap 类 是 基于 哈 希 表 Map 类 实现 了 弱 密 钥 。 WeakHashMap 中 
的 条 目 将 自动 被 垃圾 收集 器 ， 当 其 键 不 再 使 用 会 被 删除 。 以 下 是 关于 
WeakHashMap 的 要 点 : 

e 无 论 是 null 值 和 null 键 都 支持 。 

e 像 大 多 数 集合 类 ， 这 个 类 也 没有 同步 。 


e 这 个 类 主要 用 于 与 主要 对 象 的 equals 方 法 测试 ， 使 用 == 操 作 符 对 象 标识 的 使 


e WeakHashMap 每 个 键 对 象 间接 地 存储 为 一 个 弱 引 用 的 引用 。 
e 这 个 类 是 Java 集 合 框架 成 员 。 


= 
类 两 明 
以 下 是 java.util.WeakHashMap 类 的 声明 : 


public class WeakHashMap<K,V> 
extends AbstractMap<K, V> 
implements Map<K, V> 


在 这 里 ，<K> 键 是 由 该 映射 和 <V> 映 射 值 的 类 型 保持 的 类 型 。 


类 构造 函数 


S.N. ERZ & 描述 


1 WeakHashMap() 此 构造 函数 用 于 创建 有 具有 上 默认 初始 容量 (16) 和 加 载 
因子 (0.75) 在 空 的 WeakHashMap 中 。 


2 WeakHashMapiint initialCapacity) Jb is ERq23 FH T- 6] E& EU 2^ END 
始 容量 和 默认 加 载 因子 (0.75) 在 空 的 WeakHashMap 中 。 


3 WeakHashMapiint initialCapacity, float loadFactor) Jb (ig WA 
创建 具有 给 定 的 初始 容量 和 给 定 的 负载 因子 在 空 的 WeakHashMap 中 。 
4 | extends K,? extends V» m) 此 构造 画 数 用 于 


一 个 新 WeakHashMap 中 具有 相同 的 映射 关系 与 指定 映射 。 


TutorialsPoint Java 技术 教程 
S.N. 方法 & 描述 
1 void clear() 此 方法 移 除 此 映射 中 。 


2 boolean containsKey(Object key) 如 果 此 映射 包含 指定 键 的 映射 此 方法 
返回 true。 


boolean containsValue(Object value) 如 果 此 映射 将 一 个 或 多 个 键 映射 
到 指定 值 ， 该 方法 返回 true。 


4 Set<Map.Entry>K,V>> entrySet() 此 方法 返回 此 映射 中 包含 的 映射 关系 


的 Set 视 图 。 

5 v get(Object key) 此 方法 返回 指定 键 所 映射 的 值 ， 则 返回 null 如 果 此 映射 
不 包含 该 键 。 

6 boolean isEmpty() 如 果 此 映射 不 包含 键 - 值 映射 关系 ， 此 方法 返回 
true。 


7 Set<K> keySet() 此 方法 返回 此 映射 中 包含 的 键 的 Set 视 图 。 
8 v put(K key, V value) 此 方法 将 指定 值 与 此 映射 中 的 指定 的 键 。 


void putAll(Map<? extends K,? extends V» m) 此 方法 会 将 所 有 从 指定 
映射 到 此 映射 中 。 


10 v remove(Object key) 此 方法 删除 映射 关系 ， 这 种 弱 哈 希 映射 中 的 键 
(如 果 存 在 ) 。 


11 int size() 此 方法 返回 此 映射 中 的 键 - 值 映 射 关系 数量 。 


Collection<V> values() 此 方法 返回 此 映射 中 包含 的 值 的 Collection 视 
图 。 


方法 继承 


这 个 类 从 以 下 类 继承 的 方法 : 
e java.util.AbstractMap 
e java.lang.Object 


e java.util.Map 


TAI ti \AlanLLIachhN Anan 3 ANT £11 七 ] AA7R 
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java.util.Interfacest£ L1 - Java.util& 


java.util. Interfaces 包含 集合 框架 ， 遗 留 的 collection 类 ， 事 件 模型 ， 日 期 和 时 间 ， 
国际 化 和 各 种 实用 工具 类 (字符 串 标记 生成 器 ， 随 机 数 生 成 器 和 位 数组 )。 


接口 概要 


S.N. 


接口 与 说 明 
Collection<E> 这 是 在 集 层 次 结构 的 根 接口 。 


Comparator<T> 这 是 一 个 比较 函数 强行 对 某 些 对 象 collection 进 行 整体 
排序 。 


Deque<E> 这 是 支持 元 素 插 入 和 移 除 在 两 端 一 个 线性 的 集合 。 


Enumeration<E> 这 是 一 个 对 象 ， 它 实现 Enumeration 接 口 生成 一 系列 
IER eM 


EventListener 这 是 一 个 标记 接口 的 所 有 事件 侦 听 器 接口 必须 扩展 。 


Formattable 这 是 Formattable 接 口 必 须 由 需要 执行 自 定义 使 用 格式 化 
的 's' 转 换 说 明 符 的 任何 类 中 实现 。 


Iterator«E» 这 是 一 个 迭代 器 的 集合 
List<E> 这 是 一 个 有 序 NEUEM 序列 )。 


Listlterator<E> Z ERARA, WEE A Ki DREAM, 
代 期 间 修 改 列表 ， 并 获得 该 列表 中 的 迭代 器 的 当前 位 置 。 


Map<K,V> 这 是 一 个 键 映射 到 值 的 对 象 。 
Map.Entry<K,V> 这 是 一 个 映射 项 ( 键 - 值 对 )。 


NavigableMap<K,V> 这 是 扩展 了 导航 方法 返回 给 定 搜索 目标 最 接近 的 
匹配 一 个 SortedMap。 


NavigableSet<E> 这 是 扩展 了 导航 方法 报告 给 定 搜索 目标 最 接近 的 匹配 
项 的 SortedSet。 


Observer 这 是 一 个 类 可 以 实现 Observer 接口 时 ， 它 希望 被 告知 改变 观 
察 的 对 象 。 


Queue<E> 这 是 设计 处 理 之 前 持 有 的 元 素 的 集合 


RandomAccess() 这 是 List 实 现 所 使 用 ， 以 表明 其 支持 快速 (通常 是 固定 
时 间 ) 随 机 访问 标记 接口 。 


Set«E» 这 是 不 包含 重复 的 元 素 的 集合 
SortedMap<K,V> 这 是 一 个 映射 还 提供 了 对 键 的 总 体 排序 。 
SortedSet<E> 这 是 一 组 还 提供 了 关于 其 元 素 的 总 排序 。 


java.util.Exceptionst£ L1 - Java.util@ 


java.util.Exceptions B&RR, stEPBJcollectionXx, BARA, ARAMA 
间 ， 国 际 化 和 各 种 实用 工具 类 (字符 串 标记 生成 器 ， 随 机 数 生成 器 和 位 数组 )。 


接口 概要 


S.N. 


1 


接口 与 说 明 


ConcurrentModificationException 此 异常 可 能 由 已 检测 到 对 象 的 并 发 
修改 时 ， 这 种 修改 是 不 允许 的 方法 抛 出 。 


DuplicateFormatFlagsException 这 是 未 经 检查 的 异常 时 ， 在 格式 说 
明 符 中 提供 重复 标志 抛 出 。 


EmptyStackException 这 是 通过 在 Stack 类 的 方法 抛 出 ， 指 示 堆 栈 为 


yu 
一 一心 


FormatFlagsConversionMismatchException 这 是 未 经 检查 的 异常 抛 
出 时 ， 转 换 和 标志 是 不 相 容 的 。 


FormatterClosedException 这 是 未 经 检查 的 异常 抛 出 时 ， 格 式 化 已 被 


天 闭 。 
lllegalFormatCodePointException 这 是 未 经 检查 的 异常 时 ， 通 过 
Character.isValidCodePoint (int) 定义 了 一 个 无 效 的 Unicode 代 码 点 的 


字符 传递 给 格式 化 抛 出 。 

IllegalFormatConversionException 这 是 未 经 检查 的 异常 抛 出 时 ， 对 
应 于 格式 说 明 符 的 参数 是 不 兼容 的 类 型 。 

IllegalFormatException 这 是 未 经 检查 的 异常 时 抛 出 一 个 格式 字符 串 包 
含 非法 语法 或 格式 说 明 符 是 与 给 定 参数 不 兼容 。 
IllegalFormatFlagsException 这 是 未 经 检查 的 异常 抛 出 一 个 非法 组 合 
标志 时 给 出 。 

IllegalFormatPrecisionException 这 是 未 经 检查 的 异常 抛 出 时 的 精度 
是 其 他 的 负 值 比 -1， 转 换 不 支持 某 个 精度 或 者 值 在 其 他 方面 不 受 支持 。 
IllegalFormatWidthException 这 是 未 经 检查 的 异常 时 抛 出 的 幅面 宽度 
为 负 值 除 -1 以 外 或 其 他 不 受 支持 。 

InputMismatchException 这 是 由 扫描 器 抛 出 ， 指 示 检 索 到 的 令 牌 不 匹 
配 的 格局 ， 为 预期 的 类 型 ， 或 者 该 标记 超出 范围 的 预期 的 类 型 。 


InvalidPropertiesFormatException 这 被 抛 出 ， 指 示 操 作 无 法 完成 ， 
因为 输入 不 符合 相应 的 XML 文档 类 型 的 属性 的 集合 ， 按 照 Properties 规 
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MissingFormatArgumentException 这 是 未 经 检查 的 异常 抛 出 时 ， 有 
一 个 格式 说 明 符 没有 相应 的 参数 ， 或 者 参数 索引 引用 了 不 存在 的 说 法 。 


MissingFormatWidthException 这 是 未 经 检查 的 异常 时 ， 格 式 化 宽度 
必须 抛 出 。 


MissingResourceException 这 标志 着 一 个 资源 丢失 。 


NoSuchElementException 这 是 通过 枚 举 的 nextElement 方 法 抛 出 ， 表 
明 有 枚 举 没有 更 多 的 元 素 。 

TooManyListenersException 这 是 用 来 作为 Java 事 件 模型 的 一 部 分 注 
释 和 实施 的 多 播 事件 源 的 单 播 特例 。 
UnknownFormatConversionException 这 是 未 经 检查 的 异常 抛 出 一 
个 未 知 的 转换 时 给 出 。 


UnknownFormatFlagsException 这 是 未 经 检查 的 异常 抛 出 一 个 未 知 
的 标志 时 给 出 。 


java.util.Formatter.BigDecimalLayoutForm?z O 
- Java.util 包 


java.util.Formatter.BigDecimalLayoutForm 枚 举 提供 了 可 用 的 祥 式 格式 非常 大 的 
十 进 制 数 。 


Enum declaration 
L F java.util. -Formatter.BigDecimalLayoutForm#< #4 BY zs Bj : 
public static enum Formatter.BigDecimalLayoutForm 
extends Enum<Formatter .BigDecimalLayoutForm> 
Constants 


LAF java.util. -Formatter.BigDecimalLayoutFormM@ A $$ Œ : 
e DECIMAL FLOAT -- 正常 使 用 十 进 制 / 浮 点 数 风 格 表示 BigDecimals。 
e SCIENTIFIC -- 用 科学 的 风格 表示 BigDecimals。 


枚 举 方法 


S.N. 方法 & 描述 

1 static Formatter.BigDecimalLayoutForm valueOf(String name) 此 
方法 返回 这 个 类 型 具有 指定 名 称 的 枚 举 常 量 。 

2 static Formatter.BigDecimalLayoutForm[] values() 此 方法 返回 一 个 


包含 该 枚 举 类 型 的 常量 数组 的 顺序 被 声明 。 


Java XML 教程 


XML (可 扩展 标记 语言 ) 是 一 种 很 流行 的 简单 的 基于 文本 的 语言 来 用 作 应 用 程序 之 
间 的 通信 模式 。 它 被 认为 是 传输 标准 装置 和 存储 数据 。JAVA 提 供 了 极 好 的 支持 和 让 
富 的 库 来 解析 ， 修 改 或 查询 XML 文档 。 


XML 是 什么 ? 
XML 是 一 种 简单 的 基于 文本 的 语言 ， 它 被 设计 为 储存 和 运输 以 纯 文本 格式 的 数据 。 
它 代表 着 可 扩展 标记 语言 。 以 下 是 一 些 XML 的 显 着 特征 。 

e XML 是 一 种 标记 语言 。 

e XML 是 一 种 标记 语言 就 像 HTML 一 样 。 

e XML 标签 不 是 像 HTML 那 样 预定 义 。 

e 可 以 定义 自己 的 标签 ， 这 就 是 为 什么 它 被 称 为 可 扩展 的 语言 。 

e XML 标签 被 设计 成 自 描 述 性 的 。 

e XML 是 W3C 推 荐 用 于 数据 存储 和 传输 。 


示例 


<?xml version="1.0"?> 
<Class> 
<Name>First</Name> 
<Sections> 
<Section> 
<Name>A</Name> 
<Students> 
<Student>Rohan</Student> 
<Student>Mohan</Student> 
<Student>Sohan</Student> 
<Student>Lalit</Student> 
<Student>Vinay</Student> 
</Students> 
</Section> 
<Section> 
<Name>B</Name> 
<Students> 
<Student>Robert</Student> 
<Student>Julie</Student> 
<Student>Kalie</Student> 
<Student>Michael</Student> 
</Students> 
</Section> 
</Sections> 
</Class> 


优势 
以 下 是 XML 提供 的 优势 : 


e 技术 无 关 - 作为 普通 文本 ，XML 是 技术 独立 。 它 可 以 用 于 由 任何 技术 进行 数据 
的 存储 和 传输 的 目的 。 


e A n] i - XML 使 用 简单 的 文本 格式 。 它 是 人 类 可 读 和 可 以 理解 的 。 
e 可 扩展 性 - 在 XML， 自 定义 标签 可 以 创建 和 很 容易 使 用 。 
e 人 允许 验证 - 使 用 XSD，DTD 和 XML 结构 可 以 很 容易 地 验证 。 


缺点 
下 面 是 使 用 XML 的 缺点 : 
e TRITA - 通常 XML 文件 中 包含 大 量 的 重复 计算 。 
e JUA - 作为 一 个 兄长 的 语言 ，XML 文 件 大 小 增加 了 传输 和 存储 成 本 。 


Java XML 解析 器 - Java XML 教程 


什么 是 XML 解析 ? 
解析 XML 是 指 和 将 通过 XML 文档 访问 数据 或 修改 数据 的 一 个 操作 或 方法 。 
XML 解析 器 是 什么 ? 


XML 解析 器 提供 方法 来 访问 或 修改 XML 文档 中 的 数据 。 Java 提 供 了 多 种 选择 来 解 
析 XML 文 档 。 以 下 是 各 种 类 型 解析 器 其 通常 用 于 解析 XML 文档 。 


Domf@it ax - 解析 通过 加 载 该 文件 的 全 部 内 容 ， 并 创建 其 完整 分 级 树 中 存储 的 
文件 。 


SAX MPT as - 解析 基于 事件 触发 器 的 文档 。 不 完整 (部 分 ) 的 文件 加 载 到 存储 器 
中 。 


JDOM 解 析 器 - 解析 以 类 似 的 方式 ， 以 DOM 解 析 器 但 更 简单 的 方法 的 文档 。 
StAX 解 析 器 - 解析 以 类 似 的 方式 ， 以 SAX 解 析 器 但 在 更 高 效 的 方式 的 文档 。 
XPath 解析 器 - 解析 基于 表达 式 XML 并 广泛 选择 使 用 XSLT。 


DOM4J 解 析 器 - Java 库 来 解析 XML，XPath 和 使 用 Java 集 合 框架 XSLT， 为 
DOM，SAX 和 JAXP 的 支持 。 


JAXB 和 XSLT 的 AP| 来 处 理 XML 人 解析 在 面向 对 象 方法 。 我 们 将 详细 一 个 一 个 阅 述 解 
析 器 在 下 一 章节 。 


Java DOM 解 析 器 - Java XML 教程 


文档 对 象 模型 是 万 维 网 联盟 (W3C) 的 官方 推荐 。 它 定义 了 一 个 接口 ， 使 程序 能 够 访 
问 和 更 新 祥 式 ， 结 构 和 XML 文档 的 内 容 。 支 持 DOM 实 现 该 接口 的 XML 解析 器 。 
何 时 使 用 ? 
在 以 下 几 种 情况 时 ， 应 该 使 用 DOM 解 析 器 : 

e 需要 知道 很 多 关于 文档 的 结构 

e 需要 将 文档 的 部 分 周围 (例如 ， 可 能 需要 某 些 元 素 进 行 排序 ) 

e 需要 使 用 的 文件 中 的 信息 超过 一 次 


会 得 到 什么 ? 

当 使 用 DOM 解析 器 解析 一 个 XML 文档 ， 会 得 到 一 个 树 形 结构 ， 其 中 包含 的 所 有 文 
档 的 元 素 。 DOM 提 供 了 多 种 可 用 于 检查 文档 的 内 容 和 结构 的 回 数 。 

优势 

DOM 是 用 于 处理 文 档 结 构 的 通用 接口 。 它 的 一 个 设计 目标 是 Java 代 码 编写 一 个 
DOM 兼 容 的 解析 器 ， 运 行 在 任何 其 他 的 DOM 兼 容 的 解析 器 不 会 有 变化 。 


DOM 接 口 


DOM 定 义 了 几 个 Java 接 口 。 这 里 是 最 常见 的 接口 : 
。 节 点 - DOM 的 基本 数据 类 型 。 
e 元 素 - 要 处 理 的 对 象 绝 大 多 数 是 元 素 。 
。 Attr - 代表 元 素 的 属性 。 
e 文本 - 元 素 或 Attr 的 实际 内 容 。 
。 文档 - 代表 整个 XML 文档 。 文 档 对 象 是 通常 被 称 为 DOM 树 。 


常见 的 DOM 方 法 
当 正 在 使 用 DOM， 有 经 常用 到 的 几 种 方法 : 


Document.getDocumentElement() - 返回 文档 的 根 元 素 。 
Node.getFirstChild() - 返回 给 定 节点 的 第 一 个 子 节 点 。 
Node.getLastChild() - 返回 给 定 节 点 的 最 后 一 个 子 节点 。 
Node.getNextSibling() - 这 些 方法 返回 一 个 特定 节点 的 下 一 个 兄弟 节点 。 
Node.getPreviousSibling() - 这 些 方 法 返回 一 个 特定 节点 的 前 一 个 兄弟 节点 。 


Node.getAttribute(attrName) - 对 于 给 定 的 节点 ， 则 返回 所 请 求 的 名 字 的 属 
性 。 


Java DOM 解 析 器 - 解析 XML 文档 - Java XML 教程 


使 用 DOM 的 步骤 


以 下 是 在 使 用 DOM 解 析 器 解析 文档 使 用 的 步骤 。 
e. 导 人 XML 相关 的 软件 包 。 
e 创建 DocumentBuilder 
。 从 文件 或 流 创 建 一 个 文档 
。 提取 根 元 素 
。 检查 属性 
。 检查 子 元 素 
导入 XML 相 关 的 软件 包 


import org.w3c.dom.*; 
import javax.xml.parsers.*; 
import java.io.*; 


创建 DocumentBuilder 


DocumentBuilderFactory factory - 
DocumentBuilderFactory.newInstance(); 
DocumentBuilder builder - factory.newDocumentBuilder(); 


从 文件 或 流 创 建 一 个 文档 


StringBuilder xmlStringBuilder = new StringBuilder(); 

xmlStringBuilder.append("«?xml version="1.0"?> «class» </class>"); 

ByteArrayInputStream input = new ByteArrayInputStream( 
xmlStringBuilder.toString().getBytes("UTF-8")); 

Document doc - builder.parse(input); 


二 Bil 
提取 根 元 素 


Element root = document.getDocumentElement(); 


检查 属性 


//returns specific attribute 
getAttribute("attributeName"); 
//returns a Map (table) of names/values 
getAttributes(); 


//returns a list of subelements of specified name 
getElementsByTagName ( " subelementName"); 

//returns a list of all child nodes 
getChildNodes(); 


演示 示例 
这 是 输入 需要 解析 的 xml 文件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


演示 示例 : 


DomParserDemo.java 


package com.yiibai.xml; 


import java.io.File; 

import javax.xml.parsers.DocumentBuilderFactory; 
import javax.xml.parsers.DocumentBuilder ; 

import org.w3c.dom.Document; 

import org.w3c.dom.NodeList; 

import org.w3c.dom.Node; 

import org.w3c.dom.Element; 


public class DomParserDemo { 
public static void main(String[] args){ 


try { 
File inputFile = new File("input.txt"); 
DocumentBuilderFactory dbFactory 
= DocumentBuilderFactory.newInstance(); 
DocumentBuilder dBuilder = dbFactory.newDocumentBuilder(), 
Document doc = dBuilder.parse(inputFile); 
doc.getDocumentElement().normalize(); 
System.out.println("Root element :" 
+ doc.getDocumentElement().getNodeName( )); 
NodeList nList = doc.getElementsByTagName( student"); 
System.out.println("---------------------------- MN 
for (int temp = 0; temp < nList.getLength(); temp++) { 
Node nNode - nList.item(temp); 
System.out.println("NnCurrent Element :" 
+ nNode.getNodeName( )); 
if (nNode.getNodeType() == Node.ELEMENT NODE) { 
Element eElement - (Element) nNode; 
System.out.println("Student roll no : 
* eElement.getAttribute("rollno")); 
System.out.println("First Name : " 
* eElement 
.getElementsByTagName("firstname") 
.item(0) 
.getTextContent()); 
System.out.println("Last Name : " 
* eElement 
.getElementsByTagName("lastname") 
.item(0) 
.getTextContent ( )); 
System.out.println("Nick Name : " 
* eElement 
.getElementsByTagName( "nickname") 
.item(0) 
.getTextContent()); 
System.out.println("Marks : " 
* eElement 
.getElementsByTagName( "marks" ) 
.item(0) 
.getTextContent( )); 


j 


} catch (Exception e) { 


e.printStackTrace(); 


} 
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这 将 产生 以 下 结果 : 


Root element :class 


Current Element :student 
Student roll no : 393 
First Name : dinkar 

Last Name : kad 

Nick Name : dinkar 

Marks : 85 


Current Element :student 
Student roll no : 493 
First Name : Vaneet 

Last Name : Gupta 

Nick Name : vinni 

Marks : 95 


Current Element :student 
Student roll no : 593 
First Name : jasvir 

Last Name : singn 

Nick Name : jazz 

Marks : 90 


Java DOM 解 析 器 - 查询 XML 文档 - Java XML 教程 


演示 示例 
这 是 需要 我 们 查询 的 输入 XML 文件 : 


<?xml version="1.0"?> 
<cars> 
«supercars company="Ferrari"> 
<carname type="formula one">Ferarri 101</carname> 
«carname type="Sports car">Ferarri 201</carname> 
<carname type="Sports car">Ferarri 301</carname> 
</supercars> 
<supercars company="Lamborgini"> 
<carname>Lamborgini 001</carname> 
<carname>Lamborgini 002</carname> 
<carname>Lamborgini 003</carname> 
</supercars> 
«luxurycars company="Benteley"> 
<carname>Benteley 1</carname> 
<carname>Benteley 2</carname> 
<carname>Benteley 3</carname> 
</luxurycars> 
</cars> 


演示 示例 : 


QueryXmlFileDemo.java 


package com.yiibai.xml; 


import javax.xml.parsers.DocumentBuilderFactory; 
import javax.xml.parsers.DocumentBuilder; 

import org.w3c.dom.Document; 

import org.w3c.dom.NodeList; 

import org.w3c.dom.Node; 

import org.w3c.dom.Element; 

import java.io.File; 


public class QueryXmlFileDemo { 


public static void main(String argv[]) { 


try { 
File inputFile - new File("input.txt"); 
DocumentBuilderFactory dbFactory - 
DocumentBuilderFactory.newInstance(); 


DocumentBuilder dBuilder = dbFactory.newDocumentBuilder(), 
Document doc = dBuilder.parse(inputFile) ; 
doc.getDocumentElement().normalize(); 
System.out.print("Root element: "); 
System.out.println(doc.getDocumentElement().getNodeName( ): 
NodeList nList = doc.getElementsByTagName("supercars"); 
System.out.println("---------------------------- ys 
for (int temp = 0; temp < nList.getLength(); temp++) { 
Node nNode - nList.item(temp); 
System.out.println("NnCurrent Element :"); 
System.out.print(nNode.getNodeName( )); 
if (nNode.getNodeType() == Node.ELEMENT NODE) { 
Element eElement - (Element) nNode; 
System.out.print("company : "); 
System.out.println(eElement.getAttribute("company"): 
NodeList carNameList = 
eElement.getElementsByTagName("carname"); 
for (int count = 0; 
count < carNameList.getLength(); count++) { 
Node node1 = carNameList.item(count); 
if (node1.getNodeType() == 
nodei1.ELEMENT_NODE) { 
Element car = (Element) node1; 
System.out.print("car name : "); 
System.out.println(car.getTextContent()); 
System.out.print("car type : "); 
System.out.println(car.getAttribute("type")); 


j 


} catch (Exception e) { 
e.printStackTrace(); 


Root element :cars 


Current Element :supercars 
company : Ferrari 

car name : Ferarri 101 

car type : formula one 

car name : Ferarri 201 

car type : sports car 

car name : Ferarri 301 

car type : sports car 


Current Element :supercars 
company : Lamborgini 

car name : Lamborgini 001 
car type : 

car name : Lamborgini 002 
car type : 

car name : Lamborgini 003 
car type : 


Java DOM 解 析 器 - 修改 XML 文档 - Java XML 教程 


演示 示例 
这 是 我 们 需要 修改 的 输入 XML 文件 : 


<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
<cars> 
«supercars company="Ferrari"> 
<carname type="formula one">Ferrari 101</carname> 
<carname type="Sports">Ferrari 202</carname> 
</supercars> 
<luxurycars company="Benteley"> 
<carname>Benteley 1</carname> 
<carname>Benteley 2</carname> 
<carname>Benteley 3</carname> 
</luxurycars> 
</cars> 


演示 示例 : 


ModifyXmlFileDemo.java 


package com.yiibai.xml; 


import java.io.File; 

import javax.xml.parsers.DocumentBuilder; 
import javax.xml.parsers.DocumentBuilderFactory; 
import javax.xml.transform.Transformer; 

import javax.xml.transform.TransformerFactory; 
import javax.xml.transform.dom.DOMSource; 
import javax.xml.transform.stream.StreamResult; 
import org.w3c.dom.Document; 

import org.w3c.dom.Element; 

import org.w3c.dom.NamedNodeMap; 

import org.w3c.dom.Node; 

import org.w3c.dom.NodeList; 


public class ModifyXmlFileDemo { 


public static void main(String argv[]) { 


try { 
File inputFile = new File("input.xml"); 
DocumentBuilderFactory docFactory = 
DocumentBuilderFactory.newInstance(); 
DocumentBuilder docBuilder - 


docFactory.newDocumentBuilder(); 

Document doc - docBuilder.parse(inputFile); 

Node cars - doc.getFirstChild(); 

Node supercar = doc.getElementsByTagName("supercars").item(0: 
// update supercar attribute 

NamedNodeMap attr - supercar.getAttributes(); 

Node nodeAttr - attr.getNamedItem("company"); 
nodeAttr.setTextContent("Lamborigini"); 


// loop the supercar child node 
NodeList list - supercar.getChildNodes(); 
for (int temp = 0; temp < list.getLength(); temp++) { 
Node node - list.item(temp); 
if (node.getNodeType() == Node.ELEMENT NODE) { 
Element eElement - (Element) node; 
if ("carname".equals(eElement.getNodeName()))( 
if("Ferrari 101".equals(eElement.getTextContent())): 
eElement.setTextContent("Lamborigini 001"); 
} 


if("Ferrari 202".equals(eElement.getTextContent())) 
eElement.setTextContent("Lamborigini 002"); 
j 


} 

} 

NodeList childNodes = cars.getChildNodes(); 

for(int count = ©; count < childNodes.getLength(); count++){ 
Node node = childNodes.item(count); 
if("luxurycars".equals(node.getNodeName())) 

cars.removeChild(node); 

} 


// write the content on console 
TransformerFactory transformerFactory = 
TransformerFactory.newInstance(); 
Transformer transformer = transformerFactory.newTrans forme 
DOMSource source = new DOMSource(doc); 
System.out.println("----------- Modified File----------- d) 
StreamResult consoleResult - new StreamResult(System.out), 
transformer.transform(source, consoleResult); 

) catch (Exception e) { 
e.printStackTrace(); 





----------- Modified File----------- 

<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
<cars> 

<supercars company="Lamborigini"> 

<carname type="formula one">Lamborigini 001</carname> 
<carname type="sports">Lamborigini 002</carname> 
</supercars></cars> 


Java SAX 解 析 器 - Java XML 教程 


SAX( 针 对 XML 的 简单 API) 是 基于 事件 为 XML 文档 的 解析 器 。 不 像 DOM 解 析 器 ， 
SAX 解 析 器 创建 没有 解析 树 。 SAX 是 一 个 流 接 口 用 于 XML 的 ， 这 意味 着 使 用 SAX 应 
用 接收 事件 通知 有 关 XML 文 档 被 处 理 的 元 素 ， 属 性 ， 在 按 顺 序 每 次 开始 在 文档 的 顶 
部 ， 并 与 所 述 闭 合 结束 根 元 素 。 


e. 读 取 XML 文 件 从 上 到 下 ， 构 成 一 个 结构 完整 的 XML 文档 的 标记 
e 兮 牌 以 相同 的 顺序 进行 处 理 ， 它 们 出 现在 文档 中 

e 报告 应 用 程序 ， 因 为 它们 所 出 现 解 析 器 遇 到 标记 的 特性 

e 应 用 程序 提供 了 必须 的 解析 器 注册 的 “事件 ”处理 程序 

e 作为 标记 标识 ， 在 处 理 程序 回调 方法 相关 信息 调用 


什么 时 候 使 用 ? 


应 该 使 用 SAX 解 析 器 的 时 候 : 
e. 可 以 在 XML 文档 从 上 往 下 义理 以 线性 方式 
。 该 文件 并 不 深层 次 谋 套 


。 处 理 一 个 非常 大 的 XML 文 档 ，DOM 树 会 占用 太 多 的 内 存 。 典 型 DOM 的 实现 使 
用 10 字 节 的 存储 器 以 表示 XML 的 一 个 字 节 


。 解决 的 问题 涉及 的 XML 文 档 的 一 部 分 


e 数据 是 可 用 的 ， 只 要 它 是 由 解析 器 看 出 ， 这 样 的 SAX 可 以 很 好 地 用 于 到 达 流 的 
XML 文 档 


SAX 的 缺点 


e 它 是 在 一 个 只 进入 处 理 随机 访问 方式 XML 文 档 
e 如 果 需 要 跟踪 的 数据 分 析 器 已 经 看 到 或 更 改 项 目的 顺序 ， 必 须 自 己 编 写 代 码 和 
数据 存储 


ContentHandler 接 口 


此 接口 指定 SAX 解 析 器 用 来 通知 XML 文 档 ， 已 经 看 到 部 件 应 用 程序 的 回调 方法 。 
e void startDocument() - 调用 在 一 个 文件 的 开头 。 


void endDocument() - 调用 在 一 个 文件 的 末尾 。 


void startElement(String uri, String localName, String qName, Attributes 
atts) - 调用 在 一 个 元 素 的 开头 。 


void endElement(String uri, String localName,String qName) - 调用 在 一 
个 元 件 的 末端 。 


e void characters(char[] ch, int start, int length) - 字符 数据 出 现时 调用 。 


void ignorableWhitespace( char[] ch, int start, int length) - 当 DTD 是 当前 
和 忽略 空白 遇 到 时 调用 。 


e void processinglnstruction(String target, String data) - 24 43818 4 BJ; A 


时 调用 。 
e void setDocumentLocator(Locator locator)) - 提供 可 用 于 识别 文档 中 的 位 
置 的 定位 器 。 


e void skippedEntity(String name) - 一 个 尚未 解决 实体 遇 到 时 调用 。 
e void startPrefixMapping(String prefix, String uri) - 当 一 个 新 的 命名 空间 的 


映射 定义 调用 。 
e void endPrefixMapping(String prefix) - 当 一 个 命名 空间 定义 结束 其 范围 时 
调用 。 


属性 接口 


这 种 接口 指定 用 于 处 理 连接 到 一 个 元 素 的 属性 的 方法 。 
e int getLength() - 返回 属性 的 数目 。 
e String getQName(int index) 
e String getValue(int index) 
e String getValue(String qname) 
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演示 示例 
这 是 输入 需要 解析 xml 文 件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


UserHandler. java 


package com.yiibai.xml; 


import org.xml.sax.Attributes; 
import org.xml.sax.SAXException; 
import org.xml.sax.helpers.DefaultHandler; 


public class UserHandler extends DefaultHandler { 


boolean bFirstName - false; 
boolean bLastName - false; 
boolean bNickName - false; 
boolean bMarks - false; 


QOverride 
public void startElement(String uri, 
String localName, String qName, Attributes attributes) 


throws SAXException { 

if (qName.equalsIgnoreCase("student")) { 
String rollNo = attributes.getValue("rollno"); 
System.out.println("Roll No : " + rollNo); 

) else if (qName.equalsIgnoreCase("firstname")) { 
bFirstName - true; 

) else if (qName.equalsIgnoreCase("lastname")) ( 
bLastName - true; 

) else if (qName.equalsIgnoreCase("nickname")) { 
bNickName - true; 


else if (qName.equalsIgnoreCase("marks")) { 
bMarks - true; 
} 
} 


@Override 
public void endElement(String uri, 
String localName, String qName) throws SAXException { 
if (qName.equalsIgnoreCase("student")) { 
System.out.println("End Element :" + qName); 


} 
} 


@Override 
public void characters(char ch[], 
int start, int length) throws SAXException { 
if (bFirstName) { 
System.out.println("First Name: 
+ new String(ch, start, length)); 
bFirstName = false; 
} else if (bLastName) { 
System.out.println("Last Name: 
+ new String(ch, start, length)); 
bLastName = false; 
} else if (bNickName) { 
System.out.println("Nick Name: 
+ new String(ch, start, length)); 
bNickName = false; 
} else if (bMarks) { 
System.out.println("Marks: 
* new String(ch, start, length)); 
bMarks - false; 


SAXParserDemo.java 


package com.yiibai.xml; 


import java.io.File; 
import javax.xml.parsers.SAXParser; 
import javax.xml.parsers.SAXParserFactory; 


import org.xml.sax.Attributes; 
import org.xml.sax.SAXException; 
import org.xml.sax.helpers.DefaultHandler; 


public class SAXParserDemo { 
public static void main(String[] args){ 


try { 
File inputFile = new File("input.txt"); 
SAXParserFactory factory = SAXParserFactory.newInstance(), 
SAXParser saxParser = factory.newSAXParser(); 
UserHandler userhandler = new UserHandler(); 
saxParser.parse(inputFile, userhandler); 

} catch (Exception e) { 
e.printStackTrace(); 

} 


} 


class UserHandler extends DefaultHandler { 


boolean bFirstName = false; 
boolean bLastName = false; 

boolean bNickName = false; 

boolean bMarks = false; 


@Override 
public void startElement(String uri, 
String localName, String qName, Attributes attributes) 
throws SAXException { 
if (qName.equalsIgnoreCase("student")) { 
String rollNo - attributes.getValue("rollno"); 
System.out.println("Roll No : " + rollNo); 
) else if (qName.equalsIgnoreCase("firstname")) { 
bFirstName - true; 
) else if (qName.equalsIgnoreCase("lastname")) { 
bLastName - true; 
) else if (qName.equalsIgnoreCase("nickname")) { 
bNickName - true; 


else if (qName.equalsIgnoreCase("marks")) { 
bMarks - true; 
} 


} 


@Override 

public void endElement(String uri, 
String localName, String qName) throws SAXException { 
if (qName.equalsIgnoreCase("student")) { 


System.out.println("End Element :" + qName); 


} 


@Override 
public void characters(char ch[], 
int start, int length) throws SAXException { 
if (bFirstName) { 
System.out.println("First Name: " 
* new String(ch, start, length)); 
bFirstName - false; 
) else if (bLastName) { 
System.out.println("Last Name: " 
* new String(ch, start, length)); 
bLastName - false; 
) else if (bNickName) { 
System.out.println("Nick Name: " 
* new String(ch, start, length)); 
bNickName - false; 
) else if (bMarks) ( 
System.out.println("Marks: " 
* new String(ch, start, length)); 
bMarks - false; 


j 
LIEN; U 
这 将 产生 以 下 结果 : 


Roll No : 393 

First Name: dinkar 
Last Name: kad 

Nick Name: dinkar 
Marks: 85 

End Element :student 
Roll No : 493 

First Name: Vaneet 
Last Name: Gupta 
Nick Name: vinni 
Marks: 95 

End Element :student 
Roll No : 593 

First Name: jasvir 
Last Name: singn 
Nick Name: jazz 
Marks: 90 

End Element :student 
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演示 示例 
这 是 我 们 需要 查询 耸 号 : rolno 输入 文本 文件 : 393 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


UserHandler. java 


package com.yiibai.xml; 


import org.xml.sax.Attributes; 
import org.xml.sax.SAXException; 
import org.xml.sax.helpers.DefaultHandler; 


public class UserHandler extends DefaultHandler { 


boolean bFirstName - false; 
boolean bLastName - false; 
boolean bNickName - false; 
boolean bMarks - false; 
String rollNo - null; 


QOverride 
public void startElement(String uri, 


String localName, String qName, Attributes attributes) 
throws SAXException { 


if (qName.equalsIgnoreCase("student")) { 
rollNo = attributes.getValue("rollno"); 


} 

if(("393").equals(rollNo) && 
qName.equalsIgnoreCase("student") ){ 
System.out.println("Start Element :" + qName); 

} 

if (qName.equalsIgnoreCase("firstname")) { 
bFirstName = true; 

} else if (qName.equalsIgnoreCase("lastname")) { 
bLastName = true; 

} else if (qName.equalsIgnoreCase("nickname")) { 
bNickName = true; 


else if (qName.equalsIgnoreCase("marks")) { 
bMarks = true; 


} 
} 


@Override 
public void endElement(String uri, 
String localName, String qName) throws SAXException { 
if (qName.equalsIgnoreCase("student")) { 
if( ("393") .equals(rol1No) 
&& qName.equalsIgnoreCase("student") ) 
System.out.println("End Element :" + qName); 


} 


@Override 
public void characters(char ch[], 
int start, int length) throws SAXException { 


if (bFirstName && ("393").equals(rollNo)) { 
//age element, set Employee age 
System.out.println("First Name: " + 
new String(ch, start, length)); 
bFirstName - false; 
) else if (bLastName && ("393").equals(rollNo)) { 
System.out.println("Last Name: " + 
new String(ch, start, length)); 
bLastName - false; 
) else if (bNickName && ("393").equals(rollNo)) { 
System.out.println("Nick Name: " + 
new String(ch, start, length)); 
bNickName - false; 
) else if (bMarks && ("393").equals(rollNo)) { 
System.out.println("Marks: " + 
new String(ch, start, length)); 
bMarks - false; 


SAXQueryDemo.java 


package com.yiibai.xml; 


import 
import 
import 


import 
import 
import 


public 
pub 


j 


class 


java.io.File; 
javax.xml.parsers.SAXParser; 
javax.xml.parsers.SAXParserFactory; 


org.xml.sax.Attributes; 
org.xml.sax.SAXException; 
org.xml.sax.helpers.DefaultHandler; 


class SAXQueryDemo { 
lic static void main(String[] args){ 


try { 
File inputFile = new File("input.txt"); 
SAXParserFactory factory = SAXParserFactory.newInstance(), 
SAXParser saxParser = factory.newSAXParser(); 
UserHandler userhandler = new UserHandler(); 
saxParser.parse(inputFile, userhandler); 

) catch (Exception e) { 
e.printStackTrace(); 


j 


UserHandler extends DefaultHandler { 


boolean bFirstName - false; 
boolean bLastName - false; 
boolean bNickName - false; 
boolean bMarks - false; 
String rollNo - null; 


QOverride 
public void startElement(String uri, 


String localName, String qName, Attributes attributes) 
throws SAXException { 


if (qName.equalsIgnoreCase("student")) { 
rollNo - attributes.getValue("rollno"); 


if(("393").equals(rollNo) && 
qName.equalsIgnoreCase("student"))( 
System.out.println("Start Element :" + qName); 


if (qName.equalsIgnoreCase("firstname")) { 
bFirstName = true; 

} else if (qName.equalsIgnoreCase("lastname")) ( 
bLastName - true; 

) else if (qName.equalsIgnoreCase("nickname")) { 
bNickName - true; 


else if (qName.equalsIgnoreCase("marks")) ( 
bMarks - true; 
y 
J 


@Override 
public void endElement(String uri, 
String localName, String qName) throws SAXException { 
if (qName.equalsIgnoreCase("student")) ( 
if(("393").equals(rollNo) 
&& qName.equalsIgnoreCase("student") ) 
System.out.println("End Element :" + qName); 


} 
} 


@Override 
public void characters(char ch[], 
int start, int length) throws SAXException { 


if (bFirstName && ("393").equals(rollNo)) { 
//age element, set Employee age 
System.out.println("First Name: " + 
new String(ch, start, length)); 
bFirstName - false; 

) else if (bLastName && ("393").equals(rollNo)) ( 
System.out.println("Last Name: " + 
new String(ch, start, length)); 
bLastName - false; 

) else if (bNickName && ("393").equals(rollNo)) { 
System.out.println("Nick Name: " + 
new String(ch, start, length)); 
bNickName - false; 

) else if (bMarks && ("393").equals(rollNo)) ( 
System.out.println("Marks: " + 
new String(ch, start, length)); 
bMarks - false; 





Start Element :student 
First Name: dinkar 
Last Name: kad 

Nick Name: dinkar 
Marks: 85 

End Element :student 
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演示 示例 
这 是 我 们 需要 通过 修改 XML 输入 文件 附加 <Result>Pass<Result/> 


在 </marks> 标 记 结 束 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


SAXModifyDemo.java 


package com.yiibai.xml; 


import java.io.*; 

import org.xml.sax.*; 

import javax.xml.parsers.*; 

import org.xml.sax.helpers.DefaultHandler; 


public class SAXModifyDemo extends DefaultHandler { 
static String displayText[] = new String[1000]; 
static int numberLines - 0; 
static String indentation = ""; 


public static void main(String args[]) { 


try { 


File inputFile = new File("input.txt"); 

SAXParserFactory factory = 

SAXParserFactory.newInstance(); 

SAXModifyDemo obj - new SAXModifyDemo(); 
obj.childLoop(inputFile); 

Filewriter filewriter = new FileWriter("newfile. xml"); 

for(int loopIndex = 0; loopIndex < numberLines; loopIndex- 
filewriter.write(displayText[loopIndex].toCharArray()), 
filewriter.write('\n'); 
System.out.println(displayText[loopIndex].toString()); 

} 


filewriter.close(); 
} 
catch (Exception e) { 
e.printStackTrace(System.err); 
} 


} 


public void childLoop(File input){ 
DefaultHandler handler = this; 
SAXParserFactory factory = SAXParserFactory.newInstance(), 
try { 
SAXParser saxParser = factory.newSAXParser(); 
saxParser.parse(input, handler); 
} catch (Throwable t) {} 


} 


public void startDocument() { 
displayText[numberLines] = indentation; 
displayText[numberLines] += "<?xml version=\"1.0\" encoding=` 
"UTF-8" 4 IN Med 
numberLines++; 


} 


public void processingInstruction(String target, 
String data) { 
displayText[numberLines] = indentation; 
displayText[numberLines] += "<?"; 
displayText[numberLines] += target; 
if (data != null && data. Tengen) > 0) t 
displayText[numberLines] += 
displayText[numberLines] += dem 
} 
displayText[numberLines] += "?>"; 
numberLines++; 
} 
public void startElement(String uri, String localName, 
String qualifiedName, Attributes attributes) { 
displayText[numberLines] = indentation; 


indentation += " ie 


displayText[numberLines] += '«'; 
displayText[numberLines] += qualifiedName; 
if (attributes != null) { 
int numberAttributes = attributes.getLength(); 
for (int loopIndex = 0; loopIndex < numberAttributes; 
loopIndex++) { 
displayText[numberLines] += ' '; 
displayText[numberLines] += attributes. getQName(loopiInc 


displayText[numberLines] += "=\""; 
displayText[numberLines] += attributes.getValue(loopIn: 
displayText[numberLines] += '"'; 
} 
} 
displayText[numberLines] += '>'; 
numberLines++; 


} 


public void characters(char characters[], 
int start, int length) { 
String characterData - (new String(characters, start, length: 
if(characterData.indexOf("Nn") < © && characterData.length() 
displayText[numberLines] - indentation; 
displayText[numberLines] += characterData; 
numberLines++; 


} 


public void endElement(String uri, String localName, 
String qualifiedName) { 
indentation = indentation.substring(0, indentation. length() 
displayText[numberLines] = indentation; 
displayText[numberLines] += "</"; 
displayText[numberLines] += qualifiedName; 
displayText[numberLines] += '>'; 
numberLines++; 


if (qualifiedName.equals("marks")) { 
startElement("", "Result", "Result", null); 
characters("Pass".toCharArray(), 0, "Pass".length()); 
endElement("", "Result", "Result"); 





这 将 产生 以 下 结果 : 


<?xml version="1.0" encoding="UTF-8"?> 
<class> 
<student rollno="393"> 
<firstname> 


dinkar 
</firstname> 
<lastname> 

kad 
</lastname> 
<nickname> 

dinkar 
</nickname> 
<marks> 

85 
</marks> 
<Result> 

Pass 
</Result> 

</student> 
<student rollno="493"> 
«firstname» 

Vaneet 
«/firstname» 
«lastname» 

Gupta 
</lastname> 
<nickname> 

vinni 
</nickname> 
<marks> 

95 
</marks> 
<Result> 

Pass 
</Result> 

</student> 
<student rollno="593"> 
«firstname» 
jasvir 
«/firstname» 
«lastname» 
singn 
«/lastname» 
«nickname» 
jazz 
«/nickname» 
«marks» 

90 
«/marks» 
«Result» 

Pass 
«/Result» 

</student> 
</class> 


Java JDOM 解 析 器 - Java XML 教程 


JDOM 是 一 个 开源 的 ， 基 于 Java 的 库 来 解析 XML 文档 ， 这 是 典型 的 Java 开 发 人 员 友 
好 的 API。 这 是 java 的 优化 ， 它 使 用 Java 集 合 像 列表 和 数组 。 它 适用 于 DOM 和 SAX 
API 并 结合 了 两 个 中 优点 : 低 内 存 占 用 几乎 和 SAX 一 样 快 。 


环境 设置 
为 了 使 用 JDOM 解 析 器 ， 应 该 有 jdom.jar 在 应 用 程序 的 类 路 径 中 。 下 载 jdom- 
2.0.5.zip. 
什么 情况 下 使 用 ? 
应 该 使 用 JDOM 解 析 器 的 情况 : 

e 需要 知道 很 多 关于 文档 的 结构 

e 需要 将 文档 的 部 分 围绕 (例如 ， 可 能 需要 某 些 


e 需要 使 用 的 文件 中 的 信息 超过 一 次 
e Java 开 发 人 员 ， 并 希望 利用 Java 的 优化 解析 XML。 


会 得 到 什么 ? 


当 一 个 JDOM 解析 器 分 析 XML 文 档 ， 可 以 灵活 地 得 到 一 个 树 形 结构 ， 其 中 包含 所 有 
文档 的 元 素 ， 而 不 会 影响 应 用 程序 的 内 存 占用 。JDOM 提 供 了 多 种 可 用 于 检查 的 情 
况 下 的 文件 的 文档 的 内 容 和 结构 的 实用 功能 是 良好 的 结构 ， 其 结构 是 公 知 的 。 


ell 
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优势 


JDOM 使 Java 开 发 灵活 性 和 XML 解 析 代 码 易于 维护 。 它 是 量 轻 级 ， 快 速 APl。 


JDOM # 


JDOM 定 义 了 几 个 Java 类 。 以 下 是 最 常见 的 类 : 
e Document - 表示 整个 XML 文档 。 文 档 Document 对 象 是 通常 被 称 为 DOM 树 。 


e Element - 表示 一 个 XML 元 素 。 Element 对 象 有 方法 来 操作 其 子 元 素 ， 它 的 文 
本 ， 属 性 和 名 称 空间 。 


e Attribute 表示 元 素 的 属性 。 属 性 有 方法 来 获取 和 设置 属性 的 值 。 它 有 家 长 和 
属性 类 型 。 


e Text 表示 XML 标 记 的 文本 。 
e Common 表示 一 个 XML 文 档 中 的 注释 。 


党 见 的 JDOM 方 法 


使 用 JDOM， 还 有 会 经 常用 到 的 几 种 方法 : 
e SAXBuilder.build(xmlSource)() - 构建 XML 源 的 JDOM 文 档 。 
e Document.getRootElement() - 得 到 XML 的 根 元 素 。 
e Element.getName() - 获取 XML 节点 的 名 称 。 
e Element.getChildren() - 得 到 一 个 元 素 的 所 有 直接 子 节点 。 
e Node.getChildren(Name) - 获得 具有 给 定名 称 的 直接 子 节点 。 
e Node.getChild(Name) - 获取 使 用 给 定名 称 的 第 一 个 孩子 节点 。 


Java JDOM 解 析 器 - 解析 XML 文档 - Java XML 教 


程 


使 用 JDOM 的 步骤 


以 下 是 解析 时 使 用 JDOM 解 析 器 文档 的 步骤 。 
e 导 和 人 XML 相关 的 软件 包 
e 创建 一 个 SAXBuilder 
e. 从 文件 或 流 创 建 一 个 文档 
e 提取 根 元 素 
。 检查 属性 
e 检查 子 元 素 
导 和 人 XML 相关 的 软件 包 
import java.io.*; 


import java.util.*; 
import org.jdom2.*; 


创建 DocumentBuilder 


SAXBuilder saxBuilder = new SAXBuilder(); 


从 文件 或 流 创建 一 个 文档 


File inputFile = new File("input.txt"); 
SAXBuilder saxBuilder = new SAXBuilder(); 
Document document - saxBuilder.build(inputFile); 


提取 根 元 素 


Element classElement = document.getRootElement(); 


检查 属性 


//returns specific attribute 
getAttribute("attributeName"); 


//returns a list of subelements of specified name 
getChildren("subelementName"); 

//returns a list of all child nodes 
getChildren(); 

//returns first child node 
getChild("subelementName" ) ; 


演示 示例 
这 是 输入 需要 解析 xml 文 件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


演示 示例 : 


DomParserDemo.java 


import java.io.File; 
import java.io.IOException; 
import java.util.List; 


import org.jdom2.Attribute; 

import org.jdom2.Document; 

import org.jdom2.Element; 

import org.jdom2.JDOMException; 
import org.jdom2.input.SAXBuilder; 


public class JDomParserDemo { 
public static void main(String[] args) { 


try { 
File inputFile - new File("input.txt"); 


SAXBuilder saxBuilder - new SAXBuilder(); 
Document document - saxBuilder.build(inputFile); 


System.out.println("Root element :" 
* document.getRootElement().getName()); 


Element classElement - document.getRootElement(); 


List<Element> studentList = classElement.getChildren(); 
System.out.println("--------------------------- Sur 


for (int temp = 0; temp < studentList.size(); temp++) { 

Element student - studentList.get(temp); 
System.out.println("NnCurrent Element :" 

+ student.getName()); 
Attribute attribute = student.getAttribute("rollno"); 
System.out.println("Student roll no : " 

* attribute.getValue() ); 
System.out.println("First Name : " + student.getChild(' 
System.out.println("Last Name : "+ student.getChild("l: 
System.out.println("Nick Name : "+ student.getChild("n: 
System.out.println("Marks : "+ student.getChild("marks' 


} 
jcatch(JDOMException e){ 


e.printStackTrace(); 
jcatch(IOException ioe){ 
ioe.printStackTrace(); 





Root element :class 


Current Element :student 
Student roll no : 393 
First Name : dinkar 

Last Name : kad 

Nick Name : dinkar 

Marks : 85 


Current Element :student 
Student roll no : 493 
First Name : Vaneet 

Last Name : Gupta 

Nick Name : vinni 

Marks : 95 


Current Element :student 
Student roll no : 593 
First Name : jasvir 

Last Name : singn 

Nick Name : jazz 

Marks : 90 


Java JDOM 解 析 器 - 查询 XML 文档 - Java XML 教 


程 


演示 示例 
这 是 需要 我 们 查询 的 输入 XML 文件 : 


<?xml version="1.0"?> 

<cars> 

<supercars company="Ferrari"> 

<carname type="formula one">Ferarri 101</carname> 
<carname type="Sports car">Ferarri 201</carname> 
«carname type="Sports car">Ferarri 301</carname> 
</supercars> 

<supercars company="Lamborgini"> 
<carname>Lamborgini 001</carname> 
<carname>Lamborgini 002</carname> 
<carname>Lamborgini 003</carname> 

«/supercars» 

«luxurycars company="Benteley"> 
<carname>Benteley 1</carname> 

<carname>Benteley 2</carname> 

<carname>Benteley 3</carname> 

</luxurycars> 

</cars> 


演示 示例 : 


QueryXmlFileDemo.java 


import java.io.File; 
import java.io.IOException; 
import java.util.List; 


import org.jdom2.Attribute; 

import org.jdom2.Document; 

import org.jdom2.Element; 

import org.jdom2.JDOMException; 
import org.jdom2.input.SAXBuilder; 


public class QueryXmlFileDemo { 
public static void main(String[] args) { 


try { 
File inputFile = new File("input.txt"); 


SAXBuilder saxBuilder - new SAXBuilder(); 


Document document = saxBuilder.build(inputFile); 
System.out.println("Root element :" 
* document.getRootElement().getName()); 


Element classElement - document.getRootElement(); 


List<Element> supercarList = classElement.getChildren("suy 
System.out.println("---------------------------- e) 


for (int temp = 0; temp < supercarLlist.size(); temp++) { 
Element supercarElement - supercarList.get(temp); 
System.out.println("NnCurrent Element :" 
* supercarElement.getName()); 
Attribute attribute = supercarElement.getAttribute("ct« 
System.out.println("company : " 
* attribute.getValue() ); 
List<Element> carNameList = supercarElement.getChildrer 
for (int count = 0; 
count < carNameList.size(); count++) { 
Element carElement = carNameList.get(count); 
System.out.print("car name : "); 
System.out.println(carElement.getText()); 
System.out.print("car type : "); 
Attribute typeAttribute - carElement.getAttribute("! 
if(typeAttribute !-null) 
System.out.println(typeAttribute.getValue()); 
else{ 
System.out.println(""); 
} 


} 
} 
jcatch(JDOMException e){ 
e.printStackTrace(); 
jcatch(IOException ioe){ 
ioe.printStackTrace(); 





这 将 产生 以 下 结果 : 


Root element :cars 


Current Element :supercars 
company : Ferrari 

car name : Ferarri 101 

car type : formula one 

car name : Ferarri 201 

car type : sports car 

car name : Ferarri 301 

car type : sports car 


Current Element :supercars 
company : Lamborgini 

car name : Lamborgini 001 
car type : 

car name : Lamborgini 002 
car type : 

car name : Lamborgini 003 
car type : 


Java JDOM 解 析 器 - 创建 XML 文档 - Java XML 教 


程 


演示 示例 
这 是 我 们 需要 创建 XML : 


<?xml version="1.0" encoding="UTF-8"?> 
<cars> 
<supercars company="Ferrari"> 
<carname type="formula one">Ferrari 101</carname> 
<carname type="Sports">Ferrari 202</carname> 
</supercars> 
</cars> 


演示 示例 : 


CreateXmlFileDemo.java 


import java.io.IOException; 


import org.jdom2.Attribute; 

import org.jdom2.Document; 

import org.jdom2.Element; 

import org.jdom2.output.Format; 
import org.jdom2.output.XMLOutputter; 


public class CreateXmlFileDemo { 
public static void main(String[] args) { 


try{ 
//root element 


Element carsElement = new Element("cars"); 
Document doc = new Document(carsElement); 


//supercars element 
Element supercarElement - new Element("supercars"); 
supercarElement.setAttribute(new Attribute("company", "Fert 


//supercars element 

Element carElementi - new Element("carname"); 
carElementi.setAttribute(new Attribute("type","formula ont 
carElementi.setText("Ferrari 101"); 


Element carElement2 - new Element("carname"); 
carElement2.setAttribute(new Attribute("type","sports")); 
carElement2.setText("Ferrari 202"); 


supercarElement.addContent(carElement1); 
supercarElement.addContent(carElement2); 


doc.getRootElement().addContent(supercarElement); 
XMLOutputter xmlOutput - new XMLOutputter(); 


// display ml 

xmlOutput.setFormat(Format.getPrettyFormat()); 

xmlOutput.output(doc, System.out); 
jcatch(IOException e){ 

e.printStackTrace(); 





这 将 产生 以 下 结果 : 


<?xml version="1.0" encoding="UTF-8"?> 
<cars> 
<supercars company="Ferrari"> 
<carname type="formula one">Ferrari 101</carname> 
<carname type="Sports">Ferrari 202</carname> 
«/supercars» 
</cars> 


Java JDOM 解 析 器 - 修改 XML 文档 - Java XML 教 


程 


演示 示例 
这 是 我 们 需要 修改 输入 的 文本 文件 : 


<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
<cars> 
«supercars company="Ferrari"> 
<carname type="formula one">Ferrari 101</carname> 
<carname type="Sports">Ferrari 202</carname> 
</supercars> 
«luxurycars company="Benteley"> 
<carname>Benteley 1</carname> 
<carname>Benteley 2</carname> 
<carname>Benteley 3</carname> 
</luxurycars> 
</cars> 


演示 示例 : 


ModifyXmlFileDemo.java 


import java.io.File; 
import java.io.IOException; 
import java.util.List; 


import org.jdom2.Attribute; 

import org.jdom2.Document; 

import org.jdom2.Element; 

import org.jdom2.JDOMException; 
import org.jdom2.input.SAXBuilder; 
import org.jdom2.output.Format; 
import org.jdom2.output.XMLOutputter; 


public class ModifyXMLFileDemo { 
public static void main(String[] args) { 
try { 
File inputFile = new File("input.txt"); 
SAXBuilder saxBuilder = new SAXBuilder(); 
Document document = saxBuilder.build(inputFile); 
Element rootElement = document.getRootElement(); 


//get first supercar 
Element supercarElement = rootElement.getChild("supercars' 


// update supercar attribute 
Attribute attribute = supercarElement.getAttribute("compar 
attribute.setValue("Lamborigini"); 


// loop the supercar child node 
List<Element> list = supercarElement.getChildren(); 
for (int temp = 0; temp < list.size(); temp++) { 
Element carElement = list.get(temp); 
if("Ferrari 101".equals(carElement.getText())){ 
carElement.setText("Lamborigini 001"); 


if("Ferrari 202".equals(carElement.getText()))( 
carElement.setText("Lamborigini 002"); 
j 
} 


//get all supercars element 

List<Element> supercarslist = rootElement.getChildren(); 

for (int temp = 0; temp < supercarslist.size(); temp++) { 
Element tempElement = supercarslist.get(temp); 
if("luxurycars".equals(tempElement.getName())){ 

rootElement .removeContent(tempElement); 

} 

} 


XMLOutputter xmlOutput = new XMLOutputter(); 


// display xml 
xmlOutput.setFormat(Format.getPrettyFormat()); 
xmlOutput.output(document, System.out); 

} catch (JDOMException e) { 
e.printStackTrace(); 

) catch (IOException e) { 
e.printStackTrace(); 





这 将 产生 以 下 结果 : 


<?xml version="1.0" encoding="UTF-8"?> 
<cars> 
«supercars company="Lamborigini"> 
<carname type="formula one">Lamborigini 001</carname> 
«carname type="Sports">Lamborigini 002</carname> 
</Supercars> 
</cars> 


Java StAX 解 析 器 - Java XML 教程 
StAX 是 一 个 基于 JAVA API 用 于 解析 XML 文档 ， 类 似 SAX 解 析 器 的 方式 。 但 两 种 API 
之 间 有 两 个 区 别 


e StAX 是 PULL API， 其 中 作为 SAX 是 PUSH API。 这 意味 着 如 果 StAX 解 析 器 ， 
客户 端 应 用 程序 需要 询问 StAX 解 析 器 从 XML 获取 信息 它 所 需要 的 ， 但 如 果 是 
SAX 解 析 器 ， 客 户 端 应 用 程序 需要 获取 信息 时 ，SAX 解 析 器 会 通知 客 户 端 应 用 
程序 的 信息 是 可 用 的 。 


e StAX 的 API 可 以 读 取 和 写 入 XML 文档 。 使 用 SAX API，XML 可 以 是 只 读 的 。 


环境 设置 
为 了 使 用 StAX 的 解析 器 ， 应 该 准备 好 stax.jar 在 应 用 程序 的 类 路 径 中 。 下 载 stax- 
1.2.0.jar. 
以 下 是 StAX API 的 功能 
e. 读 取 XML 文 件 从 上 到 下 ， 认 识 构成 一 个 结构 完整 的 XML 文档 的 标记 
e 兮 牌 是 以 相同 的 顺序 进行 处 理 ， 它 们 出 现在 文档 中 
e 报告 应 用 程序 ， 因 为 解析 器 遇 到 标记 的 特性 


e 应 用 程序 提供 了 一 个 "事件 " 读 取 器 充当 了 事件 ， 以 获得 所 需 信息 的 迭代 器 和 和 
代 。 可 另 一 个 读 取 器 是 “光标 "充当 一 个 指向 XML 节 点 。 


e 由 于 事件 被 识别 ，XML 元 素 可 以 从 事件 对 象 进行 检索 ， 并 且 可 以 进一步 处 理 。 


什么 情况 下 使 用 ? 

应 该 使 用 的 StAX 解 析 器 的 时 候 : 
。 可 以 处 理 在 自 上 而 下 线性 方式 的 XML 文档 。 
。 文 件 并 不 深入 说 套 。 


e 义理 一 个 非常 大 的 XML 文档 的 DOM 树 会 占用 太 多 的 内 存 。 典 型 的 DOM 的 实现 
使 用 10 字 节 的 存储 器 以 表示 XML 的 一 个 字 节 。 


要 解决 的 问题 涉及 XML 文档 的 一 部 分 。 


数据 是 可 用 的 ， 只 要 它 是 由 解析 器 处 理 ， 这 样 StAX 可 以 很 好 地 用 于 所 收 到 超过 
数据 流 的 XML 文档 。 


SAX 的 缺点 


e 因为 它 是 在 一 个 处 理 的 方式 ， 而 不 是 随机 访问 XML 文档 。 


e 如 果 需 要 跟踪 的 数据 分 析 器 已 经 看 到 或 更 改 项 目的 顺序 ， 必 须 编写 代码 和 数据 
存储 以 自己 方式 处 理 。 


XMLEventReader # 


因为 在 解析 XML 文档 时 该 类 提供 可 用 于 和 迭代 事件 事件 迭代 器 
e StartElement asStartElement() - 用 于 检索 值 和 元 素 的 属性 。 
e EndElement asEndElement() - 调用 元 件 的 端 部 。 
e Characters asCharacters() - 可 用 于 获得 字符 ， 例 如 一 个 CDATA， 空 白 等 。 


XMLEventwWriter 类 


此 接口 指定 创建 事件 的 方法 。 
e add(Event event) - 添加 包含 元 素 XML 事 件 。 


XMLStreamReader Class 


为 在 解析 XML 文档 时 该 类 提供 可 用 于 和 迭代 事件 事件 迭代 器 
e int next() - 用 于 检索 下 一 个 事件 。 
e boolean hasNext() - 用 于 检查 其 他 事件 的 存在 与 否 
e String getText() - 用 于 获取 一 个 元 素 的 文本 
e String getLocalName() - 用 于 获取 一 个 元 素 的 名 称 


XMLStreamWriter 类 


此 接口 指定 创建 事件 的 方法 
e writeStartElement(String localName) - 加 入 定名 称 开始 元 素 。 
e writeEndElement(String localName) - 添加 指定 名 称 的 结束 元 素 。 
e writeAttribute(String localName, String value) - 编写 属性 到 元 素 。 


Java StAX 解 析 器 - 解析 XML 文档 - Java XML 教程 


演示 示例 
这 是 输入 需要 解析 xml 文件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


StAXParserDemo.java 


package com.yiibai.xml; 


import java.io.FileNotFoundException; 
import java.io.FileReader; 
import java.util.Iterator; 


import javax.xml.stream.XMLEventReader ; 
import javax.xml.stream.XMLInputFactory; 
import javax.xml.stream.XMLStreamConstants; 
import javax.xml.stream.XMLStreamException; 
import javax.xml.stream.events.Attribute; 
import javax.xml.stream.events.Characters; 
import javax.xml.stream.events.EndElement; 
import javax.xml.stream.events.StartElement; 


import javax.xml.stream.events.XMLEvent; 


public class StAXParserDemo { 
public static void main(String[] args) { 
boolean bFirstName = false; 
boolean bLastName = false; 
boolean bNickName = false; 
boolean bMarks = false; 


try { 


XMLInputFactory factory = XMLInputFactory.newInstance(); 


XMLEventReader eventReader = 
factory.createXMLEventReader( 
new FileReader("input.txt")); 


while(eventReader .hasNext()){ 


XMLEvent event = eventReader.nextEvent(); 


switch(event.getEventType()){ 


case XMLStreamConstants.START_ELEMENT: 

StartElement startElement = event.asStartEleme 

String qName = startElement.getName().getLoca- 

if (qName.equalsIgnoreCase("student")) { 
System.out.println("Start Element : student 
Iterator<Attribute> attributes = startEleme 
String rollNo = attributes.next().getValuei 
System.out.println("Roll No : " + rollNo); 

) else if (qName.equalsIgnoreCase("firstname" 
bFirstName = true; 

) else if (qName.equalsIgnoreCase("lastname") | 
bLastName = true; 

) else if (qName.equalsIgnoreCase("nickname"): 
bNickName - true; 


else if (qName.equalsIgnoreCase("marks")) { 
bMarks - true; 

} 

break; 

case XMLStreamConstants.CHARACTERS: 

Characters characters = event.asCharacters(); 

if(bFirstName) { 
System.out.println("First Name: 
+ characters.getData()); 
bFirstName = false; 


j 

if(bLastName) { 
System.out.println("Last Name: 
+ characters.getData()); 
bLastName = false; 


} 

if (bNickName) { 
System.out.printin( "Nick Name: 
+ characters.getData()); 
bNickName = false; 


j 
if(bMarks){ 
System.out.println("Marks: 


+ characters.getData()); 
bMarks = false; 

} 

break; 

case XMLStreamConstants .END_ELEMENT: 

EndElement endElement = event.asEndElement(); 

if(endElement.getName().getLocalPart().equals: 
System.out.println("End Element : student": 
System.out.println(); 

} 


break; 


} 


} catch (FileNotFoundException e) { 
e.printStackTrace(); 

) catch (XMLStreamException e) { 
e.printStackTrace(); 





这 将 产生 以 下 结果 : 


Start Element : student 
Roll No : 393 

First Name: dinkar 

Last Name: kad 

Nick Name: dinkar 
Marks: 85 

End Element : student 


Start Element : student 
Roll No : 493 

First Name: Vaneet 

Last Name: Gupta 

Nick Name: vinni 

Marks: 95 

End Element : student 


Start Element : student 
Roll No : 593 

First Name: jasvir 

Last Name: singn 

Nick Name: jazz 

Marks: 90 

End Element : student 


Java StAX 解 析 器 - 查询 XML 文档 - Java XML 教程 


演示 示例 
这 是 输入 需要 解析 xml 文 件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


StAXParserDemo.java 


package com.yiibai.xml; 


import java.io.FileNotFoundException; 
import java.io.FileReader; 
import java.util.Iterator; 


import javax.xml.stream.XMLEventReader ; 
import javax.xml.stream.XMLInputFactory; 
import javax.xml.stream.XMLStreamConstants; 
import javax.xml.stream.XMLStreamException; 
import javax.xml.stream.events.Attribute; 
import javax.xml.stream.events.Characters; 
import javax.xml.stream.events.EndElement; 
import javax.xml.stream.events.StartElement; 


import javax.xml.stream.events.XMLEvent; 


public class StAXQueryDemo { 
public static void main(String[] args) { 

boolean bFirstName = false; 

boolean bLastName = false; 

boolean bNickName = false; 

boolean bMarks = false; 

boolean isRequestRollNo = false; 

try { 
XMLInputFactory factory = XMLInputFactory.newInstance(); 
XMLEventReader eventReader = 
factory.createXMLEventReader( 

new FileReader("input.txt")); 


String requestedRollNo - "393"; 
while(eventReader .hasNext()){ 
XMLEvent event = eventReader.nextEvent(); 
switch(event.getEventType()){ 
case XMLStreamConstants.START_ELEMENT: 
StartElement startElement = event.asStartElement | 
String qName = startElement.getName().getLocalPa! 
if (qName.equalsIgnoreCase("student")) { 
Iterator<Attribute> attributes = startElement 
String rollNo = attributes.next().getValue(); 
if(rollNo.equalsIgnoreCase(requestedRollNo))([ 
System.out.println("Start Element : student 
System.out.println("Roll No : " + rollNo); 
isRequestRollNo - true; 
} 
} else if (qName.equalsIgnoreCase("firstname")) . 
bFirstName - true; 
) else if (qName.equalsIgnoreCase("lastname")) { 
bLastName - true; 
) else if (qName.equalsIgnoreCase("nickname")) { 
bNickName - true; 


else if (qName.equalsIgnoreCase("marks")) { 
bMarks - true; 
} 


break; 
case XMLStreamConstants.CHARACTERS: 
Characters characters = event.asCharacters(); 
if(bFirstName && isRequestRollNo){ 
System.out.println("First Name: " 
+ characters.getData()); 
bFirstName = false; 


if(bLastName && isRequestRol1No) { 
System.out.println("Last Name: " 
* characters.getData()); 
bLastName - false; 


if(bNickName && isRequestRollNo)( 
System.out.println("Nick Name: " 


+ characters.getData()); 
bNickName = false; 


} 
if(bMarks && isRequestRollNo){ 
System.out.println("Marks: " 
+ characters.getData()); 
bMarks = false; 
} 
break; 
case XMLStreamConstants.END ELEMENT: 
EndElement endElement - event.asEndElement(); 
if (endElement .getName().getLocalPart().equalsIgn¢ 
System.out.println("End Element : student"); 
System.out.println(); 
isRequestRollNo - false; 
} 
break; 


} 


} catch (FileNotFoundException e) { 
e.printStackTrace(); 

) catch (XMLStreamException e) ( 
e.printStackTrace(); 





这 将 产生 以 下 结果 : 


Start Element : student 
Roll No : 393 

First Name: dinkar 

Last Name: kad 

Nick Name: dinkar 
Marks: 85 

End Element : student 


Java StAX 解 析 器 - 创建 XML 文档 - Java XML 教程 


演示 示例 


这 是 我 们 需要 创建 的 XML 文档 : 


<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
<cars><supercars company="Ferrari"> 

«carname type="formula one">Ferrari 101</carname> 
«carname type="Sports">Ferrari 202</carname> 


</supe 


演示 示例 


rcars></cars> 


StAxXCreateXMLDemo.java 


packag 


import 
import 


import 
import 
import 


public 


e com.yiibai.xml; 


java.io.IOException; 
java.io.Stringwriter; 


javax.xml.stream.XMLOutputFactory; 
javax.xml.stream.XMLStreamException; 
javax.xml.stream.XMLStreamwriter; 


class StAXCreateXMLDemo { 
public static void main(String[] args) { 


try ( 


StringWriter stringWriter = new StringWriter(); 


XMLOutputFactory xMLOutputFactory = XMLOutputFactory.newIr 


XMLStreamwriter 


xMLStreamwriter. 
xMLStreamwriter 


xMLStreamwriter 
xMLStreamwriter 


xMLStreamwriter 
xMLStreamwriter 
xMLStreamwriter 
xMLStreamwriter 


xMLStreamwriter 
xMLStreamwriter 
xMLStreamwriter 


xMLStreamwriter = xMLOutputFactory.create) 


writeStartDocument(); 


.writeStartElement("cars"); 


.writeStartElement("supercars"); 
.writeAttribute("company", "Ferrari"); 


.writeStartElement("carname") ; 
.WwriteAttribute("type", "formula one"); 
.writeCharacters("Ferrari 101"); 
.writeEndElement(); 


.writeStartElement("carname") ; 
.writeAttribute("type", "sports"); 
.writeCharacters("Ferrari 202"); 


xMLStreamWriter.writeEndElement(); 


xMLStreamWriter.writeEndElement(); 
xMLStreamWriter.writeEndDocument(); 


xMLStreamwriter.flush(); 
xMLStreamwriter.close(); 


String xmlString = stringWwriter.getBuffer().toString(); 
stringwriter.close(); 
System.out.println(xmlString); 
) catch (XMLStreamException e) { 
e.printStackTrace(); 
) catch (IOException e) ( 


// TODO Auto-generated catch block 
e.printStackTrace(); 





这 将 产生 以 下 结果 : 


<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
<cars><supercars company="Ferrari"> 

«carname type="formula one">Ferrari 101</carname> 
<carname type="Sports">Ferrari 202</carname> 
</supercars></cars> 


Java StAX 解 析 器 - 修改 XML 文档 - Java XML 教程 


演示 示例 


这 是 我 们 需要 修改 的 XML 文档 : 


«class style="box-sizing: border-box;"><student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 

</student> 

<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 

</student> 

<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singh</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 

</student></class> 


演示 示例 : 


StAXModifyDemo.java 


package com.yiibai.xml; 


import java.io.File; 

import java.io.FileNotFoundException; 
import java.io.FileReader; 

import java.io.IOException; 

import java.util.Iterator; 

import java.util.List; 


import javax.xml.stream.XMLEventReader ; 
import javax.xml.stream.XMLInputFactory; 
import javax.xml.stream.XMLStreamConstants; 
import javax.xml.stream.XMLStreamException; 
import javax.xml.stream.events.Attribute; 
import javax.xml.stream.events.StartElement; 


import javax.xml.stream.events.XMLEvent; 


import 
import 
import 
import 
import 
import 


public 
pub 


org. jdom2.Document; 
org.jdom2.Element; 
org.jdom2.JDOMException; 

org. jdom2.input .SAXBuilder; 
org.jdom2.output.Format; 
org.jdom2.output.XMLOutputter; 


class StAXModifyDemo { 
lic static void main(String[] args) { 


try { 
XMLInputFactory factory - XMLInputFactory.newInstance(); 


XMLEventReader eventReader - 
factory.createXMLEventReader( 
new FileReader("input.txt")); 
SAXBuilder saxBuilder - new SAXBuilder(); 
Document document = saxBuilder.build(new File("input.txt"' 
Element rootElement - document.getRootElement(); 
List«Element» studentElements - rootElement.getChildren(": 
while(eventReader .hasNext()){ 
XMLEvent event = eventReader.nextEvent(); 
switch(event.getEventType()){ 
case XMLStreamConstants.START_ELEMENT: 
StartElement startElement = event.asStartElement(); 
String qName = startElement.getName().getLocalPart(: 


if (qName.equalsIgnoreCase("student")) { 
Iterator<Attribute> attributes = startElement.get 
String rollNo - attributes.next().getValue(); 
if(rollNo.equalsIgnoreCase("393"))( 
//get the student with roll no 393 
for(int i-0;i < studentElements.size();i++){ 
Element studentElement = studentElements. ge 
if(studentElement.getAttribute("rollno").g« 
studentElement.removeChild("marks"); 
studentElement.addContent(new ElementY("r 


} 
} 
} 
break; 
} 
} 
XMLOutputter xmlOutput = new XMLOutputter(); 
// display xml 
xmlOutput.setFormat(Format.getPrettyFormat()); 
xmlOutput.output(document, System.out); 
) catch (FileNotFoundException e) ( 
e.printStackTrace(); 
) catch (XMLStreamException e) ( 
e.printStackTrace(); 


) catch (JDOMException e) ( 
e.printStackTrace(); 


} catch (IOException e) { 
e.printStackTrace(); 
} 


} 
下 








这 将 产生 以 下 结果 : 


«student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>80</marks> 

</student> 

«student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 

</student> 

«student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singh</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 

</student> 


Java XPath 解析 器 - Java XML 教程 


XPath 是 妃 维 网 联盟 盟 (W3C) 的 官方 推荐 。 它 定义 了 一 个 语言 在 XML 文件 中 查找 信 
息 。 它 被 用 于 通 历 XML 文档 的 元 素 和 属性 。 XPath 提供 各 种 类 型 ， 可 用 于 从 XML 文 
档 查 询 相 关 的 信息 表现 形式 。 


什么 是 XPath ? 


e 结构 定义 - XPath 定义 像 元 素 ， 属 性 ， 文 本 ， 命 名 空间 ， 义 理 指令 ， 注 释 和 文 
档 节 点 的 XML 文档 部 分 


e 路 径 表 达 式 - XPath 提供 了 强大 的 路 径 表 达 式 选择 的 节点 或 在 XML 文档 中 的 节 
点 列表 。 


e 标准 功能 - XPath 提 供 了 丰富 的 标准 函数 库 操纵 字符 串 值 ， 数 值 ， 日 期 和 时 间 
比较 ， 节操 作 ， 顺 序 操作 ， 布 尔 值 等 。 


e XSLT 重 要 组 成 部 分 - XPath 是 在 XSLT 标 准 的 主要 元 素 之 一 ， 是 必须 有 知识 ， 
以 便 使 用 XSLT 的 文档 。 


。 W3C 推 荐 - XPath 是 万 维 网 联盟 (W3C) 的 官方 推荐 。 
这 里 是 我 们 需要 分 析 输 入 文本 文件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


XPath 表达 式 


XPath 使 用 路 径 表 达 陈 从 XML 文档 中 选择 一 个 或 多 个 节 点 的 列表 。 以 下 是 有 用 的 路 
径 和 表达 ， 从 XML 文档 选择 节点 的 任何 节点 /列表 清单 。 


表达 式 描述 
node-name 选择 具有 给 定名 称 的 所 有 节点 "nodename” 
/ 选择 从 根 节 点 开始 
// 选择 从 当前 节点 匹配 开始 的 选择 
选择 当前 节点 

选择 当前 节点 的 父 节点 
@ 选择 属性 
student 例如 : 选择 名 称 为 "student 的 所 有 节点 
class/student 例如 : 选择 属于 类 的 所 有 学 生 的 子 类 元 素 
/student 选择 文档 中 所 有 学 生 的 元 素 

谓词 

谓词 用 于 查找 特定 的 节点 或 一 个 节点 含有 特定 的 值 ， 并 使 用 所 定义 […] . 

表达 式 结果 

/class/student[1] 选择 的 是 类 元 素 的 子 第 一 个 学 生 的 元 素 
/class/student{last()] 选择 的 是 类 元 素 的 子 最 后 一 个 学 生 的 元 素 
/class/student[last()-1] 选择 的 是 类 元 素 倒 数 的 第 二 个 学 生 的 子 元 素 


//student[@rollno='493'] 选择 一 个 名 为 rollno 为 493' 值 的 属性 的 学 生 元 素 


Java XPath 解析 器 - 解析 XML 文档 - Java XMLAX 


程 


使 用 XPath 的 步骤 
以 下 是 使 用 XPath 解析 器 在 解析 文档 时 使 用 的 步骤 。 


导 和 XML 相关 的 软件 包 。 

创建 DocumentBuilder 

从 文件 或 数据 流 创建 一 个 文档 

创建 XPath 对 象 和 XPath 的 路 径 表 达 式 


编译 XPath 表达 式 使 用 XPath.compile() ， 并 由 XPath.evaluate() 评 估计 算 获 得 
一 个 节点 列表 


通 历 节点 列表 。 
检查 属性 
检查 子 元 素 


导入 XML 相 关 的 软件 包 


import org.w3c.dom.*; 
import org.xml.sax.*; 
import javax.xml.parsers.*; 
import javax.xml.xpath.*; 
import java.io.*; 


创建 DocumentBuilder 


DocumentBuilderFactory factory = 
DocumentBuilderFactory.newInstance(); 
DocumentBuilder builder - factory.newDocumentBuilder(); 


从 文件 或 数据 流 创建 一 个 文档 


StringBuilder xmlStringBuilder = new StringBuilder(); 

xmlStringBuilder.append("«?xml version="1.0"?> «class» «/class»"); 

ByteArrayInputStream input = new ByteArrayInputStream( 
xmlStringBuilder.toString().getBytes("UTF-8")); 

Document doc - builder.parse(input); 


s] _ — BE | 





构建 XPath 


XPath xPath = XPathFactory.newInstance().newXPath(); 


准备 路 径 表 达 式 ， 并 计算 它 


"/class/student"; 
(NodeList) xPath.compile(expression).evaluate( 


String expression 
NodeList nodeList 





mi 
通 历 节点 列表 


for (int i = 0; i < nodeList.getLength(); i++) { 
Node nNode = nodeList.item(i); 


检查 属性 


//returns specific attribute 
getAttribute("attributeName"); 
//returns a Map (table) of names/values 
getAttributes(); 


MEF ICR 


//returns a list of subelements of specified name 
getElementsByTagName ( " subelementName"); 

//returns a list of all child nodes 
getchildNodes(); 


演示 示例 : 


这 里 是 我 们 需要 分 析 输 入 文本 文件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singh</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


演示 示例 : 
XPathParserDemo.java 
package com.yiibai.xml; 


import java.io.File; 
import java.io.IOException; 


import javax.xml.parsers.DocumentBuilderFactory; 
import javax.xml.parsers.DocumentBuilder; 
import javax.xml.parsers.ParserConfigurationException; 


import javax.xml.xpath.XPath; 


import javax.xml.xpath.XPathConstants; 
import javax.xml.xpath.XPathExpressionException; 


import javax.xml.xpath.XPathFactory; 


import org.w3c.dom.Document; 
import org.w3c.dom.NodeList; 
import org.w3c.dom.Node; 

import org.w3c.dom.Element; 
import org.xml.sax.SAXException; 


public class XPathParserDemo ( 


public static void main(String[] args) 


try { 


File inputFile - new File("input.txt"); 
DocumentBuilderFactory dbFactory 
- DocumentBuilderFactory.newInstance(); 


ww rc YY cc 


DocumentBuilder dBuilder; 
dBuilder = dbFactory.newDocumentBuilder(); 


Document doc = dBuilder.parse(inputFile); 
doc.getDocumentElement().normalize(); 


XPath xPath = XPathFactory.newInstance().newXPath(); 


String expression "/class/student"; 
NodeList nodeList (NodeList) xPath.compile(expression).: 
for (int i = 0; i < nodeList.getLength(); i++) { 
Node nNode = nodeList.item(i); 
System.out.println("NnCurrent Element 
+ nNode.getNodeName( )); 
if (nNode.getNodeType() == Node.ELEMENT NODE) { 
Element eElement - (Element) nNode; 
System.out.println("Student roll no : " 
* eElement.getAttribute("rollno")); 
System.out.println("First Name E 
* eElement 
.getElementsByTagName("firstname" ) 
.item(0) 
.getTextContent()); 
System.out.println("Last Name 
* eElement 
.getElementsByTagName("lastname" ) 
.item(0) 
.getTextContent()); 
System.out.println("Nick Name 
+ eElement 
.getElementsByTagName ("nickname") 
.item(0) 
-getTextContent ()); 
System.out.println("Marks 
* eElement 
.getElementsByTagName ( "marks" ) 
.item(0) 
.getTextContent()); 


} 
} 
catch (ParserConfigurationException e) { 
e.printStackTrace(); 
catch (SAXException e) { 
e.printStackTrace(); 
catch (IOException e) { 
e.printStackTrace(); 
catch (XPathExpressionException e) { 
e.printStackTrace(); 








«| ma 








这 将 产生 以 下 结果 : 


Current Element :student 
Student roll no : 393 
First Name : dinkar 

Last Name : kad 

Nick Name : dinkar 

Marks : 85 


Current Element :student 
Student roll no : 493 
First Name : Vaneet 

Last Name : Gupta 

Nick Name : vinni 

Marks : 95 


Current Element :student 
Student roll no : 593 
First Name : jasvir 

Last Name : singh 

Nick Name : jazz 

Marks : 90 


Java XPath 解析 器 - 查询 XML 文档 - Java XMLAX 


程 


演示 示例 
这 是 我 们 需要 查询 输入 的 文本 文件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


演示 示例 : 


XPathParserDemo.java 


package com.yiibai.xml; 


import java.io.File; 
import java.io.IOException; 


import javax.xml.parsers.DocumentBuilderFactory; 
import javax.xml.parsers.DocumentBuilder; 

import javax.xml.parsers.ParserConfigurationException; 
import javax.xml.xpath.XPath; 

import javax.xml.xpath.XPathConstants; 

import javax.xml.xpath.XPathExpressionException; 


import javax.xml.xpath.XPathFactory; 


import org.w3c.dom.Document; 
import org.w3c.dom.NodeList; 
import org.w3c.dom.Node; 

import org.w3c.dom.Element; 
import org.xml.sax.SAXException; 


public class XPathParserDemo { 
public static void main(String[] args) ( 
try { 
File inputFile = new File("input.txt"); 
DocumentBuilderFactory dbFactory 
= DocumentBuilderFactory.newInstance(); 
DocumentBuilder dBuilder; 


dBuilder = dbFactory.newDocumentBuilder(); 


Document doc = dBuilder.parse(inputFile); 
doc.getDocumentElement().normalize(); 


XPath xPath = XPathFactory.newInstance().newXPath(); 


String expression "/class/student[Qrollno-'493']"; 
NodeList nodeList (NodeList) xPath.compile(expression).: 
for (int i = 0; i < nodeList.getLength(); i++) { 
Node nNode = nodeList.item(i); 
System.out.println("NnCurrent Element :" 
+ nNode.getNodeName( )); 
if (nNode.getNodeType() == Node.ELEMENT NODE) { 
Element eElement - (Element) nNode; 
System.out.println("Student roll no : " 
* eElement.getAttribute("rollno")); 
System.out.println("First Name H 
* eElement 
.getElementsByTagName("firstname" ) 
.item(0) 
.getTextContent()); 
System.out.println("Last Name 
* eElement 
.getElementsByTagName("lastname" ) 
.item(0) 
.getTextContent()); 
System.out.println("Nick Name 
+ eElement 
.getElementsByTagName ("nickname") 
.item(0) 
.getTextContent()); 
System.out.println("Marks 
* eElement 
.getElementsByTagName( "marks" ) 
.item(0) 
.getTextContent()); 


catch (ParserConfigurationException e) { 
e.printStackTrace(); 

catch (SAXException e) ( 
e.printStackTrace(); 

catch (IOException e) { 
e.printStackTrace(); 

catch (XPathExpressionException e) { 
e.printStackTrace(); 
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这 将 产生 以 下 结果 : 


Current Element :student 
Student roll no : 493 
First Name : Vaneet 

Last Name : Gupta 

Nick Name : vinni 

Marks : 95 


Java DOM4J 解 析 器 - Java XML 教程 


DOM4J 是 一 个 开源 的 ， 基 于 Java 的 库 来 解析 XML 文档 ， 它 具有 高 度 的 灵活 性 ， 高 
性 能 和 内 存 效率 的 API。 这 是 java 的 优化 ， 使 用 Java 集 合 像 列 表 和 数组 。 它 可 以 使 
用 DOM，SAX，XPath 和 XSLT。 它 解析 大 型 XML 文档 时 具有 极 低 的 内 存 占 用 。 


环境 设置 


为 了 使 用 DOM4J 解 析 器 ， 应 该 dom4j-1.6.1.jar 和 jaxen.jar 在 应 用 程序 的 类 路 径 
中 。 下 载 dom4j-1.6.1.zip. 


什么 情况 下 使 用 ? 
应 该 考虑 使 用 DOM4J 解 析 器 的 时 候 : 
。 需要 知道 很 多 关于 文档 的 结构 
e 需要 将 文档 的 部 分 围绕 (例如 ， 可 能 需要 某 些 
。 需要 使 用 的 文件 中 的 信息 超过 一 次 
e 你 是 一 个 Java 开 发 人 员 ， 并 希望 利用 XML 的 Java 的 优化 解析 。 


会 得 到 什么 ? 


当 解 析 一 个 DOM4J 解 析 XML 文 档 ， 可 以 灵活 地 得 到 一 个 树 形 结构 ， 其 中 包含 所 有 
文档 的 元 素 ， 而 不 会 影响 应 用 程序 的 内 存 占用 。DOM4J 提 供 了 多 种 可 用 于 检查 的 情 
况 下 文档 内 容 和 结构 的 实用 功能 是 良好 的 结构 ， 其 结构 是 公 知 的 。 DOM4J 使 用 
XPath 表达 式 来 浏览 XML 文档 。 
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优势 


DOM4J 使 Java 开 发 的 灵活 性 和 XML 解析 代码 易于 维护 。 它 是 轻 量 级 的 ， 快 速 的 
API. 


DOM4J 类 


DOM4J 定 义 了 几 个 Java 类 。 以 下 是 最 常见 的 类 : 
e Document - 表示 整个 XML 文档 。 文 档 Document 对 象 是 通常 被 称 为 DOM 树 。 


e Element - 表示 一 个 XML 元 素 。 Element 对 象 有 方法 来 操作 其 子 元 素 ， 它 的 文 
本 ， 属 性 和 名 称 空间 。 


e Attribute - 表示 元 素 的 属性 。 属 性 有 方法 来 获取 和 设置 属性 的 值 。 它 有 父 节点 
和 属性 类 型 。 


e Node - 代表 元 素 ， 属 性 或 义理 指令 


前 见 DOM4J 的 方法 


当 使 用 DOM4J， 还 有 经 常用 到 的 几 种 方法 : 
。 SAXReader.read(xmlSource)() - 构建 XML 源 的 DOM4J 文 档 。 
e Document.getRootElement() - 得 到 的 XML 的 根 元 素 。 
e Element.node(index) - 获得 在 元 素 特定 索引 XML 节 点。 
e Element.attributes() - 获取 一 个 元 素 的 所 有 属性 。 
。 Node.valueOf(@Name) - 得 到 元 件 的 给 定名 称 的 属性 的 值 。 


Java DOM4J 解 析 器 - 解析 XML 文档 - Java XMLAX 


程 


使 用 DOM4J 的 步骤 


以 下 是 解析 时 使 用 DOM4J 解 析 器 文档 使 用 的 步骤 。 
。 导 和 人 XML 相关 的 软件 包 。 
e 创建 一 个 SAXReader 
。 从 文件 或 数据 流 创建 一 个 文档 
e 通过 调用 document.selectNodes() 获 取 使 用 XPath 表达 式 所 需 的 节点 
。 提取 根 元 素 
。 通 历 节 点 列表 。 
。 检查 属性 
e 检查 子 元 素 
导 和 人 XML 相关 的 软件 包 


import java.io.*; 
import java.util.*; 
import org.dom4j.*; 


创建 一 个 DocumentBuilder 
SAXBuilder saxBuilder = new SAXBuilder(); 


从 文件 或 数据 流 创建 一 个 文档 


File inputFile = new File("input.txt"); 
SAXBuilder saxBuilder = new SAXBuilder(); 
Document document = saxBuilder.build(inputFile); 


提取 根 元 素 


Element classElement = document.getRootElement(); 


Examine attributes 


//returns specific attribute 
valueOf ("@attributeName" ); 


//returns first child node 
selectSingleNode("subelementName" ) ; 


演示 示例 
这 是 输入 需要 解析 xml 文 件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


演示 示例 : 


DOM4JParserDemo.java 


package com.yiibai.xml; 


import java.io.File; 
import java.util.List; 


import org.dom4j.Document; 

import org.dom4j.DocumentException; 
import org.dom4j.Element; 

import org.dom4j.Node; 

import org.dom4j.io.SAXReader; 


public class DOM4JParserDemo { 
public static void main(String[] args) ( 
try { 

File inputFile = new File("input.txt"); 
SAXReader reader = new SAXReader(); 
Document document = reader.read( inputFile ); 
System.out.println("Root element :" 

* document.getRootElement().getName()); 


Element classElement - document.getRootElement(); 


List«Node» nodes - document.selectNodes("/class/student" 
System.out.println("---------------------------- Moy 
for (Node node : nodes) { 
System.out.println("NnCurrent Element 
+ node.getName()); 
System.out.println("Student roll no 
* node.valueOf("Qrollno") ); 


System.out.println("First Name : " + node.selectSingle! 
System.out.println("Last Name : " + node.selectSingleN 
System.out.println("First Name : " + node.selectSingle! 
System.out.println("Marks : " + node.selectSingleNode(' 


) catch (DocumentException e) { 
e.printStackTrace(); 





这 将 产生 以 下 结果 : 


Root element :class 


Current Element :student 
Student roll no 

First Name : dinkar 

Last Name : kad 

First Name : dinkar 
Marks : 85 


Current Element :student 
Student roll no 

First Name : Vaneet 

Last Name : Gupta 

First Name : vinni 

Marks : 95 


Current Element :student 
Student roll no 

First Name : jasvir 

Last Name : singn 

First Name : jazz 

Marks : 90 


Java DOM4J 解 析 器 - 查询 XML 文档 - Java XMLZA 
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演示 示例 
这 是 输入 需要 解析 xml 文 件 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


演示 示例 : 


DOM4JQueryDemo.java 


package com.yiibai.xml; 


import java.io.File; 
import java.util.List; 


import org.dom4j.Document; 

import org.dom4j.DocumentException; 
import org.dom4j.Element; 

import org.dom4j.Node; 

import org.dom4j.io.SAXReader; 


public class DOM4JQueryDemo { 
public static void main(String[] args) ( 
try { 
File inputFile = new File("input.txt"); 
SAXReader reader = new SAXReader(); 
Document document = reader.read( inputFile ); 


System.out.println("Root element :" 
* document.getRootElement().getName()); 


Element classElement - document.getRootElement(); 


List«Node» nodes - document.selectNodes("/class/student [Q! 
System.out.println("---------------------------- Moy 
for (Node node : nodes) { 
System.out.println("NnCurrent Element 
+ node.getName()); 
System.out.println("Student roll no 
* node.valueOf("Qrollno") ); 


System.out.println("First Name : " + node.selectSingle! 
System.out.println("Last Name : " + node.selectSingleN 
System.out.println("First Name : " + node.selectSingle! 
System.out.println("Marks : " + node.selectSingleNode(' 


) catch (DocumentException e) { 
e.printStackTrace(); 





这 将 产生 以 下 结果 : 


Root element :class 
Current Element :student 
Student roll no : 493 
First Name : Vaneet 

Last Name : Gupta 

First Name : vinni 

Marks : 95 


Java DOM4J 解 析 器 - 创建 XML 文档 - Java XML 
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演示 示例 
这 是 我 们 需要 创建 的 XML 文档 : 


<?xml version="1.0" encoding="UTF-8"?> 
<cars> 
<supercars company="Ferrari"> 
<carname type="formula one">Ferrari 101</carname> 
<carname type="Sports">Ferrari 202</carname> 
</supercars> 
</cars> 


演示 示例 : 


CreateXmlFileDemo.java 


package 


import 
import 


import 
import 
import 
import 
import 


public 


publ 
t 


} 


com.yiibai.xml; 


java.io.IOException; 
java.io.UnsupportedEncodingException; 


org.dom4j .Document ; 
org.dom4j .DocumentHelper; 
org.dom4j .Element; 
org.dom4j.io.OutputFormat; 
org.dom4j.io.XMLWriter; 


class DOM4JCreateXMLDemo { 
ic static void main(String[] args) { 
ry { 
Document document = DocumentHelper.createDocument(); 
Element root = document.addElement( "cars" ); 
Element supercarElement= root.addElement("supercars") 
.addAttribute("company", "Ferrai"); 


supercarElement.addElement("carname") 
.addAttribute("type", "Ferrari 101") 
.addText("Ferrari 101"); 


supercarElement.addElement("carname") 
.addAttribute("type", "sports") 
.addText("Ferrari 202"); 


// Pretty print the document to System.out 
OutputFormat format = OutputFormat.createPrettyPrint(); 
XMLWriter writer; 

writer - new XMLWriter( System.out, format ); 
writer.write( document ); 

catch (UnsupportedEncodingException e) { 
e.printStackTrace(); 


) catch (IOException e) { 
e.printStackTrace(); 
} 
} 
} 
这 将 产生 以 下 结果 : 


<?xml version="1.0" encoding="UTF-8"?> 


<cars> 


<supercars company="Ferrari"> 
<carname type="formula one">Ferrari 101</carname> 
<carname type="Sports">Ferrari 202</carname> 
«/supercars» 
</cars> 


Java DOM4J 解 析 器 - 修改 XML 文档 - Java XML 教 


程 


演示 示例 
这 是 我 们 需要 修改 的 XML 文档 : 


<?xml version="1.0"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>95</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 


演示 示例 : 


DOM4jModifyXMLDemo.java 


package com.yiibai.xml; 


import java.io.File; 

import java.io.IOException; 

import java.io.UnsupportedEncodingException; 
import java.util.Iterator; 

import java.util.List; 


import org.dom4j.Document; 

import org.dom4j.DocumentException; 
import org.dom4j.Element; 

import org.dom4j.Node; 

import org.dom4j.io.OutputFormat; 
import org.dom4j.io.SAXReader; 
import org.dom4j.io.XMLWriter; 


public class DOM4jModifyXMLDemo { 
public static void main(String[] args) ( 
try { 
File inputFile = new File("input.txt"); 
SAXReader reader = new SAXReader(); 
Document document = reader.read( inputFile ); 


Element classElement = document.getRootElement(); 


List<Node> nodes = document.selectNodes("/class/student[Q 
for (Node node : nodes) { 
Element element = (Element )node; 
Iterator<Element> iterator-element.elementIterator("mai 
while(iterator.hasNext()){ 
Element marksElement-(Element)iterator.next(); 
marksElement.setText("80"); 


} 


// Pretty print the document to System.out 
OutputFormat format = OutputFormat.createPrettyPrint(); 
XMLWriter writer; 
writer - new XMLWriter( System.out, format ); 
writer.write( document ); 

) catch (DocumentException e) { 
e.printStackTrace(); 

} catch (UnsupportedEncodingException e) ( 
e.printStackTrace(); 

) catch (IOException e) { 
e.printStackTrace(); 

} 








这 将 产生 以 下 结果 : 


<?xml version="1.0" encoding="UTF-8"?> 
<class> 
<student rollno="393"> 
<firstname>dinkar</firstname> 
<lastname>kad</lastname> 
<nickname>dinkar</nickname> 
<marks>85</marks> 
</student> 
<student rollno="493"> 
<firstname>Vaneet</firstname> 
<lastname>Gupta</lastname> 
<nickname>vinni</nickname> 
<marks>80</marks> 
</student> 
<student rollno="593"> 
<firstname>jasvir</firstname> 
<lastname>singn</lastname> 
<nickname>jazz</nickname> 
<marks>90</marks> 
</student> 
</class> 
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XML KDA 


JDOM - 专门 为 软件 开发 人 员 和 使 用 JDOM XML 解析 库 测 试 。 
JDOM - 专门 为 软件 开发 人 员 和 使 用 DOM4J XML 解析 库 测 试 。 
StAX - 专门 为 软件 开发 人 员 和 使 用 StAX 的 XML 解 析 库 测试 。 
Java2 SDK， 标 准 版 - 官方 网 站 的 Java2 SDK， 标 准 版 

Java 下 载 - 下 载 Java | 

Java XML 教程 - Java XML 教程 中 文 版 本 ! 


JavaMail API 教程 


JavaMail API 提 供 了 一 种 与 平台 无 关 和 协议 独立 的 框架 来 构建 邮件 和 消息 应 用 程 
Fe, JavaMail API 提 供 了 一 组 抽象 类 定义 构成 一 个 邮件 系统 的 对 象 。 它 是 阅读 ， 撰 
宇和 发 送 电 子 信息 的 可 选 包 ( 标 准 扩展 ) o 


读者 


本 教程 乃 为 初学 者 ， 帮 助 他 们 了 解 基本 的 JavaMail 的 编程 。 完 成 本 教程 后 ， 在 一 定 
程度 上 提高 了 你 自己 的 JavaMail 的 编程 水 平 。 


必 备 条 件 


JavaMail 编程 是 基于 Java 编程 语言 ， 所 以 如 果 你 对 Java 编 程 有 基本 的 了 解 ， 那 么 
在 应 用 程序 开发 中 使 用 JavaMail 会 比较 顺手 。 


JavaMail API 概述 - JavaMail 


JavaMail API 提 供 了 一 种 与 平台 无 关 和 协议 独立 的 框架 来 构建 邮件 和 消息 应 用 程 


序 。 


JavaMail API 提 供 了 一 组 抽象 类 定义 构成 一 个 邮件 系统 的 对 象 。 它 是 阅读 ， 撰 


写 和 发 送 电子 信息 的 可 选 包 〈 标 准 扩展 ) 。 


JavaMail 规定 ， 用 于 构造 一 个 接口 ， 一 个 消息 传送 系统 中 的 元 素 ， 包 括 系统 的 部 件 
和 接口 。 虽然 本 规范 没有 定义 任何 特定 的 实现 ，JavaMail 是 否 包括 实现 RFC822 和 
MIME Internet 邮 件 标准 几 类 。 这 些 类 都 作为 JavaMail 的 类 包 的 一 部 分 。 


以 下 是 一 些 在 JavaMail API 支持 的 协议 : 


SMTP: 缩 写 为 简单 邮件 传输 协议 。 它 提供 传送 邮件 的 机 制 。 


POP: 缩写 为 邮局 协议 。 POP 是 大 多 数 人 在 互联 网 上 使 用 ， 以 获得 他 们 的 邮件 
的 机 制 。 它 定义 了 一 个 单个 邮箱 的 支持 为 每 个 用 户 。 RFC 1939 定 义 了 该 协 
议 。 


IMAP: 缩写 为 Internet 邮 件 访 问 协 议 。 它 是 一 种 先进 的 协议 ， 用 于 接收 消息 。 它 
提供 了 多 个 邮箱 的 支持 为 每 个 用 户 ， 除 了 邮箱 可 以 被 多 个 用 户 共享 。 它 是 在 
RFC2060 中 定义 。 


MIME: 缩写 为 多 用 途 Internet 邮 件 扩展 。 。 这 不 是 一 个 邮件 传输 协议 。 相 反 ， 
它 定 义 了 什么 是 传输 的 内 容 : 邮件 ， 附 件 ， 等 等 的 格式 。 有 许多 不 同 的 文档 生 
效 这 里 : RFC822，RFC2045，RFC2046 和 RFC2047。 作 为 JavaMail API 用 
>， 您 通常 不 需要 担心 这 些 格式 。 然 而 ， 这 些 格式 确实 存在 ， 并 且 由 程序 使 
用 。 


NNTP 其 它 : 有 由 第 三 方 供 应 商 提 供 的 许多 协议 。 其 中 有 些 是 网 络 新 闻 传 输 协 
议 (NNTP) ， 安 全 多 用 途 Internet 邮 件 扩 展 (S/MIME) 等 。 


这 些 细节 将 包括 在 后 续 章 节 。 


体系 结构 


正如 上 面 的 java 应 用 程序 表示 用 户 使 用 JavaMail API 来 编写 ， 发 送 和 接收 电子 邮 


ft. 
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JavaMail API 的 抽象 机 制 类 似 于 其 他 的 J2EE API， 如 JDBC，JNDI 和 JMS。 如 上 面 
看 到 的 体系 结构 图 ，JavaMail API 被 分 为 两 个 主要 部 分 : 


e 与 应 用 程序 无 关 的 部 分 : 应 用 程序 编程 接口 (API) 是 由 应 用 程序 使 用 的 组 件 
来 发 送 和 接收 邮件 ， 独 立 于 底层 的 供应 商 或 协议 中 使 用 的 。 


e 一 个 服务 相关 的 部 分 : 一 个 服务 提供 商 接口 (SPD 说 ， 协 议 特定 的 语言 ， 如 
SMTP，POP，IMAP 和 网 络 新 闻 传 输 协 议 (NNTP) 。 它 是 用 来 插 在 一 封 邮 件 
服务 到 J2EE 平 台 的 供应 商 。 


JavaMail API 环境 设置 - JavaMail 
要 使 用 Java 应 用 程序 发 送 邮件 是 很 简单 的 ， 但 首先 应 该 有 安装 JavaMail API 和 
Java 激活 框架 (JAF) 。 


> 您 需要 JavaBeans 激 活 框架 (JAF) 的 扩展 ， 当 你 不 使 用 Java SE6 或 更 高 版 本 提 
供 了 javax.activation 中 的 包 。 


e 您 可 以 从 Java 标准 网 站 下 载 最 新 版 本 的 JavaMail (版 本 1.5.0) 。 
e 您 可 以 从 Java 的 标准 网 站 下 载 最 新 版 本 的 JAF (版 本 1.1.1) 。 


下 载 并 解压 缩 这 些 文件 ， 在 新 创建 的 顶层 目录 ， 你 会 发 现 一 些 jar 文 件 同 时 为 应 用 。 
需要 添加 mailjar 和 activation.jar 文件 在 CLASSPATH 中 。 


SMPT fk 4-35 
发 送 电子 邮件 ， 您 必须 有 SMTP 服 务 器 ， 它 负责 发 送 邮 件 。 您 可 以 使 用 下 列 方法 之 
一 来 获取 SMTP 服 务 器 : 


e 安装 和 使 用 任何 SMTP 服 务 器 ， 如 Postfix 服务 器 (Ubuntu) , James Apache 
服务 器 (Apache 的 Java 的 企业 邮件 服务 器 ) 等 。 


e 使 用 由 主机 供应 商 如 提供 的 SMTP 服 务 器 : 免费 SMTP 通过 JangoSMTP 网 站 
提供 的 是 relay.jangosmtp.net。 


e 使 用 由 公司 提供 的 SMTP 服 务 器 如 Gmail， 雅 虎 等 。 


> 在 随后 的 章节 中 的 例子 中 ， 我 们 使 用 了 免费 JangoSMTP 服务 器 发 送 电子 邮件 。 
您 可 以 通过 访问 这 个 网 站 上 创建 一 个 帐户 ， 并 配置 您 的 电子 邮件 地 址 。 


JavaMail API 核心 类 - JavaMail 


JavaMail API 包 含 了 一 些 接口 ， 用 于 发 送 ， 读 取 和 删除 电子 邮件 消息 的 类 。 虽 然 有 


许多 软件 包 在 JavaMail API 中 ， 频 繁 用 于 Java 邮 件 API 主 要 有 两 个 包 : javax.mail 和 
javax.mail.internet。 这 些 软件 包 包含 所 有 的 JavaMail 核 心 类 。 它 们 分 别 是 : 
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javax.mail.Session 


javax.mail.Message 


javax.mail.Address 


javax.mail.Authenticator 


javax.mail. Transport 


javax.mail.Store 


javax.mail.Folder 


javax.mail.internet.MimeMessage 


javax.mail.internet.InternetAddress 


描述 


The key class of the API. A 
multithreaded object represents the 
connection factory. 


An abstract class that models an e- 
mail message. Subclasses provide the 
actual implementations. 


An abstract class that models the 
addresses (from and to addresses) in 
a message. Subclasses provide the 
specific implementations. 


An abstract class used to protect mail 
resources on the mail server. 


An abstract class that models a 
message transport mechanism for 
sending an e-mail message. 


An abstract class that models a 
message store and its access protocol, 
for storing and retrieving messages. A 
Store is divided into Folders. 


An abstract class that represents a 
folder of mail messages. It can contain 
subfolders. 


Message is an abstract class, hence 
must work with a subclass; in most 
cases, you'll use a MimeMessage. A 
MimeMessage is an e-mail message 
that understands MIME types and 
headers. 


This class represents an Internet email 
address using the syntax of RFC822. 
Typical address syntax is of the 
formuser@host.domain or Personal 
Name <user@host.domain>. 


让 我 们 研究 这 些 类 的 细节 ， 并 在 随后 的 章节 中 ， 我 们 将 使 用 所 有 这 些 研 究 的 例子 。 


会 话 类 


会 话 类 是 JavaMail API 的 主要 类 ， 它 不 创建 子 类 。 


Session 对 象 充 当 连 接 工厂 的 


JavaMail API， 它 可 以 同时 义理 配置 设置 和 身份 验证 。 


Session 对 象 可 以 通过 以 下 方式 创建 : 
e 通过 查找 存储 在 JNDI 服 务 的 管理 对 象 


InitialContext ctx = new InitialContext(); 
Session session = (Session) ctx. lookup("usersMailSession"); 


usersMailSession 是 用 作 Session 对 象 的 管理 对 象 的 JNDI 名 称 的 对 象 。 
usersMailSession 可 以 创建 并 配置 必要 的 参数 作为 名 称 / 值 对 ， 包 括 信 息 ， 如 邮 
件 服务 器 的 主机 名 ， 用 户 帐 户 发 送 邮 件 ， 并 通过 Session 对 象 所 支持 的 协议 。 


e 创建 Session 对 象 的 另 一 种 方法 是 基于 编程 方法 ， 可 以 在 其 中 使 用 的 
java.util.Properties 对 象 来 覆盖 一 些 默认 信息 ， 如 邮件 服务 器 名 ， 用 户 名 ， 密 
码 ， 那 可 以 是 其 他 信息 整个 应 用 程序 共享 。 

该 构造 Session 类 是 私有 的 。 因 此 ， 会 话 类 提供 了 两 个 方法 (如 下 所 示 ) ， 它 获得 
了 Session 对 象 。 

e getDefaultlnstance(): 有 两 种 方法 使 用 getDefaultlnstance () 方法 来 获取 会 话 

对 象 。 它 返回 默认 的 会 话 。 


public static Session getDefaultInstance(Properties props) 
public static Session getDefaultInstance(Properties props, Authe 
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e getinstance(): 有 两 种 方法 使 用 getlnstance () 方法 来 获取 会 话 对 象 。 它 返回 
新 的 会 话 。 





public static Session getInstance(Properties props) 
public static Session getInstance(Properties props, Authenticatc 
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消息 米 
IIS 六 


与 Session 对 象 创建 的 ， 我 们 现在 继续 创建 将 要 发 送 的 消息 。 该 消息 类 型 将 是 
javax.mail.Message. 


e Message 是 一 个 抽象 类 。 因 此 ， 它 的 子 类 javax.mail.internet.MimeMessage 类 


大 多 使 用 。 
e 创建 消息 ， 你 需要 传递 会 话 对 象 中 的 MimeMessage 类 的 构造 画 数 。 例 如 : 


MimeMessage message-new MimeMessage(session); 


e 一 旦 消息 对 象 被 创建 ， 我 们 需要 存储 的 信息 在 里 面 。 消 息 类 实现 了 


javax.mail.Part 接 口 ， 当 使 用 javax.mail.internet。 的 MimeMessage 实 现 
javax.mail.internet.MimePart。 您 可 以 使 用 message.setContent() 或 
mimeMessage.setText() 来 存储 内 容 。 


MimeMessage 类 的 常用 的 方法 有 
方法 描述 


public void setFrom(Address address) used to set the from header field. 


public void 
addRecipients(Message.RecipientType 
type, String addresses) 


used to add the given address to 
the recipient type. 


public void setSubject(String subject) used to set the subject header field. 
public void setText(String used to set the text as the message 
textmessage) content using text/plain MIME type. 


地 址 类 


现在 ， 


我 们 有 一 个 会 话 和 消息 〈 存 储 在 它 里 面 的 内 容 ) 的 对 象 ， 我 们 需要 使 用 地 址 


对 象 ， 以 解决 这 封 邮 件 。 


Address 是 一 个 抽象 类 。 因 此 ， 它 的 子 类 javax.mail.internet.InternetAddress 类 
大 多 被 使 用 。 


Address 可 以 通过 刚好 路 过 的 电子 邮件 地 址 来 创建 : 


Address address = new InternetAddress("manishaQgmail.com"); 


创建 地 址 的 另 一 种 方式 是 通过 将 名 称 与 电子 邮件 地 址 : 


Address address = new InternetAddress("manisha@gmail.com", Mani 
mi = ü 


您 还 可 以 设置 收 件 人 ， 发 件 人 ， 抄 送 ， 密 件 抄 送 (To, From, CC, BCC) 字段 
如 下 fields as below 
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o message.setFrom(address) 

o message.addRecipient(type, address) 

o 三 种 预定 义 的 地 址 类 型 是 与 这 些 值 中 的 一 个 对 象 : 
a Message.RecipientType.TO 
=» Message.RecipientType.CC 


m Message.RecipientType.BCC 


Authenticator # 
Authenticator 类 表示 懂得 如 何 获 得 认证 的 网 络 连接 的 对 象 。 通 常情 况 下 ， 它 会 通过 
提示 信息 的 用 户 这 样 做 。 
e 身份 验证 是 一 个 抽象 类 。 您 可 以 创建 一 个 子 类 PasswordAuthentication， 通 过 
用 户 名 和 密码 给 它 的 构造 。 
e 必须 注册 认证 者 与 当 您 创建 会 话 对 象 的 会 话 。 
以 下 是 验证 器 使 用 的 一 个 例子 : 


Properties props = new Properties(); 

//Override props with any customized data 

PasswordAuthentication auth = new PasswordAuthentication("manisha", 
Session session = Session.getDefaultInstance(props, auth); 


PN É 





Transport # 


Transport 类 用 来 作为 消息 传输 机 制 。 这 个 类 通常 使 用 SMTP 协 议 来 发 送 消息 。 
e 它 是 一 个 抽象 类 。 


e 你 可 以 通过 只 调用 静态 的 send O 方法 使 用 该 类 的 默认 版 本 : 


Transport.send(message); 


。 发 送 消息 的 另 一 种 方法 是 通过 从 会 话 您 的 协议 得 到 一 个 特定 的 实例 ， 传 递 下 去 
的 用 户 名 和 密码 (空白 ， 如 果 不 必要 的 ) ， 发 送 消息 ， 并 关闭 连接 : 


message.saveChanges(); // implicit with send() 

//Get transport for session 

Transport transport = session.getTransport("smtp"); 
//Connect 

transport.connect(host, username, password); 

//repeat if necessary 

transport.sendMessage(message, message.getAllRecipients()); 
//Done, close the connection 

transport.close(); 


Store # 


一 个 抽象 类 ， 模 型 信息 存储 和 访问 协议 ， 用 于 存储 和 检索 信息 。 子 类 提供 实际 的 实 
现 。 存 储 扩展 服务 类 ， 它 提供 命名 商店 ， 连 接 到 存储 ， 并 听取 连接 事件 很 多 常见 的 
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客户 获得 通过 获得 它 实 现 了 数据 库 访 问 协议 的 Store 对 象 访问 消息 存储 。 大 多 数 邮 件 
存储 需要 进行 身份 验证 ， 才 人 允许 访问 的 用 户 。 connect 方 法 进行 身份 验证 。 


Store store = session.getStore("pop3"); 
store.connect(host, username, password); 


Folder 类 

folder 是 表示 一 个 文件 夹 的 邮件 消息 的 抽象 类 。 子 类 实现 协议 的 具体 文件 夹 。 文 件 
夹 可 以 包含 子 文件 夹 ， 以 及 消息 ， 从 而 提供 了 一 种 分 层 结 构 。 

连接 到 存储 后 ， 您 就 可 以 得 到 一 个 文件 夹 ， 必 须 先 打 开 ， 然 后 才能 从 中 读 取消 息 。 
Folder folder = store.getFolder("INBOX"); 


folder.open(Folder.READ ONLY); 
Message message[] = folder.getMessages(); 


getFolder (字符 串 name) 方法 为 一 个 Folder 对 象 返回 指定 的 子 文件 夹 。 关 闭 一 次 
读 邮 件 完成 两 者 的 存储 和 文件 夹 的 连接 。 


我 们 可 以 看 到 下 面 的 图 片 的 存储 和 文件 夹 的 关系 : 


Folder “Inbox” 


Message #1 
Message #2 


Another Folder #1 


Another Folder #2 
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正如 我 们 所 看 到 的 ， 每 个 用 户 帐 户 ， 该 服务 器 有 一 个 商店 ， 这 是 用 户 的 信息 的 存 
储 。 该 存储 分 为 文件 夹 ， 并 在 “ 收 件 箱 " 文 件 夹 ， 其 中 包含 电子 邮件 的 主要 文件 夹 。 
文件 夹 可 以 包含 邮件 和 子 文件 夹 。 


JavaMail API 发 送 电子 邮件 - JavaMail 


现在 ， 我 们 对 JavaMail API 及 其 核心 类 有 一 个 清晰 的 概念 ， 现 在 让 我 们 写 这 将 发 送 
简单 的 电子 邮件 ， 邮 件 带 有 附件 ， 电 子 邮件 ，HTML 内 容 和 电子 邮件 内 典 图 像 一 个 
简单 的 程序 。 
接着 在 上 述 所 有 情况 的 基本 步骤 如 下 : 

e 获取 Session 对 象 。 

。 撰写 邮件 。 

。 发 送 消息 。 
在 下 面 的 章节 中 ， 我 们 已 经 证 明了 简单 的 例子 : 

e 发 送 简单 邮件 

e 发 送 附 件 的 邮件 

e 在 电子 邮件 中 发 送 HTML 内 容 

e RAAB A RBA BF op p 


JavaMail 查询 电子 邮件 - JavaMail 


分 为 两 部 分 ， 需 要 在 继续 本 章 之 前 的 理解 。 邮 件 检查 和 提取 。 


e 检查 在 JavaMail 的 电子 邮件 是 我 们 在 邮箱 打开 相应 的 文件 夹 ， 每 个 消息 传递 的 
过 程 。 在 这 里 ， 我 们 只 检查 每 封 邮件 的 标题 即 发 件 人 ， 收 件 人 ， 主 题 。 内 容 不 
会 被 读 取 。 


。 在 获取 JavaMail 的 电子 邮件 是 我 们 在 邮箱 中 打开 相应 的 文件 夹 ， 每 个 消息 传递 
的 过 程 。 非 常 久 远 的 标题 ， 我 们 也 认识 到 内 容 类 型 阅读 的 内 容 。 


为 了 使 用 JavaMail API 检查 或 提取 电子 邮件 ， 我 们 需要 POP 或 IMAP 服 务 器 。 要 检 
查 并 获取 邮件 ， 需 要 文件 夹 和 存储 类 。 在 这 里 ， 我 们 使 用 了 Gmail 的 POP3 服 务 器 
(pop.gmail.com) 。 在 本 章 将 学 习 如 何 使 用 JavaMail API 来 检查 电子 邮件 。 提 取 
应 覆盖 在 随后 的 章节 。 要 检查 的 电子 邮件 : 


。 获得 一 个 Session 

。 创建 POP3 Store 对 象 并 连接 pop 服 务 器 。 

e 创建 文件 夹 对 象 。 在 您 的 邮箱 中 打开 相应 的 文件 夹 。 
。 得 到 消息 。 


e 关闭 存储 和 文件 夹 对 象 。 


创建 Java 类 
创建 一 个 Java 类 文件 CheckingMails， 是 其 内 容 如 下 : 


package com.yiibai; 
import java.util.Properties; 


import javax.mail.Folder; 

import javax.mail.Message; 

import javax.mail.MessagingException; 
import javax.mail.NoSuchProviderException; 
import javax.mail.Session; 


import javax.mail.Store; 
public class CheckingMails { 


public static void check(String host, String storeType, String t 
String password) 


try { 


} 


//create properties field 
Properties properties = new Properties(); 


properties.put("mail.pop3.host", host); 
properties.put("mail.pop3.port", "995"); 
properties.put("mail.pop3.starttls.enable", "true"); 

Session emailSession = Session.getDefaultInstance(properties 


//create the POP3 store object and connect with the pop serve 
Store store = emailSession.getStore("pop3s"); 


store.connect(host, user, password); 


//create the folder object and open it 
Folder emailFolder = store.getFolder ("INBOX"); 
emailFolder.open(Folder.READ ONLY); 


// retrieve the messages from the folder in an array and prir 
Message[] messages - emailFolder.getMessages(); 
System.out.println("messages.length---" + messages.length); 


for (int i = 0, n = messages.length; i < n; i++) { 
Message message - messages[i]; 
System.out.println("--------------------------------- ENS 
System.out.println("Email Number " + (i + 1)); 
System.out.println("Subject: " + message.getSubject()); 
System.out.println("From: " + message.getFrom()[0]); 
System.out.println("Text: " + message.getContent().toStrir 


} 


//close the store and folder objects 
emailFolder.close(false) ; 
store.close(); 


} catch (NoSuchProviderException e) { 
e.printStackTrace(); 

) catch (MessagingException e) { 
e.printStackTrace(); 

} catch (Exception e) { 
e.printStackTrace(); 

} 


public static void main(String[] args) { 


String host = "pop.gmail.com";// change accordingly 

String mailStoreType = "pop3"; 

String username = "yourmail@gmail.com";// change accordingly 
String password = "*****""// change accordingly 


check(host, mailStoreType, username, password); 


} 
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编译 并 运行 
现在 ， 我 们 班 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
CheckingMails.javaB x : /homeimanishanuavaMalAPIEXerise 我 们 需 


javax.mail.jar andactivation.jar 在 classpath 中 。 执 行 下 面 的 命令 从 命令 提示 符 编 译 
类 (两 个 jar 文 件 被 放置 在 lhome/manisha/ 目录 下 ) 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.ja! 
a m—— À— JJ '—— a Z] 
现在 ， 这 个 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 





java -cp /home/manisha/activation.jar:/home/manisha/javax.mail. jar 


al — 





验证 输出 
你 应 该 看 到 下 面 的 消 Salat : 


messages. length---4 

Email Number 1 

Subject: Test Mail--Fetch 

From: <abcd@gmail.com> 

Text: javax.mail.internet .MimeMultipart@327a5b7f 
Email Number 2 

Subject: testing ----checking simple email 

From: <abcd@gmail.com> 

Text: javax.mail.internet.MimeMultipartQ7fOdO8bc 
Email Number 3 

Subject: Email with attachment 

From: <abcd@gmail.com> 

Text: javax.mail.internet .MimeMultipart@30b8afce 
Email Number 4 

Subject: Email with Inline image 

From: <abcd@gmail.com> 

Text: javax.mail.internet .MimeMultipart@2d1e165f 


这 里 ， 我 们 已 经 打印 的 消息 ， 其 中 是 4 在 这 种 情况 下 ， 收 件 箱 的 数目 。 我 们 还 印 制 
主题 ， 发 件 人 地 址 和 文本 的 每 封 电子 邮件 。 


JavaMail 获取 电子 邮件 - JavaMail 


在 前 面 的 章节 中 ， 我 们 学 会 了 如 何 检查 电子 邮件 。 现 在 让 我 们 来 看 看 如 何 获 取 每 封 
电子 邮件 和 阅读 其 内 容 。 让 我 们 编写 一 个 Java 类 FetchingEmail 读 取 以 下 类 型 的 电 
子 邮 件 : 


e 简单 的 电子 邮件 
e 电子 邮件 与 附件 
e uf PES PIER LR 
其 次 在 代码 的 基本 步骤 如 下 : 
。 获取 Session 对 象 。 
e 创建 POP3 存 储 对 象 ， 并 连接 到 存储 。 
e 创建 文件 夹 对 象 ， 并 在 您 的 邮箱 中 打开 相应 的 文件 夹 。 
。 检索 消息 。 


© 分 别 关 闭 文件 夹 和 存储 对 象 。 


创建 Java 类 
创建 一 个 Java 创 建 一 个 Java 类 文件 FetchingEmail， 内 容 都 是 如 下 : 


package com.yiibai; 


import java.io.BufferedOutputStream; 
import java.io.BufferedReader; 
import java.io.DataOutputStream; 
import java.io.File; 

import java.io.FileOutputStream; 
import java.io.IOException; 

import java.io.InputStream; 

import java.io.InputStreamReader; 
import java.util.Date; 

import java.util.Properties; 


import javax.mail.Address; 

import javax.mail.Folder; 

import javax.mail.Message; 

import javax.mail.MessagingException; 
import javax.mail.Multipart; 

import javax.mail.NoSuchProviderException; 
import javax.mail.Part; 

import javax.mail.Session; 


import javax.mail.Store; 
public class FetchingEmail { 


public static void fetch(String pop3Host, String storeType, Str: 

String password) { 

try { 
// create properties field 
Properties properties = new Properties(); 
properties.put("mail.store.protocol", "pop3"); 
properties.put("mail.pop3.host", pop3Host); 
properties.put("mail.pop3.port", "995"); 
properties.put("mail.pop3.starttls.enable", "true"); 
Session emailSession = Session.getDefaultInstance(propert: 
// emailSession.setDebug(true); 


// create the POP3 store object and connect with the pop : 
Store store = emailSession.getStore("pop3s"); 


store.connect(pop3Host, user, password); 


// create the folder object and open it 
Folder emailFolder = store.getFolder ("INBOX"); 
emailFolder.open(Folder.READ ONLY); 


BufferedReader reader = new BufferedReader(new InputStrear 
System.in)); 


// retrieve the messages from the folder in an array and I 
Message[] messages - emailFolder.getMessages(); 
System.out.println("messages.length---" + messages, length 


for (int i = 0; i « messages.length; i++) { 

Message message = messages[i]; 

System.out.println("--------------------------------- 

writePart(message); 

String line - reader.readLine(); 

if ("YES".equals(line)) { 
message.writeTo(System.out); 

) else if ("QUIT".equals(line)) { 
break; 

j 


j 


// close the store and folder objects 
emailFolder.close(false); 
store.close(); 


) catch (NoSuchProviderException e) ( 
e.printStackTrace(); 

) catch (MessagingException e) { 
e.printStackTrace(); 

) catch (IOException e) { 


e.printStackTrace(); 
} catch (Exception e) { 

e.printStackTrace(); 
} 


} 


public static void main(String[] args) { 


String host = "pop.gmail.com";// change accordingly 
String mailStoreType = "pop3"; 
String username = 
"abc@gmail.com";// change accordingly 
String password = "*****"^// change accordingly 


//Call method fetch 
fetch(host, mailStoreType, username, password); 


j 


Vf 

* This method checks for content-type 

* based on which, it processes and 

* fetches the content of the message 

n 

public static void writePart(Part p) throws Exception { 

if (p instanceof Message) 

//Call methos writeEnvelope 
writeEnvelope((Message) p); 


System. out.println(“--------=7-7------------------ Bye 
System.out.println( "CONTENT-TYPE: " + p.getContentType()); 


//check if the content is plain text 

if (p.isMimeType("text/plain")) { 
System.out.println("This is plain text"); 
System.out.println("--------------------------- ym 
System.out.println((String) p.getContent()); 

} 

//check if the content has attachment 

else if (p.isMimeType("multipart/*")) { 
System.out.println("This is a Multipart"); 
System.out.println("--------------------------- ys 
Multipart mp - (Multipart) p.getContent(); 
int count - mp.getCount(); 
for (int i = 0; i < count; i++) 

writePart(mp.getBodyPart(i)); 


//check if the content is a nested message 

else if (p.isMimeType("message/rfc822")) { 
System.out.println("This is a Nested Message"); 
System.out.println("--------------------------- ys 
writePart((Part) p.getContent()); 


//check if the content is an inline image 


else if (p.isMimeType("image/jpeg")) { 
System.out.println("-------- » image/jpeg"); 
Object o = p.getContent(); 


InputStream x - (InputStream) o; 

// Construct the required byte array 
System.out.println("x.length = " + x.available()); 
int i - 0; 

byte[] bArray - new byte[x.available()]; 


while ((i = (int) ((InputStream) x).available()) > 0) { 
int result = (int) (((InputStream) x).read(bArray)); 
if (result == -1) 
break; 

} 

FileOutputStream f2 = new FileOutputStream("/tmp/image.jpt 

f2.write(bArray); 


else if (p.getContentType().contains("image/")) ( 
System.out.println("content type" + p.getContentType()); 
File f = new File("image" + new Date().getTime() + ".jpg": 
DataOutputStream output = new DataOutputStream( 
new BufferedOutputStream(new FileOutputStream(f))); 
com.sun.mail.util.BASE64DecoderStream test = 
(com.sun.mail.util.BASE64DecoderStream) p 
.getContent(); 
byte[] buffer = new byte[1024]; 
int bytesRead; 
while ((bytesRead = test.read(buffer)) != -1) { 
output.write(buffer, 0, bytesRead); 
} 
} 


else { 
Object o = p.getContent(); 
if (o instanceof String) { 
System.out.println("This is a string"); 
System.out.println("--------------------------- ca 
System.out.println((String) o); 


else if (o instanceof InputStream) { 
System.out.println("This is just an input stream"); 
System.out.println("--------------------------- Ey 
InputStream is - (InputStream) o; 
is - (InputStream) o; 


Int e; 
while ((c = is.read()) != -1) 
System.out.write(c); 
} 
else { 
System.out.println("This is an unknown type"); 
System.out.println("--------------------------- sa 


System.out.println(o.toString()); 
j 


} 

7 

* This method would print FROM,TO and SUBJECT of the message 

n 

public static void writeEnvelope(Message m) throws Exception ( 
System.out.println("This is the message sued oper m 
System.out.println("--------------------------- d 
Address[] a; 


, 


// FROM 

if ((a = m.getFrom()) != null) ( 
for (int j = 0; j < a.length; j++) 
System.out.println("FROM: " + a[j].toString()); 


77 TO 

if ((a = m.getRecipients(Message.RecipientType.TO)) != null) 
for (int j = 0; j < a.length; j++) 
System.out.println("TO: " + a[j].toString()); 


// SUBJECT 
if (m.getSubject() != null) 
System.out.println( "SUBJECT: " + m.getSubject()); 





> 您 可 以 通过 取消 注释 语句 上 设置 调试 emailSession.setDebug(true); 


编译 并 运行 


现在 ， 我 们 班 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
FetchingEmail.java 目 录 : IhomelmanishalJavaMalAP IExercise ee 
javax.mail.jar andactivation.jar 在 classpath 中 。 执 行 下 面 的 命令 从 命令 提示 符 编 译 
类 〈 两 个 缸 子 被 放 冒 在 /home/manisha/ 目 录 下 ) 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.ja! 


[i| ege e LL LLL] 





现在 ， 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 


java -cp /home/manisha/activation. jar:/home/manisha/javax.mail. jar 


‘ — HW 








验证 输出 
你 应 该 看 到 下 面 的 消息 命令 控制 台 


messages.length---3 


FROM: XYZ <xyz@gmail.com> 

TO: ABC <abc@gmail.com> 

SUBJECT: Simple Message 

CONTENT-TYPE: multipart/alternative; boundary-047d7b343d6ad3e4ea04« 
This is a Multipart 


CONTENT-TYPE: text/plain; charset-ISO-8859-1 
This is plain text 


Hi am a simple message string.... 


Regards 
xyz 


This is the message envelope 

FROM: XYZ <xyz@gmail.com> 

TO: ABC <abc@gmail.com> 

SUBJECT: Attachement 

CONTENT-TYPE: multipart/mixed; boundary=047d7b343d6a99180904e8ec67! 
This is a Multipart 


CONTENT-TYPE: text/plain; charset-ISO-8859-1 
This is plain text 


Hi I've an attachment.Please check 


Regards 
XYZ 


CONTENT-TYPE: application/octet-stream; name=sample_attachement 
This is just an input stream 


Submit your Tutorials, White Papers and Articles into our Tutorial: 


This is the message envelope 


FROM: XYZ <xyz@gmail.com> 
TO: ABC <abc@gmail.com> 
SUBJECT: Inline Image 


CONTENT-TYPE: multipart/related; boundary-f46d04182582be803504e8ec« 
This is a Multipart 


CONTENT-TYPE: text/plain; charset-ISO-8859-1 
This is plain text 


Hi I've an inline image 
[image: Inline image 3] 


Regards 
XYZ 


CONTENT-TYPE: image/png; name-"javamail-mini-logo.png" 
content typeimage/png; name-"javamail-mini-logo.png" 


| —— JE 
在 这 里 ， 你 可 以 看 到 有 三 封 邮 件 在 邮箱 中 。 首 先 一 个 简单 的 邮件 消息 "Hi ama 


simple message string.…"。 第 二 个 邮件 有 附件 。 附 件 的 内 容 也 印 如 上 所 示 。 第 三 
^r up 8 —T VERE AR 





JavaMail 认 证 /验证 - JavaMail 


在 前 面 的 章节 查询 电子 邮件 和 读 取 电子 邮件 ， 我 们 通过 授权 凭证 (A Pees) 
以 及 主机 ， 连 接 到 您 的 邮箱 中 存储 时 。 相 反 ， 我 们 可 以 配置 属性 有 主机 ， 并 告诉 您 
的 自 定 义 的 Authenticator 实 例 的 会 话 。 这 示 于 下 面 的 例子 : 


创建 Java 类 


我 们 将 修改 CheckingMails.java 请 先 阅 读 章 查 询 电 子 邮 件 这 章 。 其 内 容 如 下 所 


xh: 


packag 
import 


import 
import 
import 
import 
import 
import 
import 
import 


public 
pub 
1 


e com.yiibai; 
java.util.Properties; 


javax.mail.Authenticator; 
javax.mail.Folder; 
javax.mail.Message; 
javax.mail.MessagingException; 
javax.mail.NoSuchProviderException; 
javax.mail.PasswordAuthentication; 
javax.mail.Session; 
javax.mail.Store; 


class CheckingMails { 


lic static void check(String host, String storeType, String t 
String password) 


try { 


// create properties field 
Properties properties = new Properties(); 


properties.put("mail.pop3s.host", host); 
properties.put("mail.pop3s.port", "995"); 
properties.put("mail.pop3s.starttls.enable", "true"); 


// Setup authentication, get session 
Session emailSession = Session.getInstance(properties, 
new javax.mail.Authenticator() { 
protected PasswordAuthentication getPasswordAuthentica! 
return new PasswordAuthentication( 
"manishapatil3mayQgmail.com", "manisha123"); 
} 
}); 


// emailSession.setDebug(true); 


// create the POP3 store object and connect with the pop ser\ 
Store store = emailSession.getStore("pop3s"); 


store.connect(); 


// create the folder object and open it 
Folder emailFolder = store.getFolder ("INBOX"); 
emailFolder.open(Folder.READ ONLY); 


// retrieve the messages from the folder in an array and prir 
Message[] messages - emailFolder.getMessages(); 
System.out.println("messages.length---" + messages.length); 


for (int i = 0, n = messages.length; i < n; i++) { 
Message message - messages[i]; 
System.out.println("--------------------------------- m 
System.out.println("Email Number " + (i + 1)); 
System.out.println("Subject: " + message.getSubject()); 
System.out.println("From: " + message.getFrom()[0]); 
System.out.println("Text: " + message.getContent().toStrir 


j 


// close the store and folder objects 
emailFolder.close(false); 
store.close(); 


) catch (NoSuchProviderException e) { 
e.printStackTrace(); 

) catch (MessagingException e) { 
e.printStackTrace(); 

) catch (Exception e) { 
e.printStackTrace(); 


j 
} 
public static void main(String[] args) { 
String host = "pop.gmail.com";// change accordingly 
String mailStoreType = "pop3"; 
String username = "abc@gmail.com";// change accordingly 


String password "*****W,// change accordingly 


check(host, mailStoreType, username, password); 


} 


«| E 











> 您 可 以 通过 取消 注释 语句 上 设置 调试 emailSession.setDebug(true); 


编译 并 运行 


现在 ， 我 们 班 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
CheckingMails.java B x : lhome/manisha/JavaMailAPIExercise. 我 们 需 
javax.mail.jar andactivation.jar 在 classpath 中 。 执 行 下 面 的 命令 从 命令 提示 符 编 译 
类 (两 个 缸 子 被 放置 在 /home/manisha/ 目录 下 ) 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.jat 


«| = —E 








现在 ， 这 个 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 


java -cp /home/manisha/activation. jar:/home/manisha/javax.mail. jar 


SSS Saas 





验证 输出 
你 可 以 看 到 一 个 类 似 的 消息 ， 如 下 命令 控制 台 上 : 


messages.length---3 

Email Number 1 

Subject: Today is a nice day 

From: XYZ <xyz@gmail.com> 

Text: javax.mail.internet.MimeMultipartQ45f676cb 
Email Number 2 

Subject: hiiii.... 

From: XYZ <xyz@gmail.com> 

Text: javax.mail.internet.MimeMultipartQ37f12d4f 
Email Number 3 

Subject: helloo 

From: XYZ <xyz@gmail.com> 

Text: javax.mail.internet .MimeMultipart@3ad5ba3a 


JavaMail 电子 邮件 答复 /回复 - JavaMail 


在 本 章 中 ， 我 们 将 看 到 如 何 使 用 JavaMail APl 来 回复 电子 邮件 。 接 着 在 下 面 的 程序 
中 的 列 出 基本 步骤 : 


获取 Session 对 象 与 POP 和 SMTP 服务 器 的 细节 属性 。 我 们 需要 POP 细节 来 检 
索 信 息 和 SMPT 详 细 信 息 发 送 邮 件 。 


创建 POP3 存 储 对 象 ， 并 连接 到 存储 。 

创建 文件 夹 对 象 ， 并 在 您 的 邮箱 中 打开 相应 的 文件 夹 。 
检索 消息 。 

声 历 的 消息 ， 如 果 你 想 回复 键入 “Y” 或 “y”。 


得 到 消息 的 所 有 信息 OFA, RIFA, ER, AR) (To,From,Subject, 
Content) 。 


建立 应 答 消息 ， 使 用 Message.reply() 方 法 。 这 个 方法 配置 一 个 新 的 消息 与 适当 
的 收 件 人 和 主题 。 该 方法 接受 一 个 布尔 参数 ， 指 示 是 否 只 回复 给 发 送 者 (false) 
或 回复 给 所 有 人 (true) 。 


从 设置 ， 文 本 和 回复 到 邮件 中 ， 并 通过 传输 对 象 的 实例 发 送 。 
关闭 传输 ， 文 件 夹 和 存储 对 象 分 别 。 


> 在 这 里 ， 我 们 使 用 JangoSMPT 服 务 器 通过 该 电子 邮件 发 送 到 我 们 的 目标 电子 邮件 
地 址 。 设 置 是 在 环境 设置 章节 解释 。 


创建 Java 类 


创建 一 个 Java 类 文件 ReplyToEmail， 是 其 内 容 如 下 : 


package com.yiibai; 


import java.io.BufferedReader; 
import java.io.InputStreamReader; 
import java.util.Date; 

import java.util.Properties; 


import javax.mail.Folder; 

import javax.mail.Message; 

import javax.mail.Session; 

import javax.mail.Store; 

import javax.mail.Transport; 

import javax.mail.internet.InternetAddress; 
import javax.mail.internet.MimeMessage; 


public class ReplyToEmail { 
public static void main(String args[]) 


i 


Date date = null; 


Properties properties = new Properties(); 
properties.put("mail.store.protocol", "pop3"); 
properties.put("mail.pop3s.host", "pop.gmail.com"); 
properties.put("mail.pop3s.port", "995"); 
properties.put("mail.pop3.starttls.enable", "true"); 
properties.put("mail.smtp.auth", "true"); 
properties.put("mail.smtp.starttls.enable", "true"); 
properties.put("mail.smtp.host", "relay.jangosmtp.net"); 
properties.put("mail.smtp.port", "25"); 

Session session = Session.getDefaultInstance(properties); 


// session.setDebug(true); 


try 


( 


// Get a Store object and connect to the current host 

Store store - session.getStore("pop3s"); 

store.connect("pop.gmail.com", "xyzQgmail.com", 
"xx*xx*")///change the user and password accordingly 


Folder folder - store.getFolder("inbox"); 
if (!folder.exists()) { 
System.out.println("inbox not found"); 
System.exit(0); 
} 
folder.open(Folder.READ ONLY); 


BufferedReader reader = new BufferedReader(new InputStrear 
System.in)); 


Message[] messages = folder.getMessages(); 
if (messages.length != 0) ( 


for (int i = 0, n = messages.length; i < n; i++) { 
Message message = messages[i]; 
date = message.getSentDate(); 
// Get all the information from the message 
String from = InternetAddress.toString(message.getFi 
if (from != null) { 


System.out.println("From: " + from); 
} 
String replyTo = InternetAddress.toString(message 
.getReplyTo()); 


if (replyTo != null) { 
System.out.println("Reply-to: " + replyTo); 
} 
String to = InternetAddress.toString(message 
.getRecipients(Message.RecipientType.TO)); 


if (to != null) { 
System.out.println("To: " + to); 
j 


String subject - message.getSubject(); 
if (subject !- null) ( 


System.out.println("Subject: " + subject); 


j 


Date sent - message.getSentDate(); 
if (sent !- null) ( 
System.out.println("Sent: " + sent); 


j 


System.out.print("Do you want to reply [y/n] 


String ans - reader.readLine(); 


if ("Y".equals(ans) || "y".equals(ans)) { 


7): 


Message replyMessage - new MimeMessage(session); 


replyMessage = (MimeMessage) message.reply(false: 
replyMessage.setFrom(new InternetAddress(to)); 
replyMessage.setText("Thanks"); 
replyMessage.setReplyTo(message.getReplyTo()); 


// Send the message by authenticating the SMTP st 
// Create a Transport instance and call the send! 


Transport t = session.getTransport("smtp"); 


try { 


//connect to the smpt server using transport instar 


//change the user and password accordingly 
t.connect("abc", RUP 
t.sendMessage(replyMessage, 


replyMessage.getAllRecipients()); 


} finally { 
t.close(); 
j 


System.out.println("message replied successfully 


// close the store and folder objects 
folder.close(false); 
store.close(); 


) else if ("n".equals(ans)) ( 
break; 


} 
}//end of for loop 
} else { 


System.out.println("There is no msg...."); 
} 


} catch (Exception e) { 
e.printStackTrace(); 


} 


} 


«| x 











> 您 可 以 通过 取消 注释 语句 上 设置 调试 session.setDebug(true); 


编译 并 运行 
现在 ， 我 们 班 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
ReplyToEmail.java 到 目录 : /homelmanisha/ JavaMailAPIExercise peers 


E mail.jar andactivation.jar 在 classpath 中 。 执 行 下 面 的 命令 从 命令 提示 符 编 
类 (AMES RAS /home/manisha/ 目录 下 ) 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.ja! 
E | É 
现在 ， 这 个 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 





java -cp /home/manisha/activation. jar:/home/manisha/javax.mail. jar 


[E __ SSE 





验证 输出 
你 应 该 看 到 下 面 的 消息 命令 控制 台 上 : 


From: ABC <abc@gmail.com> 
Reply-to: abc@trioteksolutions.com 
To: XYZ <xyz@gmail.com> 

Subject: Hi today is a nice day 
Sent: Thu Oct 17 15:58:37 IST 2013 
Do you want to reply [y/n] : y 
message replied successfully .... 


检查 该 邮件 发 送 的 收 件 箱 。 在 我 们 的 例子 中 收 到 的 邮件 看 起 来 如 下 : 


Thanks 


Rome ani 
Transter St 
www. romet 


Thu, Oct 17, 2013 at 4:11 PM 





bounce. secureserver.net 


Important mainly because it was sent directly to you 


ecureserver. net 4:11 PM (2 minutes ag 


JavaMail 转发 电子 邮件 - JavaMail 


在 本 章 中 ， 我 们 将 看 到 如 何 使 用 JavaMail AP| 来 转发 电子 邮件 。 接 着 在 下 面 的 程序 
的 基本 步骤 是 : 


e 获取 Session 对 象 与 POP 和 SMTP 服 务 器 的 细节 的 属性 。 我 们 需要 的 POP 细节 
来 检索 信息 和 SMPT 详 细 信 息 发 送 邮件 。 


e 创建 POP3 存 储 对 象 ， 并 连接 到 存储 。 

e 创建 文件 夹 对 象 ， 并 在 您 的 邮箱 中 打开 相应 的 文件 夹 。 
。 检索 消息 。 

。 通 历 的 消息 ， 如 果 你 想 转发 键入" 或"y "。 

e 得 到 消息 的 所 有 信息 〈 收 件 人 ， 发 件 人 ， 主 题 ， 内 容 ) 。 


e 通过 与 组 成 消息 的 各 个 部 分 的 工作 建立 转发 消息 。 第 一 部 分 将 是 消息 的 文本 和 
第 二 部 分 将 要 转发 的 邮件 。 结 合 两 成 多 部 分 。 那 么 你 多 部 分 添加 到 妥善 义理 消 
息 并 发 送 它 。 


e 关闭 传输 ， 文 件 夹 和 存储 对 象 分 别 。 


> 在 这 里 ， 我 们 使 用 JangoSMPT 服 务 器 通过 该 电子 邮件 被 发 送 到 我 们 的 目标 电子 邮 
件 地 址 。 设 置 是 在 环境 设置 章节 解释 。 


创建 Java 类 
创建 一 个 Java 类 文件 ForwardEmail， 是 其 内 容 如 下 : 


package com.yiibai; 


import java.io.BufferedReader; 
import java.io.InputStreamReader; 
import java.util.Date; 

import java.util.Properties; 


import javax.mail.BodyPart; 

import javax.mail.Folder; 

import javax.mail.Message; 

import javax.mail.Multipart; 

import javax.mail.PasswordAuthentication; 
import javax.mail.Session; 

import javax.mail.Store; 

import javax.mail.Transport; 

import javax.mail.internet.InternetAddress; 
import javax.mail.internet.MimeBodyPart; 


import javax.mail.internet .MimeMessage; 
import javax.mail.internet.MimeMultipart; 


public class ForwardEmail { 


public static void main(String[] args) ( 
Properties properties - new Properties(); 
properties.put("mail.store.protocol", "pop3"); 
properties.put("mail.pop3s.host", "pop.gmail.com"); 
properties.put("mail.pop3s.port", "995"); 
properties.put("mail.pop3.starttls.enable", "true"); 
properties.put("mail.smtp.auth", "true"); 
properties.put("mail.smtp.host", "relay.jangosmtp.net"); 
properties.put("mail.smtp.port", "25"); 
Session session = Session.getDefaultInstance(properties); 
try { 
// session.setDebug(true); 
// Get a Store object and connect to the current host 
Store store = session.getStore("pop3s"); 
store.connect("pop.gmail.com", "xyz@gmail.com", 
"x*xx*'")///change the user and password accordingly 


// Create a Folder object and open the folder 

Folder folder = store.getFolder("inbox"); 

folder .open(Folder.READ_ ONLY); 

BufferedReader reader = new BufferedReader (new InputStrear 
System.in)); 

Message[] messages = folder.getMessages(); 

if (messages.length != 0) { 


for (int i = 0, n = messages.length; i < n; i++) ( 
Message message = messages[i]; 
// Get all the information from the message 
String from = InternetAddress.toString(message.getFromi 
if (from != null) { 


System.out.println("From: " + from); 

} 

String replyTo = InternetAddress.toString(message 
.getReplyTo()); 


if (replyTo !- null) ( 
System.out.println("Reply-to: " + replyTo); 
j 


String to - InternetAddress.toString(message 
.getRecipients(Message.RecipientType.TO)); 
if (to != null) ( 
System.out.printin("To: " + to); 
} 


String subject = message.getSubject(); 

if (subject != null) { 
System.out.println("Subject: " + subject); 

j 


Date sent - message.getSentDate(); 


if (sent != null) { 
System.out.println("Sent: " + sent); 
} 


System.out.print("Do you want to reply [y/n] : "); 

String ans - reader.readLine(); 

if ("Y".equals(ans) || "y".equals(ans)) ( 
Message forward - new MimeMessage(session); 
// Fill in header 
forward.setRecipients(Message.RecipientType.TO, 
InternetAddress.parse(from)); 
forward.setSubject("Fwd: " + message.getSubject()); 
forward.setFrom(new InternetAddress(to)); 


// Create the message part 

MimeBodyPart messageBodyPart - new MimeBodyPart(); 
// Create a multipart message 

Multipart multipart - new MimeMultipart(); 

// set content 

messageBodyPart.setContent(message, "message/rfc822' 
// Add part to multi part 
multipart.addBodyPart(messageBodyPart); 

// Associate multi-part with message 
forward.setContent(multipart); 
forward.saveChanges(); 


// Send the message by authenticating the SMTP serve 
// Create a Transport instance and call the sendMes: 
Transport t = session.getTransport("smtp"); 
try { 
//connect to the smpt server using transport insi 
//change the user and password accordingly 
t.connect("abc", yos 
t.sendMessage(forward, forward.getAllRecipients(: 
} finally { 
t.close(); 
} 


System.out.println("message forwarded successfully. 


// close the store and folder objects 
folder.close(false); 

store.close(); 

}// end if 


}// end for 
}// end if 
} catch (Exception e) { 
e.printStackTrace(); 











«| a 











> 您 可 以 通过 取消 注释 语句 上 设置 调试 session.setDebug(true); 


编译 并 运行 


现在 类 准备 好 了 ， 编 译 上 面 的 类 。 我 已 经 保存 了 类 ForwardEmailjava 目 录 : 
/home/manisha/JavaMailAPIExercise. 我 们 需要 javax.mailjar 和 activation.jar 在 
classpath 中 。 执 行 下 面 的 命令 从 命令 提示 符 编 译 类 (两 个 jar 放置 在 
/home/manisha/ 目录 下 ) 


Javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.jai 





现在 ， 这 个 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 


java -cp /home/manisha/activation.jar:/home/manisha/javax.mail. jar 


国 二 一 





验证 输出 


From: ABC <abc@gmail.com> 
Reply-to: abcQtrioteksolutions.com 
To: XYZ <xyz@gmail.com> 

Subject: Hi today is a nice day 
Sent: Thu Oct 17 15:58:37 IST 2013 
Do you want to reply [y/n] : y 
message forwarded successfully.... 


检查 该 邮件 发 送 的 收 件 箱 。 在 我 们 的 例子 中 转发 的 邮件 看 起 来 如 下 : 


TutorialsPoint Java 技术 教程 


Ce VI3 0000051000 4:37 PM (1 minute age 
tome =+ 
From: | tror Sas Oal con > via jangomal com 
cian med 
| mail.com> 
Cc: eg 
Date: | Thu, Oct 17, 2013 at 4:37 PM 
Subjec 
Hello t 
= jangomail.com 
Regarc , 
XYZ e Important mainly because of your interaction with messages in the conversation 


Ziioaieou 
Hi today is a nice day © inbox x 


MM via jandgomall com 


to me [= 





-- Forwarded message ---------- 


From: j @gmail.com> 
To @gmail.com> 
Cc 


Date: Thu, 17 Oct 2013 15:58:37 +0530 
Subject: Hi today is a nice day 


Hello to day is a noce day 


Regards 
XYZ 


JavaMail 转发 电子 邮件 - JavaMail 1599 


JavaMail 删除 电子 邮件 - JavaMail 


在 本 章 中 ， 我 们 将 看 到 如 何 使 用 JavaMail API m ER o, FR. m ERE RRS 


sv 
消息 


相关 联 的 标志 工作 。 有 不 同 的 标志 为 不 同 的 状态 ， 一 些 系统 定义 和 一 些 用 户 定 


义 的 。 预 定义 的 标志 在 内 部 类 中 定义 的 标志 。 标 志 如 下 所 列 : 


Flags.Flag.ANSWERED 
Flags.Flag.DELETED 
Flags.Flag.DRAFT 
Flags.Flag.FLAGGED 
Flags.Flag.RECENT 
Flags.Flag.SEEN 
Flags.Flag. USER 


POP 协议 支持 的 消息 的 唯一 删除 。 
其 次 在 删除 程序 的 基本 步骤 是 : 


获取 Session 对 象 与 POP 和 SMTP 伺 服 器 的 细节 的 属性 。 我 们 需要 的 POP 细节 
来 检索 信息 和 SMPT 详 细 信 息 发 送 邮件 。 


创建 POP3 存 储 对 象 ， 并 连接 到 存储 。 
创建 文件 夹 对 象 ， 并 在 READ_WRITE 模 式 下 邮箱 打开 相应 的 文件 夹 。 
从 收 件 箱 文 件 夹 中 检索 邮件 。 


通 历 的 消息 ， 如 果 你 想 通 过 Message 对 象 上 调用 方法 
setFlag(Flags.Flag.DELETED, true) 以 删除 邮件 中 键入 "Y” 或 “y”。 


这 些 消息 标记 DELETED 实际 上 并 没有 删除 ， 直 到 我 们 调用 Folder 对 象 上 
expunge() 方法 ， 或 expunge 设置 为 ttue， 关 闭 文件 夹 。 


关闭 存储 对 象 。 


创建 Java 类 


创建 一 个 Java 类 文件 ForwardEmail， 是 其 内 容 如 下 : 


package com.yiibai; 


import java.io.BufferedReader ; 
import java.io.IOException; 


import 
import 


import 
import 
import 
import 
import 
import 
import 


public 


java.io.InputStreamReader ; 
java.util.Properties; 


javax 
javax 
javax 
javax 
javax 
javax 
javax 


class 


.mail. 
.mail. 
.mail. 
.mail. 
.mail. 
.mail. 
.mail. 


Delet 


Flags; 

Folder; 

Message; 
MessagingException; 
NoSuchProviderException; 
Session; 

Store; 


eEmail { 


public static void delete(String pop3Host, String storeType, Sti 
String password) 


( 


in 
{ 


ry 


// get the session object 


Properties properties = new Properties(); 
properties.put("mail.store.protocol", "pop3"); 
properties.put("mail.pop3s.host", pop3Host); 
properties.put("mail.pop3s.port", "995"); 
properties.put("mail.pop3.starttls.enable", "true"); 
Session emailSession = Session.getDefaultInstance(propert: 
// emailSession.setDebug(true); 


// create the POP3 store object and connect with the pop : 
Store store - emailSession.getStore("pop3s"); 


store.connect(pop3Host, user, password); 


// create the folder object and open it 
Folder emailFolder - store.getFolder("INBOX"); 
emailFolder.open(Folder.READ WRITE); 


BufferedReader reader = new BufferedReader(new InputStrear 
System.in)); 

// retrieve the messages from the folder in an array and I 

Message[] messages = emailFolder.getMessages(); 

System.out.println("messages.length---" + messages.length:; 

for (int i = 0; i < messages.length; i++) { 
Message message = messages[i]; 
System.out.println("--------------------------------- ne 
System.out.println("Email Number " + (i + 1)); 
System.out.println("Subject: " + message.getSubject()), 
System.out.println("From: " + message.getFrom()[0]); 


String subject = message.getSubject(); 
System.out.print("Do you want to delete this message [\ 
String ans = reader.readLine(); 

if ("Y".equals(ans) || "y".equals(ans)) { 

// set the DELETE flag to true 


message.setFlag(Flags.Flag.DELETED, true); 
System.out.println("Marked DELETE for message: " + subje 
} else if ("n".equals(ans)) { 
break; 
} 
} 
// expunges the folder to remove messages which are markec 


emailFolder.close(true); 
store.close(); 


) catch (NoSuchProviderException e) { 
e.printStackTrace(); 

) catch (MessagingException e) ( 
e.printStackTrace(); 

) catch (IOException io) { 
io.printStackTrace(); 

E 


} 

public static void main(String[] args) { 
String host = "pop.gmail.com";// change accordingly 
String mailStoreType = "pop3"; 
String username = "abc@gmail.com";// change accordingly 


String password = "*****""// change accordingly 


delete(host, mailStoreType, username, password); 





> 您 可 以 通过 取消 注释 语句 上 设置 调试 emailSession.setDebug(true); 


编译 并 运行 


现在 ， 我 们 的 类 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
DeleteEmail.java El 3 : /home/manisha/JavaMailAPIExercise. 我 们 需 
javax.mail.jar 和 activation.jar 在 classpath 中 。 执 行 下 面 的 命令 从 命令 提示 符 编 译 
类 (两 个 jar 放置 在 /home/manisha/ 目录 下 ) 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.ja! 





现在 ， 这 个 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 


java -cp /home/manisha/activation. jar:/home/manisha/javax.mail. jar 


| = ER 
验证 输出 


你 应 该 看 到 下 面 的 消息 命令 控制 台 








messages. length---1 

Email Number 1 

Subject: Testing 

From: ABC <abc@gmail.com> 

Do you want to delete this message [y/n] ? y 
Marked DELETE for message: Testing 


JavaMail Gmail SMTPfk 425 - JavaMail 


在 所 有 前 面 的 章节 中 ， 我 们 使 用 JangoSMPT 服 务 器 来 发 送 电 子 邮 件 。 在 本 章 中 ， 
我 们 将 了 解 通过 Gmail 时 提供 的 SMTP 伺 服 器 。 Gmail 的 (Œ) 提供 了 使 用 他 们 的 
公共 SMTP 服 务 器 的 免费 。 


Gmail SMTP 服 务 器 的 详细 信息 可 以 在 这 里 找到 。 正 如 你 可 以 在 细节 里 看 到 的 一 
样 ， 我 们 可 以 使 用 TLS 或 SSL 连 接 ， 以 通过 Gmail SMTP 服 务 器 发 送 邮 件 。 


使 用 Gmail SMTP 服 务 器 发 送 邮 件 的 过 程 类 似 的 发 送 电子 邮件 的 章节 中 描述 说 明 ， 
除了 我 们 改变 主机 服务 器 。 作 为 先决 条 件 ， 发 件 人 的 电子 邮件 地 址 应 该 是 一 个 活路 
的 Gmail 帐户 。 让 我 们 党 试 一 个 例子 。 


创建 Java 类 
创建 一 个 Java 类 文件 SendEmailUsingGMailSMTP， 内 容 都 是 如 下 : 


package com.yiibai; 
import java.util.Properties; 


import javax.mail.Message; 

import javax.mail.MessagingException; 
import javax.mail.PasswordAuthentication; 
import javax.mail.Session; 

import javax.mail.Transport; 

import javax.mail.internet.InternetAddress; 
import javax.mail.internet .MimeMessage; 


public class SendEmailUsingGMailSMTP { 
public static void main(String[] args) { 
// Recipient's email ID needs to be mentioned. 
String to = "xyz@gmail.com";//change accordingly 


// Sender's email ID needs to be mentioned 


String from = "abc@gmail.com";//change accordingly 
final String username = "abc";//change accordingly 
final String password = "*****"://change accordingly 


// Assuming you are sending email through relay.jangosmtp.net 
String host - "smtp.gmail.com"; 


Properties props - new Properties(); 
props.put("mail.smtp.auth", "true"); 
props.put("mail.smtp.starttls.enable", "true"); 
props.put("mail.smtp.host", host); 
props.put("mail.smtp.port", "587"); 


// Get the Session object. 
Session session = Session.getInstance(props, 
new javax.mail.Authenticator() { 
protected PasswordAuthentication getPasswordAuthenticatior 
return new PasswordAuthentication(username, password); 
} 
3); 


try { 
// Create a default MimeMessage object. 


Message message = new MimeMessage(session); 


// Set From: header field of the header. 
message.setFrom(new InternetAddress(from)); 


// Set To: header field of the header. 
message.setRecipients(Message.RecipientType.TO, 
InternetAddress.parse(to)); 


// Set Subject: header field 
message.setSubject("Testing Subject"); 


// Now set the actual message 
message.setText("Hello, this is sample for to check send ' 
+ "email using JavaMailAPI "); 


// Send message 
Transport.send(message) ; 


System.out.println("Sent message successfully...."); 


) catch (MessagingException e) { 
throw new RuntimeException(e); 





主机 设置 为 smtp.gmail.com， 端 口 设 置 为 587。 在 这 里 ， 我 们 已 经 启用 TLS 连 接 。 


编译 并 运行 


现在 ， 我 们 的 类 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
SendEmailUsingGMailSMTP.java 到 目录 : /home/manisha/JavaMailAPIExercise. 我 
们 需要 javax.mail.jar 和 activation.jar 文件 在 classpath 中 。 执 行 下 面 的 命 舍 从 命令 
提示 符 编译 类 (jar 文 件 放 置 在 /home/manisha/ 目 录 下 ) 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.jat 


‘ __ Ẹ 








java -cp /home/manisha/activation. jar:/home/manisha/javax.mail. jar 


‘ = 








验证 输出 
你 应 该 可 以 看 到 下 面 的 消 使 控制 台 上 : 


Sent message successfully.... 


JavaMail 邮件 文件 夹 管 理 - JavaMail 


到 目前 为 止 ， 我们 已 经 在 前 面 的 章节 主要 介绍 收 件 箱 文件 夹 的 工作 。 这 是 大 多 数 邮 
件 位 于 其 中 的 默认 文件 来 。 有 些 系统 可 能 会 调用 它 的 收 件 箱 和 其 他 一 些 可 能 被 其 他 
一 些 名 字 来 称呼 它 。 但 是 ， 你 总 是 可 以 从 JavaMail API 为 使 用 该 名 称 的 收 件 箱 访 问 


€. 


JavaMail API 为 代表 文件 夹 的 文件 夹 抽象 类 的 实例 : 


public abstract class Folder extends Object 


这 个 类 声明 请 求 命名 文件 夹 从 服务 器 ， 从 文件 夹 中 删除 邮件 ， 搜 索 文件 夹 中 特定 消 
息 ， 列 出 文件 夹 中 的 邮件 ， 等 等 方法 。 


打开 文件 夹 


我 们 不 能 直接 创建 一 个 文件 夹 中 Folder 类 唯一 的 构造 玉 数 是 受 保 扩 的 。 我 们 可 以 得 
到 一 个 文件 夹 从 : 


e Session 

e Store 

e 另外 的 Folder 
上 述 所 有 的 类 都 有 一 个 类 似 的 getFolder() 方 法 类 似 签名 : 

public abstract Folder getFolder(String name) throws MessagingExce| 
Bn ——————————————— ——Í( 
一 些 在 其 中 获取 Folder 对 象 帮助 的 方法 有 : 





方法 


boolean 
exists() 


abstract void 
open(int 
mode) 


abstract 
boolean 
isOpen() 


abstract void 
close(boolean 
expunge) 


描述 


Checks if the folder really exists. Use this method before 
getting the Folder object. 


When you get a Folder, its closed. Use this method to open 
it. mode can be Folder. READ ONLY or 
Folder.READ WRITE. 


This method returns true if the folder is open, false if it's 
closed 


Closes the folder. If the expunge argument is true, any 
deleted messages in the folder are deleted from the actual 
file on the server. Otherwise, they're simply marked 
asdeleted, but the messages can still be undeleted. 


基本 文件 夹 信息 


以 下 是 一 些 它 返 回 有 关 一 个 文件 夹 的 基本 信息 ， 文 件 夹 类 中 的 方法 : 


A 


abstract String 
getName() 


abstract String 
getFullName() 


URLName 
getURLName() 


abstract Folder 
getParent() 


abstract int 
getType() 


int getMode() 


Store 
getStore() 


abstract char 
getSeparator() 


Returns the name of the folder, such as "TutorialsPoint Mail" 


Returns the complete hierarchical name from the root such 
as "books/Manisha/TutorialsPoint Mail". 


Return a URLName representing this folder. 


Returns the name of the folder that contains this folder i.e 
the parent folder. E.g "Manisha" from the previous 
"TutorialsPoint Mail" example. 


Returns an int indicating whether the folder can contain 
messages and/or other folders. 


It returns one of the two named constants 
Folder. READ ONLY or Folder. READ WRITE or -1 when 
the mode is unknown. 


Returns the Store object from which this folder was 
retrieved. 


Return the delimiter character that separates this Folder's 
pathname from the names of immediate subfolders. 


管理 文件 夹 


以 下 是 一 些 有 助 于 管理 文件 夹 的 方法 : 
方法 描述 


This creates a new folder in this folder’s Store. Where 
abstract boolean type would be:Folder HOLDS MESSAGES or 
create(int type) Folder.HOLDS FOLDERS. Returns true if folder is 

successfully created else returns false. 


abstract boolean This deletes the folder only if the folder is closed. 
delete(boolean Otherwise, it throws an //legalStateException. If recurse 
recurse) istrue, then subfolders are deleted. 


abstract boolean This changes the name of this folder. A folder must be 
renameTo(Folder closed to be renamed. Otherwise, an 
f) IllegalStateException is thrown. 


在 文件 夹 管 理 邮 件 


以 下 是 一 些 帮助 文件 夹 管 理 邮 件 的 方法 : 


方法 描述 
abstract ar 
As the name implies, the messages in the 
voldappendMessages(Messagel array are placed at the end of this folder. 
messages) 
void copyMessages(Message[] This copies messages from this folder into 
messages, Folder destination) a specified folder given as an argument. 


To delete a message from a folder, set its 
Flags.Flag.DELETED flag to true. To 
physically remove deleted messages from 
a folder, you have to call this method. 


abstract Message[] expunge() 


列 出 文件 夹 的 内 容 
有 四 种 方法 可 以 列 出 一 个 文件 天 中 包含 的 文件 夹 : 


方法 描述 


Folder[] list() This returns an array listing the folders that this folder 


contains. 
Folder[] This returns an array listing all the subscribed folders 
listSubscribed() that this folder contains. 


This is similar to the /ist() method except that it allows 
you to specify a pattern. The pattern is a string giving 
the name of the folders that match. 


abstract Folder]] 
list(String pattern) 


Folder[] This is similar to the /istSubscribed() method except 
listSubscribed(String | that it allows you to specify a pattern. The pattern is a 
pattern) string giving the name of the folders that match. 
检查 邮件 
方法 描述 


This method can be invoked on an open or 
closed folder. However, in the case of a closed 


abstract int folder, this method may (or may not) return -1 to 


Geliessage Count) indicate that the exact number of messages 
isn’t easily available. 

abstract boolean This returns true if new messages have been 

hasNewMessages() added to the folder since it was last opened. 

int It returns the new message count by checking 

getNewMessageCount() messages in the folder whose RECENT flag is 


set. 


This can be invoked on either an open or a 
int closed folder. However, in the case of a closed 
getUnreadMessageCount() folder, it may return -1 to indicate that the real 
answer would be too expensive to obtain. 


获取 信息 的 文件 夹 


Folder 类 提供 了 四 种 方法 ， 用 于 检索 从 打开 文件 夹 的 邮件 : 


方法 


abstract Message 
getMessage(int 
messageNumber) 


Messagel] 
getMessages() 


Messagel] 
getMessages(int 
start, int end) 


Messagel] 
getMessagest(int[] 
messageNumbers) 


void 
fetch(Messagel] 


messages, 
FetchProfile fp) 


搜索 文件 夹 


描述 


This returns the nth message in the folder. The first 
message in the folder is number 1. 


This returns an array of Message objects representing 
all the messages in this folder. 


This returns an array of Message objects from the 
folder, beginning with start and finishing with end, 
inclusive. 


This returns an array containing only those messages 
specifically identified by number in the 
 messageNumbers array. 


Prefetch the items specified in the FetchProfile for the 
given Messages. The FetchProfile argument specifies 
which headers in the messages to prefetch. 


如 果 服 务 器 支持 搜索 《许多 IMAP 服 务 器 做 最 POP 服务 器 没有 ) ， 很 容易 搜索 的 文 


方法 


Messagel] 
search(SearchTerm 
term) 


Messagel] 
search(SearchTerm 
term, Messagel] 
messages) 


Flags 


件 夹 ， 以 满足 某 些 条 件 的 邮件 。 标 准 编码 在 搜索 关键 词 的 对 象 。 以 下 是 两 种 搜索 方 


fh 


Search this Folder for messages matching the specified 
search criterion. Returns an array containing the 
matching messages. Returns an empty array if no 
matches were found. 


Search the given array of messages for those that 
match the specified search criterion. Returns an array 
containing the matching messages. Returns an empty 
array if no matches were found. The the specified 
Message objects must belong to this folder. 


当 你 需要 改变 标志 的 文件 夹 对 整个 消息 集 标志 的 修改 是 很 有 用 的 。 以 下 是 在 文件 夹 


类 提供 的 方法 : 


方法 


void setFlags(Messagel] 
messages, Flags flag, 
boolean value) 


void setFlags(int start, int 
end, Flags flag, boolean 
value) 


void setFlags(int[] 
messageNumbers, Flags 
flag, boolean value) 


abstract Flags 
getPermanentFlags() 


描述 


Sets the specified flags on the messages 
specified in the array. 


Sets the specified flags on the messages 
numbered from start through end, both start 
and end inclusive. 


Sets the specified flags on the messages 
whose message numbers are in the array. 


Returns the flags that this folder supports for 
all messages. 


JavaMail 限额 管理 - JavaMail 
JavaMail 配 领 是 限定 或 固定 的 号 码 或 邮件 的 数量 在 电子 邮件 存储 。JavaMail APEX 
每 个 邮件 服务 请 求 调用 计数 配额 。 电 子 邮 件 服务 可 以 适用 下 列 配额 标准 : 
。 外 发 邮件 (包括 附件 ) 的 最 大 大 小 。 
。 邮件 信息 ， 包 括 附 件 的 最 大 大 小 。 
。 消息 的 最 大 大 小 时 ， 管 理 员 是 一 个 收 件 人 
对 于 配额 管理 的 JavaMail 有 以 下 类 别 : 


Class 


public class 
Quota 


public static class 
Quota.Resource 


public interface 
QuotaAwareStore 


Fah 


This class represents a set of quotas for a given quota 
root. Each quota root has a set of resources, represented 
by the Quota.Resource class. Each resource has a name 
(for example, "STORAGE"), a current usage, and a 
usage limit. This has only one method 
setResourceLimit(String name, long limit). 


Represents an individual resource in a quota root. 


An interface implemented by Stores that support quotas. 
The getQuota and setQuota methods support the quota 
model defined by the IMAP QUOTA 
extension.GmailSSLStore, GmailStore, IMAPSSLStore, 
IMAPStore are the known implementing classes of this 
interface. 


让 我 们 来 看 看 和 例子 在 下 面 的 章节 会 检查 邮件 存储 名 称 ， 并 限制 其 使 用 。 


创建 Java 类 


创建 一 个 Java 类 文件 QuotaExample， 是 其 内 容 如 下 : 


package com.yiibai; 


import java.util.Properties; 


import 
import 
import 


import 


public 


( 


javax.mail.Quota; 
javax.mail.Session; 
javax.mail.Store; 
com.sun.mail.imap.IMAPStore; 


class QuotaExample 


public static void main(String[] args) 


{ 


try 


i 


Properties properties = new Properties(); 
properties.put("mail.store.protocol", "imaps"); 
properties.put("mail.imaps.port", "993"); 
properties.put("mail.imaps.starttls.enable", "true"); 
Session emailSession = Session.getDefaultInstance(propert: 
// emailSession.setDebug(true); 


// create the IMAP3 store object and connect with the pop 
Store store = emailSession.getStore("imaps"); 


//change the user and password accordingly 
store.connect("imap.gmail.com", "abc@gmail.com", "*****") 
IMAPStore imapStore - (IMAPStore) store; 
System.out.println("imapStore ---" + imapStore); 


//get quota 
Quota[] quotas = imapStore.getQuota("INBOX"); 
//Iterate through the Quotas 
for (Quota quota : quotas) ( 
System.out.println(String.format("quotaRoot: '%s'", 
quota.quotaRoot)); 
//Iterate through the Quota Resource 
for (Quota.Resource resource : quota.resources) ( 
System.out.println(String.format( 
"name: '%s', limit:'%s', usage:'9*s'", resource.nar 
resource.limit, resource.usage) ); 


} 


) catch (Exception e) 


( 


e.printStackTrace(); 











这 里 是 连接 通过 IMAP (imap.gmail.com) 服务 器 的 Gmail 服务 ， 为 IMAPStore 实 现 
QuotaAwareStore。 一 旦 你 获得 了 存储 对 象 ， 获 取 配 额 阵 列 和 通 历 并 打印 相关 信 


编译 并 运行 
现在 ， 我 们 的 类 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
QuotaExample.java 到 目 录 /homelmanisha/JavaMaiAPIExerciso 我 们 需要 


javax.mail.jar 和 activation.jar 在 classpath 中 。 执 行 下 面 的 命 倒 从 命 合 提 示 符 编译 类 
(两 个 jar 被 放置 在 /home/manisha/ 目录 下 ) : 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.ja! 
Me 
现在 ， 这 个 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 





java -cp /home/manisha/activation. jar:/home/manisha/javax.mail. jar 


E O OB 





验证 输出 
您 应 该 看 到 类 似 的 消息 在 命令 控制 侣 上 : 


imapStore ---imaps://abc%40gmail.com@imap. gmail.com 
quotaRoot:'' 
name: 'STORAGE', limit: '15728640', usage: '513' 


JavaMail 退回 邮件 - JavaMail 


消息 可 以 被 退回 的 几 个 原因 。 这 个 ee 只 有 服务 器 可 确定 特 
定 的 邮箱 或 用 户 名 的 不 存在 。 当 服务 器 检测 到 错误 ， 它 会 返回 一 个 消息 ， 指 出 失败 
的 原 邮 件 的 发 件 人 的 原因 。 


有 才 盖 发 送 状 态 通知 许多 互联 网 标准 ， 但 大 量 的 服务 器 不 使 用 特殊 技术 来 返还 这 些 
失败 消息 支持 这 些 新 的 标准 代替 。 因 此 ， 它 变 得 非常 难以 关联 与 导致 问题 的 原始 邮 
件 的 退回 邮件 。 


JavaMail 包括 用 于 解析 传递 状态 通知 的 支持 。 有 许多 技术 和 试探 法 来 处理 这 个 问 

题 。 其 中 一 个 是 可 变 的 信封 返回 路 径 的 技术 。 2 12 如 
下 面 的 例子 这 是 在 弹跳 邮件 馈 发 送 到 的 地 址 。f 您 可 能 需要 将 其 设置 为 一 个 通用 的 
地 址 ， 而 不 同 : : 头 ， 这 样 你 就 可 以 处 理 远 程 退回 。 这 可 以 通过 i r Email. smtp.from 
属性 在 JavaMail 中 。 


创建 Java 类 
创建 一 个 Java 类 文件 SendEmail， 是 其 内 容 如 下 : 


import java.util.Properties; 


import javax.mail.Message; 

import javax.mail.PasswordAuthentication; 
import javax.mail.Session; 

import javax.mail.Transport; 

import javax.mail.internet.InternetAddress; 
import javax.mail.internet .MimeMessage; 


public class SendEmail { 
public static void main(String[] args) throws Exception { 
String smtpServer = "smtp.gmail.com"; 
int port = 587; 
final String userid = "youraddress";//change accordingly 
final String password = "*****"^///change accordingly 
String contentType = "text/html"; 
String subject = "test: bounce an email to a different addre: 
"from the sender"; 
String from - "youraddressQgmail.com"; 
String to - "bouncerQfauxmail.com";//some invalid address 
String bounceAddr - "toaddressQgmail.com";//change according. 
String body - "Test: get message to bounce to a separate ema: 


Properties props - new Properties(); 


props.put("mail.smtp.auth", "true"); 
props.put("mail.smtp.starttls.enable", "true"); 


props.put("mail.smtp.host", smtpServer); 
props.put("mail.smtp.port", "587"); 
props.put("mail.transport.protocol", "smtp"); 
props.put("mail.smtp.from", bounceAddr); 


Session mailSession - Session.getInstance(props, 
new javax.mail.Authenticator() { 
protected PasswordAuthentication getPasswordAuthentica! 
return new PasswordAuthentication(userid, password), 
} 


3: 


MimeMessage message - new MimeMessage(mailSession); 
message.addFrom(InternetAddress.parse(from)); 
message.setRecipients(Message.RecipientType.TO, to); 
message.setSubject(subject); 
message.setContent(body, contentType); 


Transport transport - mailSession.getTransport(); 

try { 
System.out.println("Sending ...."); 
transport.connect(smtpServer, port, userid, password); 
transport.sendMessage(message, 

message.getRecipients(Message.RecipientType.TO)); 

System.out.println("Sending done ..."); 

} catch (Exception e) { 
System.err.println("Error Sending: "); 
e.printStackTrace(); 


j 


transport.close(); 
)// end function main() 





在 这 里 ， 我 们 可 以 看 到 ， 该 属性 mail.smtp.from 设 距离 来 源 地 址 不 同 。 


编译 并 运行 
现在 ， 我 们 的 类 是 准备 好 了 ， 让 我 们 编译 上 面 的 类 。 我 已 经 保存 了 类 
SendEmailjava 到 目录 : /home/manisha/JavaMailAPIExercise. 我 们 需 


javax.mail.jar 和 activation.jar 在 classpath 中 。 执 行 下 面 的 命 舍 从 命令 提示 符 编 译 
类 (两 个 jar 文 件 被 放置 在 /home/manisha/ 目 录 下 ) 


javac -cp /home/manisha/activation.jar:/home/manisha/javax.mail.ja! 


«| — — 


现在 ， 这 个 类 被 编译 ， 执 行 下 面 的 命令 来 运行 : 








java -cp /home/manisha/activation.jar:/home/manisha/javax.mail. jar 


«| —] 








验证 输出 


Sending 
Sending done ... 


JavaMail SMTP&k 4-23 - JavaMail 


SMTP 是 一 个 缩写 为 简单 邮件 传输 协议 。 它 是 跨越 互联 网 协议 (IP) 网 络 电子 邮件 
(电子 邮件 ) 传输 的 Internet 标 准 。 SMTP 使 用 TCP 端 口 25。 受 SSL 保 折 的 SMTP 连 
接 通过 缩写 SMTPS 称 ， 虽 然 SMTPS 不 是 一 个 协议 在 自己 的 权利 。 


JavaMail API 有 包 com.sun.mail.smtp 它 作 为 SMTP 协 议 提 供 访 问 SMTP 服 务 器 。 
下 表 列 出 了 包含 在 这 个 包 中 的 类 : 


This class is a specialization of the MimeMessage 

SMTPMessage class that allows you to specify various SMTP options 
and parameters that will be used when this message is 
sent over SMTP. 


This class implements the Transport abstract class 
SMTPSSLTransport using SMTP over SSL for message submission and 


transport. 
This class implements the Transport abstract class 
SMTP Transport using SMTP for message submission and transport. 
下 表 列 出 抛 出 的 异常 : 
异常 描述 
SMTPAddressFailedException This exception is thrown when the 


message cannot be sent. 


This exception is chained off a 

SMTPAddressSucceededException nl al sels E AS 
mail.smtp.reportsuccess property is 
true. 


SMTPSenderFailedException This exception is thrown when the 
message cannot be sent. 


This exception is thrown when the 
message cannot be sent. The exception 
Sree eer ence includes the sender's address, which 
the mail server rejected. 


com.sun.mail.smtp 提 供 使 用 SMTP 身 份 验证 选择 性 。 使 用 SMTP 验 证 ， 您 需要 设置 
mail.smtp.auth 属 性 或 提供 SMTP 传 输 与 连接 到 SMTP 服 务 器 的 用 户 名 和 密码 。 您 可 
以 使 用 以 下 方法 之 一 进行 : 


Transport.send(message); 


e 创建 您 的 邮件 会 话 时 提供 一 个 Authenticator 对 象 ， 并 提供 身份 验证 器 回调 过 程 
中 的 用 户 名 和 密码 信息 。mail.smtp.user 属 性 可 以 设置 ， 以 提供 一 个 默认 的 用 
户 名 回调 ， 但 密码 仍然 需要 显 式 提供 。 这 种 方法 允许 您 使 用 静态 传输 send 方 法 


来 发 送 消 息 。 例 如 : 


e 调用 传输 用 户 名 和 密码 参数 显 式 连接 方法 。 例 如 : 


Transport tr = session.getTransport("smtp"); 
tr.connect(smtphost, username, password); 


msg.saveChanges(); 


tr.sendMessage(msg, msg.getAllRecipients()); 


tr.close(); 


SMTP 协 议 提供 程序 支持 以 下 属性 ， 这 些 属性 可 以 在 JavaMail 会 话 对 象 进行 设置 。 


该 属性 始终 设置 为 字符 串 。 例 如 : 


props.put("mail.smtp.port", 


"587" ) 7 


在 这 里 ， 类 型 列 描述 字符 串 是 如 何 解 释 的 。 


名 称 
mail.smtp.user 


mail.smtp.host 


mail.smtp.port 


mail.smtp.connectiontimeout 


mail.smtp.timeout 


mail.smtp.from 


mail.smtp.localhost 


String 
String 


int 


int 


int 


String 


String 


fi 


Default user name for 
The SMTP server to c 


The SMTP server por 
connect() method doe 
one. Defaults to 25. 


Socket connection tirr 
milliseconds. Default i 


Socket I/O timeout va 
Default is infinite time: 


Email address to use 
command. This sets t 
address. Defaults to n 
InternetAddress.getl c 


Local host name usec 
EHLO command. Def. 
InetAddress.getLocall 
Should not normally n 
JDK and your name s 


mail.smtp.localaddress 


mail.smtp.localport 


mail.smtp.ehlo 


mail.smtp.auth 


mail.smtp.auth.mechanisms 


mail.smtp.auth.login.disable 


mail.smtp.auth.plain.disable 


mail.smtp.auth.digest- 
md5.disable 


mail.smtp.auth.ntlm.disable 


mail.smtp.auth.ntlm.domain 


mail.smtp.auth.ntlm.flags 


mail.smtp.submitter 


mail.smtp.dsn.notify 


mail.smtp.dsn.ret 


String 


int 


boolean 


boolean 


String 


boolean 


boolean 


boolean 


boolean 


String 


int 


String 


String 


String 


properly. 


Local address (host n 
creating the SMTP so 
address picked by the 
not normally need to I 


Local port number to | 
the SMTP socket. Del 
number picked by the 


If false, do not attemp 
EHLO command. Def. 


If true, attempt to aut 
the AUTH command. 


If set, lists the authen! 
consider. Only mecha 
server and supported 
implementation will be 
"LOGIN PLAIN DIGES 
includes all the auther 
supported by the curr 


If true, prevents use o 
command. Default is 1 


If true, prevents use 0 
command. Default is 1 


If true, prevents use o 
MD5 command. Defai 


If true, prevents use o 
command. Default is 1 


The NTLM authentica 
NTLM protocol-specif 


The submitter to use i 
MAIL FROM comman 
mail relay to pass alor 
original submitter of tr 


The NOTIFY option tc 
Either NEVER, or son 
SUCCESS, FAILURE 
(separated by comma 


The RET option to the 
FULL or HDRS. 


mail.smtp.sendpartial 


mail.smtp.sasl.enable 


mail.smtp.sasl.mechanisms 


mail.smtp.sasl.authorizationid 


mail.smtp.sasl.realm 


mail.smtp.quitwait 


mail.smtp.reportsuccess 


mail.smtp.socketFactory 


mail.smtp.socketFactory.class 


mail.smtp.socketFactory.fallback 


mail.smtp.socketFactory.port 


mail.smtp.ssl.enable 


boolean 


boolean 


String 


String 


String 


boolean 


boolean 


SocketFactory 


String 


boolean 


int 


boolean 


If set to true, and a m 
and some invalid addi 
message anyway, rep 
with a SendFailedExc 
(the default), the mes: 
of the recipients if the. 
address. 


If set to true, attempt | 
javax.security.sasl pat 
authentication mecha 
to false. 


A space or comma se 
mechanism names to 


The authorization ID t 
authentication. If not s 
ID (user name) is use 


The realm to use with 
authentication. 


If set to false, the QUI 
the connection is imm 
true (the default), cau: 
for the response to th: 


If set to true, causes t 
an SMTPAddressSuc 
each address that is s 


If set to a class that in 
javax.net.SocketFactc 
will be used to create 


If set, specifies the na 
implements the javax. 
interface. This class v 
SMTP sockets. 


If set to true, failure to 
the specified socket f: 
the socket to be creat 
java.net.Socket class. 


Specifies the port to c 
the specified socket f: 
default port will be ust 


If set to true, use SSL 
SSL port by default. E 


mail.smtp.ssl.enable 


mail.smtp.ssl.checkserveridentity 


mail.smtp.ssl.trust 


mail.smtp.ssl.socketFactory 


mail.smtp.ssl.socketFactory.class 


mail.smtp.ssl.socketFactory.port 


mail.smtp.ssl.protocols 


mail.smtp.starttls.enable 


mail.smtp.starttls.required 


mail.smtp.socks.host 


boolean 


boolean 


String 


SSLSocketFactory 


String 


int 


string 


boolean 


boolean 


string 


"smtp" protocol and tr 
protocol. 


If set to true, checks t 
specified by RFC 259 


If set, and a socket fa 
specified, enables use 
MailSSLSocketFactor 
are trusted. If set to a 
list of hosts, those ho: 
Otherwise, trust depe 
the server presents. 


If set to a class that e: 
javax.net.ssl.SSLSocl 
class will be used to c 
sockets. 


If set, specifies the na 
extends the javax.net. 
class. This class will k 
SSL sockets. 


Specifies the port to c 
the specified socket f: 
default port will be ust 


Specifies the SSL pro 
enabled for SSL conn 
value is a whitespace 
acceptable to the 
javax.net.ssl.SSL Socl 
method. 


If true, enables the us 
command (if supporte 
switch the connection 
connection before issi 
commands. Defaults 1 


If true, requires the us 
command. If the serve 
STARTTLS command 
the connect method w 


Specifies the host nar 
server that will be use 
mail server. 


Specifies the port nun 


mail.smtp.socks.port string used if the proxy serv: 
standard port number 


Extension string to ap 


mail.smtp.mailextension String 
command. 
If set to true, use the | 
instead of the NOOP | 
mail.smtp.userset boolean isConnected method. 


sendmail will respond 
NOOP commands; us 
sendmail issue. Defat 


一 般 情况 下 ， 应 用 程序 应 该 不 需要 直接 使 用 的 类 在 这 个 包 。 相 反 ， 他 们 应 该 使 用 
javax.mail 的 包 定 义 的 APl (FIFE) 。 例 如 说 ， 应 用 程序 不 应 该 直接 构造 
SMTPTransport 的 实例 。 相 反 ， 他 们 应 该 使 用 Session 方 法 getTransport 获 得 一 个 合 
适 的 Transport 对 象 。 


示例 使 用 的 SMTP 服 务 器 是 体现 在 发 送 邮 件 。 


JavaMail IMAP fk 425 - JavaMail 


IMAP 是 缩写 为 Internet 邮 件 访问 协议 。 这 是 一 个 应 用 层 互联 网 协议 ， 它 允许 电子 邮 


件 客户 端 来 访问 邮件 的 远程 服务 器 上 的 邮件 。 


口 143。 


IMAP 服 务 器 通常 监听 众所周知 的 端 


IMAP 通 过 SSL (IMAPS) 被 分 配 为 端口 号 993。 


IMAP 支 持 两 种 操作 在 线 和 离线 模式 。 使 用 IMAP 电 子 邮 件 客户 端 一 般 在 服务 器 上 保 


留 邮件 ， 直 到 用 户 显 式 删 除 它 们 。 


包装 com.sun.mail.imap 是 IMAP 协 议 提 供 JavaMail API， 它 提供 了 访问 一 个 IMAP 邮 
件 存储 。 下 表 列 出 了 此 提供 程序 的 接口 和 类 : 


类 /接口 


IMAPFolder.ProtocolCommand 


ACL 


IMAPFolder 
IMAPFolder.FetchProfileltem 


IMAPMessage 


IMAPMessage.FetchProfileCondition 


IMAPSSLStore 


IMAPStore 


Rights 


Rights.Right 


SortTerm 


有 几 点 要 注意 此 提供 以 上 : 


描述 


This a simple interface for user- 
defined IMAP protocol commands. 


This is a class. An access control list 
entry for a particular authentication 
identifier (user or group). 


This class implements an IMAP folder. 
This a class for fetching headers. 


This class implements an 
ReadableMime object. 


This class implements the test to be 
done on each message in the folder. 


This class provides access to an 
IMAP message store over SSL. 


This class provides access to an 
IMAP message store. 


This class represents the set of rights 
for an authentication identifier (for 
instance, a user or a group). 


This inner class represents an 
individual right. 


A particular sort criteria, as defined by 
RFC 5256. 


e 提供 同时 支持 IMAP4 和 的 IMAP4rev1 协 议 。 


e. 关连 IMAPStore 维 扩 IMAP 协 议 的 对 象 池 在 与 IMAP 服 务 器 进行 通信 的 使 用 。 为 
文件 夹 被 打开 ， 需 要 有 新 的 IMAP 协 议 的 对 象 ， 如 果 没 有 可 用 ，IMAPStore 将 为 
他 们 提供 从 连接 池 中 ， 或 者 创建 他 们 。 当 一 个 文件 夹 被 关闭 ， 其 IMAP 协 议 的 
对 象 被 返回 到 连接 池 ， 如 果 池 有 创建 过 的 对 象 。 


e 该 连接 IMAPStore 对 象 可 能 会 或 可 能 不 会 维持 一 个 单独 的 IMAP 协 议 的 对 象 ， 它 
提供 了 存储 专用 连接 到 |IMAP 服 务 器 。 


IMAP 协 议 提供 程序 支持 以 下 属性 ， 这 些 属性 可 以 在 JavaMail 会 话 对 象 进行 设置 。 该 


属性 始终 设置 为 字符 串 ;类 型 列 描述 字符 串 是 如 何 解释 的 。 


名 称 
mail.imap.user 


mail.imap.host 


mail.imap.port 


mail.imap.partialfetch 


mail.imap.fetchsize 


mail.imap.ignorebodystructuresize 


mail.imap.connectiontimeout 


mail.imap.timeout 


mail.imap.statuscachetimeout 


mail.imap.appendbuffersize 


mail.imap.connectionpoolsize 


mail.imap.connectionpooltimeout 


String 
String 


int 


boolean 


int 


boolean 


int 


int 


int 


int 


int 


int 


Default user name fi 
The IMAP server to 


The IMAP server po 
connect() method dc 
one. Defaults to 143 


Controls whether the 
capability should be 


Partial fetch size in | 


The IMAP BODYST 
includes the exact s 
Normally, this size is 
much data to fetch fi 
Defaults to false. 


Socket connection ti 
milliseconds. Defaul 


Socket I/O timeout v 
Default is infinite tim 


Timeout value in mil 
STATUS command | 
(1 second). Zero dis 


Maximum size of ar 
memory when appe 


Maximum number o 
the connection pool. 


Timeout value in mil 
pool connections. D: 
seconds). 


Flag to indicate whe 


mail.imap.separatestoreconnection 


mail.imap.auth.login.disable 


mail.imap.auth.plain.disable 


mail.imap.auth.ntlm.disable 


mail.imap.proxyauth.user 


mail.imap.localaddress 


mail.imap.localport 


mail.imap.sasl.enable 


mail.imap.sasl.mechanisms 


mail.imap.sasl.authorizationid 


mail.imap.sasl.realm 


mail.imap.auth.ntlm.domain 


mail.imap.auth.ntlm.flags 


mail.imap.socketFactory 


boolean 


boolean 


boolean 


boolean 


String 


String 


int 


boolean 


String 


String 


String 


String 


int 


SocketFactory 


store connection for 
is false. 


If true, prevents use 
AUTHENTICATE LC 
using the plain LOG 
false. 


If true, prevents use 
PLAIN command. D 


If true, prevents use 
NTLM command. De 


If the server support 
extension, this prope 
the user to act as. A 
using the administra 
authentication, the ll 
the PROXYAUTH cc 
name specified in th 


Local address (host 
creating the IMAP s: 
address picked by tl 


Local port number tc 
the IMAP socket. De 
picked by the Socke 


If set to true, attemp 
javax.security.sasl p 
authentication mech 
to false. 


A space or comma s 
mechanism names 1 


The authorization IC 
authentication. If nol 
ID (user name) is us 


The realm to use wi! 
mechanisms that ret 
DIGEST-MD5. 


The NTLM authentic 
NTLM protocol-spec 


If set to a class that 
javax.net.SocketFac 
will be used to creat 


mail.imap.socketFactory.class 


mail.imap.socketFactory.fallback 


mail.imap.socketFactory.port 


mail.imap.ssl.enable 


mail.imap.ssl.checkserveridentity 


mail.imap.ssl.trust 


mail.imap.ssl.socketFactory 


mail.imap.ssl.socketFactory.class 


mail.imap.ssl.socketFactory.port 


mail.imap.ssl.protocols 


String 


boolean 


int 


boolean 


boolean 


String 


SSLSocketFactory 


String 


int 


string 


If set, specifies the r 
implements the java 
interface. This class 
IMAP sockets. 


If set to true, failure 
the specified socket 
the socket to be cre; 
java.net.Socket clas 


Specifies the port to 
the specified socket 
used when not set. 


If set to true, use SE 
SSL port by default. 
"imap" protocol and 
protocol. 


If set to true, check ! 
specified by RFC 25 


If set, and a socket | 
specified, enables u 
MailSSLSocketFact 
are trusted. If set to 
list of hosts, those h 
trusted.Otherwise, ti 
certificate the server 


If set to a class that 
javax.net.ssl.SSL So 
class will be used to 
sockets. 


If set, specifies the r 
extends the javax.ne 
class. This class will 
SSL sockets. 


Specifies the port to 
the specified socket 
default port will be u 


Specifies the SSL pi 
enabled for SSL cor 
value is a whitespac 
acceptable to the 
javax.net.ssl.SSL So 
method. 


mail.imap.starttls.enable 


mail.imap.starttls.required 


mail.imap.socks.host 


mail.imap.socks.port 


mail.imap.minidletime 


mail.imap.enableimapevents 


mail.imap.folder.class 


boolean 


boolean 


string 


string 


int 


boolean 


String 


If true, enables the t 
command (if suppor 
switch the connectic 
connection before is 
commands. Default 


If true, requires the t 
command. If the ser 
STARTTLS commar 
the connect method 


Specifies the host n; 
server that will be us 
mail server. 


Specifies the port nt 
proxy server. This sl 
used if the proxy ser 
standard port numb: 


This property sets tr 
not set, the default i: 


Enable special IMAF 
delivered to the Stor 
true, unsolicited res| 
the Store's idle mett 
ConnectionEvents w 
IMAPStore.RESPOI 
message will be the 
string. By default, th 


Class name of a sut 
com.sun.mail.imap.| 
subclass can be use 
additional IMAP con 
must have public co 
public MyIMAPFolde 
separator, IMAPStor 
isNamespace) and [ 
MyIMAPFolder(Listl 


一 般 情况 下 ， 应 用 程序 应 该 不 需要 直接 使 用 的 类 在 这 个 包 。 相 反 ， 他 们 应 该 使 用 
javax.mail 包 定义 的 API (和 子 包 ) 。 应 用 程序 不 应 该 兴建 IMAPStore 或 IMAPFolder 


的 直接 实例 。 相 反 ， 他 们 应 该 使 用 Session 方 法 getStore 


获取 文件 夹 对 象 。 


示例 使 用 IMAP 服 务 器 是 体现 在 限额 管理 . 


适当 的 存储 对 象 ， 并 从 


JavaMail POP3k 425 - JavaMail 


邮局 协议 (POP) 是 使 用 本 地 电子 邮件 客户 端 可 以 检索 电子 邮件 从 远程 服务 器 通过 
TCP! IP 连 接 的 应 用 层 网 络 标准 协议 。 POP 支持 访问 远程 邮箱 简单 的 下 载 和 - 删除 
要 求 。 一 个 POP3 服 务 器 监听 熟知 端口 110。 


软件 包 com.sun.mail.pop3 是 POP3 协 议 提供 的 JavaMail API， 它 提供 了 访问 的 
POP3 邮 件 存储 。 下 表 列 出 了 类 此 包 中 : 


名 称 描述 
POP3Folder A POP3 Folder (can only be "INBOX"). 
POP3Message A POP3 Message. 

POP3SSLStore A POP3 Message Store using SSL. 
POP3Store A POP3 Message Store. 


有 几 点 要 注意 此 提供 以 上 : 


POP3 提 供 程序 只 支持 一 个 名 为 INBOX 一 个 文件 夹 。 由 于 POP3 协 议 的 限制 ， 
许多 像 事 件 通知 ， 文 件 夹 管理 ， 标 志 管 理 等 JavaMail 的 API 的 功能 是 不 允许 
的 。 


POP3 提 供 通过 的 JavaMail API 的 使 用 协议 名 称 POP3 或 以 下 形式 的 URL 访 问 
pop3://user:password@host:port/INBOX". 


POP3 支 持 没有 永久 的 标志 。 例 如 ，Flags.Flag.RECENT 标 志 将 永远 不 会 被 用 
于 POP3 邮 件 设置 。 它 是 由 应 用 程序 ， 以 确定 哪些 是 在 一 个 POP3 邮 箱 的 新 邮 
件 。 


POP3 不 支持 Folder.expunge() 方 法 。 删 除 并 抹 去 消息 ， 请 将 
Flags.Flag.DELETED 标 志 上 的 信息 ， 并 使 用 Folder.close (true) 方法 关闭 文 
f x. 


POP3 不 提供 接收 日 期 ， 所 以 getReceivedDate 方 法 将 返回 null。 


当 被 访问 的 POP3 邮 件 的 标题 ， 在 POP3 提 供 程序 使 用 top 命 令 来 获取 所 有 标 
题 ， 然 后 将 其 缓存 。 


当 访 问 一 个 POP3 邮 件 的 内 容 时 ，POP3 提 供 程序 使 用 RETR 命 令 来 获取 整个 消 
E 


NO 


POP3Message.invalidate 方 法 可 用 于 缓存 的 无 效 数 据 ， 但 不 关闭 文件 夹 。 


POP3 协 议 提供 程序 支持 以 下 属性 ， 这 些 属性 可 以 在 JavaMail 会 话 对 象 进行 设置 。 
该 属性 始终 设置 为 字符 串 ; 类 型 列 描述 字符 串 是 如 何 解释 的 。 


名 称 类 型 


mail.pop3.user 


mail.pop3.host 


mail.pop3.port 


mail.pop3.connectiontimeout 


mail.pop3.timeout 


mail.pop3.rsetbeforequit 


mail.pop3.message.class 


mail.pop3.localaddress 


mail.pop3.localport 


mail.pop3.apop.enable 


mail.pop3.socketFactory 


mail.pop3.socketFactory.class 


mail.pop3.socketFactory.fallback 


boolean 


String 


String 


boolean 


SocketFactory 


String 


boolean 


Default user name for 
The POP3 server to c 


The POP3 server por 
connect() method doe 
one. Defaults to 110. 


Socket connection tin 
milliseconds. Default 


Socket I/O timeout va 
Default is infinite time 


Send a POP3 RSET « 
the folder, before sen 
command. Default is 1 


Class name of a subc 
com.sun.mail.pop3.P\ 
subclass can be used 
non-standard Content 
subclass must have a 
the form MyPOP3Me: 
msgno) throws Messe 


Local address (host n 
creating the POP3 so 
address picked by the 


Local port number to 
the POP3 socket. Del 
picked by the Socket 


If set to true, use APC 
USER/PASS to login : 
the POP3 server supy 
sends a digest of the 
the clear text passwoi 


If set to a class that in 
javax.net.SocketFactc 
will be used to create 


If set, specifies the na 
implements the javax. 
interface. This class v 
POP3 sockets. 


If set to true, failure tc 
the specified socket f: 
the socket to be creat 


mail.pop3.socketFactory.port 


mail.pop3.ssl.enable 


mail.pop3.ssl.checkserveridentity 


mail.pop3.ssl.trust 


mail.pop3.ssl.socketFactory 


mail.pop3.ssl.socketFactory.class 


mail.pop3.ssl.socketFactory.port 


mail.pop3.ssl.protocols 


mail.pop3.starttls.enable 


mail.pop3.starttls.required 


boolean 


boolean 


String 


SSLSocketFactory 


String 


string 


boolean 


boolean 


java.net.Socket class. 


Specifies the port to c 
the specified socket f: 
default port will be us: 


If set to true, use SSL 
SSL port by default. L 
"pop3" protocol and tr 
protocol. 


If set to true, check th 
specified by RFC 259 


If set, and a socket fa 
specified, enables ust 
MailSSLSocketFactor 
are trusted. If set to a 
list of hosts, those ho: 
Otherwise, trust depe 
the server presents. 


If set to a class that e 
javax.net.ssl.SSL Socl 
class will be used to c 
sockets. 


If set, specifies the ne 
extends the javax.net 
class. This class will k 
SSL sockets. 


Specifies the port to c 
the specified socket f: 
default port will be us: 


Specifies the SSL pro 
enabled for SSL conn 
value is a whitespace 
acceptable to the 
javax.net.ssl.SSL Socl 
method. 


If true, enables the us 
command (if supporte 
switch the connection 
connection before iss 
commands. Defaults 1 


If true, requires the us 
command. If the servt 
STLS command, or tt 


mail.pop3.socks.host 


mail.pop3.socks.port 


mail.pop3.disabletop 


mail.pop3.forgettopheaders 


mail.pop3.filecache.enable 


mail.pop3.filecache.dir 


mail.pop3.cachewriteto 


mail.pop3.keepmessagecontent 


string 


string 


boolean 


boolean 


boolean 


String 


boolean 


boolean 


connect method will f: 


Specifies the host nar 
server that will be use 
mail server. 


Specifies the port nun 
proxy server. 


If set to true, the POP 
not be used to fetch n 
Defaults to false. 


If set to true, the heac 
been retrieved using 1 
command will be forg 
headers retrieved as | 
command. Defaults tc 


If set to true, the POP 
message data in a ter 
in memory. Messages 
cache when accessin 
Message headers are 
memory (on demand) 
removed when the fol 
JVM terminates. Defa 


If the file cache is ene 
be used to override th 
by the JDK for tempoi 


Controls the behavior 
on a POP3 message 

and the message con 
cached, and ignoreLis 
cached before being 
message is streamed 
stream without being 

false. 


If this property is set t 
to the cached content 
the memory from beir 
is closed or the cache 
invalidated (using the 
Defaults to false. 


一 般 情况 下 ， 应 用 程序 不 应 在 此 包 中 直接 使 用 的 类 。 相 反 ， 他 们 应 该 使 用 
javax.mail 的 包 定 义 的 API (MFE) 。 应 用 程序 不 应 该 构建 POP3Store 或 
POP3Folder 直 接 的 实例 。 相 反 ， 他 们 应 该 使 用 Session 方 法 getStore 获 得 适当 的 存 


储 对 象 ， 并 从 获取 文件 夹 对 象 。 
示例 使 用 的 POP3 服 务 器 是 体现 在 检查 电子 邮件 . 


JDBC 教 程 


JDBC API 是 一 个 Java API 可 以 访问 任何 类 型 的 表格 格式 数据 ， 存 储 在 一 个 关系 数 
据 库 尤其 是 数据 。 JDBC 的 工作 原理 与 Java 在 各 种 平台 一 样 ， 如 Windows，Mac 
OS 和 各 种 版 本 的 UNIX。 


读者 


jl OBERE 员 设计 的 ， 需 要 了 解 JDBC 框 架 的 细节 以 及 它 的 架构 和 实际 使 
用 情况 。 


必 备 条 件 
在 继续 本 教程 ， 应 该 对 Java 编 程 语言 的 一 个 很 好 的 理解 。 因 为 要 处 理 RDBMS， 所 
以 它 需 要 对 SQL 和 数据 库 的 概念 有 很 好 的 理解 。 


JDBC 代 表 Java 数 据 库 连接 ， 这 对 Java 编 程 语言 和 广泛 的 数据 库 之 间 独 立 于 数据 库 
的 连接 标准 的 Java API. 


JDBC 库 包含 的 API 为 每 个 通常 与 数据 库 的 使 用 相关 联 的 任务 : 
。 使 得 连接 到 数据 库 
e 创建 SQL 或 MySQL 语 句 
e 执行 SQL 或 MySQL 的 查询 数据 库 
e 查看 和 修改 结果 记录 


从 根本 上 说 ，JDBC 是 一 种 规范 ， 它 提供 的 接口 ， 一 套 完整 的 ， 人 允许 便携 式 访问 底 
层 数据 库 。 可 以 用 Java 来 写 不 同类 型 的 可 执行 文件 ， 如 : 


e Java 应 用 程序 

e Java Applets 

e Java Servlets 

e Java ServerPages (JSP) 

e Enterprise JavaBeans (EJBs) 


所 有 这 些 不 同 的 可 执行 文件 就 可 以 使 用 JDBC 了 驱动 程序 来 访问 数据 库 ， 并 把 存储 的 
数据 的 优势 。 


JDBC 提 供 了 相同 的 功能 ，ODBC， 人 允许 Java 程 序 包含 与 数据 库 无 关 的 代码 。 


先决 条 件 : 

以 前 正如 期 进行 本 教程 ， 需 要 具备 以 下 两 个 主题 内 容 很 好 的 了 解 : 
e 核心 Java 编 程 
e SQL 或 MySQL 数 据 库 


JDBC2& yj : 
JDBC APIx fr EZ A= 2 FBR! ut TE ER qu, IBTE—BRBJJDBCASSR 2E HA 
两 层 组 成 : 

e JDBC API: 提供 了 应 用 程序 对 JDBC 的 管理 连接 。 

e JDBC Driver API: 支持 JDBC 管 理 到 驱动 器 连接 。 


JDBC API 的 使 用 驱动 程序 管理 器 和 数据 库 特 定 的 驱动 程序 提供 透明 的 连接 到 异 构 
数据 库 。 


JDBC 了 驱动 程 序 管理 器 可 确保 正确 的 驱动 程序 来 访问 每 个 数据 源 。 该 驱动 程序 管理 
器 能 够 支持 连接 到 多 个 异 构 数据 库 的 多 个 并 发 的 驱动 程序 。 


以 下 是 结构 图 ， 它 显示 了 了 驱动 程序 管理 器 方面 的 JDBC 了 驱动 程序 和 Java 应 用 程序 的 
位 置 : 





常见 的 JDBC 组 件 : 


JDBC API 提 供 了 以 下 接口 和 类 : 


DriverManager: 这 个 类 管理 数据 库 驱 动 程序 的 列表 。 内 容 是 否 符合 从 Java 应 用 
程序 使 用 的 通信 子 协议 正确 的 数据 库 驱 动 程序 的 连接 请 求 。 识 别 JDBC 在 一 定 
子 协议 的 第 一 个 驱动 器 将 被 用 来 建立 数据 库 连 接 。 


Driver: 此 接口 处 理 和 与 数据 库 服务 器 通信 。 很 少 直 接 与 驱动 程序 对 象 。” 相 反 ， 使 
用 DriverManager 中 的 对 象 ， 它 管理 此 类 型 的 对 象 。 它 也 抽象 与 驱动 程序 对 象 
工作 相关 的 详细 信息 


Connection : 此 接口 与 接触 数据 库 的 所 有 方法 。 连 接 对 象 表示 通信 上 下 文 ， 
即 ， 与 数据 库 中 的 所 有 的 通信 是 通过 唯一 的 连接 对 象 。 


Statement : 可 以 使 用 这 个 接口 创建 的 对 象 的 SQL 语句 提交 到 数据 库 。 一 些 派 生 
的 接口 接受 除 执行 存储 过 程 的 参数 。 


ResultSet: 这 些 对 象 保 存 从 数据 库 后 ， 执 行使 用 Statement 对 象 的 SQL 查询 中 
检索 数据 。 它 作为 一 个 迭代 器 ， 让 您 可 以 通过 移动 它 的 数据 。 


SQLException: 这 个 类 义理 发 生 在 一 个 数据 库 应 用 程序 的 任何 错误 。 


JDBC 4.0 软 件 包 


对 JDBC4.0，java.sql 和 javax.sql 是 主要 的 包 。 这 是 最 新 版 本 的 JDBC 在 写 这 篇 教程 
的 时 候 。 它 提供 的 主要 类 与 数据 源 进 行 交 互 。 


在 这 些 包 中 的 新 功能 包括 改变 在 以 下 几 个 方面 : 


自动 数据 库 驱 动 程序 加 载 
异常 处 理 的 改进 
增强 的 BLOB/ CLOB 功 能 
连接 和 话 句 界面 增强 

国家 字符 集 支 持 

SQL ROWID 访 问 

SQL 2003 XML 数据 类 型 支持 
注释 


JDBC4 简 介 ，JDBC 是 什么 ? - JDBC 教 程 


JDBC 是 什么 ? 
JDBC 代 表 Java 数 据 库 连接 这 对 Java 编 程 语言 和 广泛 的 数据 库 之 间 独 立 于 数据 亩 
的 连接 标准 的 Java API. 
JDBC 库 包含 的 AP| 为 每 个 通常 与 数据 库 的 使 用 相关 联 的 任务 : 
。 使 得 连接 到 数据 库 
e 创建 SQL 或 MySQL 语 句 
e 执行 SQL 或 MySQL 的 查询 数据 库 
e 查看 和 修改 结果 记录 


从 根本 上 说 ，JDBC 是 一 种 规范 ， 它 提供 的 接口 ， 一 套 完整 的 ， 人 允许 便携 式 访问 底 
层 数据 库 。 可 以 用 Java 来 写 不 同类 型 的 可 执行 文件 ， 如 : 


e Java 应 用 程序 

e Java Applets 

e Java Servlets 

e Java ServerPages (JSP) 

e Enterprise JavaBeans (EJBs) 


所 有 这 些 不 同 的 可 执行 文件 就 可 以 使 用 JDBC 了 驱动 程序 来 访问 数据 库 ， 并 把 存储 的 
数据 的 优势 。 


JDBC 提 供 了 相同 的 功能 ，ODBC， 人 允许 Java 程 序 包含 与 数据 库 无 关 的 代码 。 
先决 条 件 : 
以 前 正如 期 进行 本 教程 ， 需 要 具备 以 下 两 个 主题 内 容 很 好 的 了 解 : 
e 核心 Java 编 程 
e SQL 或 MySQL 数 据 库 
JDBC28# : 


JDBC API 支 持 两 屋 和 三 层 义理 模型 进行 数据 库 访 问 ， 但 在 一 般 的 JDBC 体 系 结构 由 
两 层 组 成 : 


e JDBC API: 提供 了 应 用 程序 对 JDBC 的 管理 连接 。 
e JDBC Driver API: 支持 JDBC 管 理 到 驱动 器 连接 。 


JDBC API 的 使 用 驱动 程序 管理 器 和 数据 库 特定 的 驱动 程序 提供 透明 的 连接 到 异 构 
数据 库 。 


JDBC 了 驱动 程序 管理 器 可 确保 正确 的 驱动 程序 来 访问 每 个 数据 源 。 该 驱动 程序 管理 


器 能 


够 支持 连接 到 多 个 异 构 数据 库 的 多 个 并 发 的 驱动 程序 。 


以 下 是 结构 图 ， 它 显示 了 了 驱动 程序 管理 器 方面 的 JDBC 了 驱动 程序 和 Java 应 用 程序 的 
位 置 : 





前 





见 的 JDBC 组 件 : 


JDBC API 提 供 了 以 下 接口 和 类 : 


DriverManager: 这 个 类 管理 数据 库 驱 动 程序 的 列表 。 内 容 是 否 符合 从 Java 应 用 
程序 使 用 的 通信 子 协议 正确 的 数据 库 驱 动 程序 的 连接 请 求 。 识 别 JDBC 在 一 定 
子 协议 的 第 一 个 驱动 器 将 被 用 来 建立 数据 库 连 接 。 

Driver: 此 接口 处 理 与 数据 库 服务 器 通信 。 很 少 直 接 与 驱动 程序 对 象 。” 相 反 ， 使 


用 DriverManager 中 的 对 象 ， 它 管理 此 类 型 的 对 象 。 它 也 抽象 与 驱动 程序 对 象 
工作 相关 的 详细 信息 


Connection : 此 接口 与 接触 数据 库 的 所 有 方法 。 连 接 对 象 表示 通信 上 下 文 ， 

即 ， 与 数据 库 中 的 所 有 的 通信 是 通过 唯一 的 连接 对 象 。 

Statement : 可 以 使 用 这 个 接口 创建 的 对 象 的 SQL 语句 提交 到 数据 库 。 一 些 派 生 
的 接口 接受 除 执行 存储 过 程 的 参数 。 


ResultSet: 这 些 对 象 保 存 从 数据 库 后 ， 执 行使 用 Statement 对 象 的 SQL 查询 中 
检索 数据 。 它 作为 一 个 迭代 器 ， 让 您 可 以 通过 移动 它 的 数据 。 


e SQLException: 这 个 类 处 理发 生 在 一 个 数据 库 应 用 程序 的 任何 错误 。 


JDBC 4.0 软 件 包 


对 JDBC4.0，java.sql 和 javax.sql 是 主要 的 包 。 这 是 最 新 版 本 的 JDBC 在 写 这 篇 教程 
的 时 候 。 它 提供 的 主要 类 与 数据 源 进行 交互 。 


在 这 些 包 中 的 新 功能 包括 改变 在 以 下 几 个 方面 : 
e 自动 数据 库 驱 动 程序 加 载 
e 异常 处 理 的 改进 
e 增强 的 BLOB/ CLOB 功 能 
e. 连接 和 语句 界面 增强 
。 国家 字符 集 支持 
SQL ROWID 访 问 
e SQL 2003 XML 数据 类 型 支持 
。 注释 


JDBC SQL 话 法 - JDBC 教 程 


结构 化 查询 语言 (SQL) 是 一 种 标准 化 的 语言 ， 它 允许 你 在 数据 库 上 执行 操作 ， 如 
创建 项 目 ， 读 取 内 容 ， 内 容 更 新 和 删除 条 目 。 


SQL 是 所 有 可 能 会 使 用 几乎 任何 数据 库 支 持 ， 它 允许 独立 于 底层 数据 库 的 写 人 数据 
库 的 代码 。 


本 教程 给 出 的 SQL， 这 是 一 个 先决 条 件 ， 了 解 JDBC 概 述 。 本 教程 提供 了 足够 的 
读 取 ， 更 新 和 删除 (通常 被 称 为 CRUD 操 作 ) 从 一 个 数据 库 
中 的 数据 。 


有 关 SQL 的 详细 了 解 ， 可 以 阅读 我 们 的 MySQL 教 程 。 


创建 数据 库 : 
CREATE DATABASE 语 句 用 于 创建 一 个 新 的 数据 库 。 话 法 是 : 


SQL> CREATE DATABASE DATABASE NAME; 


例子 : 
下 面 的 SQL 语句 创建 一 个 名 为 EMP 数 据 库 : 


SQL> CREATE DATABASE EMP; 


删除 数据 库 : 
使 用 DROP DATABASE 语 句 用 于 删除 现 有 的 数据 库 。 语 法 是 : 


SQL> DROP DATABASE DATABASE NAME; 


注意 : 要 创建 或 删除 ， 应 该 有 数据 库 服务 器 上 管理 员 权限 的 数据 库 。 请 注意 ， 删 除 
数据 库 将 所 有 损失 存储 在 数据 库 中 的 数据 。 


创建 表 : 


CREATE TABLE 语 句 用 于 创建 一 个 新 表 。 语法 是 : 


SQL> CREATE TABLE table_name 
( 


column_name column_data_type, 
column_name column_data_type, 
column_name column_data_type 


); 


例子 : 
下 面 的 SQL 语句 创建 一 个 有 四 个 栏 位 名 为 Employees 表 : 


SQL> CREATE TABLE Employees 


( 
id INT NOT NULL, 


age INT NOT NULL, 
first VARCHAR(255), 
last VARCHAR(255), 
PRIMARY KEY ( id ) 


): 


MIRA : 
DROP TABLE 语 句 用 于 删除 现 有 的 表 。 语 法 是 : 


SQL> DROP TABLE table_name; 


例子 : 
下 面 的 SQL 语句 删除 一 个 名 为 Employees 表 : 


SQL> DROP TABLE Employees; 


插入 数据 : 


语法 INSERT 类 似 于 以 下 内 容 ， 其 中 column1, column2， 依 此 类 推 表 示 新 的 数据 出 
现在 各 列 : 


SQL> INSERT INTO table name VALUES (columni, column2, ...); 


例子 : 
下 面 的 SQL INSERT 语 句 中 插入 先前 创建 的 Employees 数据 库 : 


SQL> INSERT INTO Employees VALUES (100, 18, 'Zara', 'Ali'); 


SELECT 数据 : 
SELECT 语句 用 于 从 数据 库 中 检索 数据 。 该 语法 的 SELECT 是 : 


SQL> SELECT column_name, column_name, 
FROM table_name 
WHERE conditions; 


WHERE 子 句 可 以 使 用 比较 操作 符 例 如 =, !=, <, >, <=, >=, 以 及 BETWEEN 和 LIKE 操 
作 符 。 


例子 : 
下 面 的 SQL 语句 从 Employees 表 选 择 age 第 一 个 和 最 后 一 列 名 where id =100 : 


SQL> SELECT first, last, age 
FROM Employees 
WHERE id = 100; 


下 面 的 SQL 语句 从 Employees 表 ， 其 中 第 一 列 选择 age， 第 一 列 包含 Zaral: 


SQL> SELECT first, last, age 
FROM Employees 
WHERE first LIKE '%Zara%'; 


UPDATE 数据 : 
UPDATE 语 句 用 于 更 新 数据 。UPDATE 语 法 为 : 


SQL> UPDATE table_name 
SET column_name = value, column_name = value, 
WHERE conditions; 


WHERE 子 句 可 以 使 用 比较 操作 符 例 如 =，! =，<，>，<=， 和 >=， 以 及 BETWEEN 
和 LIKE 操 作 符 。 


例子 : 
下 面 的 SQL 的 UPDATE 语 句 更 改 其 ID 为 100 的 员工 的 age 列 : 


SQL> UPDATE Employees SET age=20 WHERE id=100; 


DELETE 数据 : 
DELETE 语 句 用 来 删除 表 中 的 数据 。 语 法 DELETE 是 : 


SQL> DELETE FROM table_name WHERE conditions; 


WHERE 子 句 可 以 使 用 比较 操作 符 例 如 =，! =，<，>，<=， 和 >=， 以 及 BETWEEN 
和 LIKE 操 作 符 。 
例子 : 


下 面 的 SQL DELETE 语 句 删除 ID 为 100 的 员工 的 记录 : 


SQL> DELETE FROM Employees WHERE id=100; 


JDBC 环 境 设 置 - JDBC 教 程 


eee 置 ,按照 以 下 所 示 的 步骤 开发 JDBC 环 境 。 以 下 内 容 假设 
Windows 平 台 


安装 Java: 


安装 J2SE 开 发 工具 包 5.0 (JDK 5.0) 下 载 : Java 官 方 网 站 。 
请 确保 以 下 环境 变量 设置 ， 如 下 所 述 : 


e JAVA HOME: 此 环境 变量 应 该 指向 安装 JDK 的 目录 ， 例 如 : C:Program 
FilesJavajdk1.5.0 


e CLASSPATH: 此 环境 变量 点 已 适当 的 路 径 设 置 ， 如 : C:Program 
FilesJavajdk1.5.0 20jrelib 


e PATH: 此 环境 变量 应 指向 适当 的 JRE bin, 40: C:Program 
FilesJavajre1.5.0 20in. 


可 能 已 有 这 些 变量 设置 了 ， 但 只 是 为 了 确保 在 这 里 是 如 何 检查 。 


e 进入 控制 面板 ， 双 击 系统 。 如 果 是 Windows XP 的 用 户 有 可 能 要 打开 : "性 
能 "=》 "维护 "， 会 看 到 系统 图 标 。 


e 转 到 "高 级 "选项 卡 ， 然 后 单 击 "环境 变量 "。 
e 现在 ， 选 择 所 有 输入 的 变量 设置 正确 。 
将 自动 获得 了 JDBC 包 java.sql 和 javax.sql， 当 安装 J2SE 开 发 工具 包 5.0 (JDK 5.0) 


安 委 数 据 库 : 


将 需要 当然 ， 最 重要 的 是 实际 运行 的 数据 库 用 ， 可 以 查询 和 修改 表 。 
安装 数据 库 是 最 适合 的 。 可 以 有 很 多 选择 ， 最 常见 的 有 : 


e MySQL DB: MySQL 是 一 个 开放 源码 的 数据 库 。 可 以 从 这 里 下 载 MySQL 官方 网 
站 ， 建 议 下 载 完 整 Windows 安 装 。 


此 外 ， 下 载 和 安装 MySQL 管 理 以 及 MySQL 坦 询 浏览 器 。 这 些 都 是 基于 GUI 的 
工具 ， 这 将 使 开发 更 加 容易 。 


最 后 ， 请 下 载 并 在 一 个 方便 的 目录 解压 缩 的 MySQL Connector/J (MySQL 
JDBC 了 驱动 程序 ) 。 对 于 本 教程 的 目的 ， 我 们 将 假设 已 经 安装 了 驱动 程序 位 于 
C:Program FilesMySQLmysal-connector-java-5.1.8. 


相应 地 设置 CLASSPATH 变 量 到 C:Program FilesMySQLmysgql-connector-java- 
5.1.8mysql-connector-java-5.1.8-bin.jar. 根据 安装 的 驱动 程序 版 本 可 能 会 有 所 
不 同 。 

PostgreSQL DB: PostgreSQL 是 一 个 开放 源码 的 数据 库 。 可 以 从 这 里 下 载 
PostgreSQL 官 方 网 站 。 


Postgres 安 装 包含 一 个 名 为 pPgAdmin 川 一 个 基于 GUI 管 理工 具 。 JDBC 驱 动 程 
序 也 包括 作为 安装 的 一 部 分 。 


Oracle DB: Oracle 数 据 库 是 Oracle 销 售 的 商用 数据 库 。 假 设 有 必须 的 分 发 介质 
进行 安装 。 

Oracle 的 安装 包括 一 个 名 为 Enterprise Manager 中 基于 GUI 的 管理 工具 。 JDBC 
驱动 程序 也 包括 作为 安装 的 一 部 分 。 


Be AGE HE UE REP: 
最 新 的 JDK 包 含 JDBC-ODBC 桥 驱动 程序 ， 使 大 多 数 开 放 式 数据 库 连 接 (ODBC) 
驱动 程序 程序 员 可 使 用 JDBC API. 


现在 ， 大 多 数 数据 库 厂商 随 数 据 库 的 安装 提供 相应 的 JDBC 了 驱动 程序 。 所 以 ， 不 应 
该 担心 这 部 分 。 


设置 数据 库 认 证 : 
在 本 教程 中 ， 我 们 将 使 用 MySQL 数 据 库 。 当 安装 上 述 任何 数据 库 ， 它 的 管理 员 1ID 设 
畦 为 root， 并 给 出 规定 设置 选择 的 密码 。 


用 root 和 密码 ， 可 以 创建 另 一 个 用 户 ID 和 密码 ， 或 者 可 以 使 用 root 和 密码 在 JDBC 应 
用 程序 中 。 


有 各 种 不 同 的 数据 库 操 作 ， 如 数据 库 的 创建 和 删除 ， 这 将 需要 管理 员 ID 和 密码 。 


对 于 JDBC 教 程 的 其 余部 分 ， 我 们 将 使 用 MySQL 数 据 库 username 作为 ID 和 
password 作为 密码 。 


如 果 没 有 足够 的 权限 来 创建 新 的 用 户 ， 那 么 可 以 让 数据 库 管 理 员 (DBA) 来 创建 一 
个 用 户 ID 和 密码 给 你 。 


创建 数据 库 : 


要 创建 EMP 数 据 库 ， 请 使 用 下 列 步骤 : 


步骤 1 : 


打开 命令 提示 符 并 更 改 到 安装 目录 ， 如 下 所 示 : 


Ci> 
C:>cd Program FilesMySQLin 
C:Program FilesMySQLin> 


注 : 这 取决 于 的 MySQL 系 统 上 的 安装 位 置 ，mysqld.exe 的 路 径 可 能 会 有 所 不 同 。 也 
可 以 查看 关于 如 何 启动 和 停止 数据 库 服务 器 文档 。 


步骤 2 : 
通过 执行 下 面 的 命 分， 如果 它 没有 运行 启动 数据 库 服务 器 。 


C:Program FilesMySQLin>mysqld 
C:Program FilesMySQLin> 


步骤 3 : 
通过 执行 以 下 命令 来 创建 数据 库 EMP 


C:Program FilesMySQLin> mysqladmin create EMP -u root -p 
Enter password: ******** 
C:Program FilesMySQLin> 


创建 表 

要 创建 Employees 表 中 EMP 的 数据 库 ， 请 执行 以 下 步骤 : 
步骤 1 : 

打开 命令 提示 符 并 更 改 到 安装 目录 ， 如 下 所 示 : 


C:> 
C:>cd Program FilesMySQLin 
C:Program FilesMySQLin> 


步骤 2 : 


登录 数据 库 ， 如 下 所 示 


C:Program FilesMySQLin»mysql -u root -p 
Enter password: ******** 


mysql> 


步骤 3 


创建 Employee 表 如 下 : 


mysql> 
mysql> 
= 
-> 
= 
-> 
> 
> 


use EMP; 

create table Employees 
( 

id int not null, 

age int not null, 
first varchar (255), 
last varchar (255) 


); 


Query OK, © rows affected (0.08 sec) 


mysql> 


创建 数据 记录 


最 后 ， 在 Employee 表 中 创建 一 些 记 录 如 下 : 


mysql> INSERT INTO Employees VALUES 
Query OK, 1 row affected (0.05 sec) 


mysql> INSERT INTO Employees VALUES 
Query OK, 1 row affected (0.00 sec) 


(100, 


(101, 


mysql> INSERT INTO Employees VALUES (102, 
Query OK, 1 row affected (0.00 sec) 


mysql> INSERT INTO Employees VALUES (103, 
Query OK, 1 row affected (0.00 sec) 


mysql> 


18, 


25, 


30, 


28, 


‘Zales, Alan )e 


'Mahnaz', 'Fatma'); 


'Zaid', 'Khan'); 


'Sumit', 'Mittal'): 


EE 
关于 MySQL 数 据 库 的 完整 认识 ， 学 习 MySQL 教 程 。 
现在 ， 就 可 以 开始 使 用 JDBC 尝 试 。 接 下 来 的 教程 将 给 予 有 关 JDBC 编 程 的 一 个 样本 


示例 。 


JDBC 示 例 代 码 - IDBCATE 

本 教程 提供 了 如 何 创 建 一 个 简单 的 JDBC 应 用 程序 的 示例 。 演 示 如 何 打开 一 个 数据 
库 连 接 ， 执 行 SQL 查询 ， 并 显示 结果 。 

所 有 在 此 模板 的 例子 中 提 到 的 步骤 ， 将 在 本 教程 的 后 续 章 节 说 明 。 


创建 JDBC 应 用 程序 : 


有 下 列 涉及 构建 JDBC 应 用 程序 的 六 个 步骤 : 


e 导 人 数据 包 . 需要 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情 况 
下 ， 使 用 import java.sql.* 就 可 以 了 . 


注册 JDBC 驱 动 程序 . 需要 初始 化 驱动 程序 ， 可 以 与 数据 库 打 开 一 个 通信 通道 。 


e。 打 开 连 接 . 需要 使 用 DriverManager.getConnection() 方法 创建 一 个 Connection 
对 象 ， 它 代表 与 数据 库 的 物理 连接 。 


e 执行 查询 . 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语句 到 数据 库 。 


从 结果 集中 提取 数据 . 要 求 使 用 适当 的 关于 ResultSet.getXXX() 方 法 来 检索 结 
果 集 的 数据 。 


清理 环境 . 需要 明确 地 关闭 所 有 的 数据 库 资源 相对 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 


这 个 范例 的 例子 可 以 作为 一 个 模板 ， 在 需要 建立 JDBC 应 用 程序 。 
基于 对 环境 和 数据 库 安装 在 前 面 的 章节 中 做 此 示例 代码 已 写 和 人。 
复制 下 面 的 例子 FirstExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class FirstExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/EMP"; 


// Database credentials 
static final String USER 
static final String PASS 


"username"; 
"password"; 


public static void main(String[] args) { 


Connection conn = null; 

Statement stmt = null; 

try{ 
//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println("Connecting to database..."); 
conn = DriverManager.getConnection(DB URL,USER, PASS) ; 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 

stmt = conn.createStatement(); 

String sql; 

sql = "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sql); 


//STEP 5: Extract data from result set 
while(rs.next())( 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age - rs.getInt("age"); 
String first - rs.getString("first"); 
String last - rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


//STEP 6: Clean-up environment 
rs.close(); 
stmt.close(); 
conn.close(); 
jcatch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-znull) 
stmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(conn!znull) 
conn.close(); 
jcatch(SQLException se){ 
se.printStackTrace(); 


}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end FirstExample 


现在 来 编译 上 面 的 例子 如 下 : 


C:>javac FirstExample. java 
C> 


当 运 行 FirstExample， 它 会 产生 以 下 结果 : 


C:>java FirstExample 

Connecting to database... 

Creating statement... 

ID: 100, Age: 18, First: Zara, Last: Ali 

ID: 101, Age: 25, First: Mahnaz, Last: Fatma 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
C> 
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什么 是 JDBC 了 驱动 程序 ? 


JDBC 驱 动 程序 实现 JDBC API 中 定义 的 接口 ， 用 于 与 数据 库 服务 器 进行 交互 。 


例如 ， 使 用 JDBC 驱 动 程序 可 以 打开 数据 库 连 接 ， 并 通过 发 送 SQL 或 数据 库 命 倒 ， 
然后 在 收 到 结果 与 Java 进 行 交 互 。 


java.sql 包 中 附带 的 JDK 包 含 定 义 各 种 类 与 他 们 的 行为 和 实际 实现 在 第 三 方 驱动 程 
序 。 第 三 方 供应 丙 实现 了 他 们 的 数据 库 驱 动 程序 的 java.sql.Driver 接 口 。 
JDBC 了 驱动 程序 类 型 : 

JDBC 了 驱动 程序 实现 ， 因 为 各 种 各 样 的 操作 系统 和 Java 运 行 在 硬件 平台 的 不 同 而 不 
fl, Sun 已 经 划分 了 实现 类 型 分 为 四 大 类 ， 类 型 1，2，3，4， 其 解释 如 下 : 
类 型 1 : JDBC-ODBC 桥 驱动 程序 : 


在 类 型 1 驱动 程序 ， 一 个 JDBC 桥 接 器 是 用 来 访问 安装 在 每 个 客户 机 上 的 ODBC 了 驱动 
程序 。 使 用 ODBC， 需 要 配置 系统 数据 源 名 称 (DSN) ， 表 示 在 目标 数据 库 上 。 


当 Java 刚 出 来 时 ， 这 是 一 个 有 用 的 驱动 程序 ， 因 为 大 多 数 的 数据 库 只 支持 ODBC 访 
问 ， 但 现在 建议 使 用 此 类 型 的 驱动 程序 仅 用 于 实验 用 途 或 在 没有 其 他 选择 的 情况 。 
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类 型 2 : JDBC-Native API 调 用 : 


在 类 型 2 驱动 程序 ，JDBC API 调 用 转换 成 原生 的 C / C+ + API 调 用 都 有 它 独 特 的 数 
据 库 。 这 些 通常 由 数据 库 厂商 提供 ， 并 以 相同 的 方式 将 JDBC-ODBC 桥 驱动 程序 使 
用 ， 特 定 供应 商 的 驱动 程序 必须 安装 在 每 台 客 户 机 上 。 


如 果 改 变 了 数据 库 ， 那 么 必须 改变 本 机 API， 因 为 它 是 具体 到 一 个 数据 库 ， 他 们 大 
多 是 过 时 了 ， 但 现在 可 以 实现 一 些 速度 增加 了 类 型 2 驱动 程序 ， 因 为 它 消除 了 数据 
库 的 开销 。 
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Oracle 调 用 接口 (OCI) 驱动 程序 是 一 个 类 型 2 驱动 程序 的 一 个 示例 。 


类 型 3 : JDBC 网 络 纯 Java : 


在 类 型 3 驱动 程序 ， 一 个 三 层 的 方法 来 访问 数据 库 。 在 JDBC 客 户 端 使 用 标准 的 网 络 
套 接 字 与 中 间 件 应 用 服务 器 进行 通信 。 套 接 字 的 相关 信息 ， 然 后 由 中 间 件 应 用 服务 
器 进入 由 DBMS 所 需要 的 的 调用 格式 转换 ， 并 转发 到 数据 库 服务 器 。 


这 种 驱动 器 是 非常 灵活 的 ， 因 为 它 不 需要 安装 在 客户 端 上 的 代码 和 一 个 单一 的 驱动 
器 实际 上 可 以 提供 访问 多 个 数据 库 。 
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可 以 将 应 用 服务 器 作为 一 个 JDBC“ 代 理 "”， 这 意味 着 它 会 调用 客户 端 应 用 程序 。 因 
此 ， 需 要 应 用 服务 器 的 配置 ， 以 有 效 地 使 用 此 驱动 程序 类 型 的 一 些 知识 。 

应 用 服务 器 可 能 使 用 类 型 1，2， 或 4 驱动 程序 与 数据 库 进 行 通信 ， 了 解 细微 之 处 将 
证 明 是 有 益 的 。 


类 型 4 : 100% 纯 Java : 


在 一 个 类 型 4 驱动 程序 ， 直 接 与 供应 商 的 数据 库 进行 通信 ， 通 过 socket 连 接 一 个 纯 
粹 的 基于 Java 的 驱动 程序 。 这 是 可 用 于 数据 库 的 最 高 性 能 的 驱动 程序 ， 并 且 通 常 由 
供应 商 本 身 提供 。 


这 种 驱动 器 是 非常 灵活 的 ， 不 需要 在 客户 端 或 服务 器 上 安装 特殊 的 软件 。 此 外 ， 这 
些 驱动 程序 可 以 动态 下 载 。 
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MySQL 的 Connector/J 的 驱动 程序 是 一 个 类 型 4 驱动 程序 。 因 为 他 们 的 网 络 协议 的 专 
有 性 的 ， 数 据 库 厂商 通常 提供 类 型 4 的 驱动 程序 。 


其 中 驱动 器 应 使 用 ? 

如 果 正 在 访问 一 个 类 型 的 数据 库 ， 如 Oracle，Sybase 或 IBM， 首 选 驱动 程序 是 类 型 
4, 

如 果 Java 应 用 程序 同时 访问 多 个 数据 库 类 型 ， 类 型 3 是 首选 的 驱动 程序 。 

第 2 类 驱动 程序 是 在 情况 下 : 类 型 3 或 类 型 4 驱动 程序 还 没有 提供 数据 库 非常 有 用 。 
类 型 1 驱动 程序 不 被 认为 是 部 署 级 别 的 驱动 程序 ， 它 通常 仅 用 于 开发 和 测试 目的 。 


JDBC 连 接 数 据 库 - JDBC 教 程 


在 安装 相应 的 驱动 程序 后 ， 现 在 是 时 候 建 立 使 用 JDBC 的 数据 库 连 接 。 
涉及 到 建立 一 个 JDBC 连 接 的 编程 是 相当 简单 的 。 下 面 是 这 些 简 单 的 四 个 步骤 : 
e 导入 JDBC 包 : 添加 import 语 句 到 Java 程 序 导 入 所 需 的 类 在 Java 代 码 中 。 


e 注册 JDBC 了 驱动 程序 : 这 一 步 会 导致 JVM 加 载 所 需 的 驱动 程序 实现 到 内 存 中 ， 
因此 它 可 以 实现 JDBC 请 求 。 


数据 库 URL 制 定 : 这 是 创建 格式 正确 的 地 址 指向 到 要 连接 的 数据 库 。 


创建 连接 对 象 : 最 后 ， 代 码 调 用 DriverManager 对 象 的 getConnection() 方 法 来 
建立 实际 的 数据 库 连 接 。 


导 人 JDBC 包 : 


import 语句 告诉 Java 编 译 器 在 哪里 可 以 找到 在 代码 中 引用 ， 并 放置 在 您 的 源 代码 最 
开始 的 类 。 


使 用 标准 的 JDBC 包 ， 它 允许 选择 ， 插 入 ， 更 新 和 SQL 表 中 删除 数据 ， 添 加 以 下 进 
口 到 您 的 源 代码 : 


import java.sql.* ; // for standard JDBC programs 
import java.math.* ; // for BigDecimal and BigInteger support 


注册 JDBC 驱 动 程序 : 
使 用 它 之 前 ， 必 须 注册 你 的 驱动 程序 在 程序 。 注 册 驱 动 程 序 是 由 Oracle 驱 动 程序 的 
类 文件 被 加 载 到 内 存 中 以 便 它 可 以 被 用 作 JDBC 接 口 的 实现 过 程 。 


需要 做 这 个 注册 只 能 在 你 的 程序 一 次 。 可 以 通过 以 下 两 种 方式 之 一 注册 一 个 驱动 程 
序 。 


方法 (D - Class.forName() : 


注册 一 个 驱动 程序 中 最 常用 的 方法 是 使 用 Java 的 Class.forName() 方 法 来 动态 加 载 驱 
动 程序 的 类 文件 到 内 存 中 ， 它 会 自动 将 其 注册 。 这 种 方法 是 可 取 的 ， 因 为 它 允 许 使 
驱动 注册 配置 ， 便于 携带 。 


下 面 的 示例 使 用 Class.forName() 来 注册 Oracle 驱 动 程序 : 


try { 
Class.forName("oracle.jdbc.driver.OracleDriver"); 


catch(ClassNotFoundException ex) ( 
System.out.println("Error: unable to load driver class!"); 
System.exit(1); 

} 


可 以 使 用 getlnstance() 方 法 来 解决 不 兼容 的 JVM， 但 要 编写 了 两 个 额外 的 例外 情 ; 
如 下 : 


try ( 
Class.forName("oracle.jdbc.driver.OracleDriver").newInstance(); 


catch(ClassNotFoundException ex) { 
System.out.println("Error: unable to load driver class!"); 
System.exit(1); 

catch(IllegalAccessException ex) { 
System.out.println("Error: access problem while loading!"); 
System.exit(2); 

catch(InstantiationException ex) ( 
System.out.println("Error: unable to instantiate driver!"); 
System.exit(3); 
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方法 (=) -DriverManager.registerDriver() : 


可 以 用 它 来 注册 一 个 驱动 程序 的 第 二 种 方法 是 使 用 
staticDriverManagerregisterDriver() 方 法 。 


应 该 ， 如 果 使 用 的 是 不 兼容 的 JDK JVM， 比 如 微软 提供 一 个 使 用 registerDriver() 方 


法 。 


下 面 的 示例 使 用 registerDriver() 来 注册 Oracle 驱 动 程序 : 


try { 
Driver myDriver = new oracle.jdbc.driver.OracleDriver(); 
DriverManager.registerDriver( myDriver ); 


catch(ClassNotFoundException ex) { 
System.out.println("Error: unable to load driver class!"); 
System.exit(1); 

} 


数据 库 URL 制 定 : 


当 加 载 的 驱动 程序 ， 可 以 建立 程序 中 使 用 DriverManager.getConnection() 方 法 的 连 
接 。 为 方便 参考 ， 让 列 出 了 三 个 重 载 DriverManager.getConnection() 方 法 : 
e getConnection(String url) 
e getConnection(String url, Properties prop) 
e getConnection(String url, String user, String password) 
在 这 里 ， 每 个 表单 需要 一 个 数据 库 URL。 数 据 库 的 URL 是 指向 数据 库 地 址 。 
制定 一 个 数据 库 URL 是 大 多 数 用 在 建立 连接 相关 。 
下 表 列 出 了 下 来 流行 的 JDBC 驱 动 程序 名 和 数据 库 的 URL。 


RDBMS JDBC 驱 动 程序 的 名 称 URL 格式 


jdbc:mysql://hostname/ 


MySQL com.mysgl.jdbc.Driver databaseName 


jdbc:oracle:thin:@hostname:; 


ORACLE  oracle.jdbc.driver.OracleDriver EN 


jdbc:db2:hostname:port 


DB2 COM.ibm.db2.jdbc.net.DB2Driver NumboridatasscNamo 


jdbc:sybase:Tds:hostname: p 


Sybase com.sybase.jdbc.SybDriver Number/databaseName 


以 URL 格 式 所 有 高 亮 的 部 分 是 静态 的 ， 需 要 改变 只 剩余 部 分 按照 数据 库 设置 。 
创建 连接 对 象 : 
使 用 数据 库 URL 的 用 户 名 和 密码 : 


下 面 三 种 形式 DriverManager.getConnection() 方 法 来 创建 一 个 连接 对 象 。 
getConnection() 最 常用 形式 要 求 传递 一 个 数据 库 URL， 用 户 名 username 和 密码 
password : 


对 URL 数 据 库 部 分 databaseName 的 值 : 假设 使 用 的 是 Oracle 的 瘦 驱 动 程序 ， 需 要 
指定 一 个 主机 : 端口 。 


假设 有 一 台 主 机 TCP/IP 地 址 192.0.0.1 以 及 主机 名 和 Oracle 监 听 器 被 配置 为 在 端口 
1521， 数 据 库 名 称 是 EMP， 然 后 完整 的 数据 库 URL 是 : 


jdbc:oracle:thin:Qamrood:1521: EMP 


现在 ， 必 须 调 用 适当 的 用 户 名 和 密码 以 及 getConnection() 方 法 来 获得 一 个 
Connection 对 象 ， 如 下 所 示 : 


String URL = "jdbc:oracle:thin:Qamrood:1521:EMP"; 

String USER "username"; 

String PASS "password" 

Connection conn = DriverManager.getConnection(URL, USER, PASS); 


只 使 用 一 个 数据 库 URL : 


第 二 种 形式 DriverManager.getConnection() 方 法 只 需要 一 个 数据 库 URL : 


DriverManager.getConnection(String url); 


然而 ， 在 这 种 情况 下 ， 数 据 库 的 URL， 包 括 用 户 名 和 密码 ， 并 具有 以 下 的 一 般 形 


-E 


jdbc:oracle:driver:username/passwordQdatabase 


所 以 上 面 的 连接 可 以 创建 如 下 : 


String URL = "jdbc:oracle:thin:username/passwordQamrood : 1521: EMP"; 
Connection conn - DriverManager.getConnection(URL); 


1 II I 1) 
使 用 数据 库 的 URL 和 一 个 Properties 对 象 : 


第 三 种 形式 DriverManager.getConnection() 方 法 需要 一 个 数据 库 URL 和 一 个 
Properties 对 象 : 


DriverManager.getConnection(String url, Properties info); 


Properties 对 象 ， 保 存 一 组 关键 字 - 值 对 。 它 被 用 来 调用 getConnection() 方 法 时 驱 
动 程序 属性 传递 给 驱动 程序 。 


为 了 使 通过 前 面 的 例子 中 所 做 的 相同 的 连接 ， 使 用 下 面 的 代码 : 


import java.util.*; 

String URL - "jdbc:oracle:thin:Qamrood:1521:EMP"; 
Properties info - new Properties( ); 

info.put( "user", "username" ); 

info.put( "password", "password" ); 


Connection conn - DriverManager.getConnection(URL, info); 


关闭 JDBC 连 接 : 
在 JDBC 程 序 的 结束 ， 它 明确 要 求 关闭 所 有 的 连接 到 数据 库 ， 以 结束 每 个 数据 库 会 
话 。 但 是 ， 如 果 忘 了 ，Java 垃 圾 收集 器 会 关闭 连接 时 ， 它 会 清除 陈旧 的 对 象 。 


依托 垃圾 收集 ， 特 别 是 在 数据 库 编 程 ， 是 非常 差 的 编程 习惯 。 应 该 总 是 在 关闭 与 连 
接 对 象 关 联 的 close() 方 法 连接 的 习惯 。 


为 了 确保 连接 被 关闭 ， 可 以 在 代码 中 的 finally 块 执行 。 finally 块 都 会 执行 ， 不 管 是 否 
发 生 或 也 不 例外 。 


要 关闭 上 面 打 开 的 连接 ， 应 该 调用 close() 方 法 ， 如 下 所 示 : 
conn.close(); 


显 式 地 关闭 连接 DBMS 节 约 资源 。 
为 了 更 好 地 理解 ， 建 议 看 看 JDBC - 示例 代码 。 
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一 旦 获得 一 个 连接 ， 我 们 可 以 和 与 数据 库 进行 交互 。 在 JDBC Statement, 


CallableStatement 和 PreparedStatement 接口 定义 的 方法 和 属性 ， 使 可 以 发 送 
SQL 或 PL/SQL 命 信和 从 数据 库 接收 数据 。 


它们 还 定义 方法 ， 帮 助 Java 和 数据 库 使 用 SQL 数 据 类 型 之 间 转 换 数据 的 差异 。 
下 表 提 供 了 每 个 接口 的 用 途 概要 ， 了 解决 定 使 用 哪个 接口 ? 


接口 推荐 使 用 
使 用 通用 访问 数据 库 。 当 在 运行 时 使 用 静态 SQL 语句 。 


>iatement Statement 接 口 不 能 接受 的 参数 。 
S^ « M c ~ ` p s 
PreparedStatement 当 计 划 多 次 使 用 SQL 语句 。 那么 可 以 


PreparedStatement 接 口 接收 在 运行 时 输入 参数 。 


当 要 访问 数据 库 中 的 存储 过 程 中 使 用 。 
CallableStatement CallableStatement 对 象 的 接 口 还 可 以 接受 运行 时 输入 参 


o 


Statement 对 象 : 


创建 Statement 对 象 : 


在 可 以 使 用 Statement 对 象 执行 SQL 语句 ， 需 要 使 用 Connection 对 象 的 
createStatement( ) 方 法 创建 一 个 ， 如 下 面 的 示例 所 示 : 


Statement stmt = null; 


try { 
stmt = conn.createStatement( ); 


catch (SQLException e) { 
} 

finally { 

} 


一 旦 创建 了 一 个 Statement 对 象 ， 然 后 可 以 用 它 来 与 它 的 三 个 执行 方法 之 一 执行 
SQL 语句 。 


e boolean execute(String SQL) : 如 果 ResultSet 对 象 可 以 被 检索 返回 布尔 值 
true， 人 否则 返回 false。 使 用 这 个 方法 来 执行 SQL DDL 语 句 ， 或 当 需要 使 用 真正 
的 动态 SQL。 


e int executeUpdate(String SQL) : 返回 受 影响 的 SQL 语句 执行 的 行 的 数目 。 使 
用 此 方法 来 执行 ， 而 希 刻 得 到 一 些 受 影响 的 行 的 SQL 语句 - 例如 ，INSERT， 
UPDATE 或 DELETE 语 句 。 


e ResultSet executeQuery(String SQL) : 返回 ResultSet 对 象 。 当 希望 得 到 一 
个 结果 集 使 用 此 方法 ， 就 像 使 用 一 个 SELECT 语句 。 
关闭 Statement 对 象 : 


正如 关闭 一 个 Connection 对 象 来 保存 数据 库 资 源 ， 出 于 同样 的 原因 ， 也 应 该 关闭 
Statement &. 


close() 方 法 简单 的 调用 将 完成 这 项 工作 。 如 果 关 闭 了 Connection 对 象 首先 它 会 关闭 
Statement 对 象 也 是 如 此 。 然 而 ， 应 该 始终 明确 关闭 Statement 对 象 ， 以 确保 正确 的 
清除 。 


Statement stmt = null; 


try { 
stmt = conn.createStatement( ); 


} 
catch (SQLException e) { 


} 

finally { 
stmt.close(); 

} 


为 了 更 好 地 理解 ， 建 议 研 究 和 学 习 Statement 3: 51/522. 


PreparedStatement 对 象 : 


PreparedStatement 接 口 扩展 了 Statement 接 口 ， 让 过 一 个 通用 的 Statement 对 象 增 
加 几 个 高 级 功能 。 


statement 提供 动态 参数 的 灵活 性 。 


创建 PreparedStatement 对 象 : 


PreparedStatement pstmt = null; 


try { 
String SQL = "Update Employees SET age = ? WHERE id = ?"; 
pstmt = conn.prepareStatement(SQL); 


catch (SQLException e) { 
} 

finally { 

} 


在 JDBC 中 所 有 的 参数 都 被 代表 ? 符号 ， 这 是 已 知 的 参数 标记 。 在 执行 SQL 语句 之 
前 ， 必 须 提 供 值 的 每 一 个 参数 。 


setXXX() 方 法 将 值 绑 定 到 参数 ， 其 中 XXX 表示 希望 绑 定 到 输入 参数 值 的 Java 数 据 类 
型 。 如 果 忘 了 提供 值 ， 将 收 到 一 个 SQLException。 


每 个 参数 标记 是 由 它 的 序号 位 置 引 用 。 第 一 标记 表示 位 置 1， 下 一 个 位 置 为 2 等 等 。 
这 种 方法 不 同 于 Java 数 组 索引 ， 以 0 开始 。 


所 有 的 Statement 对 象 的 方法 来 与 数据 库 交 互 (a) execute(), (b) executeQuery(), 及 
(c) executeUpdate() 也 与 PreparedStatement 对 象 的 工作 。 然 而 ， 该 方法 被 修改 为 
使 用 SQL 语句 ， 可 以 利用 输入 的 参数 。 


关闭 PreparedStatement 对 象 : 


正如 关闭 Statement 对 象 ， 出 于 同样 的 原因 ， 也 应 该 关闭 的 PreparedStatement 对 


o 


close() 方 法 简单 的 调用 将 完成 这 项 工作 。 如 果 关 闭 了 Connection 对 象 首 先 它 会 关闭 
PreparedStatement 对 象 。 然 而 ， 应 该 始终 明确 关闭 PreparedStatement 对 象 ， 以 确 
保 正 确 的 清除 。 


PreparedStatement pstmt = null; 


try { 
String SQL = "Update Employees SET age = ? WHERE id = ?"; 
pstmt = conn.prepareStatement(SQL); 


j 
catch (SQLException e) ( 


} 

finally { 
pstmt.close(); 

j 


为 了 更 好 地 理解 ， 建 议 学 习 Prepare 例子 代码 . 


CallableStatement 对 象 : 


正如 一 个 Connection 对 象 创建 Statement 和 PreparedStatement 对 象 ， 它 也 创造 了 
CallableStatement 对 象 这 将 被 用 来 执行 调用 数据 库存 储 过 程 。 


创建 CallableStatement 对 象 : 
假设 ， 需 要 执行 以 下 Oracle 存 储 过 程 : 


CREATE OR REPLACE PROCEDURE getEmpName 

(EMP_ID IN NUMBER, EMP_FIRST OUT VARCHAR) AS 
BEGIN 

SELECT first INTO EMP_FIRST 

FROM Employees 

WHERE ID = EMP ID; 
END; 


X: 上 面 的 存储 过 程 已 写 人 用 于 Oracle， 但 我 们 正在 使 用 MySQL 数 据 库 ， 以 便 让 我 
们 写 相 同 的 存储 过 程 对 于 MySQL 如 下 ， 以 EMP 数 据 库 中 创建 它 : 


DELIMITER $$ 


DROP PROCEDURE IF EXISTS 'EMP'.'getEmpName' $$ 
CREATE PROCEDURE “EMP ， getEmpName 

(IN EMP_ID INT, OUT EMP_FIRST VARCHAR(255) ) 
BEGIN 

SELECT first INTO EMP_FIRST 

FROM Employees 

WHERE ID = EMP ID; 
END $$ 


DELIMITER ; 


三 种 类 型 的 参数 有 : IN，OUT 和 INOUT。 PreparedStatement 对 象 只 使 用 IN 参数 。 
CallableStatement 对 象 可 以 使 用 所 有 三 个 。 


这 里 是 每 个 的 定义 : 


参数 描述 


它 的 值 是 在 创建 SQL 话 句 时 未 知 的 参数 。 将 值 绑 定 到 与 setXXX() 方 法 

S 的 参数 。 

OUT 其 值 由 它 返回 的 SQL 语句 提供 的 参数 。 从 OUT 参 数 的 getXXX() 方 法 检 
索 值 。 

INOUT 同时 提供 输入 和 输出 值 的 参数 。 绑 定 的 setXXX() 方 法 的 变量 ， 并 使 用 
getXXX() 方 法 检索 值 。 


下 面 的 代码 片段 显示 了 如 何 使 用 该 Connection.prepareCall() 方 法 实例 化 基于 上 述 存 
储 过 程 CallableStatement 对 象 : 


CallableStatement cstmt = null; 


try ( 
String SQL = "(call getEmpName (?, ?)}"; 
cstmt = conn.prepareCall (SQL); 


} 

catch (SQLException e) { 
} 

finally { 

} 


String 变 量 的 SQL 表示 存储 过 程 ， 使 用 参数 占 位 符 。 


使 用 CallableStatement 对 象 是 就 像 使 用 PreparedStatement 对 象 。 必 须 将 值 绑 定 到 
所 有 的 参数 执行 该 语句 之 前 ， 否 则 将 收 到 一 个 SQLException。 


如 果 有 IN 参数 ， 只 要 按照 适用 于 PreparedStatement 对 象 相同 的 规则 和 技巧 ;使 用 对 
应 于 要 绑 定 的 Java 数 据 类 型 的 setXXX() 方 法 。 


当 使 用 OUT 和 INOUT 参 数 就 必须 采用 额外 的 CallableStatement 及 
registerOutParameter() 方 法 。registerOutParameter() 方 法 JDBC 数 据 类 型 绑 定 到 数 
据 类 型 的 存储 过 程 应 返回 。 

一 旦 调用 存储 过 程 ， 用 适当 的 getXXX() 方 法 的 输出 参数 检索 值 。 这 种 方法 投射 SQL 
类 型 的 值 检索 到 Java 数 据 类 型 。 


关闭 CallableStatement x12 : 


正如 关闭 其 他 Statement 对 象 ， 出 于 同 祥 的 原因 ， 也 应 该 关闭 CallableStatement 对 


o 


close() 方 法 简单 的 调用 将 完成 这 项 工作 。 如 果 关 闭 了 Connection 对 象 首 先 它 会 关闭 
CallableStatement 对 象 为 好 。 然 而 ， 应 该 始终 明确 关闭 CallableStatement 对 象 ， 以 
确保 正确 的 清除 。 


CallableStatement cstmt = null; 


try { 
String SQL = "(call getEmpName (?, ?)}"; 
cstmt = conn.prepareCall (SQL); 


} 
catch (SQLException e) { 


} 
finally { 
cstmt.close(); 


} 


为 了 更 好 地 理解 ， 建 议 学 习 Callable 实 例 代码 。 


JDBC PreparedStatementsxt & 3: fJ - JDBC 教 程 


以 下 是 这 使 得 使 用 PreparedStatement 以 及 打开 和 关闭 statments 的 例子 : 
基于 对 环境 和 数据 库 安 装 在 前 面 的 章节 中 进行 这 个 范例 程式 码 已 被 宇和 人。 
复制 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/EMP"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 
= "password"; 
public static void main(String[] args) { 
Connection conn = null; 
PreparedStatement stmt = null; 
try{ 

//STEP 2: Register JDBC driver 

Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println("Connecting to database..."); 
conn = DriverManager.getConnection(DB URL,USER, PASS); 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 

String sql - "UPDATE Employees set age-? WHERE id-?"; 
stmt = conn.prepareStatement(sql); 


//Bind values into the parameters. 
stmt.setInt(1, 35); // This would set age 
stmt.setInt(2, 102); // This would set ID 


// Let us update age of the record with ID = 102; 
int rows = stmt.executeUpdate(); 
System.out.println("Rows impacted : " + rows ); 


// Let us select all the records and display them. 
sql = "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sql); 


//STEP 5: Extract data from result set 
while(rs.next()){ 


//Retrieve by column name 

int id = rs.getInt("id"); 

int age = rs.getInt("age"); 

String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 
System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 
} 
//STEP 6: Clean-up environment 
rs.close(); 
stmt.close(); 
conn.close(); 
jcatch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
stmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


现在 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
Gr 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 

Connecting to database... 

Creating statement... 

Rows impacted : 1 

ID: 100, Age: 18, First: Zara, Last: Ali 

ID: 101, Age: 25, First: Mahnaz, Last: Fatma 
ID: 102, Age: 35, First: Zaid, Last: Khan 
ID: 103, Age: 30, First: Sumit, Last: Mittal 
Goodbye! 

C:> 


JDBC CallableStatementxt & 3: | - JDBC 教 程 


下 面 是 利用 CallableStatement 连 同 下 列 getEmpName() 的 MySQL 存 储 过 程 的 例子 
请 确定 已 经 在 EMP 数 据 库 中 创建 该 存储 过 程 。 可 以 使 用 MySQL 查 询 浏览 器 来 完成 


它 。 


DELIMITER $$ 


DROP PROCEDURE IF EXISTS 'EMP'.'getEmpName' $$ 
CREATE PROCEDURE “EMP . getEmpName~ 

(IN EMP_ID INT, OUT EMP_FIRST VARCHAR(255) ) 
BEGIN 

SELECT first INTO EMP_FIRST 

FROM Employees 

WHERE ID = EMP ID; 
END $$ 


DELIMITER ; 


基于 对 环境 和 数据 库 安装 在 前 面 的 章节 中 进行 ， 这 个 范例 程式 码 已 被 守 入 。 
复制 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/EMP"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 
= "password"; 
public static void main(String[] args) { 
Connection conn = null; 
CallableStatement stmt = null; 
try{ 

//STEP 2: Register JDBC driver 

Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println("Connecting to database..."); 
conn = DriverManager.getConnection(DB URL, USER, PASS); 


//STEP 4: Execute a query 


System.out.println("Creating statement..."); 
String sql = "(call getEmpName (?, ?)}"; 
stmt = conn.prepareCall(sql); 


//Bind IN parameter first, then bind OUT parameter 
int empID = 102; 

stmt.setInt(1, empID); // This would set ID as 102 
// Because second parameter is OUT so register it 
stmt.registerOutParameter(2, java.sql.Types.VARCHAR) ; 


//Use execute method to run stored procedure. 
System.out.println("Executing stored procedure..." ); 
stmt.execute(); 


//Retrieve employee name with getXXX method 
String empName = stmt.getString(2); 
System.out.println("Emp Name with ID:" + 
empID + " is " + empName); 
stmt.close(); 
conn.close(); 
jcatch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-znull) 
stmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(conn!znull) 
conn.close(); 
jcatch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


现在 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
CES 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 
Connecting to database... 
Creating statement... 
Executing stored procedure... 
Emp Name with ID:102 is Zaid 
Goodbye! 

C:> 


JDBC 结 果 集 Result/Sets - JDBC 教 程 


从 数据 库 查 询 读 取 数 据 的 SQL 语句 返回 的 结果 集 的 数据 。 SELECT 语句 的 标准 方法 
来 选择 从 一 个 数据 库 中 的 行 并 查 来 在 一 个 结果 集 。java.sql.ResultSet 接 口 表 示 一 个 
数据 库 查 询 的 结果 集 。 


一 个 ResultSet 对 象 维护 一 个 游标 指向 当前 行 的 结果 集 。 术 话 “ 结 果 集 "是 指 包含 在 
ResultSet 对 象 中 的 行 和 列 的 数据 。 


ResultSet 接 口 的 方法 可 分 为 三 类 : 
e 导航 方法 : 用 于 移动 光标 . 
e 获取 方法 : 用 于 查看 当前 行 的 光标 所 指向 的 列 中 的 数据 。 


e 更 新 方法 : 用 于 更 新 当前 行 的 列 中 的 数据 。 这 些 更 新 然后 可 以 在 基础 数据 库 
中 ， 以 及 更 新 。 


将 光标 移动 基于 ResultSet 的 属性 。 所 创建 生成 ResultSet 相 应 的 声明 时 ， 这 些 属 性 
被 指定 。 


JDBC 提 供 下 列 连接 方法 来 创建 所 需 的 ResultSet 语 名 : 
e createStatement(int RSType, int RSConcurrency); 
e prepareStatement(String SQL, int RSType, int RSConcurrency); 
e prepareCall(String sql, int RSType, int RSConcurrency); 


第 一 个 参数 表示 ResultSet 对 象 的 类 型 ， 第 二 个 参数 是 2 的 ResultSet 常 量 ， 用 于 指定 
一 个 结果 集 是 否 为 只 读 或 可 更 新 之 一 。 


ResultSet 的 类 型 : 


可 能 的 RSType 如 下 ， 如 果 不 指定 ResultSet 类 型 ， 将 自动 获得 一 个 是 
TYPE FORWARD ONLY, 


Type 描述 
ResultSet. TYPE FORWARD ONLY 游标 只 能 向 前 移动 的 结果 集 。 


游标 可 以 向 前 和 向 后 滚动 ， 结 果 
ResultSet. TYPE SCROLL INSENSITIVE ， 集 不 是 别人 向 创建 结果 集 后 发 生 
的 数据 库 更 改 敏 感 。 


游标 可 以 向 前 和 向 后 滚动 ， 结 果 
ResultSet.TYPE_SCROLL SENSITIVE. 集 是 别人 向 创建 结果 集 后 发 生 的 
数据 库 更 改 敏感 。 


并 发 性 的 ResultSet : 


可 能 的 RSConcurrency 如 下 ， 如 果 不 指定 任何 并 发 类 型 ， 将 自动 获得 一 个 为 
CONCUR_READ_ONLY, 


并 发 描述 
ResultSet.CONCUR_READ_ONLY 创建 结果 集 只 读 。 这 是 默认 的 
ResultSet.CONCUR_UPDATABLE 创建 一 个 可 更 新 的 结果 集 。 


到 目前 为 止 已 写 入 的 例子 可 以 写成 如 下 的 初始 化 一 个 Statement 对 象 来 创建 一 个 只 
进 ， 只 读 的 ResultSet 对 象 : 


try ( 
Statement stmt = conn.createStatement ( 
ResultSet.TYPE FORWARD ONLY, 
ResultSet.CONCUR READ ONLY); 


catch(Exception ex) { 
} 

finally { 

} 


导航 结果 集 : 


有 几 种 方法 在 ResultSet 接 口 涉及 移动 光标 ， 包 括 : 


S.N. 方法 & 描述 


public void beforeFirst() throws SQLException 将 光标 移动 到 正好 位 
于 第 一 行 之 前 
public void afterLast() throws SQLException 将 光标 移动 到 刚刚 结束 


“ EEF 

3 public boolean first() throws SQLException 将 光标 移动 到 第 一 行 

4 public void last() throws SQLException 将 光标 移动 到 最 后 一 行 。 

5 public boolean absolute(int row) throws SQLException 将 光标 移动 
到 指定 的 行 

6 public boolean relative(int row) throws SQLException 从 它 目前 所 
指向 向 前 或 向 后 移动 光标 行 的 给 定数 量 。 

7 public boolean previous() throws SQLException 将 光标 移动 到 上 一 
行 。 上 一 行 关闭 的 结果 集 此 方法 返回 false 

8 public boolean next() throws SQLException 将 光标 移动 到 下 一 行 。 
如 果 没 有 更 多 的 行 结果 集中 的 此 方法 返回 false 

9 public int getRow() throws SQLException 返回 的 行 号 ， 该 光标 指向 


的 行 . 
public void moveTolnsertRow() throws SQLException 将 光标 移动 


10 到 一 个 特殊 的 行 ， 可 以 用 来 插入 新 行 插入 到 数据 库 中 的 结果 集 。 当 前 光 
标 位 置 被 记 住 . 


public void moveToCurrentRow() throws SQLException 移动 光标 
11 返回 到 当前 行 ， 如 果 光 标 在 当前 插入 行 ， 否 则 ， 这 个 方法 不 执行 任何 操 
作 


为 了 更 好 地 理解 ， 建 议 学 习 导 航 示例 代码 


查看 结果 集 : 


ResultSet 接 口中 含有 几 十 种 用 于 获取 当前 行 的 数据 的 方法 。 
有 一 个 get 方 法 为 每 个 可 能 的 数据 类 型 ， 并 且 每 个 get 方 法 有 两 个 版 本 : 
。 即 需 要 在 一 个 列 名 。 
。 即 需要 在 列 中 索引 。 
例如 ， 如 果 有 兴趣 查看 的 列 包含 一 个 整数 ， 需 要 使 用 ResultSet 调 用 getlnt() 方 法 之 


S.N. 方法 & 描述 


1 public int getlnt(String columnName) throws SQLException 返回 
整数 的 当前 行 中 名 为 ColumnName 列 


public int getInt(int columnindex) throws SQLException 返回 整数 
2 的 当前 行 中 指定 列 的 索引 。 列 索引 从 1 开始 ， 意 味 着 一 个 行 的 第 一 列 是 
1， 行 的 第 二 列 是 2， 依 此 类 推 。 


与 此 类 似 的 还 有 get 方 法 在 ResultSet 接 口 为 每 个 八 个 Java 原 始 类 型 ， 以 及 常见 的 类 
型 比如 java.lang.String，java.lang.Object 和 java.net.URL 


也 有 用 于 获取 SQL 数据 类 型 java.sql.Date，java.sql.Time，java.sql.Timestamp， 
java.sql.Clob，java.sql.Blob 中 的 方法 。 检 查 有 关 使 用 这 些 SQL 数据 类 型 的 详细 信息 
的 文档 。 


为 了 更 好 地 理解 ， 建 议 学 习 查看 - 示例 代码 . 


更 新 的 结果 集 : 


ResultSet 接 口中 包含 的 更 新 方法 用 于 更 新 的 结果 集 的 数据 的 集合 。 

由 于 get 方 法 ， 有 两 种 更 新 方法 为 每 种 数据 类 型 : 
。 即 需 要 在 一 个 列 名 。 
。 即 需要 在 列 中 索引 。 

要 更 新 一 个 结果 集 的 当前 行 的 String 列 ， 可 以 使 用 下 面 的 updateString O 方 
S.N. 方法 & 描述 


1 public void updateString(int columnlndex, String s) throws 
SQLException 指定 列 中 的 字符 串 更 改 为 s 的 值 。 


public void updateString(String columnName, String s) throws 
2 SQLException 类 似 于 前 面 的 方法 ， 不 同 之 处 在 于 由 它 的 名 称 ， 而 不 是 
它 的 索引 指定 的 列 。 


Eu rere 以 及 字符 串 ， 对 象 ，URL， 并 在 java.sql 包 中 的 SQL 
Z mm. 


更 新 结果 集中 的 行 改变 当前 行 的 列 中 的 ResultSet 对 象 ， 而 不 是 基础 数据 库 中 。 要 更 
新 更 改 数据 库 中 的 一 行 ， 需 要 调用 下 面 的 方法 之 一 。 


S.N. 方法 & 描述 

1 public void updateRow() 通过 更 新 数据 库 中 相应 的 行 更 新 当前 行 。 

2 public void deleteRow() 从 数据 库 中 删除 当前 行 

3 public void refreshRow() 刷新 在 结果 集 的 数据 ， 以 反映 最 新 变化 在 数 


据 库 中 。 

4 public void cancelRowUpdates() 取消 所 做 的 当前 行 的 任何 更 新 。 

5 public void insertRow() 插入 一 行 到 数据 库 中 。 当 光标 指向 插入 行 此 方 
法 只 能 被 调用 。 


为 了 更 好 地 理解 ， 建 议 学 习 更 新 示例 代码 。 
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JDBC 了 驱动 程序 将 其 发 送 到 数据 库 之 前 的 Java 数 据 类 型 转换 为 相应 的 JDBC 类 型 。 它 
采用 了 默认 的 映射 对 于 大 多 数 数据 类 型 。 例 如 ， 一 个 Java 整 型 转换 为 SQL 
INTEGER。 创 建 默认 映射 提供 的 驱动 程序 之 间 的 一 致 性 。 


下 表 总 结 了 Java 数 据 类 型 转换 为 当 调 用 PreparedStatement 中 的 setXXX() 方 法 或 
CallableStatement 对 象 或 ResultSet.updateXXX() 方 法 的 默认 JDBC 数 据 类 型 。 


SQL 
VARCHAR 
CHAR 
LONGVARCHAR 
BIT 
NUMERIC 
TINYINT 
SMALLINT 
INTEGER 
BIGINT 
REAL 
FLOAT 
DOUBLE 
VARBINARY 
BINARY 
DATE 
TIME 
TIMESTAMP 
CLOB 
BLOB 
ARRAY 
REF 
STRUCT 


JDBC/Java 
java.lang.String 
java.lang.String 
java.lang.String 


boolean 


java.math.BigDecimal 


byte 

short 

int 

long 

float 

float 

double 

bytel ] 

byte[ ] 
java.sql.Date 
java.sql. Time 
java.sql. Timestamp 
java.sql.Clob 
java.sql.Blob 
java.sql.Array 
java.sql.Ref 


java.sql.Struct 


setXXX 
setString 
setString 
setString 
setBoolean 
setBigDecimal 
setByte 
setShort 
setint 
setLong 
setFloat 
setFloat 
setDouble 
setBytes 
setBytes 
setDate 
setTime 
setTimestamp 
setClob 
setBlob 
setARRAY 
SetRef 
SetStruct 


updateXXX 
updateString 
updateString 
updateString 
updateBoolean 
updateBigDecim. 
updateByte 
updateShort 
updatelnt 
updateLong 
updateFloat 
updateFloat 
updateDouble 
updateBytes 
updateBytes 
updateDate 
updateTime 
updateTimestam 
updateClob 
updateBlob 
updateARRAY 
updateRef 
updateStruct 


JDBC3.0 增 强 了 对 BLOB，CLOB，ARRAY 和 REF 数 据 类 型 的 支持 。 ResultSet 对 
象 现在 有 UPDATEBLOB()，updateCLOB()，updateArray()， 和 updateRef() 方 法 ， 
可 以 直接 操作 服务 器 上 的 相应 数据 。 


setXXX() 和 updateXXX() 方 法 能 够 将 特定 Java 类 型 转换 为 特定 的 JDBC 数 据 类 型 。 
该 方法 setObject(0) 和 updateObject()， 能 够 将 几乎 任何 Java 类 型 映射 到 JDBC 数 据 类 


型 。 
ResultSet 对 象 为 每 个 数据 类 型 来 检索 列 值 对 应 的 getXXX() 方 法 。 
列 名 或 由 它 的 序数 位 置 。 

SQL JDBC/Java SetXXX 
VARCHAR java.lang.String setString 
CHAR java.lang.String setString 
LONGVARCHAR _ java.lang.String setString 
BIT boolean setBoolean 
NUMERIC java.math.BigDecimal | setBigDecimal 
TINYINT byte setByte 
SMALLINT short setShort 
INTEGER int setint 
BIGINT long setLong 
REAL float setFloat 
FLOAT float setFloat 
DOUBLE double setDouble 
VARBINARY byte[ ] setBytes 
BINARY byte[ ] setBytes 
DATE java.sql.Date setDate 
TIME java.sql. Time setTime 
TIMESTAMP java.sql. Timestamp setTimestamp 
CLOB java.sql.Clob setClob 
BLOB java.sql.Blob setBlob 
ARRAY java.sql.Array setARRAY 
REF java.sql.Ref SetRef 
STRUCT java.sql.Struct SetStruct 


每 个 方法 可 用 于 和 与 


getXXX 
getString 
getString 
getString 
getBoolean 
getBigDecimal 
getByte 
getShort 
getint 
getLong 
getFloat 
getFloat 
getDouble 
getBytes 
getBytes 
getDate 
getTime 
getTimestamp 
getClob 
getBlob 
getARRAY 
getRef 
getStruct 


日 期 和 时 间 数 据 类 型 : 


java.sql.Date 中 的 类 映射 到 SQL DATE 类 型 ， 以 及 java.sql.Time 和 
java.sql.Timestamp 类 映射 分 别 到 SQL TIME 和 SQL TIMESTAMP 数 据 类 型 。 


下 面 的 例子 显示 了 日 期 和 时 间 格 式 类 标准 的 Java 日 期 和 时 间 值 相 匹 配 的 SQL 数 据 类 
型 的 要 求 。 


import java.sql.Date; 
import java.sql.Time; 
import java.sql.Timestamp; 
import java.util.*; 


public class SqlDateTime { 
public static void main(String[] args) { 
//Get standard date and time 
java.util.Date javaDate - new java.util.Date(); 
long javaTime - javaDate.getTime(); 
System.out.println("The Java Date is:" + 
javaDate.toString()); 


//Get and display SQL DATE 

java.sql.Date sqlDate = new java.sql.Date(javaTime); 

System.out.println("The SQL DATE is: " + 
sqlDate.toString()); 


//Get and display SQL TIME 

java.sql.Time sqlTime = new java.sql.Time(javaTime) ; 

System.out.println("The SQL TIME is: " + 
sqlTime.toString()); 

//Get and display SQL TIMESTAMP 

java.sql.Timestamp sqlTimestamp = 

new java.sql.Timestamp(javaTime) ; 

System.out.println("The SQL TIMESTAMP is: " + 
sqlTimestamp.toString()); 

)//end main 

}//end SqlDateTime 


现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac SqlDateTime.java 
Ca 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java SqlDateTime 

The Java Date is:Tue Aug 18 13:46:02 GMT+04:00 2009 
The SQL DATE is: 2009-08-18 

The SQL TIME is: 13:46:02 

The SQL TIMESTAMP is: 2009-08-18 13:46:02.828 

C:> 


处 理 NULL 值 : 


SQL 使 用 NULL 值 和 Java 使 用 null 是 不 同 的 概念 。 那 么 ， 如 何 处 理 Java 中 的 SQL 
NULL 值 ?有 三 种 策略 可 以 使 用 : 


e. 避免 使 用 返回 原始 数据 类 型 的 getXXX() 方 法 


e S S 类 的 基本 数据 类 型 ， 并 使 用 ResultSet 对 象 的 wasNull() 方 法 来 测试 是 
是 收 到 getXXX() 方 法 返回 的 值 ， 包 装 类 变量 应 该 被 设置 为 null。 


e 使 用 原始 数据 类 型 和 ResultSet 对 象 的 wasNull() 方 法 来 测试 是 否 是 收 到 
getXXX() 方 法 返回 的 值 的 原始 变量 应 设置 为 你 已 经 选择 代表 一 个 NULL 可 接受 
的 值 。 


下 面 是 一 个 例子 来 处 理 NULL 值 : 


Statement stmt = conn.createStatement( ); 
String sql = "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sq1); 


int id = rs.getInt(1); 

HRSA iem JE 
id = 
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如 果 JDBC 和 连接 是 在 自动 提交 模式 下 ， 它 在 默认 情况 下 ， 那 么 每 个 SQL 语句 都 是 在 
其 完成 时 提交 到 数据 库 。 


这 可 能 是 对 简单 的 应 用 程序 ， 但 有 三 个 原因 ， 你 可 能 想 关 闭 自 动 提 交 和 管理 自己 的 
事务 : 


。 为 了 提高 性 能 
。 为 了 保持 业务 流程 的 完整 性 
。 使 用 分 布 式 事务 


若 要 控制 事务 ， 以 及 何 时 更 改 应 用 到 数据 库 。 它 把 单个 SQL 语句 或 一 组 SQL 语句 作 
为 一 个 逻辑 单元 ， 而 且 如 果 任 何 语句 失败 ， 整 个 事务 失败 。 


若 要 和 启用， 而 不 是 JDBC 驱 动 程序 默认 使 用 auto-commit 模 式 手 动 事务 支持 ， 使 用 


Connection 对 象 的 的 setAutoCommit() 方 法 。 如 果 传 递 一 个 布尔 值 false 到 
setAutoCommit()， 关 闭 自动 提交 。 可 以 传递 一 个 布尔 值 true 将 其 重新 打开 。 


例如 ， 如 果 有 一 个 名 为 conn Connection 对 象 ， 以 下 代码 来 关闭 自动 提交 : 


conn.setAutoCommit (false); 


提交 和 回 滚 


且 已 经 完成 了 变化 ， 要 提交 更 改 ， 然 后 调用 commit (在 连接 对 象 ) 方法 ， 如 下 所 


Al | 


conn.commit( ); 


否则 回 滚 更 新 对 数据 库 所 做 的 使 用 命名 连接 conn， 使 用 下 面 的 代码 : 


conn.rollback( ) 


下 面 的 例子 演示 了 如 何 使 用 一 个 提交 和 回 滚 对 象 : 


try{ 
//Assume a valid connection object conn 
conn.setAutoCommit (false); 
Statement stmt = conn.createStatement(); 


String SQL = "INSERT INTO Employees " + 
"VALUES (106, 20, 'Rita', 'Tez')"; 

stmt.executeUpdate(SQL); 

//Submit a malformed SQL statement that breaks 

String SQL = "INSERTED IN Employees " + 
"VALUES (107, 22, ‘Sita’, “Singh 

stmt.executeUpdate(SQL); 

// If there is no error. 

conn.commit(); 

}catch(SQLException se){ 
// If there is any error. 
conn.rollback(); 


} 


在 这 种 情况 下 没有 上 述 INSERT 语 句 会 成 功 ， 一 切 都 将 被 回 滚 。 
为 了 更 好 地 理解 ， 建 议 学 习 事务 提交 实例 代码 . 


使 用 保存 点 : 


新 的 JDBC3.0 保 存 点 的 接口 提供 了 额外 的 事务 控制 。 他 们 的 环境 中 ， 如 Oracle 的 
PL/ SQL 中 的 大 多 数 现代 的 DBMS 支 持 保 存 点 。 


当 设 置 一 个 保存 点 在 事务 中 定义 一 个 逻辑 回 滚 点 。 如 果 发 生 错 误 ， 过 去 一 个 保存 
点 ， 则 可 以 使 用 rollback 方 法 来 撤消 要 么 所 有 的 改变 或 仅 保存 点 之 后 所 做 的 更 改 。 


Connection 对 象 有 两 个 新 的 方法 ， 可 帮助 管理 保存 点 : 


e setSavepoint(String savepointName): 定义 了 一 个 新 的 保存 点 。 它 也 返回 一 个 
Savepoint 对 象 。 


e releaseSavepoint(Savepoint savepointName): 删除 一 个 保存 点 。 请 注意 ， 它 
需要 一 个 Savepoint 对 象 作为 参数 。 这 个 对 象 通常 是 由 setSavepoint() 方 法 生成 
一 个 保存 点 。 


有 一 个 rollback ( String savepointName ) 方法 回 滚 工 作 到 指定 的 保存 点 。 
下 面 的 例子 演示 如 何 使 用 Savepoint 对 象 : 


try{ 
//Assume a valid connection object conn 


conn.setAutoCommit (false); 
Statement stmt = conn.createStatement(); 


//set a Savepoint 
Savepoint savepointi = conn.setSavepoint("Savepoint1"); 
String SQL = "INSERT INTO Employees " + 

"VALUES (106, 20, 'Rita', 'Tez')"; 
stmt.executeUpdate(SQL); 
//Submit a malformed SQL statement that breaks 
String SQL = "INSERTED IN Employees " + 

"VALUES (107, 22, "Sita’, 'Tez')"; 
stmt.executeUpdate(SQL); 
// If there is no error, commit the changes. 
conn.commit(); 


}catch(SQLException se){ 


// If there is any error. 
conn.rollback(savepoint1); 


在 这 种 情况 下 没有 上 述 INSERT 语 句 会 成 功 ， 一 切 都 将 被 回 滚 。 
为 了 更 好 地 理解 ， 建 议 学 习 保存 点 实例 代码 . 
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异常 处 理 ， 可 以 处 理 在 一 个 受 控制 的 方式 异常 情况 ， 如 程序 定义 的 错误 。 

当 异 常情 况 发 生 时 ， 将 引发 异常 。 抛 出 这 个 词 意味 着 当前 执行 的 程序 停止 ， 并 控制 
被 重 定向 到 最 近 的 适用 的 catch 子 句 。 如 果 没 有 适用 catch 子 句 存在 ， 那 么 程序 的 执 
行 结束 。 


JDBC 的 异常 处 理 非 常 类 似 于 Java Excpetion 人 处 理 ， 但 对 于 JDBC， 最 常见 的 异常 处 
理 的 是 java.sql.SQLException. 


SQLException 方法 : 


SqlIException 异 常 可 以 在 驱动 程序 和 数据 库 出 现在 这 两 种 。 当 出 现 这 样 的 异常 时 ， 
抛 出 : SQLException 类 型 的 对 象 将 被 传递 到 catch 子 句 。 


传递 的 SQLException 对 象 具有 可 用 于 检索 有 关 异 常 的 附加 信息 下 面 的 方法 : 


方法 描述 
getErrorCode( ) 获取 与 异常 关联 的 错误 号 。 
获取 JDBC 驱 动 程序 的 错误 消息 由 驱动 程序 处 理 
getMessage( ) 错误 或 获取 Oracle 错 误 号 和 消息 的 一 个 数据 库 
错误 。 
获取 XOPEN SQLSTATES #2. %tFJDBC3R 
= Oo 人 ‘2 VL k =a : ; ~ 


回 。 对 于 一 个 数据 库 错 误 ， 则 返回 五 位 XOPEN 
SQLSTATE 人 代码。 这 种 方法 可 以 返回 null。 


getNextException( ) 获取 异常 链 的 下 一 个 Exception 对 象 。 
Wet a ue 其 回溯 到 标 ; 


printStackTrace(PrintStream 打印 此 抛 出 ， 


5 其 回溯 到 指定 的 打印 流 。 


ad aes 打印 此 抛 出 ， 其 回溯 到 指定 的 打印 写 入 。 
通过 利用 可 从 Exception 对 象 捕获 异常 的 信息 ， 并 适当 地 继续 运行 程序 。 这 里 是 一 个 
try 块 的 一 般 形式 为 : 


try { 
// Your risky code goes between these curly braces!!! 
j 


catch(Exception ex) { 
// Your exception handling code goes between these 
// curly braces, similar to the exception clause 
// in a PL/SQL block. 


} 

finally { 
// Your must-always-be-executed code goes between these 
// curly braces. Like closing database connection. 

} 


例如 : 
学 习 下 面 的 代码 示例 来 了 解 试 试 try.…catch...finally 块 的 使 用 。 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/EMP"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 
= "password"; 
public static void main(String[] args) { 
Connection conn = null; 
try{ 

//STEP 2: Register JDBC driver 

Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println("Connecting to database..."); 
conn - DriverManager.getConnection(DB URL,USER, PASS); 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 
Statement stmt = conn.createStatement(); 

String sql; 

sql = "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sql); 


//STEP 5: Extract data from result set 
while(rs.next()){ 
//Retrieve by column name 


int id rs.getInt("id"); 

int age rs.getInt("age"); 

String first - rs.getString("first"); 
String last - rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.printin(", Last: " + last); 


//STEP 6: Clean-up environment 
rs.close(); 
stmt.close(); 
conn.close(); 
jcatch(SQLException se)t{ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(conn!znull) 
conn.close(); 
jcatch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C> 


当 运 行 JDBCExample， 如 果 没 有 问题 它 会 产生 以 下 结果 ， 否 则 相应 的 错误 将 被 捕 
获 并 会 显示 错误 消息 : 


C:>java JDBCExample 

Connecting to database... 

Creating statement... 

ID: 100, Age: 18, First: Zara, Last: Ali 

ID: 101, Age: 25, First: Mahnaz, Last: Fatma 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
C:> 


试 试 上 面 的 例子 中 通过 传递 错误 的 数据 库 名 称 或 错误 的 用 户 名 或 密码 ， 并 检查 结 
果 。 
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批 人 处理 人 允许 将 相关 的 SQL 语 句 组 合成 一 个 批 处 理 和 一 个 调用 数据 库 提交 。 
当 一 次 发 送 多 个 SQL 语句 到 数据 库 ， 可 以 减少 通信 开销 的 数额 ， 从 而 提高 了 性 能 。 


e JDBC 驱 动 程序 不 需要 支持 此 功能 。 应 该 使 用 
DatabaseMetaData.supportsBatchUpdates() 方 法 来 确定 目标 数据 库 支 持 批 量 
更 新 处 理 。 如 果 你 的 JDBC 了 驱动 程序 支持 此 功能 的 方法 返回 true。 


声明 addBatch() 方 法 ，PreparedStatement 和 CallableStatement 用 于 各 个 语句 
添加 到 批 处 理 。executeBatch() 将 用 于 雇 动 所 有 组 合 在 一 起 的 语句 的 执行 。 


executeBatch() 将 返回 一 个 整数 数组 ， 数 组 中 的 每 个 元 素 代 表 了 各 自 的 更 新 语 
句 的 更 新 计数 。 


e 可 以 添加 语句 批量 处 理 ， 可 以 用 theclearBatch() 方 法 删除 它们 。 此 方法 删除 所 
有 已 添加 的 addBatch() 方 法 的 语句 。 但 是 ， 不 能 有 选择 性 地 选择 要 删除 的 语 
句 。 
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下 面 是 步 又， 使 用 批 处 理 使 用 说 明 书 对 象 的 典型 顺序 : 
e 使 用 createStatement() 方 法 创建 一 个 Statement 对 象 。 
e 设置 使 用 自动 提交 为 false， 使 用 setAutoCommit(). 
。 添加 任意 多 个 到 批量 使 用 addBatch SQL 语句 (上 创建 语句 对 象 ) 的 方法 。 
e 执行 使 用 executeBatch() 将 方法 上 创建 表 对 象 中 的 所 有 SQL 语句 。 
e 最 后 ， 提 交 使 用 commit() 方 法 的 所 有 更 改 。 


例如 : 


下 面 的 代码 段 提供 了 使 用 Statement 对 象 批量 更 新 中 的 一 个 例子 : 


// Create statement object 
Statement stmt = conn.createStatement(); 


// Set auto-commit to false 
conn.setAutoCommit (false); 


// Create SQL statement 

String SQL = "INSERT INTO Employees (id, first, last, age) " + 
"VALUES(200, 'Zia', 'Ali', 30)"; 

// Add above SQL statement in the batch. 

stmt.addBatch(SQL); 


// Create one more SQL statement 

String SQL = "INSERT INTO Employees (id, first, last, age) " + 
"VALUES(201, 'Raj', 'Kumar', 35)"; 

// Add above SQL statement in the batch. 

stmt.addBatch(SQL); 

// Create one more SQL statement 

String SQL = "UPDATE Employees SET age = 35 " + 
"WHERE id - 100"; 

// Add above SQL statement in the batch. 

stmt.addBatch(SQL); 


// Create an int[] to hold returned values 
int[] count = stmt.executeBatch(); 


//Explicitly commit statements to apply changes 
conn.commit(); 


为 了 更 好 地 理解 ， 建 议 学 习 研 究 JDBC 批 处 理 用 Statement 对 象 示 例 代码 . 


批 处 理 使 用 prepareStatement 结 果 对 象 : 


下 面 是 步骤 ， 使 用 批 处 理 用 prepareStatement 结 果 对 象 的 典型 顺序 : 
e 创建 SQL 语 句 的 占 位 符 。 
e 使 用 任 一 prepareStatement() 方 法 创建 prepareStatement 结 果 对 象 。 
e 设置 使 用 setAutoCommit() 自 动 提 交 为 false。 
e. 添加 任意 多 个 批量 使 用 addBatch SQL 语句 (上 创建 语句 对 象 ) 的 方法 。 
e 执行 使 用 executeBatch() 将 方法 上 创建 表 对 象 中 的 所 有 SQL 语句 。 
e 最 后 ， 提 交 使 用 commit() 方 法 的 所 有 更 改 。 
下 面 的 代码 段 提 供 了 使 用 prepareStatement 结 果 对 象 批量 更 新 的 一 个 例子 : 


// Create SQL statement 
String SQL = "INSERT INTO Employees (id, first, last, age) 
WVALUES(2, 2, 2, 2)": 


// Create PrepareStatement object 
PreparedStatemen pstmt = conn.prepareStatement (SQL); 


//Set auto-commit to false 
conn.setAutoCommit (false); 


// Set the variables 
pstmt.setInt( 1, 400 ); 
pstmt.setString( 2, "Pappu" 
pstmt.setString( 3, "Singh" 
pstmt.setInt( 4, 33 ); 

// Add it to the batch 
pstmt.addBatch(); 


~ 
~ xe 


// Set the variables 
pstmt.setInt( 1, 401 ); 
pstmt.setString( 2, "Pawan" 
pstmt.setString( 3, "Singh" 
pstmt.setInt( 4, 31 ); 

// Add it to the batch 
pstmt .addBatch(); 


SS 
Nm xe 


//add more batches 


//Create an int[] to hold returned values 
int[] count = stmt.executeBatch(); 


//Explicitly commit statements to apply changes 
conn.commit(); 


为 了 更 好 地 理解 ， 建 议 学 习 研 究 实例 代码 
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在 前 而 我 们 已 经 学 习 了 如 何 使 用 使 用 JDBC 存 储 过 程 ，JDBC Statements, AAT 
是 类 似 ， 但 它 会 妓 有 关 JDBC 的 SQL 转 义 语法 的 附加 信息 。 


正如 一 个 Connection 对 象 创建 Statement 和 PreparedStatement 对 象 ， 它 也 创造 了 
CallableStatement 对 象 这 将 被 用 来 执行 调用 数据 库存 储 过 程 。 


创建 CallableStatement 对 象 : 
假设 ， 需 要 执行 以 下 Oracle 存 储 过 程 : 


CREATE OR REPLACE PROCEDURE getEmpName 

(EMP_ID IN NUMBER, EMP_FIRST OUT VARCHAR) AS 
BEGIN 

SELECT first INTO EMP_FIRST 

FROM Employees 

WHERE ID = EMP ID; 
END; 


Xm: 上 面 已 经 写 过 Oracle 存 储 过 程 ， 但 我 们 正在 使 用 MySQL 数 据 库 ， 写 相同 的 存 
储 过 程 对 于 MySQL 如 下 ， 以 EMP 数 据 库 中 创建 它 : 


DELIMITER $$ 


DROP PROCEDURE IF EXISTS `EMP`.` getEmpName $$ 
CREATE PROCEDURE “EMP. getEmpName 

(IN EMP_ID INT, OUT EMP_FIRST VARCHAR(255) ) 
BEGIN 

SELECT first INTO EMP_FIRST 

FROM Employees 

WHERE ID = EMP ID; 
END $$ 


DELIMITER ; 


三 种 类 型 的 参数 有 : IN，OUT 和 INOUT。PreparedStatement 对 象 只 使 用 IN 参数 。 
CallableStatement 对 象 可 以 使 用 所 有 的 三 个 。 


这 里 是 每 个 定义 : 


参数 描述 


IN 它 的 值 是 在 创建 SQL 语句 时 未 知 的 参数 。 将 值 绑 定 到 setXXX () A 
法 的 参数 。 


OUT 其 值 是 由 它 返回 的 SQL 语句 提供 的 参数 。 你 从 OUT 参 数 的 
getXXX () 方法 检索 值 。 


INOUT 同时 提供 输入 和 输出 值 的 参数 。 绑 定 setXXX O 方法 的 变量 ， 并 和 与 
getXXX () 方法 检索 值 。 


下 面 的 代码 片段 显示 了 如 何 使 用 该 Connection.prepareCall () 方法 实例 化 基于 上 
述 存 储 过 程 CallableStatement 对 象 : 


CallableStatement cstmt = null; 


try ( 
String SQL = "(call getEmpName (?, ?)}"; 
cstmt = conn.prepareCall (SQL); 


} 

catch (SQLException e) { 
} 

finally { 

} 


String 变 量 的 SQL 表示 存储 过 程 ， 使 用 参数 占 位 符 。 


使 用 CallableStatement 对 象 是 使 用 PreparedStatement 对 象 。 必 须 将 值 绑 定 到 所 有 
的 参数 执行 该 语句 之 前 ， 否 则 将 收 到 一 个 SQLException。 


如 果 有 IN 参数 ， 只 要 按照 适用 于 PreparedStatement 对 象 相同 的 规则 和 技巧 ;使 用 对 
应 于 要 绑 定 Java 数 据 类 型 的 setXXX O 方法 。 


当 使 用 OUT 和 INOUT 参 数 就 必须 采用 额外 CallableStatement 方 法 的 
registerOutParameter () > registerOutParameter () 方法 JDBC 数 据 类 型 绑 定 到 
数据 类 型 的 存储 过 程 返 回 。 

一 旦 调用 存储 过 程 ， 用 getXXX O 方法 的 输出 参数 检索 值 。 这 种 方法 投射 SQL 类 型 
的 值 检 索 到 Java 数 据 类 型 。 


关闭 CallableStatement 对 象 : 


正如 关闭 其 他 Statement 对 象 ， 出 于 同 祥 的 原因 ， 也 应 该 关闭 CallableStatement 对 


o 


close () 方法 简单 的 调用 将 完成 这 项 工作 。 如 果 关 闭 了 Connection 对 象 首先 它 会 
闭 CallableStatement 对 象 为 好 。 然 而 ， 应 该 始终 明确 关闭 的 CallableStatement 对 
象 ， 以 确保 正确 的 清除 。 


CallableStatement cstmt = null; 


try { 
String SQL = "(call getEmpName (?, ?)}"; 
cstmt = conn.prepareCall (SQL); 


} 
catch (SQLException e) { 


} 

finally { 
cstmt.close(); 

} 


为 了 更 好 地 理解 ， 建 议 研 究 学 习 Callable 实 例 代 三 . 


JDBC 的 SQL 转 义 语法 : 


转 义 语 法 使 能 够 使 用 通过 使 用 标准 的 JDBC 方 法 和 属性 ， 无 法 使 用 数据 库 的 某 些 特 
性 的 灵活 性 。 


一 般 的 SQL 转 义 语法 格式 如 下 : 


{keyword 'parameters') 
这 里 有 以 下 这 些 ， 会 发 现 非 常 有 用 的 ， 而 这 样 做 的 JDBC 编 程 的 转 义 序列 : 


d, t, ts 关键 字 : 
他 们 帮助 确定 日 期 ， 时 间 和 时 间 和 戳记 文字 。 如 所 知 ， 没 有 两 个 数据 库 管理 系统 是 基 


于 时 间 和 日 期 的 方式 相同 。 此 转 义 语法 告诉 驱动 程序 呈现 在 目标 数据 库 的 格式 ， 日 
期 或 时 间 。 实 现 例子 


(d 'yyyy-mm-dd' } 
其 中 yyyy= 年 ，mm = 月 ，DD = 日 。 使 用 这 种 语法 (d '2009-09-03'3220094F3 H 9 


o 


下 面 是 一 个 简单 的 例子 说 明 如 何 插入 日 期 表 : 


//Create a Statement object 
stmt = conn.createStatement(); 
//Insert data ==> ID, First Name, Last Name, DOB 
String sql="INSERT INTO STUDENTS VALUES" + 
"(100, Zara’, "Ala", {d '2001-12-16'})"; 


stmt .executeUpdate(sql); 

同样 ， 可 以 使 用 以 下 两 种 语法 之 一 ， 无 论 是 t 或 ts : 
{t 'hh:mm:ss'} 

其 中 hh= 小 时 ，mm= 分 ，ss= 秒 。 使 用 此 语法 ft'13:30:291 是 下 午 1 点 三 十 分 29 秒 . 
{ts 'yyyy-mm-dd hh:mm:ss'} 

这 是 上 述 两 种 语法 'd' 和 + EX HEUS. 


escape 天 键 字 : 


该 关键 字 标 识 LIKE 子 句 中 使 用 的 转 义 字符 。 有 用 使 用 SQL 通配符 %， 其 中 匹配 雪 个 
或 多 个 字符 时 。 例 如 : 


String sql = "SELECT symbol FROM MathSymbols 
WHERE symbol LIKE '\%' {escape ''}"; 
stmt.execute(sq1); 


如 果 使 用 反 斜 杠 字符 O 作为 转 义 字符 ， 还 必须 使 用 两 个 反 斜 杠 字符 在 Java 字 符 串 
字面 ， 因 为 反 斜 杠 也 是 一 个 Java 转 义 字 符 。 


fn KiF: 


此 关键 字 代 表 在 DBMS 中 使 用 标量 函 数 。 例 如 ， 可 以 使 用 SQL lengthy it AGES 
符 串 的 长 度 : 


(fn length('Hello World')) 
这 将 返回 11， 字 符 串 'Hello World' 的 长 度 。. 


call KiF: 


此 关键 字 是 用 来 调用 存储 过 程 。 例 如 ， 对 于 一 个 存储 过 程 ， 需 要 一 个 IN 参数 ， 请 使 
用 以 下 语法 : 


{call my_procedure(?)}; 


对 于 一 个 存储 过 程 ， 需 要 一 个 IN 参数 并 返回 一 个 OUT 参 数 ， 使 用 下 面 的 语法 : 


{? = call my_procedure(?)}; 


oj 关键 字 : 
此 关键 字 用 来 表示 外 部 联接 。 其 语法 如 下 : 


{oj outer-join} 


外 连接 表 ={LEFT| RIGHT| FULL} 外 连接 { 表 | 外 连接 } 的 搜索 条 件 。 例 如 : 


String sql = "SELECT Employees 

FROM {oj ThisTable RIGHT 

OUTER JOIN ThatTable on id = '100'}"; 
stmt.execute(sql); 


JDBC 流 ASCII 和 二 进 制 数据 - JDBC 教 程 


PreparedStatement 对 象 必 须 使 用 输入 和 输出 流 提供 参数 数据 的 能 力 。 这 使 能 够 将 
整个 文件 到 数据 库 列 ， 可 容纳 较 大 的 值 ， 如 CLOB 和 BLOB 数 据 类 型 


有 下 列 方法 ， 可 用 于 将 数据 传送 
e setAsciiStream(): 这 个 方法 是 用 来 提供 大 的 ASCII 值 。 
e setCharacterStream(): 这 个 方法 是 用 来 提供 大 的 UNICODE 值 。 
e setBinaryStream(): 这 个 方法 是 用 来 提供 大 的 二 进 制 值 。 


setXXXStream() 方 法 需要 一 个 额外 的 参数 ， 文件 大 小 ， 除 了 参数 占 位 符 。 这 个 参数 
通知 驱动 有 多 少数 据 要 使 用 的 流 被 发 送 到 数据 库 中 。 


例子 


考虑 到 要 上 传 一 个 XML 文 件 XML_Data.xml 到 数据 库 表 。 下 面 是 这 个 XML 文 件 的 内 
T: 


<?xml version="1.0"?> 
<Employee> 
<id>100</id> 
<first>Zara</first> 
<last>Ali</last> 
<Salary>10000</Salary> 
<Dob>18 -08-1978</Dob> 
<Employee> 


保持 这 个 XML 文件 在 要 运行 这 个 例子 相同 的 目录 。 
这 个 例子 将 创建 一 个 数据 库 表 XML_Data， 然 后 提交 XML_Data.xml 特 被 上 传 到 该 表 


o 


复制 下 面 的 例子 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


// Import required packages 
import java.sql.*; 

import java.io.*; 

import java.util.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB URL = "jdbc:mysql://localhost/EMP"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 
= "password"; 
public static void main(String[] args) { 
Connection conn = null; 
PreparedStatement pstmt = null; 
Statement stmt = null; 
ResultSet rs = null; 
try{ 
// Register JDBC driver 
Class. forName("com.mysql.jdbc.Driver"); 


// Open a connection 
System.out.println("Connecting to database..."); 
conn = DriverManager.getConnection(DB URL,USER, PASS) ; 


//Create a Statement object and build table 
stmt = conn.createStatement(); 
createXMLTable(stmt); 


//Open a FileInputStream 

File f = new File("XML Data.xml"); 

long fileLength = f.length(); 

FileInputStream fis = new FilelInputStream(f); 


//Create PreparedStatement and stream data 
String SQL - "INSERT INTO XML Data VALUES (?,?)"; 
pstmt = conn.prepareStatement(SQL); 
pstmt.setInt(1,100); 
pstmt.setAsciiStream(2,fis,(int)fileLength); 
pstmt.execute(); 


//Close input stream 
fis.close(); 


// Do a query to get the row 
SQL - "SELECT Data FROM XML Data WHERE id-100"; 
rs - stmt.executeQuery (SQL); 
// Get the first row 
if (rs.next ())( 
//Retrieve data from input stream 
InputStream xmlInputStream = rs.getAsciiStream (1); 


BIEN: 
ByteArrayOutputStream bos = new ByteArrayOutputStream(); 
while (( c = xmlInputStream.read ()) != -1) 


bos.write(c); 
//Print results 
System.out.println(bos.toString()); 
} 
// Clean-up environment 
rs.close(); 
stmt.close(); 


pstmt.close(); 
conn.close(); 
}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
stmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(pstmt!-null) 
pstmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(conn!znull) 
conn.close(); 
jcatch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 


public static void createXMLTable(Statement stmt) 
throws SQLException{ 
System.out.println("Creating XML Data table..." ); 
//Create SQL Statement 
String streamingDataSql = "CREATE TABLE XML Data " + 
"(id INTEGER, Data LONG)"; 
//Drop table first if it exists. 
tryt 
stmt.executeUpdate("DROP TABLE XML Data"); 
jcatch(SQLException se){ 
)// do nothing 
//Build table. 
stmt.executeUpdate(streamingDataSql); 
)//end createXMLTable 
}//end JDBCExample 
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现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C:> 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 
Connecting to database... 
Creating XML Data table... 
<?xml version="1.0"?> 
<Employee> 

<id>100</id> 
<first>Zara</first> 
<last>Ali</last> 
<Salary>10000</Salary> 
<Dob>18 -08-1978</Dob> 
<Employee> 

Goodbye! 

Ci 


JDBC Statement 对 象 实例 - JDBC 教 程 


以 下 是 利用 以 下 三 种 查询 以 及 打开 和 关闭 说 明 的 例子 : 


e boolean execute(String SQL) : 返回 一 个 布尔 值 true， 如 果 ResultSet 对 象 可 
以 被 检索 ， 否 则 返回 false。 使 用 这 个 方法 来 执行 SQL DDL 语 句 ， 或 当 需要 使 用 
真正 的 动态 SQL。 


e int executeUpdate(String SQL) : 返回 受 影响 的 SQL 语句 执行 的 行 数 。 使 用 此 
方法 来 执行 ， 而 希望 得 到 一 些 受 影响 的 行 的 SQL 语句 - 例如 ，INSERT， 
UPDATE 或 DELETE 语 句 。 


e ResultSet executeQuery(String SQL) : 返回 ResultSet 对 象 。 当 希望 得 到 一 
个 结果 集 使 用 此 方法 ， 就 像 使 用 一 个 SELECT 语句 。 


基于 对 环境 和 数据 库 安 装 在 前 面 的 章节 中 做 此 示例 代码 已 被 守 入 。 
复制 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB URL = "jdbc:mysql://localhost/EMP"; 


// Database credentials 
static final String USER 
static final String PASS 


- "username"; 
- "password"; 
public static void main(String[] args) { 
Connection conn - null; 
Statement stmt - null; 
try{ 

//STEP 2: Register JDBC driver 

Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println("Connecting to database..."); 
conn - DriverManager.getConnection(DB URL,USER, PASS); 


//STEP 4: Execute a query 

System.out.println("Creating statement..."); 

stmt = conn.createStatement(); 

String sql - "UPDATE Employees set age-30 WHERE id-103"; 


// Let us check if it returns a true Result Set or not. 
Boolean ret = stmt.execute(sql); 


System.out.println("Return value is : " + ret.toString() ); 


// Let us update age of the record with ID - 103; 
int rows = stmt.executeUpdate(sql); 
System.out.println("Rows impacted : " + rows ); 


// Let us select all the records and display them. 
sql = "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sql); 


//STEP 5: Extract data from result set 
while(rs.next())( 
//Retrieve by column name 
int id - rs.getInt("id"); 
int age - rs.getInt("age"); 
String first - rs.getString("first"); 
String last - rs.getString("last"); 


//Display values 
System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 
} 
//STEP 6: Clean-up environment 
rs.close(); 
stmt.close(); 
conn.close(); 
jcatch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
stmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


n "- es 








现在 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C> 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 

Connecting to database... 

Creating statement... 

Return value is : false 

Rows impacted : 1 

ID: 100, Age: 18, First: Zara, Last: Ali 

ID: 101, Age: 25, First: Mahnaz, Last: Fatma 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 30, First: Sumit, Last: Mittal 
Goodbye! 

C:> 


JDBC 创 建 数据 库 实例 - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 数据 库 的 例子 。 执 行 下面 的 示例 之 前 ， 请 确 
保 已 到 位 如 下 : 


e 应 该 有 管理 员 特 权 ， 在 给 定 的 模式 创建 一 个 数据 库 。 执 行 下 面 的 例子 中 ， 需 要 
与 实际 用 户 名 和 密码 代替 用 户 名 和 密码 。 


e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 的 是 启动 和 运行 。 


所 需 的 步骤 : 


有 创建 使 用 JDBC 占 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e 导 人 数据 包 . 要 求 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情 况 
下 ， 使 用 导入 的 java.sql.* 就 足够 了 。 


注册 JDBC 了 驱动 程序 . 要 求 初始 化 驱动 程序 ， 使 可 以 与 数据 库 打开 一 个 通信 通 


道 。 


打开 连接 . 要 求 使 用 DriverManager.getConnection() 方 法 创建 一 个 Connection 
对 象 ， 它 代表 datbase 服 务 器 的 物理 连接 。 


要 创建 一 个 新 的 数据 库 ， 不 用 给 任何 数据 库 名 ， 同 时 准备 数据 库 URL 中 所 提 到 
的 下 面 的 例子 。 


执行 查询 . 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语 句 到 数据 库 。 
清理 环境 . 需要 明确 地 关闭 所 有 的 数据 库 资源 与 依靠 JVM 垃 圾 收集 。 


示例 代码 : 
复制 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/"; 


// Database credentials 
static final String USER 
static final String PASS 


"username"; 
"password"; 


public static void main(String[] args) 


~ 


Connection conn = null; 
Statement stmt = null; 
try{ 
//STEP 2: Register JDBC driver 
Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println("Connecting to database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 


//STEP 4: Execute a query 
System.out.println("Creating database..."); 
stmt = conn.createStatement(); 


String sql - "CREATE DATABASE STUDENTS"; 
stmt.executeUpdate(sql); 
System.out.println("Database created successfully..."); 
jcatch(SQLException se)t{ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
stmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(conn!-znull) 
conn.close(); 
}catch(SQLException se)t{ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C:> 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 
Connecting to database... 
Creating database... 


Database created successfully... 


Goodbye! 
Ce 


JDBC 选 择 数 据 库 实例 - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 选择 一 个 数据 库 的 例子 。 执 行 下 面 的 示例 之 
前 ， 请 确保 已 做 好 如 下 工作 : 
e 执行 下 面 的 例子 中 ， 需 要 使 用 实际 用 户 名 和 密码 代替 username 和 password。 
e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 (启动 和 和 运行)。 


所 需 的 步骤 : 


创建 使 用 JDBC 应 用 程序 访问 数据 库 需 要 执行 以 下 步 又 : 


e 导 人 数据 包 . 要 求 包 括 含 有 需要 进行 数据 库 编程 的 JDBC 类 包 。 大 多 数 情况 
下 ， 使 用 import java.sql.* 就 足够 了 。 


注册 JDBC 驱 动 程 序 . 要 求 初始 化 驱动 程序 ， 从 而 可 以 与 数据 库 打开 一 个 通信 


打开 连接 . 使 用 DriverManager.getConnection() 方 法 创建 一 个 Connection 对 
象 ， 它 代表 使 用 所 选 (selected) 数据 库 的 物理 连接 。 


选择 数据 库 时 ， 准 各 数据库 URL。 下 面 的 例子 会 让 STUDENTS 数 据 库 连 接 。 
清理 环境 . 需要 明确 地 关闭 所 有 的 数据 库 资 源 相 对 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 


复制 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


- "username"; 
- "password"; 
public static void main(String[] args) { 
Connection conn = null; 
try{ 

//STEP 2: Register JDBC driver 

Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println( "Connecting to a selected database..."); 
conn = DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 
jcatch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se)( 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


a C E 
现在 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
Ce> 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 


Connecting to a selected database... 


Connected database successfully... 
Goodbye! 
er 


JDBC 删 除 /Delete 效 据 库 实例 - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 来 删除 一 个 现 有 数据 库 的 例子 。 执 行 下 面 的 
示例 之 前 ， 靖 确保 如 下 : 
e 执行 下 面 的 例子 中 ， 需 要 使 用 实际 用 户 名 和 密码 代替 username 和 password。 
e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 
注意 : 这 是 一 个 严重 的 操作 ， 数 据 库 中 拥有 的 一 切 将 会 丢失 。 


所 需 步 又 


有 创建 使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步 又 : 


e 导 人 数据 包 : 要 求 包 括 含 有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情 况 
下 ， 使 用 import java.sql.* 就 可 以 了 . 


注册 JDBC 驱 动 程 序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打开 一 个 通信 


e 打开 一 个 连接 : 要 求 中 使 用 DriverManager.getConnection() 方 法 创建 一 
Connection 对 象 ， 它 代表 与 数据 库 服务 器 的 物理 连接 。 


删除 一 个 数据 库 不 需要 数据 库 名 称 在 数据 库 URL。 下 面 的 例子 将 删除 
STUDENTS 数 据 库 。 


e 执行 查询 : 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语句 来 删除 数据 库 。 
清理 环境 . 需要 明确 地 关闭 所 有 的 数据 库 资 源 相 对 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 


复制 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/"; 


// Database credentials 
static final String USER 
static final String PASS 


"username"; 
"password"; 


public static void main(String[] args) { 
Connection conn = null; 
Statement stmt = null; 
try{ 
//STEP 2: Register JDBC driver 
Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn = DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Deleting database..."); 
stmt = conn.createStatement(); 


String sql - "DROP DATABASE STUDENTS"; 
stmt.executeUpdate(sql); 
System.out.println("Database deleted successfully..."); 
jcatch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
conn.close(); 
}catch(SQLException se)( 
}// do nothing 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
)//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


SS e: i 
现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
Cr 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 


Connecting to a selected database... 


Connected database successfully... 
Deleting database... 

Database deleted successfully... 
Goodbye! 

C:> 


JDBC 4] 2X/Create 3: | - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 来 创建 表 的 例子 。 执 行 下 面 的 示例 之 前 ， 请 
确保 已 做 好 如 下 : 


e 执行 下 面 的 例子 中 ， 你 可 以 与 你 的 实际 的 用 户 名 和 密码 代替 user name 和 
password。 


e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 的 步骤 : 


使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e 导 人 数据 包 : 要 求 包 括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情况 
下 ， 使 用 import java.sql.* 就 可 以 了 . 


注册 JDBC 驱 动 程序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打开 一 个 通信 通 


道 。 


打开 连接 : 要 求 中 使 用 DriverManager.getConnection() 方 法 创建 一 个 
Connection 对 象 ， 它 代表 与 数据 库 服务 器 的 物理 连接 。 


“ 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语句 在 人 围 数据 库 中 
创建 表 。 


清理 环境 . 需要 明确 地 关闭 所 有 的 数据 库 资源 相对 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 


复制 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 

= "password"; 
public static void main(String[] args) { 
Connection conn = null; 


Statement stmt = null; 
try{ 
//STEP 2: Register JDBC driver 
Class .forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn = DriverManager.getConnection(DB_URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Creating table in given database..."); 
stmt = conn.createStatement(); 


String sql = "CREATE TABLE REGISTRATION " + 
"(id INTEGER not NULL, " + 
" first VARCHAR(255), " + 
" last VARCHAR(255), " + 
" age INTEGER, " + 
" PRIMARY KEY ( id ))"; 


stmt.executeUpdate(sql); 
System.out.println("Created table in given database..."); 
}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!znull) 
conn.close(); 
}catch(SQLException se)( 
)// do nothing 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 
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现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
(5H 25 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 


Connecting to a selected database... 


Connected database successfully... 


Creating table in given database... 


Created table in given database... 
Goodbye! 
CS 


JDBC 人 删除 /Delete 表 实例 - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 点 用 程序 来 删除 一 个 表 中 的 一 个 例子 。 执 行 下 面 的 示 
例 之 前 ， 请 确保 已 经 做 好 如 下 : 

e 执行 下 面 的 例子 中 ， 使 用 实际 的 用 户 名 和 密码 代 蔡 username 和 password。 

e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


注 : 这 是 一 个 严重 的 操作 ， 在 删除 一 个 表 前 ， 要 注意 表 中 的 数据 备份 ， 一 旦 删除 
表 ， 表 中 的 数据 将 消失 。 


所 需 的 步骤 : 


创建 使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e SARE : 要 求 包 括 含 有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情况 
下 ， 使 用 import java.sql.* 就 可 以 了 . 


注册 JDBC 驱 动 程 序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打开 一 个 通信 


e 打开 一 个 连接 : 要 求 使 用 DriverManager.getConnection() 方 法 创建 一 个 
Connection 对 象 ， 它 代表 与 数据 库 服 务 器 的 物理 连接 。 


e 执行 查询 : 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语句 在 所 选择 的 数据 
库 中 删除 表 。 


清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资 源 相 对 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 
复制 过 去 下 面 的 例子 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


"username"; 
"password"; 


public static void main(String[] args) 


~ 


Connection conn = null; 

Statement stmt = null; 

tryt 
//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Deleting table in given database..."); 
stmt = conn.createStatement(); 


String sql - "DROP TABLE REGISTRATION "; 


stmt.executeUpdate(sql); 
System.out.println("Table deleted in given database..."); 
}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
}catch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
conn.close(); 
}catch(SQLException se)( 
}// do nothing 
tryt 
if(conn!znull) 
conn.close(); 
jcatch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 
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现在 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
Cr 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 


Connecting to a selected database... 


Connected database successfully... 


Deleting table in given database... 
Table deleted in given database... 


Goodbye! 
C:> 


JDBC 插 入 /Insert 记录 示例 - IDBCATE 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 中 插入 表 中 的 记录 的 例子 。 执 行 下 面 的 示例 
之 前 ， 请 确保 如 下 : 
e 执行 下 面 的 例子 ， 需 要 使 用 实际 的 用 户 名 和 密码 代替 username 和 password。 
e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 的 步骤 : 


创建 使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e 导 人 数据 包 : 要 求 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情 况 
下 ， 使 用 import java.sql.* 就 可 以 了 。 


注册 JDBC 驱 动 程序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打开 一 个 通信 


e 打开 一 个 连接 : 要 求 中 使 用 DriverManager.getConnection() 方 法 创建 一 个 
Connection 对 象 ， 它 代表 与 数据 库 服 务 器 的 物理 连接 。 


e 执行 查询 : 需要 使 用 类 型 Statement 对 象 建立 并 提交 一 个 SQL 语句 将 记 录 插 和 人 
到 表 中 。 


清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资源 相对 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 
复制 过 去 下 面 的 例子 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 

= "password"; 
public static void main(String[] args) { 
Connection conn = null; 

Statement stmt = null; 

try{ 


//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Inserting records into the table..."); 
stmt = conn.createStatement(); 


String sql = "INSERT INTO Registration " + 

"VALUES (100, '"Zara', 'Ali', 18)"; 
stmt.executeUpdate(sql); 
sql = "INSERT INTO Registration " + 

"VALUES (101, 'Mahnaz', 'Fatma', 25)"; 
stmt.executeUpdate(sql); 
sql = "INSERT INTO Registration " + 

"VALUES (102, 'Zaid', 'Khan', 30)"; 
stmt.executeUpdate(sql); 
sql = "INSERT INTO Registration " + 

"VALUES(103, 'Sumit', 'Mittal', 28)"; 
stmt.executeUpdate(sql); 
System.out.println("Inserted records into the table..."); 


}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 

jcatch(Exception e){ 

//Handle errors for Class.forName 
e.printStackTrace(); 

}finally{ 

//finally block used to close resources 
tryt 
if(stmt!-null) 
conn.close(); 
}catch(SQLException se){ 
)// do nothing 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 
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现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
(5H 25 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 


Connecting to a selected database... 


Connected database successfully... 


Inserting records into the table... 


Inserted records into the table... 
Goodbye! 
CES 


JDBC & i4Selectiz x: x: Hl - JDBC 教 程 
KAEM T 418) 34 4#/select/(# FH JDBC © FH Fe M — T jk Boe 3k BU. 3A 
行 下 面 的 示例 之 前 ， 请 确保 如 下 : 

e 执行 下 面 的 例子 中 ， 使 用 实际 的 用 户 名 和 密码 代 蔡 username 和 password。 

e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 的 步 


创建 使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


。 导 人 数据 包 : 要 求 您 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情 
况 下 ， 使 用 import java.sql.* 就 可 以 了 。 


注册 JDBC 驱 动 程序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 数据 库 打开 一 个 通信 通 


道 。 


e 打开 一 个 连接 : 要 求 中 使 用 DriverManager.getConnection() 方 法 创建 一 
Connection 对 象 ， 它 代表 与 数据 库 服 务 器 的 物理 连接 。 


e 执行 一 个 查询 : 需要 使 用 Statement 类 型 对 象 ， 并 提交 一 个 SQL 语句 来 选择 
( 即 取 ) 从 表 中 的 记录 。 


提取 数据 : 当 SQL 查 询 执 行 时 ， 可 以 从 表 中 提取 记录 。 
清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资源 ， 不 用 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 
复制 过 去 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 

= "password"; 
public static void main(String[] args) { 
Connection conn = null; 


Statement stmt = null; 

try{ 
//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 
stmt = conn.createStatement(); 


String sql - "SELECT id, first, last, age FROM Registration", 
ResultSet rs = stmt.executeQuery(sql); 
//STEP 5: Extract data from result set 
while(rs.next())( 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age - rs.getInt("age"); 
String first - rs.getString("first"); 
String last - rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.printin(", Last: " + last); 


rs.close(); 
}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
conn.close(); 
jcatch(SQLException se){ 
}// do nothing 
tryt 
if(conn!znull) 
conn.close(); 
jcatch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 


}//end JDBCExample 
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现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C:> 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 

Connecting to a selected database... 
Connected database successfully... 

Creating statement... 

ID: 100, Age: 18, First: Zara, Last: Ali 

ID: 101, Age: 25, First: Mahnaz, Last: Fatma 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
Goodbye! 

C:> 
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本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 更 新 表 中 的 记录 的 一 个 例子 。 执 行 下 面 的 示 
例 之 前 ， 请 确保 如 下 : 

e 执行 下 面 的 例子 中 ， 使 用 实际 的 用 户 名 和 密码 代 蔡 username 和 password。 

e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 的 步骤 : 


创建 使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e $A: 要 求 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情况 下 ， 
使 用 import java.sql.* 就 可 以 了 。 


注册 JDBC 了 驱动 程序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打 开 一 个 通信 


e 打开 一 个 连接 : 要 求 使 用 DriverManager.getConnection() 方 法 创建 一 个 
Connection 对 象 ， 它 代表 与 数据 库 服务 器 的 物理 连接 。 


e 执行 一 个 查询 : 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语句 来 更 新 表 中 
的 记录 。 这 个 查询 利用 IN 的 和 WHERE 子 句 来 更 新 条 件 的 记录 。 


清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资源 相对 于 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 
复制 过 去 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 

= "password"; 
public static void main(String[] args) { 
Connection conn = null; 

Statement stmt = null; 

try{ 


//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 
stmt = conn.createStatement(); 
String sql = "UPDATE Registration " + 

"SET age - 30 WHERE id in (100, 101)"; 
stmt.executeUpdate(sql); 


// Now you can extract all the records 

// to see the updated records 

sql = "SELECT id, first, last, age FROM Registration"; 
ResultSet rs = stmt.executeQuery(sql); 


while(rs.next()){ 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


rs.close(); 
}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
try{ 
if(stmt!-null) 
conn.close(); 
jcatch(SQLException se){ 
)// do nothing 
try{ 
if(conn!znull) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 


}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 
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现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C= 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 

Connecting to a selected database... 
Connected database successfully... 

Creating statement... 

ID: 100, Age: 30, First: Zara, Last: Ali 

ID: 101, Age: 30, First: Mahnaz, Last: Fatma 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
Goodbye! 

C:> 


JDBC ti kR/Deleteiz x zn - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 的 表 删 除 记 录 的 例子 。 执 行 下 面 的 示例 之 
前 ， 请 确保 以 下 : 
e 执行 下 面 的 例子 中 ， 使 用 实际 的 用 户 名 和 密码 代 蔡 username 和 password。 
e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 的 步骤 : 


创建 使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e $A: 要 求 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情况 下 ， 
使 用 import java.sql.* 就 可 以 了 。 


注册 JDBC 驱 动 程序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打开 一 个 通信 


e 打开 一 个 连接 : 要 求 使 用 DriverManager.getConnection() 方 法 创建 一 个 
Connection 对 象 ， 它 代表 与 数据 库 服 务 器 的 物理 连接 。 


e 执行 一 个 查询 : 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语句 从 表 中 删除 
记录 。 这 使 得 查询 使 用 WHERE 子 句 来 删除 条 件 的 记录 。 


清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资源 相对 于 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 


复制 过 去 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 

= "password"; 
public static void main(String[] args) { 
Connection conn = null; 

Statement stmt = null; 

try{ 


//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 

System.out.println("Creating statement..."); 

stmt = conn.createStatement(); 

String sql = "DELETE FROM Registration " + 
"WHERE id - 101"; 

stmt.executeUpdate(sql); 


// Now you can extract all the records 

// to see the remaining records 

sql = "SELECT id, first, last, age FROM Registration"; 
ResultSet rs = stmt.executeQuery(sql); 


while(rs.next()){ 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


rs.close(); 
}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
try{ 
if(stmt!-null) 
conn.close(); 
jcatch(SQLException se){ 
)// do nothing 
try{ 
if(conn!znull) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 


}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


E 








现在 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C= 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 

Connecting to a selected database... 
Connected database successfully... 

Creating statement... 

ID: 100, Age: 30, First: Zara, Last: Ali 

ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
Goodbye! 

C2 


JDBC WHERE 7 ^J i: f| - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 表 中 选择 记录 的 一 个 例子 。 这 将 使 用 WHERE 
T, 而 从 表 中 选择 记录 添加 附加 条 件 。 执行 下 面 的 示例 之 前 ， 请 确保 如 下 : 

e 执行 下 面 的 例子 中 ， 使 用 实际 的 用 户 名 和 密码 代 蔡 username 和 password。 

e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 的 步 


创建 使 用 JDBC 应 用 程序 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e 导 人 包 : 要 求 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情 况 下 ， 

使 用 import java.sal.* 。 

S CODE UIS : 要 求 初始 化 驱动 程序 ， 使 可 以 与 数据 库 打 开 一 个 通信 通 

2E. 

e 打开 一 个 连接 : 要 求 使 用 DriverManager.getConnection() 方 法 创建 一 
Connection 对 象 ， 它 代表 与 数据 库 服务 器 的 物理 连接 。 


e 执行 一 个 查询 : 需要 使 用 类 型 声明 的 对 象 建立 并 提交 一 个 SQL 语句 从 符合 
条 件 的 表 获 取 记 录 。 查 询 使 用 WHERE 子 句 来 查询 记录 。 


清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资 源 相 对 于 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 
复制 过 去 的 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


- "username"; 

- "password"; 
public static void main(String[] args) { 
Connection conn - null; 

Statement stmt - null; 

try{ 


//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 
stmt = conn.createStatement(); 


// Extract records without any condition. 
System.out.println("Fetching records without condition..."); 
String sql - "SELECT id, first, last, age FROM Registration", 
ResultSet rs = stmt.executeQuery(sql); 


while(rs.next())( 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.printin(", Last: " + last); 


j 
// Select all records having ID equal or greater than 101 
System.out.println("Fetching records with condition..."); 


sql = "SELECT id, first, last, age FROM Registration" + 
" WHERE id >= 101 "; 
rs - stmt.executeQuery(sq1); 


while(rs.next())( 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.printin(", Last: " + last); 


rs.close(); 
}catch(SQLException se){ 
//Handle errors for JDBC 


se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
try{ 
if(stmt!-null) 
conn.close(); 
}catch(SQLException se){ 
}// do nothing 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se)( 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


d RI 
现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
C:> 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 

Connecting to a selected database... 
Connected database successfully... 

Creating statement... 

Fetching records without condition... 

ID: 100, Age: 30, First: Zara, Last: Ali 

ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
Fetching records with condition... 

ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
Goodbye! 

C:> 


JDBC LIKE 子 名 实例 - JDBC 教 程 
本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 表 中 选择 记录 的 一 个 例子 。 这 里 使 用 LIKE 子 
句 ， 而 从 表 中 选择 记录 添加 附加 条 件 。 执 行 下 面 的 示例 之 前 ， 请 确保 如 下 : 
e 执行 下 面 的 例子 中 ， 请 使 用 实际 的 用 户 名 和 密码 代替 username 和 password。 
e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 步 骤 : 


使 用 JDBC 应 用 程序 创建 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 
e $A: 要 求 包括 含有 需要 进行 数据 库 编程 的 JDBC 类 的 包 。 大 多 数 情况 下 ， 
使 用 import java.sql.* 。 
注册 JDBC 了 驱动 程序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打 开 一 个 通信 
e 打开 一 个 连接 : 要 求 使 用 DriverManager.getConnection() 方 法 创建 一 个 
Connection 对 象 ， 它 代表 与 数据 库 服 务 器 的 物理 连接 。 


e 执行 一 个 查询 : 需要 使 用 类 型 Statement 对 象 建 立 并 提交 一 个 SQL 语句 从 符合 
给 定 条 件 的 表 获 取 记 录 。 这 使 得 查询 使 用 LIKE 子 句 来 选择 记录 选择 所 有 名 字 以 
"za" 开始 的 学 生 。 


清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资 源 相 对 于 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 
复制 过 去 的 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 

= "password"; 
public static void main(String[] args) { 
Connection conn = null; 


Statement stmt = null; 
try{ 
//STEP 2: Register JDBC driver 
Class. forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 
stmt = conn.createStatement(); 


// Extract records without any condition. 
System.out.println("Fetching records without condition..."); 
String sql - "SELECT id, first, last, age FROM Registration", 
ResultSet rs = stmt.executeQuery(sql); 


while(rs.next()){ 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


j 
// Select all records having ID equal or greater than 101 
System.out.println("Fetching records with condition..."); 


sql = "SELECT id, first, last, age FROM Registration" + 
" WHERE first LIKE '%za%' "; 
rs - stmt.executeQuery(sq1); 


while(rs.next())( 
//Retrieve by column name 
int id - rs.getInt("id"); 
int age = rs.getInt("age"); 
String first - rs.getString("first"); 
String last - rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


rs.close(); 


}// 
}// 


II MR ON: 


}catch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 

jcatch(Exception e){ 

//Handle errors for Class.forName 
e.printStackTrace(); 

}finally{ 

//finally block used to close resources 
tryt 
if(stmt!-null) 
conn.close(); 
}catch(SQLException se){ 
}// do nothing 
tryt 
if(conn!znull) 
conn.close(); 
}catch(SQLException se)( 
se.printStackTrace(); 
}//end finally try 

}//end try 

System.out.println("Goodbye!"); 

end main 

end JDBCExample 





现在 来 编译 上 面 的 例子 如 下 : 


C> 
CS 


javac JDBCExample.java 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


Cie 
Con 
Con 
Cre 
Fet 
ID: 
ID: 
ID: 
Fet 
ID: 
ID: 
Goo 
C= 


java JDBCExample 

necting to a selected database... 

nected database successfully... 

ating statement... 

ching records without condition... 
100, Age: 30, First: Zara, Last: Ali 
102, Age: 30, First: Zaid, Last: Khan 
103, Age: 28, First: Sumit, Last: Mittal 
ching records with condition... 


100, Age: 30, First: Zara, Last: Ali 
102, Age: 30, First: Zaid, Last: Khan 
dbye! 


JDBC 排 序 实例 - JDBC 教 程 

本 教程 介绍 了 如 何 使 用 JDBC 应 用 程序 的 对 表 中 的 数据 进行 排序 的 例子 。 这 将 使 用 

asc 和 desc 关 键 字 的 记录 按 升序 或 降序 排序 。 执 行 下 面 的 示例 之 前 ， 请 确保 如 下 : 
e 执行 下 面 的 例子 中 ， 请 使 用 实际 的 用 户 名 和 密码 代替 username 和 password。 
e MySQL 或 者 其 他 数据 库 ， 正 在 使 用 : 启动 和 运行 。 


所 需 步 骤 : 


使 用 JDBC 应 用 程序 创建 一 个 新 的 数据 库 需 要 执行 以 下 步骤 : 


e TAG: 要 求 包 括 含 有 需要 进行 数据 库 编 程 的 JDBC 类 的 包 。 大 多 数 情况 下 ， 
使 用 import java.sql.* 。 


注册 JDBC 驱 动 程 序 : 要 求 初始 化 驱动 程序 ， 使 它 可 以 与 数据 库 打开 一 个 通信 


e 打开 一 个 连接 : 要 求 使 用 DriverManager.getConnection() 方 法 创建 一 个 
Connection 对 象 ， 它 代表 与 数据 库 服 务 器 的 物理 连接 。 


e 执行 一 个 查询 : 需要 使 用 类 型 语句 的 对 象 建立 并 提交 一 个 SQL 语 句 的 记录 从 表 
中 进行 排序 。 查 询 利用 ASC 和 DESC 子 句 来 按 升序 和 降序 顺序 排序 数据 。 


清理 环境 : 需要 明确 地 关闭 所 有 的 数据 库 资源 相对 于 依靠 JVM 的 垃圾 收集 。 


示例 代码 : 
复制 过 去 的 下 面 的 例子 中 JDBCExample.java， 编 译 并 运行 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


public class JDBCExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER = "com.mysql.jdbc.Driver"; 
static final String DB_URL = "jdbc:mysql://localhost/STUDENTS"; 


// Database credentials 
static final String USER 
static final String PASS 


= "username"; 

= "password"; 
public static void main(String[] args) { 
Connection conn = null; 

Statement stmt = null; 


try{ 


//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 

System.out.println("Connecting to a selected database..."); 
conn - DriverManager.getConnection(DB URL, USER, PASS); 
System.out.println("Connected database successfully..."); 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 
stmt = conn.createStatement(); 


// Extract records in ascending order by first name. 

System.out.println("Fetching records in ascending order..."), 

String sql - "SELECT id, first, last, age FROM Registration" 
" ORDER BY first ASC"; 

ResultSet rs = stmt.executeQuery(sql); 


while(rs.next())( 
//Retrieve by column name 
int id - rs.getInt("id"); 
int age - rs.getInt("age"); 
String first - rs.getString("first"); 
String last - rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.printin(", Last: " + last); 


} 


// Extract records in descending order by first name. 
System.out.println("Fetching records in descending order... 
sql = "SELECT id, first, last, age FROM Registration" + 

" ORDER BY first DESC"; 
rs = stmt.executeQuery(sq1); 


while(rs.next())( 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age - rs.getInt("age"); 
String first - rs.getString("first"); 
String last - rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


rs.close(); 
jcatch(SQLException se){ 


//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
conn.close(); 
}catch(SQLException se)( 
}// do nothing 
try{ 
if (conn!=null) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end JDBCExample 


BH —— 
现在 编译 上 面 的 例子 如 下 : 


C:>javac JDBCExample.java 
Gr 


当 运 行 JDBCExample， 它 会 产生 以 下 结果 : 


C:>java JDBCExample 

Connecting to a selected database... 
Connected database successfully... 

Creating statement... 

Fetching records in ascending order... 

ID: 103, Age: 28, First: Sumit, Last: Mittal 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 100, Age: 30, First: Zara, Last: Ali 
Fetching records in descending order... 

ID: 100, Age: 30, First: Zara, Last: Ali 

ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
Goodbye! 

eu 





JDBC 快 速 入 门 教程 -JDBC 教 程 


JDBC 是 什么 ? 
JDBC API 是 一 个 Java API， 可 以 访问 任何 类 型 表 列 数据 ， 特 别 是 存储 在 关系 数据 
库 中 的 数据 。JDBC 代 表 Java 数 据 库 连接 。 
JDBC 库 中 所 包含 的 API 任 务 通常 与 数据 库 使 用 : 
。 连接 到 数据 库 
e 创建 SQL 或 MySQL 语 名 
。 在 数据 库 中 执行 SQL 或 MySQL 查 询 
e 查看 和 修改 记录 
123 


先决 条 件 : 


学 习 JDBC， 需 要 在 以 下 两 个 主题 有 一 定 的 了 解 : 
1，JAVA 核 心 编程 
2. SQL 或 MySQL 数 据 库 


JDBC - 环境 设置 : 


请 确认 您 已 完成 以 下 设置 : 
1. 核心 JAVA 安装 
2. SQL 或 MySQL 数据库 安装 


除 上 述 者 外 ， 需 要 建立 一 个 数据 库 ， 为 本 程 测 试 项 目 使 用 。 假 设 这 是 EMP， 在 同一 
个 数据 库 上 创建 表 Employees。 


432 JDBC č ARF: 


参与 建立 一 个 JDBC 应 用 程序 ， 本 教程 中 按 六 个 步骤 进行 : 


导入 包 : 


这 需要 你 有 软件 包 包 含 了 数据 库 编 程 所 需 的 JDBC 类 。 大 多 数 情况 下 ， 使 用 import 
java.sql.* 就 足够 了 ， 如 下 所 示 : 


//STEP 1\. Import required packages 
import java.sql.*; 


注册 JDBC 了 驱动 程序 : 


这 需要 初始 化 驱动 程序 ， 这 样 就 可 以 打开 和 与 数据 库 的 通信 信道 。 以 下 是 代码 片段 实 
现 这 一 目标 : 


//STEP 2: Register JDBC driver 
Class.forName("com.mysql.jdbc.Driver"); 


打开 一 个 连接 : 


这 需要 使 用 DriverManager.getConnection() 方 法 来 创建 一 个 Connection 对 象 ， 它 代 
表 一 个 物理 连接 的 数据 库 ， 如 下 所 示 : 


//STEP 3: Open a connection 

// Database credentials 

static final String USER "username"; 

static final String PASS "password"; 
System.out.println("Connecting to database..."); 

conn = DriverManager.getConnection(DB URL, USER, PASS); 


执行 一 个 查询 : 


这 需要 使 用 一 个 对 象 类 型 Statement 或 PreparedStatement 构 建 ， 并 提交 一 个 SQL 语 
句 到 数据 库 。 如 下 : 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 

stmt = conn.createStatement(); 

String sql; 

sql - "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sql); 


如 果 有 一 个 SQL UPDATE，INSERT 或 DELETE 语 句 ， 那 么 需要 下 面 的 代码 片段 : 


//STEP 4: Execute a query 
System.out.println("Creating statement..."); 
stmt = conn.createStatement(); 

String sql; 

sql - "DELETE FROM Employees"; 

ResultSet rs = stmt.executeUpdate(sql); 


从 结果 集中 提取 数据 : 


这 一 步 是 必需 的 情况 下 ， 从 数据 库 中 获取 数据 。 可 以 使 用 适当 的 
ResultSet.getXXX() 方 法 来 检索 的 数据 结果 如 下 : 


//STEP 5: Extract data from result set 
while(rs.next()){ 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


清理 环境 : 
应 该 明确 地 关闭 所 有 的 数据 库 资 源 ， 对 依赖 于 JVM 的 垃圾 收集 如 下 : 


//STEP 6: Clean-up environment 
rs.close(); 

stmt.close(); 

conn.close(); 


TutorialsPoint Java 技术 教程 


€ JZJDBC & AREF: 1745 


第 一 个 JDBC 程序 : 


基于 上 面 的 步骤 ， 我 们 可 以 有 以 下 综合 示例 代码 ， 我 们 可 以 用 它 作 为 模板 而 写 
JDBC 代 码 : 此 示例 代码 已 被 写 人 基于 对 环境 和 数据 库 环 境 一 章 中 设置 完成 。 


//STEP 1\. Import required packages 
import java.sql.*; 


public class FirstExample { 
// JDBC driver name and database URL 
static final String JDBC DRIVER - "com.mysql.jdbc.Driver"; 
static final String DB URL = "jdbc:mysql://localhost/EMP"; 


// Database credentials 
static final String USER 
static final String PASS 


- "username"; 
- "password"; 
public static void main(String[] args) ( 
Connection conn - null; 
Statement stmt - null; 
try{ 

//STEP 2: Register JDBC driver 

Class .forName("com.mysql.jdbc.Driver"); 


//STEP 3: Open a connection 
System.out.println("Connecting to database..."); 
conn = DriverManager .getConnection(DB_URL, USER, PASS); 


//STEP 4: Execute a query 
System.out.println("Creating statement... "); 

stmt = conn.createStatement(); 

String sql; 

sql = "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sql); 


//STEP 5: Extract data from result set 
while(rs.next()){ 
//Retrieve by column name 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


//Display values 

System.out.print("ID: " + id); 
System.out.print(", Age: " + age); 
System.out.print(", First: " + first); 
System.out.println(", Last: " + last); 


//STEP 6: Clean-up environment 
rs.close(); 
stmt.close(); 
conn.close(); 
jcatch(SQLException se){ 
//Handle errors for JDBC 
se.printStackTrace(); 
jcatch(Exception e){ 
//Handle errors for Class.forName 
e.printStackTrace(); 
}finally{ 
//finally block used to close resources 
tryt 
if(stmt!-null) 
stmt.close(); 
jcatch(SQLException se2){ 
)// nothing we can do 
tryt 
if(conn!znull) 
conn.close(); 
jcatch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
}//end try 
System.out.println("Goodbye!"); 
)//end main 
}//end FirstExample - by www.yiibai.com 


现在 让 我 们 来 编译 上 面 的 例子 如 下 : 


C:\>javac FirstExample.java 
CE 


当 你 运行 FirstExample 的 ， 它 会 产生 以 下 结果 : 


C:\>java FirstExample 

Connecting to database... 

Creating statement... 

ID: 100, Age: 18, First: Zara, Last: Ali 

ID: 101, Age: 25, First: Mahnaz, Last: Fatma 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 
C:\> 


SQLException 方 法 : 


一 个 SQLException 既 可 以 发 生 在 驱动 程序 和 数据 库 。 当 这 样 的 异 弟 时 ， 
SQLException 类 型 的 对 象 将 被 传递 到 catch 子 句 。 通过 SQLException 对 象 有 以 下 
几 种 方法 可 用 于 获取 更 多 的 关于 异常 的 信息 : 


方法 描述 
getErrorCode() 异常 关联 的 错误 号 。 
获取 的 JDBC 了 驱动 程序 的 错误 处 理 错 误 消息 的 驱 
getMessage() 动 程序 或 获取 Oracle 错 误 号 和 消息 的 数据 库 
错 i Dus 


ik BRXOPEN SQLSTATE 字 符 串 。 对 于 JDBC 驱 
动 程序 错 ik, 没有 有 用 的 信息 ， 从 该 方法 返 


IRE ey 回 。 对 于 一 个 数据 库 错误 ， 五 位 的 XOPEN 
SQLSTATE 代 码 返回 。 这 种 方法 可 以 返回 null。 

getNextException() 获取 异常 链 中 的 下 一 个 Exception 对 象 。 

E EN ee 或 可 抛 出 ， 并 回溯 到 标准 错 


pintStaokTrace(PrintSiream 打印 此 抛 出 对 象 及 其 回溯 到 指定 的 打印 流 。 


LL 打印 此 抛 出 对 象 及 其 回溯 您 指定 打印 作家 。 


通过 人 的 信息 ， 可 以 捕获 一 个 异常 ， 并 适当 地 继续 运行 程 
序 。 这 是 一 个 try 块 中 的 一 般 形式 : 


try { 
// Your risky code goes between these curly braces!!! 


catch(Exception ex) { 
// Your exception handling code goes between these 
// curly braces, similar to the exception clause 
// in a PL/SQL block. 


} 

finally { 
// Your must-always-be-executed code goes between these 
// curly braces. Like closing database connection. 


} 


JDBC - 数据 类 型 : 


下 表 总 结 了 默认 的 JDBC 数 据 类 型 的 Java 数 据 类 型 转换 ， 当 调用 PreparedStatement 
或 CallableStatement 对 象 的 setXXX() 方 法 ， 或 ResultSet.updateXXX() 方 法 。 


SQL JDBC/Java setXXX updateXXX 
VARCHAR java.lang.String setString updateString 
CHAR java.lang.String setString updateString 
LONGVARCHAR _ java.lang.String setString updateString 
BIT boolean setBoolean updateBoolean 
NUMERIC java.math.BigDecimal setBigDecimal updateBigDecim: 
TINYINT byte setByte updateByte 
SMALLINT short setShort updateShort 
INTEGER int setint updatelnt 
BIGINT long setLong updateLong 
REAL float setFloat updateFloat 
FLOAT float setFloat updateFloat 
DOUBLE double setDouble updateDouble 
VARBINARY byte[ ] setBytes updateBytes 
BINARY byte[ ] setBytes updateBytes 
DATE java.sql.Date setDate updateDate 
TIME java.sql. Time setTime updateTime 
TIMESTAMP java.sql. Timestamp setTimestamp updateTimestam 
CLOB java.sql.Clob setClob updateClob 
BLOB java.sql.Blob setBlob updateBlob 
ARRAY java.sql.Array setARRAY updateARRAY 
REF java.sql.Ref SetRef updateRef 
STRUCT java.sql.Struct SetStruct updateStruct 


JDBC3.0 的 增强 支持 BLOB，CLOB，ARRAY，REF 数 据 类 型 。 的 ResultSet 对 象 
UPDATEBLOB()，updateCLOB()，updateArray() 和 updateRef() 方 法 ， 使 您 可 以 在 
服务 器 上 直接 操作 相应 的 数据 。 


setXXX() 和 updateXXX() 方 法 ， 可 以 转换 成 特定 的 Java 类 型 到 特定 的 JDBC 数 据 类 
=. setObject(0 和 updateObject() 方 法 ， 几 乎 所 有 的 Java 类 型 映射 到 JDBC 数 据 类 


o 


ResultSet 对 象 提供 相应 的 getXXX() 方 法 为 每 个 数据 类 型 来 检索 列 值 。 每 一 种 方法 ， 
可 以 使 用 与 列 名 或 由 它 的 序号 位 置 。 


SQL 
VARCHAR 
CHAR 


LONGVARCHAR 


BIT 
NUMERIC 
TINYINT 
SMALLINT 
INTEGER 
BIGINT 
REAL 
FLOAT 
DOUBLE 
VARBINARY 
BINARY 
DATE 

TIME 
TIMESTAMP 
CLOB 

BLOB 
ARRAY 

REF 
STRUCT 


JDBC/Java 
java.lang.String 
java.lang.String 
java.lang.String 
boolean 
java.math.BigDecimal 
byte 
short 
int 
long 
float 
float 
double 
byte[ ] 
byte[ ] 
java.sql.Date 
java.sql. Time 
java.sql. Timestamp 
java.sql.Clob 
java.sql.Blob 
java.sql.Array 
java.sql.Ref 


java.sql.Struct 


setXXX 
setString 
setString 
setString 
setBoolean 
setBigDecimal 
setByte 
setShort 
setint 
setLong 
setFloat 
setFloat 
setDouble 
setBytes 
setBytes 
setDate 
setTime 
setTimestamp 
setClob 
setBlob 
setARRAY 
SetRef 
SetStruct 


getXXX 
getString 
getString 
getString 
getBoolean 
getBigDecimal 
getByte 
getShort 
getint 
getLong 
getFloat 
getFloat 
getDouble 
getBytes 
getBytes 
getDate 
getTime 
getTimestamp 
getClob 
getBlob 
getARRAY 
getRef 
getStruct 


JDBC - 批量 处 理 ; 


批 处 理 允 许 一 个 批 义理 组 相关 的 SQL 语句 ， 并 将 其 提交 的 一 个 调用 到 数据 库 。 
当 几 个 SQL 语句 一 次 发 送 到 数据 库 中 ， 可 以 减少 通信 开销 ， 从 而 提高 性 能 。 


e JDBC 了 驱动 程序 不 支持 此 功能 。 您 上 应 该 使 用 
DatabaseMetaData.supportsBatchUpdates() 方 法 来 确定 目标 数据 库 支持 批量 
更 新 处 理 。 如 果 你 的 JDBC 了 驱动 程序 支持 此 功能 ， 则 该 方法 返回 true。 


e addBatch() 方 法 的 声明 ，PreparedStatement 和 CallableStatementis 用 于 添加 
单个 语句 的 批 处 理 。 executeBatch() 将 开始 执行 的 所 有 语句 组 合 到 一 起 。 


e executeBatch() 将 返回 一 个 整数 数组 ， 每 个 数组 元 素 的 表示 为 相应 的 更 新 语句 
的 更 新 计数 。 


e 可 以 添加 语句 进行 批 处 理 ， 可 以 clearBatch() 方 法 删除 它们 。 此 方法 将 删除 
addBatch() 方 法 添加 的 所 有 语句 。 但 是 ， 你 不 能 有 选择 性 地 选择 语句 来 删除 。 


JDBC - 数据 流 : 

PreparedStatement 对 象 有 能 力 使 用 提供 参数 数据 的 输入 和 输出 流 。 这 使 您 可 以 将 
整个 文件 到 数据 库 中 ， 可 容纳 较 大 的 值 ， 如 CLOB 和 BLOB 数 据 类 型 的 列 。 

有 下 列 方法 可 用 于 流 数 据 : 

1. setAsciiStream(): 此 方法 用 于 提供 大 的 ASCII 值 。 

2. setCharacterStream(): 此 方法 用 于 提供 大 的 UNICODE 值 。 

3. setBinaryStream(): 使 用 此 方法 ， 以 提供 大 的 二 进 制 值 。 


setXXXStream() 方 法 需要 一 个 额外 的 参数 ， 文 件 大 小 ， 除 了 参数 占 位 符 。 此 参数 通 
知 应 发 送 多 少数 据 的 数据 库 ， 使 用 流 的 驱动 程序 。 


对 于 一 个 详细 的 关于 所 有 这 些 概念 ， 需 要 去 通过 学 习 完整 的 教程 。 


JFreeChart 教 程 


图 表 是 信息 的 图 形 表 示 。 有 可 用 的 各 种 工具 ， 它 可 用 于 创建 不 同类 型 的 图 表 。 


本 教程 学 习 什 么 是 JFreeChart? 为 什么 需要 它 ， 并 在 各 种 方式 列 出 一 个 基于 Java 的 
应 用 程序 或 独立 创建 不 同类 型 的 图 表 。 


JFreeChart 是 什么 ?3 


JfreeChart 是 用 Java 开 发 的 开源 库 ， 它 可 以 在 基于 Java 的 应 用 程序 可 用 于 创建 各 种 
各 样 的 图 表 。 通 过 使 用 JFreeChart， 可 以 创建 2D 和 3D 图 表 ， 如 饼 图 ， 条 形 图 ， 折 
线 图 ，XY 图 和 3D 图 表 所 有 常用 的 主要 类 型 。 


为 什么 要 使 用 JFreeChart? 


e 它 是 100% 开 源 和 免费 的 ， 人 允许 使 用 在 商业 应 用 中 无 需 任何 费用 。 

。 它 配备 了 有 据 可 查 的 API， 这 使 得 它 很 容易 理解 。 

e 它 文 持 多 种 图 表 类 型 ， 如 人 饼 图 ， 折 线 图 ， 条 形 图 ， 面 积 图 和 三 维 图 表 。 
e。JFreeChart 易 于 扩展 ， 并 且 可 以 在 客户 端 以 及 服务 器 端 应 用 程序 中 被 使 用 。 
e 它 支持 多 种 输出 格式 ， 如 PNG，JPEG，PDF，SVG 等 。 

e 它 人 允许 图 表 丰 富 的 自 定义 。 


在 哪里 使 用 JFreeChart ? 


考虑 有 这 样 一 个 情况 ， 当 正在 开发 一 个 应 用 程序 ， 需 要 以 图 表 的 形式 显示 数据 ， 其 
中 数据 本 身 是 动态 填充 。 在 这 种 情况 下 ， 可 以 使 用 JFreeChart 显 示 ， 使 用 简单 的 编 
程 图 表 的 形式 的 数据 。 


历史 


JFreeChart 工程 由 David Gilbert 成 立 十 四 年 前 (2000 年 2 月 ) ， 而 现在 JFreeChart 
是 在 Java 开 发 的 最 广泛 使 用 的 图 表 库 。 
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本 章 将 指导 您 完成 JFreeChart 在 Windows 和 Linux 的 安装 设置 过 程 。 所 需 的 用 户 管 
理 ， 同 时 安装 JFreeChart。JFreeChart 是 著名 的 高 效 图 表 创 建 和 用 户 友 好 的 安装 设 
iB. 


系统 要 求 : 
JDK 1.5 或 以 上 
内 存 2GB RAM 
硬盘 空间 没有 最 低 要 求 
操作 系统 版 本 Linux / Windows 
安装 JFreeChart 


要 安装 JFreeChart， 首 先 需 要 在 系统 上 安装 Java。 


步骤 1 : 验证 Java 安 装 
为 了 验证 Java 安 装 ， 打 开 控 制 台 并 执行 下 面 的 Java 命 兮 


操作 系统 任务 fni 
Windows 打开 命令 控制 台 C:>java -version 
Linux 打开 命令 终端 $java -version 


如 果 Java 安 装 得 当 ， 那 么 应 该 得 到 两 个 操作 系统 下 面 的 输出 : 


操作 系统 描述 


Java version "1.7.0_60" Java (TM) SE Run Time Environment 
Windows (build 1.7.0 60-b19) Java HotSpot(TM) 64-bit Server VM (build 
24.60-b09,mixed mode) 


java version "1.7.0 25" OpenJDK Runtime Environment (rhel- 
Linux 2.3.10.4.el6 4-x86 64) OpenJDK 64-Bit Server VM (build 23.7- 
b01, mixed mode) 


如 果 没 有 安装 Java， 那 么 可 以 链接 到 安装 Java 软 件 开发 工具 包 (SDK) 
http://www.oracle.com/technetwork/java/javase/downloads/index.html 
我 们 假设 你 已 经 进行 了 本 教程 之 前 安装 了 Java1.7.0_60 版 本 。 

第 2 步 : 设置 Java 环 境 

设置 JAVA_HOME 环境 变量 指向 到 安装 在 机 器 上 的 Java 基本 目录 的 位 置 。 例 如 ， 


Os 描述 


设置 的 环境 变量 JAVA_HOME 的 值 为 


Windows C:\ProgramFiles\java\jdk1.7.0_60 


Linux export JAVA_HOME=/usr/local/java-current 


附加 Java 编 译 器 位 置 系统 路 径 。 


OS 描述 
mts oe EE 音 亦 
Windows 添加 字符 串 ; C:\Program Files\Java\jdk1.7.0_60\bin 到 系统 环境 变 
= PATH. 
Linux export PATH=$PATH:$JAVA_HOME/bin/ 


从 命令 提示 符 下 验证 命令 java-version 如 上 所 述 


第 三 步 : 安装 JFreeChart 


从 链接 http://www. jfree.org/jfreechart/download/ 下 载 JFreeChart.zip 最 新 版 本 解压 
下 载 文 件 库 ， 可 以 链接 到 Java 程 序 中 的 任何 位 置 。 下 图 显示 了 目录 和 文件 的 结构 : 
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uj ant ^ æ hamcrest-core-1.3.jar 
L3 checkstyle E E jcommon-1.0.22.jar 
L3 docfiles = jfreechart- 1.0. 18-experimental.jar 
Gu ub E E jfreechart-1.0.18.jar 
L3 source ^ @ jfreesvg-1.9.jar 
Lu st > @ junit-4.11 jar 
Previous 30 Days a orsoncharts- 1.4-eval-nofx.jar 
a orsonpdf- 1.6-eval.jar 
Changelog 3 servletjar 
Ly experimental 


' P9 swtgraphics2d.Jar 
a jfreechart- 1.0.18-demo.jar 


licence-LGPL.txt 
NEWS 
pom.xml 
README.txt 

iJ tests 


添加 了 JFreeChart1.0.18.jar 和 jcommon-1.0.22 jar 文件 到 CLASSPATH 完整 路 


径 ， 如 下 图 所 示 : 


OS 描述 


添加 字符 串 “C:\ jfreechart-1.0.18\lib\ jfreechart-1.0.18.jar" #0 “C: 


Windows  ;jfreechart-1.0.18MibY jcommon-1.0.22.jar" 到 用 户 变 量 


CLASSPATH 的 尾部 


Export CLASSPATH=$CLASSPATH: /usr/share/jfreechart- 
Linux 1.0.18/lib/jfreechart-1.0.18.jar: /usr/share/jfreechart- 


1.0.18 /lib/jcommon-1.0.22.jar 
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JFreeChart2& #4 - JFreeChart 教 程 


本 章 介 绍 给 大 家 介绍 JFreeChart 不 同类 中 如 何 交 互 的 概念 , JFreeChart 基 本 类 层次 
和 应 用 水 平 的 架构 在 基于 Java 点 用 程序 如 何 工作 的 。 


类 层次 染 构 
类 层次 架构 解释 了 如 何 把 不 同 阶层 的 相互 库 交互 ， 以 创建 不 同类 型 的 图 表 。 


Database 


Create Dataset 


General Dataset Category Dataset Series Dataset 


Create Chart Series Collection 


Frame/Image 


以 下 是 在 上 述 框图 中 使 用 的 单元 细节 : 


Dataset 
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xx 描述 
文件 所 用 的 用 户 输入 为 源 ， 用 于 创建 该 文件 中 的 数据 集 。 
数据 库 所 用 的 用 户 输入 为 源 ， 用 于 创建 在 数据 库 中 的 数据 集 。 
接受 数据 集中 存储 和 数据 集中 到 数据 集 对 象 。 
TERE 。 这 种 类 型 的 数据 集 主要 用 于 饼 图 。 
2 这 种 类 型 的 数据 集 ， 用 于 柱状 图 ， 折 线 图 等 等 。 
ee 这 种 类 型 的 数据 集 被 用 于 存储 一 系列 数据 和 构建 线 图 表 。 
系列 采集 “不 同类 别 的 一 系列 数据 集 添加 条 列 集合 数据 集 。 这 种 类 型 的 数据 
数据 集 集 ， 用 于 xy 折 线 图 表 。 
创建 图 表 这 是 被 执行 以 创建 最 终 的 图 表 的 方法 。 
WUA H 该 图 显示 在 一 个 Swing 框架 或 创建 映像 。 
应 用 层 架 构 


应 用 级 架构 说 明 ， 其 中 JFreeChart 库 在 Java 应 用 程序 内 线 。 


ii Kc 


JFreeChart API 





客户 端 程序 接收 用 户 数据 ， 然 后 它 使 根据 要 求 使 用 标准 Java 和 JFreeChart 的 APl 来 
生成 输出 在 任 一 帧 的 形式 ， 它 可 以 直接 在 该 应 用 程序 或 独立 地 在 所 述 图 像 格式 ， 如 
JPEG 或 PNG 显 示 。 
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在 本 章 中 ， 我 们 将 讨论 一 些 在 JFreeChart 库 重要 的 软件 包 ， 类 和 方法 。 这 些 软件 
包 ， 类 和 方法 是 最 常见 的 ， 同 时 建立 了 各 种 使 用 JFreeChart 库 图 表 。 


ChartFactory 类 


ChartFactory 是 org.jfree.chart 包 中 抽象 类 。 它 提供 了 实用 方法 的 集合 ， 用 于 生成 标 
准 的 图 表 。 以 下 是 几 个 重要 方法 的 列表 : 


类 构造 方法 
S.N. 描述 
1 ChartFactory() ChartFactory 3: B&ER;A 443& Eq 2, 


类 方法 


S.N. 方法 & 描述 


createPieChart(java.lang.String title, PieDataset dataset, boolean 
1 legend, boolean tooltips, boolean urls) 此 方法 使 用 默认 设置 创建 一 
个 饼 图 。 它 返回 JFreeChart 类 型 的 对 象 。 


createPieChart3D(java.lang.String title, PieDataset dataset, 
2 boolean legend, boolean tooltips, boolean urls) 此 方法 使 用 指定 的 
数据 集 三 维 /3D 饼 图 。 


createBarChart(java.lang.String title, java.lang.String 
categoryAxisLabel, java.lang.String valueAxisLabel, 

3 CategoryDataset dataset, PlotOrientation orientation, boolean 
legend, boolean tooltips, boolean urls) java.lang.String 
categoryAxisLabel 标 签 放 置 在 X 轴 的 值 。 该 参数 的 java.lang.String 
valueAxisLabel 标 签 放 置 在 Y 轴 的 数值 。 此 方法 创建 一 个 条 形 图 。 


createBarChart3D(java.lang.String title, java.lang.String 
categoryAxisLabel, java.lang.String valueAxisLabel, 

4 CategoryDataset dataset, PlotOrientation orientation, boolean 
legend, boolean tooltips, boolean urls) 此 方法 创建 一 个 柱 形 图 具有 
3D 效 果 。 它 返回 JFreeChart 类 型 的 对 象 。 


createLineChart(java.lang.String title, java.lang.String 
categoryAxisLabel, java.lang.String valueAxisLabel, 

5 CategoryDataset dataset, PlotOrientation orientation, boolean 
legend, boolean tooltips, boolean urls) 此 方法 使 用 默认 设置 创建 一 
个 折线 图 。 


createLineChart3D(java.lang.String title, java.lang.String 
categoryAxisLabel, java.lang.String valueAxisLabel, 

6 CategoryDataset dataset, PlotOrientation orientation, boolean 
legend, boolean tooltips, boolean urls) 此 方法 创建 一 个 折线 图 与 3D 
效果 。 


createXYLineChart(java.lang.String title, java.lang.String 

7 xAxisLabel, java.lang.String yAxisLabel, XYDataset dataset, 
PlotOrientation orientation, boolean legend, boolean tooltips, 
boolean urls) 此 方法 使 用 默认 设置 创建 基于 XYDataset 的 折线 图 。 


ChartFrame # 


ChartFrame 类 在 org.jfree.chart 包 中 ， 提 供 所 有 的 帧 相关 的 功能 和 工具 。 
ChartFrame 类 继承 自 父 类 ， 如 Frame, Window, Container, Component 类 功能 。 


类 构造 方法 


S.N. 构造 方法 及 描述 


ChartFrame (java.lang.Frame String, JfreeChart chart) 它 构 建 一 个 框 
架 /frame。 


Chart Frame (java.lang.Frame String, JfreeChart chart, boolean 


< scrollpane) 它 构建 一 个 框架 /frame。 
类 方法 
S.N. 构造 方法 及 描述 
1 getChartPanel() 此 方法 返回 图 表面 板 的 框架 /frame。 


ChartPanel 类 


org.jfree.chart 包 中 的 ChartPanel 类 用 于 swing GUI 部 件 ， 用 于 显示 JfreeChart 对 


o 


类 构造 方法 
S.N. 构造 方法 及 描述 
1 ChartPanel(JFreeChart chart) 此 构造 一 个 面板 /panel ， 显 示 指 定 的 图 
Ro 
2 ChartPanel(JFreeChart chart, boolean useBuffer) ix NH ERRU 
造 包含 图 表 的 面板 /panel。 
ChartPanel(JFreeChart chart, boolean properties, boolean save, 
3 boolean print, boolean zoom, boolean tooltips) 此 构造 一 个 
JFreeChart tk. 
类 方法 
S.N. 方法 及 描述 


setPreferredSize(java.awt.Dimension) 该 方法 用 于 java.awt 中 设置 的 
1 mA. Dimension 类 对 象 作为 参数 。 这 个 方法 是 从 
javax.swing.JComponent 中 实现 。 


ChartUtilities 类 


org.jfree.chart 包 中 的 CharUtilites 类 提供 JFreeCharts 包 括 将 图 表 转 换 成 图 像 文 件 格 
式 ， 如 PNG，JPEG 和 创建 HTML 图 像 映 射 方法 的 实用 方法 的 集合 。 


3 HIE HA 


S.N. 构造 方法 及 描述 

1 ChartUtilities() 3x ze 3 B5— ^ SA ADS ESO 

类 方法 

S.N. 方法 及 描述 

1 saveChartAsPNG(java.io.File file, JfreeChart chart, int width, int 
height) 此 方法 转换 和 保存 图 表 为 PNG 格 式 指 定 的 文件 。 

2 saveChartAsJPEG(java.io.File file, JfreeChart chart, int width, int 


height) 此 方法 转换 并 保存 一 个 图 表 ， 以 JPEG 格 式 指定 的 文件 。 


JFreeChart 类 


JFreeChart 类 是 在 org.jfree.chart 包 的 核心 类 。 这 个 类 提供 了 JFreeChart 的 方法 来 
创建 柱状 图 ， 折 线 图 ， 饼 图 和 XY 坐 标 图 ， 包 括 时 间 序 列 数据 。 


3X iS A 
S.N. 构造 方法 及 描述 
1 JfreeChart(Plot plot) bt 438 E425 6) SAF Brie DEB 8 na — T AIT ESI 
JfreeChart(java.lang.String title, java.awt.Font titleFont, Plot plot, 
2 boolean createLegend) 该 构造 画 数 创 建 一 个 新 的 图 表 给 定 标题 和 绘 
图 。 
3 JfreeChart(java.lang.String title, Plot plot) 该 构造 画 数 创建 一 个 新 的 
图 表 给 定 标 题 和 绘图 。 
类 方法 
S.N. 方法 及 描述 
getXYPlot() 此 方法 返回 节点 图 表 作 为 XYPlot。 使 用 XYPolt 我 们 可 以 XY 


图 表 做 了 一 些 实用 操作 。 


PiePlot # 


这 个 
一 些 


类 是 org.jfree.chart.plot 包 的 一 部 分 ， 来 自 同一 个 包 扩 展 Plot 类 。 
些 方法 来 创建 饼 图 块 。 
3t B 4438 AN 


S.N. 构造 方法 及 描述 
1 PiePlot() 它 创建 了 一 个 新 的 绘图 。 


2 


o 


类 方法 


S.N. 方法 及 描述 


setStartAngle(double angle) 此 方法 设置 起 始 角度 和 
PlotChangeEvent 向 所 有 注册 的 侦 听 器 


PiePlot3D # 


PiePlot(PieDataset dataset) 它 创 建 了 一 个 绘图 ， 饼 图 由 指 


这 个 类 提供 了 


定 的 数据 


PiePlot3D 类 和 PiePlot 类 在 同一 个 包 中 的 子 类 。 因 此 ， 这 类 有 相同 的 功能 ， 


PiePlot 类 只 不 过 是 用 于 创建 3D 图 形 。 


S.N. 构造 方法 及 描述 
1  PiePlot3D() 此 构造 函数 创建 没有 数据 集 的 新 实例 。 


PiePlot3D(PieDataset dataset) 该 构造 画 数 创建 一 个 饼 图 和 使 用 指定 


的 数据 集 三 维 效果 。 


类 方法 


S.N. 方法 及 描述 


setForegroundAlpha(float alpha) 它 设 置 alpha 透 明度 并 向 所 有 发 送 
PlotChangeEvent 注 册 的 侦 听 器 。 


setlnteriorGap(double percent) 它 设 置 了 内 部 差距 并 发 送 
PlotChangeEvent 向 所 有 注册 的 侦 听 器 。 这 种 控制 的 饼 图 绘图 边缘 与 绘 
区 本 身 〈 即 ， 其 中 部 分 标签 显示 的 区 域 ) 之 间 的 空间 。 这 个 方法 是 从 
父 类 PiePlot 继 承 。 


PlotOrientation 类 
这 是 一 个 串 行 化 类 从 org.jfree.chart.plot 封 装 ， 它 是 用 来 显示 一 个 二 维 曲线 图 的 方 


位 。 方 向 可 以 是 垂直 的 或 水 平 的 。 它 设置 Y 轴 的 方向 。 传 统 的 绘图 有 一 个 垂直 的 Y 
轴 。 


字段 摘要 
S.N. 类 型 字段 & 描述 
一 个 > p EAAS 
1 Plotonentation HORIZONTAL 为 一 个 曲线 图 ， 其 中 所 述 范 围 轴 (Y 
轴 ) 是 水 平 。 
=: : VERTICAL 为 一 个 曲线 图 ， 其 中 所 述 范 围 轴 〈Y 轴 ) 
2 | PlotOnentation | sai), XX BEA ERIT, 
HA 
S.N. 方法 及 描述 
1 isHorizontal() 如 果 这 个 方向 是 水 平 的 ， 此 方法 返回 true， 否 则 返回 
false。 
2 isVertical() 如 果 这 个 方向 是 VERTICAL， 此 方法 返回 true， 否 则 返回 
false。 


XYPlot # 
这 在 org.jfree.chart.plot 包 可 用 一 个 通用 类 ， 并 将 其 用 于 在 (X, Y) 对 的 形式 标 绘 数 


据 。 这 个 曲线 图 可 以 从 实现 XYDataSet 接 口 的 任何 其 它 类 中 使 用 的 数据 。 XYPlot 利 
用 一 个 XYltemRenderer 的 画 在 图 上 的 每 个 点 。 


类 的 构造 回 数 


S.N. 构造 方法 及 描述 


XYPlot() 该 构造 器 没有 数据 集 ， 无 轴 ， 无 泻 染 器 创建 一 个 新 的 XYPlot 实 
例 。 


XYPlot(XYDataset dataset, ValueAxis domainAxis, ValueAxis 
2 rangeAxis, XYltemRenderer renderer) , Ib #415 E26) E — T AES 
图 并 指定 数据 集 ， 轴 和 演 染 。 


类 方法 
S.N. 方法 及 描述 
1 setRenderer(XYltemRenderer renderer) 此 方法 设置 演 染 器 的 主要 数 


据 集 ， 并 发 送 更 改 事件 向 所 有 注册 的 侦 听 器 。 


NumberAxis 类 

这 个 类 是 org.jfree.chart.axis 封 装 ， 它 可 以 访问 任意 轴 的 数值 数据 。 当 我 们 设置 任何 
轴 的 范围 为 默认 值 ， 它 根据 所 述 数据 的 范围 配合 。 但 使 用 NumberAxis， 类 我 们 可 
以 设置 较 低 的 利润 率 和 定义 域 和 值 域 轴 的 上 侧 边 距 。 


类 的 构造 画 数 


S.N. 构造 方法 及 描述 

1 NumberAxis( ) 3x &&NumberAxis — 4^ ERA B5443& Eq 24, 

2 NumberAxis( java.lang.String label) 构造 画 数 NumberAxis 使 用 必要 
的 默认 值 在 哪里 。 

类 方法 

S.N. 方法 及 描述 
setLowerMargin(double margin) 它 为 轴 心 的 利润 率 较 低 (为 轴 心 范 

1 的 百分比 ) ， 并 发 送 一 个 AxisChangeEvent 所 有 已 注册 的 侦 听 器 。 这 


个 方法 是 从 父 类 ValueAxis 继 承 。 
setUpperMargin(double margin) 它 设 置 于 所 述 轴 的 上 缘 misi 


2 的 百分比 ) ， 并 发 送 一 个 AxisChangeEvent 给 所 有 注册 的 监听 器 。 这 种 
方法 也 存在 于 ValueAxis 类 。 


XYLineAndShapeRenderer 类 


这 是 在 org.jfree.chart.renderer.xy 包 下 的 类 ， 它 需要 连接 数据 点 与 线 ， 并 绘制 形 
状 ， 在 每 个 数据 点 下 是 可 用 的 。 这 个 泻 染 器 类 是 专 为 XYPlot 类 配合 使 用 。 


3 BS E A 


S.N. 构造 和 描述 

XYLineAndShapeRenderer() 它 创 建 了 一 个 新 的 泻 染 器 有 两 种 线条 和 
形状 可 见 。 

2 XYLineAndShapeRenderer (boolean lines, boolean shapes) 它 创 建 


了 一 个 新 的 泻 染 与 特定 的 属性 。 
类 方法 
S.N. 方法 及 描述 
setSeriesPaint(int series, java.awt.Paint paint) 此 方法 设置 用 于 一 系 


1 列 的 涂料 ， 并 发 送 RendererChangeEvent 给 所 有 注册 的 监听 器 。 这 个 方 
法 是 从 AbstratRenderer 抽 象 类 从 泻 染 器 包 中 JFreeChart 的 API。 


setSeriesStroke(int series, java.awt.Stroke stroke) 此 方法 设置 用 于 
2 一 系列 的 流程 ， 并 发 送 RendererChangeEvent 向 所 有 注册 的 侦 听 器 。 这 
个 方法 是 从 AbstratRenderer 抽 象 类 ， 它 是 这 个 包 的 超 类 。 


XYltemRenderer 通 用 数据 集 


这 是 用 于 使 一 个 单一 的 (X, Y) 格式 项 在 XYPlot 接 口 。org.Jfree.data.general 包 其 
具有 类 和 接口 ， 以 定义 不 同类 型 的 数据 集 来 构造 图 。 


PieDataset 


这 是 作为 一 个 通用 的 数据 集 ， 其 中 值 与 键 相 关联 的 接口 。 正 如 其 名 称 所 暗示 的 ， 可 
以 使 用 这 个 数据 集 提供 数据 的 饼 图 。 此 接口 扩展 KeyedValues 数 据 集 的 接口 。 所 有 
使 用 此 接口 的 方法 取 自 KeyedValues，Values 和 数据 集 的 接口 。 


DefaultPieDataset 类 
这 是 一 个 默认 的 实现 类 PieDataset 接 口 。 


KAM E A 


S.N. HERJA HHR 
1 DefaultPieDataset() i% iE P426 6] E — AATRE, AE, 


2 DefaultPieDataset(KeyedValues data) 它 从 一 个 KeyedValues 实 例 复 
制 数 据 创 建 了 一 个 新 的 数据 集 。 


类 方法 


S.N. 方法 及 描述 


setValue(java.lang.Comparable key, double value) 它 设置 数据 值 的 
键 ， 发 送 DatasetChangeEvent 向 所 有 注册 的 侦 听 器 。 


2 setValue(java.lang.Comparable key, java.lang.Number value) 它 设 
置 数据 值 的 键 ， 发 送 DatasetChangeEvent 向 所 有 注册 的 侦 听 器 。 


SeriesException # 


这 是 一 个 异常 类 。 它 会 引发 发 生 在 时 间 序 列 中 数据 集 的 数据 的 异常 。 异 间 是 引发 上 
的 重复 或 无 效 数据 的 次 数 。 时 间 序 列 不 能 与 重复 应 用 ， 格 式 必 须 是 有 效 的 。 


DefaultCategoryDataset 


这 是 一 个 默认 的 实现 类 CategoryDataset 接 口 。 


类 的 构造 加 数 
S.N. 构造 函数 及 描述 
1 DefaultCategoryDataset() 此 构造 画 数 创建 新 的 空 数据 集 。 


类 方法 


S.N. 方法 及 描述 


addValue(double value, java.lang.Comparable rowKey, 
1 java.lang.Comparable columnKey) 这 种 方法 增加 了 一 个 值 ， 以 使 用 可 
比 的 键 表 。 


addValue(java.lang.Number value, java.lang.Comparable rowKey， 
java.lang.Comparable columnKey) 这 种 方法 增加 了 一 个 值 的 表 。 


setValue(double value, java.lang.Comparable rowKey, 
3 java.lang.Comparable columnKey) 此 方法 添加 或 在 表 中 更 新 的 值 ， 并 
发 送 aDatasetChangeEvent 给 所 有 注册 的 监听 器 。 


setValue(java.lang.Number value, java.lang.Comparable rowKey, 
4 java.lang.Comparable columnKey) 此 方法 添加 或 在 表 中 更 新 的 值 ， 并 
发 送 DatasetChangeEvent 给 所 有 注册 的 监听 器 。 


参见 JFreeChart 的 API， 用 于 各 种 其 他 方法 和 字段 的 详细 信息 。 


序列 数据 集 


系列 数据 集 用 于 XY 图 表 。 该 软件 包 是 org.Jfree.data.xy， 其 中 包含 类 和 属于 XY 图 表 
接口 。 核 心 接口 是 XYDataset。 


XYDataset 
这 是 通过 该 数据 中 的 (X，Y) 的 项 目的 形式 可 被 访问 的 接口 。 正 如 其 名 称 所 提示 


的 ， 可 以 使 用 这 个 数据 集 服务 XY 图 表 。 一 些 在 这 个 接口 中 的 方法 都 取 自 
SeriesDateset 接 口 。 


XYZDataset 
这 是 通过 该 数据 的 形式 (x, y, z) 的 项 目 可 被 访问 的 接口 。 正 如 其 名 称 所 暗示 


的 ， 可 以 使 用 这 个 数据 集 服务 XYZ 图 。 一 些 在 这 个 接口 中 的 方法 都 取 自 
SeriesDateset。 


XYSeries 

这 是 一 类 ， 它 代表 了 在 所 述 形 式 的 需 个 或 多 个 数据 项 (x, y) 的 序列 。 默 认 情 况 
下 ， 该 系列 中 的 数据 项 都 按 升序 排列 由 x 值 ， 并 重复 允许 的 x 值 。 无 论 是 排序 和 复制 
缺 省 值 可 以 在 构造 男 数 中 被 改变 。 Y 值 可 以 表示 为 空 值 代表 缺失 值 。 


类 构造 西数 


S.N. #478 Beh 


1 XYSeries(java.lang.Comparable key) i His HA 6] E& — 4 3r B] ZE 
列 。 

2 XYSeries(java.lang.Comparable key, boolean autoSort) 它 构造 一 个 新 
的 空 系 列 ， 具 有 自动 排序 标志 集 的 请 求 ， 并 且 重 复 的 值 是 允许 的 。 

3 XYSeries(java.lang.Comparable key, boolean autoSort, boolean 


allowDuplicateXValues) 它 构造 一 个 新 的 xy 系列 不 包含 任何 数据 。 


类 方法 
S.N. 方法 描述 
1 add(double x, double y) 这 种 方法 增加 了 数据 项 成 系列 。 


在 上 述 方法 中 使 用 的 教程 例子 。 如 果 想 了 解 其 余 的 方法 和 字段 ， 请 参考 JFreeChart 
的 APl。 


XYSeriesCollection 


XYSeriesCollection 类 有 类 似 父 类 AbstractlntervelDataset，AbstractXYDatset， 
AbstractSeriesDataset 和 AbstractDataset。 一些 在 这 个 类 中 的 方法 属于 这 个 类 的 父 


米 
Fo 


A BO SS BOR 
S.N. ie ES RUN 
1 XYSeriesCollection() 它 构 造 一 个 空 的 数据 集 。 
2 XYSeriesCollection(XYSeries xyseries) 它 构建 了 一 个 数据 集 ， 并 用 
一 个 系列 的 填充 。 
类 方法 
S.N. 方法 及 描述 
addSeries(XYSeries series) 这 种 方法 增加 了 一 系列 的 收集 和 发 送 


DatasetChangeEvent 向 所 有 注册 的 侦 听 器 。 


参见 JFreeChart 的 API 其 余 的 方法 和 字段 。 


Default XYZDataset : 


DefaultXYZDataset # 484 2 #, 4AbstractintervelDataset, AbstractXYDatset, 
AbstractSeriesDataset, AbstractDataset#JAbstractXYZDataset, 一些 在 这 个 类 中 
的 方法 属于 这 一 类 的 父 类 。 


类 的 构造 画 数 


S.N. 构造 方法 及 描述 

1 DefaultXYZDataset() 它 构 造 一 个 空 的 数据 集 。 
类 方法 
S.N. 方法 及 描述 


addSeries(java.lang.Comparable seriesKey, double[ ][ ] data ) ZA 
1 法 增加 了 一 系列 的 收集 和 发 送 DatasetChangeEvent 向 所 有 注册 的 侦 听 
Ai 0 


请 参考 JFreeChart 的 API， 其 余 的 方法 和 字段 。 


JFreeCharts 的 时 间 序 列 


该 软件 包 是 org.jfree.data.time。 该 软件 包 包 含 用 于 时 间 相 关 的 数据 的 类 和 接口 。 


TimeSeries : 


此 类 表示 数据 项 的 期 值 的 形式 ， 其 中 一 段 是 RegularTimePeriod 抽 和 象 类 ， 如 时 间 ， 
日 ， 小 时 ， 分 钟 和 秒 类 的 一 些 实例 序列 。 


3 BS E A 


S.N. 构造 方法 及 描述 
1 TimeSeries(java.lang.Comparable name) 它 创 建新 的 空 系列 。 


TimeSeries(java.lang.Comarable name, java.lang.String domain, 
2 java.lang.Strin range) 它 会 创建 一 个 不 包含 任何 数据 的 新 的 时 间 序 
列 。 


类 方法 


S.N. 方法 及 描述 


1 add(RegularTimePeriod period,double value) 该 方法 增加 了 一 个 新 
的 数据 项 用 以 串联 。 


其 余 的 方法 和 字段 参见 JFreeChart 的 AP|。 
TimeSeriesCollection : 


这 是 作为 时 间 序 列 的 对 象 的 集合 的 类 。 这 个 类 实现 了 XYDataset 接 口 ， 以 及 它 扩展 
了 IntervelXYDataset 接 口 。 这 使 得 它 可 以 方便 地 收集 序列 数据 对 象 。 


3 BS E A 


S.N. 构造 方法 及 描述 
1 TimeSeriesCollection() 它 构 造 一 个 空 的 数据 集 ， 绑 在 默认 时 区 。 
2 TimeSeriesCollection(TimeSeries series) 它 构 造 一 个 包含 单个 系列 
(更 多 可 添加 ) ， 绑 在 黑 认 时 区 的 数据 集 。 
3 TimeSeriesCollection(TimeSeries series, java.util. TimeZone zone) 
它 构造 包含 单个 系列 〈 更 可 添加 ) ， 绑 定 到 特定 的 时 间 段 的 数据 集 。 
4 TimeSeriesCollection(java.util. TimeZone zone) 它 构造 一 个 空 的 数据 


集 时 ， 绑 定 到 特定 的 时 间 区 。 


类 方法 
S.N. 方法 及 描述 
addSeries(TimeSeries series) 方法 增加 了 一 系列 的 收集 和 发 送 


DatasetChangeEvent 向 所 有 注册 的 侦 听 器 。 


其 余 的 方法 和 字段 请 参考 JFreeChart 的 AP|。 


Second 类 : 


这 个 类 表示 一 个 特定 的 日 子 一 秒 钟 。 这 个 类 是 不 可 变 的 ， 这 是 对 所 有 
RegularTimePeriod 子 类 的 要 求 。 


类 的 构造 画 数 


S.N. 4438s EEN Be TER 
1 Second() 它 构 造 一 个 新 的 Second， 基 于 系统 的 日 期 /时 间 。 
Second(java.util.Date time) 它 构 造 从 指定 日 期 /时 间 和 默认 时 区 的 新 实 


^ | Bl, 

3 Second(java.util.Date time, java.util. TimeZone zone, java.util.Locale 
locale) 它 创 建 基于 所 提供 的 时 间 和 时 区 的 新 的 Second 对 象 。 

4 Second(int second, int minute, int hour, int day, int month, int year) 
创建 了 一 个 新 的 Second 对 象 。 

5 Second(int second, Minute minute) 它 构建 了 一 个 新 的 Second。 

类 方法 
S.N. 方法 及 描述 
1 getSecond() 它 返 回 分 钟 和 秒 。 
2 next() 它 返 回 当前 的 下 一 秒 。 


其 余 的 方法 和 字段 请 参考 JFreeChart 的 API。 


JFreeCharts 中 的 帧 : 


该 软件 包 是 org.jfree.ui。 这 是 包 所 属 JFreeChart 的 JCommons 的 API。 它 包含 用 于 创 
建 预 配 置 的 图 表 框 架 的 实用 程序 类 。 


ApplicationFrame : 


这 是 用 于 创建 简单 的 应 用 程序 的 主 框架 的 基 类 。 帧 监听 窗口 关闭 事件 ， 并 作出 反 
应 ， 关 闭 JVM。 这 是 很 好 的 小 型 演示 应 用 。 对 于 企业 应 用 程序 ， 需 要 使 用 一 些 更 稳 
健 的 东西 。 在 这 个 类 中 的 主要 核心 方法 取 自 Component, Container, Window, 
Frame 和 Jframe 类 。 


类 构造 函数 
S.N. 构造 方法 及 描述 
1 ApplicationFrame(java.lang.String title) 它 会 创建 一 个 字符 串 标题 的 
应 用 程序 框架 。 


这 个 类 有 助 于 创建 AWT 框 架 。 这 就 是 为 什么 我 们 使 用 这 个 类 作为 父 类 在 本 教程 中 的 
例子 的 原因 。 


其 采取 父 类 的 方法 用 于 打开 一 个 框架 ， 关 闭 一 个 框架 ， 改 变 大 小 ， 改 变 背 景 或 前 景 
颜色 和 监听 器 。 


RefineryUtilities : 


这 是 关于 用 户 界 面 的 工具 方法 的 类 的 集合 。 


类 方法 
S.N. 方法 及 描述 
centerFrameOnScreen(java.awt.Window frame) 它 定位 在 屏幕 的 中 间 
的 指定 帧 。 


在 上 述 方法 中 使 用 的 教程 例子 以 外 的 类 ， 方 法 和 字段 参见 JFreeChart 的 API。 


JFreeChart/i 4 - JFreeChart 


在 人 饼 图 中 ， 每 个 属 区 的 弧 长 成 正比 它 代 表 的 数量 。 本 章 演示 了 如 何 使 用 JFreeChart 
从 一 个 给 定 的 业务 数据 创建 饼 图 。 


业务 数据 
下 面 的 例子 描述 了 移动 销售 饼 图 。 以 下 是 不 同 移动 品牌 和 销售 (每 天 单位 ) 列 表 。 
S.N. 手机 品牌 销售 (天 ) 
1 Iphone 5S 20 
2 Samsung Grand 20 
3 MOTO G 40 
4 Nokia Lumia 10 
基于 AWT 应 用 


EL FM E EAS SOE SAAN. UE a LARS BIER — 1 BEES TETE 
何 AWT 应 用 程序 。 


import javax.swing. JPanel; 

import org.jfree.chart.ChartFactory; 

import org.jfree.chart.ChartPanel; 

import org.jfree.chart.JFreeChart; 

import org.jfree.data.general.DefaultPieDataset; 
import org.jfree.data.general.PieDataset; 

import org.jfree.ui.ApplicationFrame; 

import org.jfree.ui.RefineryUtilities; 


public class PieChart AWT extends ApplicationFrame 


{ 
public PieChart_AWT( String title ) 


{ 
super( title ); 
setContentPane(createDemoPanel( )); 

} 

private static PieDataset createDataset( ) 

{ 
DefaultPieDataset dataset = new DefaultPieDataset( ); 
dataset.setValue( "IPhone 5s" , new Double( 20 ) ); 
dataset.setValue( "SamSung Grand" , new Double( 20 ) ); 
dataset.setValue( "MotoG" , new Double( 40 ) ); 
dataset.setValue( "Nokia Lumia" , new Double( 10 ) ); 
return dataset; 

} 


private static JFreeChart createChart( PieDataset dataset ) 


{ 
JFreeChart chart = ChartFactory.createPieChart( 
"Mobile Sales", // chart title 


dataset, // data 

true, // include legend 
true, 

false); 


return chart; 


public static JPanel createDemoPanel( ) 


{ 
JFreeChart chart = createChart(createDataset( ) ); 
return new ChartPanel( chart ); 

j 

public static void main( String[ ] args ) 

{ 
PieChart AWT demo = new PieChart_AWT( "Mobile Sales" ); 
demo.setSize( 560 , 367 ); 
RefineryUtilities.centerFrameOnScreen( demo ); 
demo.setVisible( true ); 

j 


让 我 们 继续 上 面 PieChart_AWTjava 文 件 中 的 Java 人 代码， 然后 从 命令 提示 符 下 编译 
并 运行 它 ， 如 下 所 示 : 


$javac PieChart_AWT.java 
$java PieChart_AWT 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 生成 以 下 人 饼 图 : 
Mobile Sales 





€ IPhone 5s € SamSung Grand 9 MotoG © Nolda Lumia 


如 果 不 需 要 在 应 用 程序 对 入 图 表 中 ， 那 么 可 以 在 命令 提示 符 下 创建 图 表 的 图 像 。 
JFreeChart 人 允许 以 JPG 或 PNG 格 式 保存 图 表 图 像 。 


JPEG 创 建 图 像 


让 我 们 重新 写 上 面 的 例子 ， 生 成 命令 行 JPEG 图 像 。 以 下 是 通过 JFreeChart 库 ， 按 
要 求 提 供 两 个 API， 用 它 来 生成 PNG 或 JPEG 图 像 。 
e saveChartAsPNG() - API 用 来 保存 图 像 为 PNG 格 式 。 


e saveChartAsJPEG() - API 用 来 保存 图 像 JPEG 格 式 。 


import 
import 
import 
import 
import 


public 
pub 
{ 


java.io.*; 
org.jfree.chart.ChartUtilities; 
org.jfree.chart.ChartFactory; 
org.jfree.chart.JFreeChart; 
org.jfree.data.general.DefaultPieDataset; 


class PieChart { 
lic static void main( String[ ] args ) throws Exception 


DefaultPieDataset dataset = new DefaultPieDataset( ); 
dataset.setValue("IPhone 5s", new Double( 20 ) ); 
dataset.setValue("SamSung Grand", new Double( 20 ) ); 
dataset.setValue("MotoG", new Double( 40 ) ); 
dataset.setValue("Nokia Lumia", new Double( 10 ) ); 


JFreeChart chart = ChartFactory.createPieChart( 
"Mobile Sales", // chart title 
dataset, // data 
true, // include legend 
true, 
false); 


int width = 640; /* Width of the image */ 

int height = 480; /* Height of the image */ 

File pieChart = new File( "PieChart.jpeg" ); 
ChartUtilities.saveChartAsJPEG( pieChart , chart , width , he 





保持 PieC 
如 下 所 示 


$javac 
$java 


hart.java 文 件 中 如 上 面 的 Java 代 码 ， 然 后 从 命令 提示 符 下 编译 并 运行 它 ， 


PieChart.java 
PieChart 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 在 当前 的 目录 中 创建 JPEG 图 像 文 件 为 
namedPieChart.jpeg. 


JFreeChart& i? 4 - JFreeChart 教 程 


本 章 演 示 了 如 何 使 用 JFreeChart 从 一 个 给 定 的 业务 数据 创建 条 形 图 。 
条 形 图 使 用 不 同 的 方位 (水 平 或 垂直 ) 条 ， 以 显示 不 同类 别 的 比较 。 图 表 中 的 一 个 轴 
( 域 轴 ) 示 出 了 特定 的 域 进行 比较 ， 并 在 另 一 个 轴 ( 范 转轴 ) 表 示 的 离散 值 。 


业务 数据 


下 面 的 例子 描述 了 各 种 汽车 用 统计 柱状 图 。 以 下 是 汽车 品牌 以 及 它们 的 不 同 特 点 ， 
我 们 将 展示 使 用 一 个 条 形 图 的 列表 : 


汽车 速度 用 户 评价 公里 数 安全 性 
Fiat 1.0 3.0 5.0 5.0 
Audi 5.0 6.0 10.0 4.0 
Ford 4.0 2.0 3.0 6.0 


基于 AWT 的 应 用 


以 下 是 对 从 上 述 给 定 的 信息 创建 条 形 图 的 代码 。 此 代码 可 以 在 AWT 的 应 用 程序 圣人 


一 个 条 形 图 。 


import org.jfree.chart.ChartFactory; 

import org.jfree.chart.ChartPanel; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.plot.PlotOrientation; 

import org.jfree.data.category.CategoryDataset; 

import org.jfree.data.category.DefaultCategoryDataset; 
import org.jfree.ui.ApplicationFrame; 

import org.jfree.ui.RefineryUtilities; 


public class BarChart AWT extends ApplicationFrame 
{ 
public BarChart_AWT( String applicationTitle , String chartTitle 
{ 
super( applicationTitle ); 
JFreeChart barChart = ChartFactory.createBarChart( 
chartTitle, 


"Category", 

"Score", 

createDataset(), 
PlotOrientation.VERTICAL, 
true, true, false); 


ChartPanel chartPanel = new ChartPanel( barChart ); 
chartPanel.setPreferredSize(new java.awt.Dimension( 560 , 36; 
setContentPane( chartPanel ); 


} 
private CategoryDataset createDataset( ) 
{ 

final String fiat = "FIAT"; 

final String audi = "AUDI"; 

final String ford = "FORD"; 


final String speed = "Speed"; 

final String millage = "Millage"; 

final String userrating = "User Rating"; 
final String safety = "safety"; 

final DefaultCategoryDataset dataset = 
new DefaultCategoryDataset( ); 


dataset.addValue( 1.0 , fiat , speed ); 
dataset.addValue( 3.0 , fiat , userrating ); 
dataset.addValue( 5.0 , fiat , millage ); 
dataset.addValue( 5.0 , fiat , safety ); 
dataset.addValue( 5.0 , audi , speed ); 
dataset.addValue( 6.0 , audi , userrating ); 
dataset.addValue( 10.0 , audi , millage ); 
dataset.addValue( 4.0 , audi , safety ); 
dataset.addValue( 4.0 , ford , speed ); 
dataset.addValue( 2.0 , ford , userrating ); 
dataset.addValue( 3.0 , ford , millage ); 
dataset.addValue( 6.0 , ford , safety ); 


return dataset; 


public static void main( String[ ] args ) 


{ 
BarChart AWT chart = new BarChart_AWT("Car Usage Statistics", 
chart.pack( ); 
RefineryUtilities.centerFrameOnScreen( chart ); 
chart.setVisible( true ); 

} 





保持 BarChart_AWTjava 文 件 中 的 Java 代 码 ， 然 后 从 命令 提示 符 下 编译 并 运行 它 ， 
如 下 所 示 : 
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$javac BarChar_AWT.java 
$java BarChart AWT 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 生成 以 下 条 形 图 : 


Which car do you like? 


64 
5i 
4 
3:l 
24 
11 
0- 


Speed User Rating Millage 
Category 


@ FIAT W AUDI ® FORD 





JPEG 创 建 图 像 
让 我 们 重新 写 上 面 的 例子 中 ， 使 用 命令 行 生 成 JPEG 图 像 。 
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import 
import 
import 
import 
import 
import 


public 


X 
pub 


( 


java.io.*; 
org.jfree.chart.ChartFactory; 
org.jfree.chart.JFreeChart; 
org.jfree.chart.plot.PlotOrientation; 


org.jfree.data.category.DefaultCategoryDataset; 
org.jfree.chart.ChartUtilities; 

class BarChart 

lic static void main( String[ ] args )throws Exception 
final String fiat = "FIAT"; 

final String audi = "AUDI"; 

final String ford = "FORD"; 


final String speed = "Speed"; 

final String millage = "Millage"; 

final String userrating = "User Rating"; 
final String safety = "safety"; 


final DefaultCategoryDataset dataset = new DefaultCategoryDat 


dataset .addValue( Fiat speed ); 


1.0, / 
dataset.addValue( 3.0 , fiat , userrating ); 
dataset.addValue( 5.0 , fiat , millage ); 
dataset.addValue( 5.0 , fiat , safety ); 
dataset.addValue( 5.0 , audi , speed ); 
dataset.addValue( 6.0 , audi , userrating ); 
dataset.addValue( 10.0 , audi , millage ); 
dataset.addValue( 4.0 , audi , safety ); 


dataset.addValue( 
dataset.addValue( 
dataset.addValue( 
dataset.addValue( 


, ford , speed ); 

7 , userrating ); 
, ford , millage ); 

7 , safety ); 


OwWN 上 
DDD 


JFreeChart barChart = ChartFactory.createBarChart( 
"CAR USAGE STATIStICS", 
"Category", "Score", 
dataset, PlotOrientation.VERTICAL, 
true, true, false); 


int width = 640; /* Width of the image */ 

int height = 480; /* Height of the image */ 

File BarChart = new File( "BarChart.jpeg" ); 
ChartUtilities.saveChartAsJPEG( BarChart , barChart , width , 











保存 BarChart.java 文 件 中 如 上 面 的 Java 代 码 ， 然 后 从 命令 提示 符 下 编译 并 运行 它 ， 
如 下 所 示 : 


$javac BarChart.java 
$java BarChart 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 在 当前 的 目录 中 创建 JPEG 图 像 文 件 
namedBarChart.jpeg 


JFreeChart 线 型 图 - JFreeChart 教 程 
线 图 或 折线 图 来 显示 信息 为 一 系列 由 直线 段 连接 的 数据 点 (标记 )。 线 图 显示 数据 在 


相同 的 时 间 频 率 如 何 变 化 。 本 章 从 一 个 给 定 的 业务 数据 演示 如 何 使 用 JFreeChart 创 
建 线 型 图 。 


业务 数据 


下 面 的 示例 绘制 折线 图 显示 从 1970 年 开始 学 校 在 不 同年 份 开 通 数 量 。 
给 定 的 数据 如 下 : 


年 份 学 校 数 量 
1970 15 
1980 30 
1990 60 
2000 120 
2013 240 
2014 300 
基于 AWT 的 应 用 


以 下 是 对 从 上 述 给 定 的 信息 创建 线 型 图 的 代码 。 此 代码 可 以 帮助 在 AWT 的 应 用 程序 
ERA — TTR Bo 


import 
import 
import 
import 
import 
import 
import 


public 


{ 
pub 


{ 


} 


org.jfree.chart.ChartPanel; 
org.jfree.chart.ChartFactory; 
org.jfree.chart.JFreeChart; 
org.jfree.ui.ApplicationFrame; 
org.jfree.ui.RefineryUtilities; 
org.jfree.chart.plot.PlotOrientation; 
org.jfree.data.category.DefaultCategoryDataset; 


class LineChart_AWT extends ApplicationFrame 
lic LineChart_AWT( String applicationTitle , String chartTit- 


super (applicationTitle); 
JFreeChart lineChart = ChartFactory.createLineChart ( 
chartTitle, 
"Years","Number of Schools", 
createDataset(), 
PlotOrientation.VERTICAL, 
true,true,false); 


ChartPanel chartPanel - new ChartPanel( lineChart ); 
chartPanel.setPreferredSize( new java.awt.Dimension( 560 , 3t 
setContentPane( chartPanel ); 


private DefaultCategoryDataset createDataset( ) 


( 


DefaultCategoryDataset dataset = new DefaultCategoryDataset ( 
dataset.addValue( 15 , "schools" , "1970" ); 
dataset.addValue( 30 , "schools" , "1980" ); 
dataset.addValue( 60 , "schools" , "1990" ); 
dataset.addValue( 120 , "schools" , "2000" ); 
dataset.addValue( 240 , "schools" , "2010" ); 
dataset.addValue( 300 , "schools" , "2014" ); 

return dataset; 


public static void main( String[ ] args ) 


( 


LineChart AWT chart - new LineChart AWT( 
"School Vs Years" , 
"Numer of Schools vs years"); 


chart.pack( ); 
RefineryUtilities.centerFrameOnScreen( chart ); 
chart.setVisible( true ); 











保存 LineChart_AWTjava 文 件 如 上 面 的 Java 代 码 ， 然 后 从 命令 提示 符 下 编译 并 运行 
它 ， 如 下 所 示 : 
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$javac LineChart_AWT.java 
$java LineChart_AWT 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 生成 以 下 线 图 : 


Numer of Schools vs years 


1980 1990 2000 2070 2014 
Years 





创建 JPEG 图 像 
让 我 们 重新 编写 上 面 的 例子 ， 在 命令 行 执 行 生成 JPEG 图 像 。 
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import 
import 
import 
import 
import 
import 


public 


{ 
pub 


{ 


java.io.*; 

org.jfree.chart.JFreeChart; 
org.jfree.chart.ChartFactory; 
org.jfree.chart.ChartUtilities; 
org.jfree.chart.plot.PlotOrientation; 
org.jfree.data.category.DefaultCategoryDataset; 


class LineChart 
lic static void main( String[ ] args ) throws Exception 


DefaultCategoryDataset line chart dataset = new DefaultCateg 
line chart dataset.addValue( 15 , "schools" , "1970" ); 
line chart dataset.addValue( 30 , "schools" , "1980" ); 
line chart dataset.addValue( 60 , "schools" , "1990" ); 
line chart dataset.addValue( 120 , "schools" , "2000" ); 
line chart dataset.addValue( 240 , "schools" , "2010" ); 
line chart dataset.addValue( 300 , "schools" , "2014" ); 


JFreeChart lineChartObject = ChartFactory.createLineChart( 
"Schools Vs Years","Year", 
"Schools Count", 
line_chart_dataset, PlotOrientation.VERTICAL, 
true, true, false); 


int width = 640; /* Width of the image */ 

int height = 480; /* Height of the image */ 

File lineChart = new File( "LineChart.jpeg" ); 
ChartUtilities.saveChartAsJPEG(lineChart ,lineChartObject, w: 





让 我 们 保存 LineChart.java 文 件 如 上 面 的 Java 代 码 ， 然 后 从 命令 提示 符 下 编译 并 运 
行 它 ， 如 下 所 示 : 


$javac 
$java 


LineChart.java 
LineChart 


如 果 一 切 顺利 ， 它 将 编译 和 执行 在 当前 的 目录 中 创建 JPEG 图 像 文 件 
namedLineChart.jpeg。 
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在 xy 图 ( 散 点 图 ) 是 根据 一 个 数据 系列 组 成 的 x 和 y 值 的 列表 。 每 个 值 对 (x，y) 是 坐标 系 
中 的 一 个 点 。 这 里 1 值 确定 水 平 (X) 位 置 ， 而 另 一 个 确定 垂直 (Y) 位 置 。 本 章 演示 了 如 
何 使 用 JFreeChart 从 一 个 给 定 的 业务 数据 创建 XY 图 表 。 


业务 数据 


考虑 这 种 情况 ， 我 们 要 创建 一 个 XY 图 表 所 有 主要 浏览 器 的 一 个 例子 。 在 这 里 ， 不 同 
的 性 能 分 数 是 从 不 同类 型 的 人 们 聚集 ， 如 下 所 示 : 


Firefox Category(X) Score(Y) 
1.0 1.0 
2.0 4.0 
3.0 3.0 

Chrome Category(X) Score(Y) 
1.0 4.0 
2.0 5.0 
3.0 6.0 

IE Category(X) Score(Y) 
3.0 4.0 
4.0 5.0 
5.0 4.0 
基于 AWT 的 应 用 


以 下 是 对 从 上 述 给 定 的 信息 创建 XY 图 表 的 代码 。 此 代码 可 以 在 AWT 应 用 程序 圣人 
一 个 XY 图 表 。 


import java.awt.Color; 

import java.awt.BasicStroke; 

import org.jfree.chart.ChartPanel; 
import org.jfree.chart.JFreeChart; 
import org.jfree.data.xy.XYDataset; 
import org.jfree.data.xy.XYSeries; 


import org.jfree.ui.ApplicationFrame; 

import org.jfree.ui.RefineryUtilities; 

import org.jfree.chart.plot.XYPlot; 

import org.jfree.chart.ChartFactory; 

import org.jfree.chart.plot.PlotOrientation; 

import org.jfree.data.xy.XYSeriesCollection; 

import org.jfree.chart.renderer.xy.XYLineAndShapeRenderer; 


public class XYLineChart AWT extends ApplicationFrame 


i 


public XYLineChart AWT( String applicationTitle, String chartTil 


{ 


} 


super (applicationTitle); 
JFreeChart xylineChart = ChartFactory.createXYLineChart( 
chartTitle , 
"Category" , 
"Score" , 
createDataset() , 
PlotOrientation.VERTICAL , 
true , true , false); 


ChartPanel chartPanel - new ChartPanel( xylineChart ); 
chartPanel.setPreferredSize( new java.awt.Dimension( 560 , 3t 
final XYPlot plot - xylineChart.getXYPlot( ); 
XYLineAndShapeRenderer renderer = new XYLineAndShapeRenderer | 
renderer.setSeriesPaint( © , Color.RED ); 
renderer.setSeriesPaint( 1 , Color.GREEN ); 
renderer.setSeriesPaint( 2 , Color.YELLOW ); 
renderer.setSeriesStroke( O , new BasicStroke( 4.0f 
renderer.setSeriesStroke( 1 , new BasicStroke( 3.0f 
renderer.setSeriesStroke( 2 , new BasicStroke( 2.0f 
plot.setRenderer( renderer ); 

setContentPane( chartPanel ); 


~ 
~ ~ 
~ ~ 


se 


private XYDataset createDataset( ) 


{ 


final XYSeries firefo new XYSeries( "Firefox" ); 
firefox.add( 1.0 , 1. 

firefox.add( 2.0 , 4. 

firefox.add( 3.0 , 3. 
final XYSeries chrome 
chrome.add( 1.0 , 4.0 


) 
chrome.add( 2.0 , 5.0 ) 
) 
e 


OOOX 


chrome.add( 3.0 , 6.0 
final XYSeries iexplo 
iexplorer.add( 3.0 , 
iexplorer.add( 4.0 , 
iexplorer.add( 5.0 , 4.0 ); 

final XYSeriesCollection dataset - new XYSeriesCollection( ), 
dataset.addSeries( firefox ); 

dataset.addSeries( chrome ); 

dataset.addSeries( iexplorer ); 


ok 全 
Oo ny 3: ~ ~: 
w “ICI 
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return dataset; 


} 

public static void main( String[ ] args ) 

{ 
XYLineChart_AWT chart = new XYLineChart AWT("Browser Usage Si 
chart.pack( ); 
RefineryUtilities.centerFrameOnScreen( chart ); 
chart.setVisible( true ); 

} 





让 我 们 保存 XYLineChart_AWTjava 文 件 如 上 面 的 Java 代 码 ， 然 后 从 命令 提示 符 下 
编译 并 运行 它 ， 如 下 所 示 : 


$javac XYLineChart_AWT. java 


$java XYLineChart_AWT 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 生成 以 下 XY 图 : 


Which Browser are you using? 


“Flefox "Chrome = InternetExplorer 





创建 JPEG 图 像 
让 我 们 重新 编写 上 面 的 例子 ， 在 命令 行 生 成 JPEG 图 像 。 
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import java.io.*; 

import org.jfree.chart.ChartFactory; 

import org.jfree.chart.JFreeChart; 

import org.jfree.data.xy.XYSeries; 

import org.jfree.chart.plot.PlotOrientation; 
import org.jfree.data.xy.XYSeriesCollection; 
import org.jfree.chart.ChartUtilities; 


public class XYLineChart image 
{ 
public static void main( String[ ] args )throws Exception 
{ 
final XYSeries firefo new XYSeries( "Firefox" ); 
firefox.add( 1.0 , 1. 
firefox.add( 2.0, 4 
firefox.add( 3.0, 3 
final XYSeries chrome = 
chrome.add( 1.0 , 4.0 ) 
chrome.add( 2.0 , 5.0 ) 
) 
e 


OOOX 


, 
, 
, 
new XYSeries( "Chrome" ); 


chrome.add( 3.0 , 6.0 
final XYSeries iexplo 
iexplorer.add( 3.0 , 
iexplorer.add( 4.0 , 
iexplorer.add( 5.0 , 4.0 ); 

final XYSeriesCollection dataset - new XYSeriesCollection( ), 
dataset.addSeries( firefox ); 

dataset.addSeries( chrome ); 

dataset.addSeries( iexplorer ); 


new XYSeries( "InternetExplorer" 


ask a 
OOo 


JFreeChart xylineChart - ChartFactory.createXYLineChart( 
"Browser usage statastics", 
"Category", 
"Score", 
dataset, 
PlotOrientation.VERTICAL, 
true, true, false); 


int width = 640; /* Width of the image */ 

int height - 480; /* Height of the image */ 

File XYChart - new File( "XYLineChart.jpeg" ); 
ChartUtilities.saveChartAsJPEG( XYChart, xylineChart, width, 





让 我 们 保存 在 XYLineChart_ imageJjava 文 件 如 上 面 的 Java 人 代码， 然后 从 命令 提示 符 
下 编译 并 运行 它 ， 如 下 所 示 : 


$javac XYLineChart_image.java 
$java XYLineChart_image 


如 果 一 切 顺利 ， 它 会 编译 并 运行 在 当前 的 目录 中 创建 JPEG 图 像 文 件 
namedXYLineChart.jpeg. 
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三 维 /3D 图 表 是 那些 显示 在 一 个 三 维 格式 。 可 以 使 用 这 些 图 表 来 提供 更 好 的 显示 效 


果 和 清晰 的 信息 。 三 维 /3D 饼 图 是 饼 图 另外 一 个 不 错 的 3D 效 果 。 3D 效 果 可 以 通过 添 
加 一 些 额 外 的 代码 来 实现 ， 它 会 创建 一 个 饼 图 3D 效 果 。 


3D 饼 图 


请 看 下 面 的 例子 来 描述 移动 销售 三 维 饼 图 。 以 下 是 不 同 移动 品牌 和 销售 (每 天 ) 名 


o 


S.N. 手机 品牌 销量 (天 ) 
1 Iphone 5S 20 
2 Samsung Grand 20 
3 MOTO G 40 
4 Nokia Lumia 10 


AFE MERA EERO EIDA ARRA. HER AARAA TE 
AWT 应 用 程序 中 。 


import 
import 
import 
import 
import 
import 


public 


X 
pub 


( 


java.io.*; 

org.jfree.chart.ChartFactory; 
org.jfree.chart.JFreeChart; 
org.jfree.chart.plot.PiePlot3D; 
org.jfree.data.general.DefaultPieDataset; 
org.jfree.chart.ChartUtilities; 


class PieChart3D 
lic static void main( String[ ] args )throws Exception 


DefaultPieDataset dataset = new DefaultPieDataset( ); 
dataset.setValue( "IPhone 5s" , new Double( 20 ) ); 
dataset.setValue( "SamSung Grand" , new Double( 20 ) ); 
dataset.setValue( "MotoG" , new Double( 40 ) ); 
dataset.setValue( "Nokia Lumia" , new Double( 10 ) ); 


JFreeChart chart = ChartFactory.createPieChart3D( 
"Mobile Sales" , // chart title 


dataset , // data 

true , // include legend 
true, 

false); 


final PiePlot3D plot = ( PiePlot3D ) chart.getPlot( ); 
plot.setStartAngle( 270 ); 

plot.setForegroundAlpha( 0.60f ); 

plot.setInteriorGap( 0.02 ); 

int width = 640; /* Width of the image */ 

int height = 480; /* Height of the image */ 

File pieChart3D - new File( "pie Chart3D.jpeg" ); 
ChartUtilities.saveChartAsJPEG( pieChart3D , chart , width , 





让 我 们 保存 在 PieChart3D.java 文 件 如 上 面 的 Java 人 代码， 然后 从 命令 提示 符 下 编译 并 
运行 它 ， 如 下 所 示 : 


$javac 
$java 


如 果 一 切 ) 


PieChart3D.java 
PieChart3D 


顺利 ， 它 会 编译 并 运行 ， 以 创建 一 个 名 为 PieChart3D.jpeg 如 以 下 3D 饼 图 


JPEG 图 像 文件 : 
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Mobile Sales 





SamSung Grand 








€ iPhone 5s € SamSung Grand 9 MotoG ^ Nokia Lumia 


3D 条 形 图 


三 维 条 形 图 是 一 样 的 条 形 图 另外 一 个 不 错 的 3D 效 果 。 3D 效 果 可 以 通过 添加 一 些 额 
外 的 代码 来 实现 ， 它 会 创建 一 个 柱 形 图 3D 效 果 。 看 看 下 面 的 例子 ， 描 绘 各 种 汽车 的 
以 下 是 汽车 品牌 以 及 它们 的 不 同 特点 ， 我 们 将 展示 使 用 一 个 条 
形 图 的 列表 : 


Car Speed User Rating Millage Safety 
FIAT 1.0 3.0 5.0 5.0 
AUDI 5.0 6.0 10.0 4.0 
FORD 4.0 2.0 3.0 6.0 


"FEBUS M. ERAN Rl B3DR A. USA LAS EIER — P RB I8 TE 
AWT 应 用 程序 中 。 


JFreeChart 3D 人 饼 图 /条 形 图 - JFreeChart 教 程 1794 


import 
import 
import 
import 
import 
import 


public 


X 
pub 


( 


java.io.*; 

org.jfree.chart.ChartFactory; 
org.jfree.chart.JFreeChart; 
org.jfree.chart.plot.PlotOrientation; 
org.jfree.data.category.DefaultCategoryDataset; 
org.jfree.chart.ChartUtilities; 


class BarChart3D 
lic static void main( String[ ] args )throws Exception 


final String fait 
final String audi "AUDI"; 

final String ford "FORD"; 

final String speed = "Speed"; 

final String popular = "Popular"; 

final String mailage = "Mailage"; 

final String userrating = "User Rating"; 

final String safty = "safty"; 

final DefaultCategoryDataset dataset = new DefaultCategoryDat 


HEA TIa 


dataset.addValue( 1.0 , fait , speed ); 
dataset.addValue( 4.0 , fait , popular ); 
dataset.addValue( 3.0 , fait , userrating ); 
dataset.addValue( 5.0 , fait , mailage ); 
dataset.addValue( 5.0 , fait , safty ); 
dataset.addValue( 5.0 , audi , speed ); 
dataset.addValue( 7.0 , audi , popular ); 
dataset.addValue( 6.0 , audi , userrating ); 
dataset.addValue( 10.0 , audi , mailage ); 
dataset.addValue( 4.0 , audi , safty ); 
dataset.addValue( 4.0 , ford , speed ); 
dataset.addValue( 3.0 , ford , popular ); 
dataset.addValue( 2.0 , ford , userrating ); 
dataset.addValue( 3.0 , ford , mailage ); 
dataset.addValue( 6.0 , ford , safty ); 


JFreeChart barChart ChartFactory.createBarChart3D( 
"Car Usage Statistics", 
"Category", 
"Score", 
dataset, 
PlotOrientation.VERTICAL, 
true, true, false); 


int width = 640; /* Width of the image */ 

int height = 480; /* Height of the image */ 

File barChart3D - new File( "barChart3D.jpeg" ); 
ChartUtilities.saveChartAsJPEG( barChart3D, barChart, width, 


007g 
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让 我 们 保存 在 BarChart3D.java 文 件 如 上 面 的 Java 代 码 ， 然 后 从 命令 提示 符 下 编译 
并 运行 它 ， 如 下 所 示 : 


$javac BarChart3D. java 
$java BarChart3 


如 果 一 切 正常 ， 它 会 编译 并 运行 创建 的 JPEG 图 像 fleBarChart3D.jpeg， 上 有 具有 下 列 
3D 条 形 图 : 


Car Usage Statistics 


Score 





Speed Popular User Rating Malage safty 
Category 


BFAI W AUDI ® FORD 
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本 章 演示 如 何 使 用 JFreeChart 从 一 个 给 定 的 业务 数据 创建 气泡 图 表 。 使 用 气泡 图 显 
示 在 三 维 方式 的 信息 。 气 泡 绘制 在 其 中 (x，y) 坐 标 相 交 的 地 方 。 气 泡 的 大 小 被 认为 
是 范围 或 X 和 Y 轴 的 数量 。 


业务 数据 


考虑 不 同 的 人 的 年 龄 ， 体 重 和 工作 能 力 可 能 不 太 相同 。 能 力 可 以 视 为 对 该 被 绘制 为 
图 表 中 的 气泡 的 小 时 数 。 


AGE 30 40 50 60 70 80 
10 4 WORK 
20 5 
30 10 
40 8 
50 9 
60 6 


基于 AWT 的 应 用 


以 下 是 对 从 上 述 给 定 的 信息 创建 气泡 图 表 的 代码 。 此 代码 可 以 帮助 褒 入 一 个 气泡 图 
在 AWT 应 用 程序 。 


import java.awt.Color; 

import java.awt.Dimension; 

import javax.swing. JPanel; 

import org.jfree.chart.*; 

import org.jfree.chart.axis.NumberAxis; 
import org.jfree.chart.plot.PlotOrientation; 
import org.jfree.chart.plot.XYPlot; 

import org.jfree.chart.renderer.xy.XYItemRenderer; 
import org.jfree.data.xy.DefaultXYZDataset; 
import org.jfree.data.xy.XYZDataset; 

import org.jfree.ui.ApplicationFrame; 

import org.jfree.ui.RefineryUtilities; 


public class BubbleChart AWT extends ApplicationFrame 


{ 
public BubbleChart_AWT( String s ) 


super( s ); 

JPanel jpanel = createDemoPanel( ); 
jpanel.setPreferredSize(new Dimension( 560 , 370 ) ); 
setContentPane( jpanel ); 


j 


private static JFreeChart createChart( XYZDataset xyzdataset ) 
d 
JFreeChart jfreechart = ChartFactory.createBubbleChart( 
"AGE vs WEIGHT vs WORK", 
"Weight", 
"AGE", 
xyzdataset, 
PlotOrientation.HORIZONTAL, 
true, true, false); 


XYPlot xyplot - ( XYPlot )jfreechart.getPlot( ); 
xyplot.setForegroundAlpha( 0.65F ); 

XYItemRenderer xyitemrenderer - xyplot.getRenderer( ); 
xyitemrenderer.setSeriesPaint( 0 , Color.blue ); 

NumberAxis numberaxis - ( NumberAxis )xyplot.getDomainAxis( 
numberaxis.setLowerMargin( 0.2 ); 
numberaxis.setUpperMargin( 0.5 ); 

NumberAxis numberaxisi = ( NumberAxis )xyplot.getRangeAxis( 
numberaxisi.setLowerMargin( 0.8 ); 
numberaxisi.setUpperMargin( 0.9 ); 


return jfreechart; 


j 

public static XYZDataset createDataset( ) 

{ 
DefaultXYZDataset defaultxyzdataset = new DefaultXYZDataset(: 
double ad[ ] = { 30, 40, 50, 60 , 70, 80 Y; 
double adi[ ] = { 10 , 20 , 30 , 40 , 50 , 60 }; 
double ad2p 12 4:4. > 195,789: 05735 
double ad3[][] = ( ad , adi , ad2 Y; 
defaultxyzdataset.addSeries( "Series 1" , ad3 ); 
return defaultxyzdataset; 

} 

public static JPanel createDemoPanel( ) 

{ 


JFreeChart jfreechart 
ChartPanel chartpanel 


createChart( createDataset( ) ); 
new ChartPanel( jfreechart ); 


chartpanel.setDomainZoomable( true ); 
chartpanel.setRangeZoomable( true ); 


return chartpanel; 
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} 


public static void main( String args[ ] ) 


{ 
Bubblechart AWT bubblechart = new BubbleChart AWT( "Bubble CI 


bubblechart.pack( ); 
RefineryUtilities.centerFrameOnScreen( bubblechart ); 
bubblechart.setVisible( true ); 





让 我 们 保存 上 面 的 Java 代 码 在 BubbleChart_AWTjava 文 件 ， 然 后 从 命令 提示 符 下 
编译 并 运行 它 ， 如 下 所 示 : 


$javac BubbleChart_AWT. java 
$java BubbleChart_Aw 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 生成 以 下 气泡 图 : 


AGE vs WEIGHT vs WORK 


Sud 
àil 
7| 
0 | 
- 
4o] 
=| 


名 





创建 JPEG 图 像 
让 我 们 重新 编写 上 面 的 例子 ， 在 命令 行 生 成 JPEG 图 像 。 
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import java.io.*; 

import java.awt.Color; 

import org.jfree.chart.*; 

import org.jfree.chart.axis.NumberAxis; 

import org.jfree.chart.plot.PlotOrientation; 
import org.jfree.chart.plot.XYPlot; 

import org.jfree.chart.renderer.xy.XYItemRenderer; 
import org.jfree.data.xy.DefaultXYZDataset; 

import org.jfree.chart.ChartUtilities; 


public class BubbleChart image 


{ 
public static void main( String args[ ] )throws Exception 
{ 
DefaultXYZDataset defaultxyzdataset = new DefaultXYZDataset ( 
double ad[ ] = { 309, 40, 50, 60 , 70, 80 Y; 
double ad1[ ] = { 10, 20 , 30 , 40 , 50, 60 Y; 
double ad2[ ]={4, 5, 10, 8,9, 6}; 
double ad3[ ][ ] = { ad , adi, ad2 Y; 
defaultxyzdataset.addSeries( "Series 1" , ad3 ); 
JFreeChart jfreechart = ChartFactory.createBubbleChart( 
"AGE vs WEIGHT vs WORK", 
"Weight", 
"AGE", 
defaultxyzdataset, 
PlotOrientation.HORIZONTAL, 
true, true, false); 
XYPlot xyplot - ( XYPlot )jfreechart.getPlot( ); 
xyplot.setForegroundAlpha( 0.65F ); 
XYItemRenderer xyitemrenderer - xyplot.getRenderer( ); 
xyitemrenderer.setSeriesPaint( 0 , Color.blue ); 
NumberAxis numberaxis - ( NumberAxis )xyplot.getDomainAxis( 
numberaxis.setLowerMargin( 0.2 ); 
numberaxis.setUpperMargin( 0.5 ); 
NumberAxis numberaxisi = ( NumberAxis )xyplot.getRangeAxis( 
numberaxisi.setLowerMargin( 0.8 ); 
numberaxisi.setUpperMargin( 0.9 ); 
int width = 560; /* Width of the image */ 
int height = 370; /* Height of the image */ 
File bubbleChart = new File("BubbleChart.jpeg"); 
ChartUtilities.saveChartAsJPEG(bubbleChart, jfreechart,width,I 
} 
} 





让 我 们 保存 上 面 的 Java 代 码 在 BubbleChart_ imageJjava 文 件 ， 然 后 从 命令 提示 符 下 
编译 并 运行 它 ， 如 下 所 示 : 


$javac BubbleChart_image.java 
$java BubbleChart_image 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 在 当前 的 目录 中 创建 的 JPEG 图 像 文 件 
namedBubbleChart.jpeg. 
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时 序 图 表 显 示 的 数据 点 在 相等 的 时 间 间 隅 序列 变化 。 本 章 演 示 了 如 何 从 一 个 给 定 的 
业务 数据 使 用 JFreeChart， 建 立时 序 图 。 


业务 数据 


让 我 们 考虑 通过 使 用 标准 Java API 的 Math.random() 产 生 的 各 种 随机 数 。 我 们 使 用 
这 些 数 字 产 生 一 个 时 间 序列 图 。 可 以 生成 用 于 发 生 错 误 的 总 数 在 自己 的 网 站 给 定 的 
时 间 间 隔 类 似 的 图 表 。 


基于 AWT 的 应 用 


下 面 是 创建 由 Math.random() 产 生 的 数字 时 间 的 代码 在 给 定时 间 内 的 序列 图 。 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 


org. 
org. 


org 


org. 
org. 
org. 
org. 
org. 
org. 


org 


jfree. 
jfree. 
.jfree. 
jfree. 
jfree. 
jfree. 
jfree. 
jfree. 
jfree. 
.jfree. 


chart.ChartFactory; 
chart.ChartPanel; 
chart.JFreeChart; 
data.general.SeriesException; 
data.time.Second; 

data. time.TimeSeries; 

data. time.TimeSeriesCollection; 
data.xy.XYDataset; 
ui.ApplicationFrame; 
ui.RefineryUtilities; 


public class TimeSeries AWT extends ApplicationFrame 


( 


public TimeSeries AWT( final String title ) 


( 


j 


super( title ); 

final XYDataset dataset - createDataset( ); 

final JFreeChart chart - createChart( dataset ); 

final ChartPanel chartPanel - new ChartPanel( chart ); 
chartPanel.setPreferredSize( new java.awt.Dimension( 560 , 
chartPanel.setMouseZoomable( true , false ); 
setContentPane( chartPanel ); 


private XYDataset createDataset( ) 


i 


final TimeSeries series = new TimeSeries( "Random Data" ); 
Second current = new Second( ); 

double value 
for (int i 


{ 


= 100.0; 
0; i < 4000; i++) 


try 

{ 
value = value + Math.random( ) - 0.5; 
series.add(current, new Double( value ) ); 
current = ( Second ) current.next( ); 


} 


catch ( SeriesException e ) 


{ 
} 


System.err.println("Error adding to series"); 


} 


return new TimeSeriesCollection(series); 


j 


private JFreeChart createChart( final XYDataset dataset ) 
1 

return ChartFactory.createTimeSeriesChart( 

"Computing Test", 

"Seconds", 

"Value", 

dataset, 

false, 

false, 

false); 


j 


public static void main( final String[ ] args ) 

t 
final String title - "Time Series Management"; 
final TimeSeries AWT demo - new TimeSeries AWT( title ); 
demo.pack( ); 
RefineryUtilities.positionFrameRandomly( demo ); 
demo.setVisible( true ); 





保存 上 面 的 Java 代 码 在 TimeSeries_AWTjava 文 件 ， 然 后 从 命令 提示 符 下 编译 并 运 
行 它 ， 如 下 所 示 : 


$javac TimeSeries AWT.java 
$java TImeSeries AWT 


如 果 一 切 顺利 ， 它 会 编译 并 运行 生成 以 下 时 序 图 : 
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Computing Test 


15:50 16:00 16:10 16:20 16:30 16:40 16:50 
Seconds 





创建 JPEG 图 像 
让 我 们 重新 编写 上 面 的 例子 ， 在 命令 行 生 成 JPEG 图 像 。 
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import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


{ 
pub 


{ 


java.io.*; 

org.jfree.chart.ChartFactory; 
org.jfree.chart.JFreeChart; 
org.jfree.data.general.SeriesException; 
org.jfree.data.time.Second; 
org.jfree.data.time.TimeSeries; 
org.jfree.data.time.TimeSeriesCollection; 
org.jfree.data.xy.XYDataset; 
org.jfree.chart.ChartUtilities; 


class TimeSeriesChart 

lic static void main( final String[ ] args )throws Exception 
final TimeSeries series - new TimeSeries( "Random Data" ); 
Second current - new Second(); 


double value - 100.0; 
for ( int i=0; i < 4000 ; i++ ) 


{ 
try 
{ 
value = value + Math.random( ) - 0.5; 
series.add( current , new Double( value ) ); 
current = ( Second ) current.next( ); 
} 
catch ( SeriesException e ) 
{ 
System.err.println( "Error adding to series" ); 
J 
} 


final XYDataset dataset=( XYDataset )new TimeSeriesCollectior 
JFreeChart timechart = ChartFactory.createTimeSeriesChart( 

"Computing Test", 

"Seconds", 

"Value", 

dataset, 

false, 

false, 

false); 


int width = 560; /* Width of the image */ 

int height = 370; /* Height of the image */ 

File timeChart = new File( "TimeChart.jpeg" ); 
ChartUtilities.saveChartAsJPEG( timeChart, timechart, width, 





继续 上 面 的 Java 代 码 保存 在 TimeSeriesChart.java 文 件 中 ， 然 后 从 命令 提示 符 下 编 
译 并 运行 它 ， 如 下 所 示 : 


$javac TimeSeriesChart.java 
$java TimeSeriesChart 


如 果 一 切 正 常 ， 它 会 编译 并 运行 在 当前 的 目录 中 创建 JPEG 图 像 文 件 
TimeChart.jpeg 文 件 。 


JFreeChart 文 件 接口 - JFreeChart 教 程 


到 目前 为 止 ， 我 们 学 习 了 如 何 使 用 静态 数据 的 创建 不 同类 型 的 JFreeChart APIA 
表 。 但 在 生产 环境 中 ， 数 据 被 设置 在 文本 文件 的 形式 与 一 个 预定 义 的 格式 ， 或 者 其 
直接 来 自 数 据 库 。 

本 章 将 解释 如 何 我 们 可 以 看 到 从 一 个 给 定 的 位 置 给 定 的 文本 文件 ， 一 个 简单 的 数 
据 ， 然 后 使 用 JFreeChart 创 建 图 表 。 


业务 数据 


假设 我 们 有 一 个 文件 名 为 mobile.txt， 含 有 一 个 简单 的 有 逗号 分 隔 不 同 的 移动 品牌 和 销 
售 (每 天 单位 )(，) : 


Iphone 5S, 20 
Samsung Grand, 20 
MOTO G, 40 Nokia 
Lumia, 10 


基于 文件 图 表 生 成 


下 面 是 基于 文件 mobile.txt 提供 的 信息 来 创建 一 个 饼 图 的 代码 : 


import 
import 
import 
import 
import 
import 


public 


X 
pub 


( 


java.io.*; 

java.util.StringTokenizer; 
org.jfree.chart.ChartUtilities; 
org.jfree.chart.ChartFactory; 
org.jfree.chart.JFreeChart; 
org.jfree.data.general.DefaultPieDataset; 


class PieChart_File 
lic static void main( String[ ] args )throws Exception 


String mobilebrands[ ] = { 
"IPhone 5s" , 
"SamSung Grand" , 
"MotoG" , 
"Nokia Lumia" 


}; 


InputStream in = new FileInputStream( new File( "C:/temp/tesi 
BufferedReader reader = new BufferedReader(new InputStreamRe: 
StringBuilder out = new StringBuilder(); 

String line; 

DefaultPieDataset dataset = new DefaultPieDataset(); 


while (( line - reader.readLine() ) !- null ) 


t 
} WW 


StringTokenizer s - new StringTokenizer( out.toString(), ", 
int i-0; 
while( s.hasMoreTokens( ) && ( mobilebrands [i] !- null ) ) 


out.append( line ); 


dataset.setValue(mobilebrands[i], Double.parseDouble( s.ne 


i++; 


} 


JFreeChart chart = ChartFactory.createPieChart( 
"Mobile Sales", // chart title 


dataset, // data 

true, // include legend 
true, 

false); 


int width = 560; /* Width of the image */ 

int height = 370; /* Height of the image */ 

File pieChart = new File( "pie_Chart.jpeg" ); 
ChartUtilities.saveChartAsJPEG( pieChart, chart, width, heigl 
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让 我 们 保存 上 面 的 Java 代 码 在 PieChart_FileJjava 文 件 ， 然 后 从 命令 提示 符 下 编译 并 
运行 它 ， 如 下 所 示 : 


$javac PieChart_File.java 
$java PieChart_File 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 以 创建 包含 下 面 的 图 表 名 为 PieChart.jpegthat 
JPEG 图 像 文 件 。 


Mobile Sales 


SamSung Grand 





€ IPhone 5s 6 SamSung Grand 9 MotoG ^ Nokia Lumia 
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ah DIMISSUS 单 的 数据 ， 然 后 JFreeChart 使 用 这 些 数据 来 创 
建 图 表 。 


业务 数据 


考虑 到 我 们 有 如 下 的 MySQL 表 mobile_tbl(mobile_brand VARCHAR(100)NOT 
NULL, unit_sale INT NO NULL); 


考虑 这 个 表 含 有 以 下 记录 : 
手机 品牌 销售 单位 
IPhone5S 20 
Samsung Grand 20 
MotoG 40 
Nokia Lumia 10 
使 用 数据 库 数 据 生成 图 表 


下 面 是 创建 一 个 基于 MySQL 数 据 库 mobile tblz& 在 数据 库 实 例 TEST_DB 中 提供 
的 信息 饼 图 的 代码 。 根 据 需要 ， 可 以 使 用 任何 其 他 数据 库 。 


import java.io.*; 

import java.sql.*; 

import org.jfree.chart.ChartUtilities; 

import org.jfree.chart.ChartFactory; 

import org.jfree.chart.JFreeChart; 

import org.jfree.data.general.DefaultPieDataset; 


public class PieChart DB 
{ 
public static void main( String[ ] args )throws Exception 
{ 
String mobilebrands[] = { 
"IPhone 5s", 
"SamSung Grand", 
"MotoG", 
"Nokia Lumia" 


HH 


/* Create MySQL Database Connection */ 
Class.forName( "com.mysql.jdbc.Driver" ); 
Connection connect - DriverManager.getConnection( 
"jdbc:mysq1://1localhost:3306/jf testdb" , 

"root", 

"roob1292 97 


Statement statement - connect.createStatement( ); 
ResultSet resultSet = statement.executeQuery("Select * from ¢ 
DefaultPieDataset dataset = new DefaultPieDataset( ); 
while( resultSet.next( ) ) 
t 
dataset.setValue( 
resultSet.getString( "brandname" ) , 
Double.parseDouble( resultSet.getString( "datavalue" ))); 
} 
JFreeChart chart = ChartFactory.createPieChart( 
"Mobile Sales", // chart title 
dataset, // data 
true, // include legend 
true, 
false ); 


int width = 560; /* Width of the image */ 

int height = 370; /* Height of the image */ 

File pieChart = new File( "Pie_Chart.jpeg" ); 
ChartUtilities.saveChartAsJPEG( pieChart , chart , width , he 








让 我 们 保存 上 面 的 Java 代 码 在 PieChart_DB.java 文 件 ， 然 后 从 命令 提示 符 下 编译 并 
运行 它 ， 如 下 所 示 : 
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$javac PieChart_DB.java 
$java PieChart_DB 


如 果 一 切 顺 利 ， 它 会 编译 并 运行 并 创建 一 个 名 为 Pie_Chart.jpeghavingJPEG 图 像 文 
件 ， 如 下 图 。 


Nokia | Lumia! 


MotoG 





€ IPhone5s € Samsung Gramd ® MotoG © Nokia Lumia 
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JMeter 教 程 


JMeter 是 什么 ? 


JMeter 是 一 个 软件 ， 使 负载 测试 或 业绩 为 导向 的 业务 (功能 ) 测试 不 同 的 协议 或 技 
术 。 Apache 软 件 基金 会 的 Stefano Mazzocchi JMeter 的 最 初 的 开发 。 他 写 道 : 它 
主要 对 Apache JServ (现在 称 为 如 Apache Tomcat 项 目 ) 的 性 能 进行 测试 。 
Apache 后 来 重新 设计 JMeter 增强 的 图 形 用 户 界 面 和 添加 功能 测试 能 力 。 


这 是 一 个 具有 图 形 界面 ， 使 用 Swing 图 形 API 的 Java 桌面 应 用 程序 ， 因 此 可 以 运 
行 在 任何 环境 /工作 站 接受 一 个 Java 虚拟 机 ， 例 如 : 在 Windows，Linux，MAC 等 。 


JMeter 支持 的 协议 是 : 
e web: HTTP，HTTPS 站 点 的 Web1.0 的 Web 2.0 (ajax, flex and flex-ws-amf) 
e Web Services: SOAP / XML-RPC 
。 通过 JDBC 了 驱动 程序 的 数据 库 
e 目录 : LDAP 
。 面向 消息 的 服务 通过 JMS 
e Service: POP3, IMAP, SMTP 
e FTP 服务 


JMeter 特点 


以 下 是 一 些 JMeter 的 特点 : 
e 它 是 免费 的 。 开 放 源 码 软 件 。 
e 它 具 有 简单 ， 直 观 的 图 形 用 户 界面 。 


JMeter 中 负载 和 性 能 测试 许多 不 同 的 服务 器 类 型 : 网 站 - HTTP, HTTPS, 
SOAP, 数据 库 通过 iJDBC, LDAP, JMS, 邮件 - POP3 


e 它 是 独立 于 平台 的 工具 。 在 Linux / UNIX，JMeter 中 JMeter 中 shell 脚 本 点 击 可 
以 调用 。 在 Windows 上 ， 它 可 以 调用 启动 jmeter.bat 文 件 。 


它 具 有 完整 的 Swing 和 轻 量 级 组 件 支 持 ( 预 编译 的 JAR 使 用 包 javax.swing 中 
*J 


JMeter 测试 计划 存储 为 XML 格式 。 这 意味 着 可 以 使 用 文本 编辑 器 生成 一 个 测试 
计划 。 


它 的 完整 的 多 线程 框架 ， 人 允许 并 发 多 线程 和 同步 采样 不 同 的 功能 由 单独 的 线程 
组 采样 。 


e 它 是 高 度 可 扩展 的 。 
也 可 用 于 执行 应 用 程序 的 自动 化 测试 和 功能 测试 。 


JMeter 是 如 何 工作 的 ? 


JMeter 中 模拟 一 组 用 户 发 送 到 目标 服务 器 的 请 求 和 回报 目标 服务 器 /应 用 程序 的 性 
能 /功能 的 统计 数字 表明 ， 通 过 表格 ， 图 形 等 下 图 描述 了 这 个 过 程 : 


JMeter 环 境 设 置 - JMeter 教 程 


JMeter 是 基于 Java 的 框架 ， 所 以 第 一 个 要 求 是 JDK 安 装 在 机 器 上 。 


JDK 1.6 + 
内 存 不 限 
硬盘 空间 不 限 
操作 系统 不 限 


第 1 步 - 验证 Java 安 装 在 你 的 机 器 上 


现在 ， 打 开 控 制 台 并 执行 以 下 java 命 邻 。 


OS 任务 命 命 
Windows | Open Command Console C:> java -version 
Linux Open Command Terminal $ java -version 
Mac Open Terminal machine:~ joseph$ java -version 


让 我 们 来 验证 所 有 的 操作 系统 的 输出 : 


Windows 


java version "1.7.0_25" 
Java(TM) SE Runtime Environment (build 1.7.0_25-b15) 
Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed mode) 


Linux 


java version "1.7.0 25" 
Java(TM) SE Runtime Environment (build 1.7.0 25-b15) 
Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed mode) 


Mac 


java version "1.7.0 25" 
Java(TM) SE Runtime Environment (build 1.7.0 25-b15) 
Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed mode) 


如 果 没 有 安装 Java， 可 以 从 以 下 网 
tit : http://www.oracle.com/technetwork/java/javase/downloads/index.htmll 下 载 并 
安装 Java 软 件 开发 工具 包 (SDK) 。 本 教程 中 使 用 Java1.7.0_25。 


第 2 步 : 设置 JAVA 环境 
设置 JAVA_HOME 环境 变量 指向 的 基本 目录 的 位 置 ， 在 机 器 上 安装 Java。 例 如 : 


OS 输出 
Set the environment variable JAVA_HOME to C:Program 


Windows | FilesJavajdk1.7.0 25 
Linux export JAVA_HOME=/usr/local/java-current 
Mac export JAVA_HOME=/Library/Java/Home 


附加 Java 编 译 器 的 位 置 到 系统 路 径 。 


OS 输出 
Append the string; C:Program FilesJavajdk1.7.0_25in to the end 
Windows 
of the system variable, Path. 
Linux export PATH=$PATH:$JAVA_HOME/bin/ 
Mac not required 


验证 Java 安 装 使 用 命令 java-version 如 上 所 述 。 


第 3 步 : 下 载 JMeter 


下 载 JMeter 最 新 版 本 ， 从 http://jmeter.apache.org/download jmeter.cgi。 在 写 这 篇 
教程 的 时 候 ， 下 载 的 Apache JMeter2.9， 并 将 它 复制 到 C:>JMeter 目录 中 : 
目录 结构 看 起 来 应 该 像 如 下 : 

e apache-jmeter-2.9 

e apache-jmeter-2.9in 

e apache-jmeter-2.9docs 


e apache-jmeter-2.9extras 


e apache-jmeter-2.9lib 

e apache-jmeter-2.9libext 

e apache-jmeter-2.9libjunit 

e apache-jmeter-2.9printable docs 


可 以 重 命名 的 父 目录 ( 即 Apache 的 JMeter2.9) ， 但 不 改变 子 目录 名 称 。 


第 4 步 : 运行 JMeter 


一 旦 下 载 JMeter， 跳 转 到 bin 目 录 。 在 我 们 本 教程 中 ， 这 将 是 
/home/manisha/apache-jmeter-2.9/bin。 现 在 点 击 以 下 : 


OS 输出 


Windows jmeter.bat 
Linux jmeter.sh 
Mac jmeter.sh 


JMeter 的 GUI 点 击 上 述 文件 后 ， 经 过 短暂 的 停顿 ， 应 该 会 出 现在 下 面 的 图 片 中 看 
到 ， 这 是 一 个 Swing 应 用 程序 : 
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file Edit Search Bun Options Help 
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Test Plan 





Test Plan 
Name: Test Pla 


Comments 


User Defined Variables 


Detail Add Add fram Clipboard Up Down 
Run Thread Groups consecutively (i.e. run groups one at a time) 
Run tearDown Thread Groups after shutdown of mam threads 


Functional Test Mode (l.e. save Response Data and Sampler Data) 


Add directory or jar to classpath | Browse.. Delete Clear 


/ZiouLeodni 





这 是 主页 面 ， 默 认 页 面 的 工具 。 
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测试 计划 是 什么 ? 

测试 计划 定义 如 何 和 测试 ， 并 提供 了 一 个 布局 。 例 如 ，Web 占 用 程序 以 及 客户 端 服 
务 器 应 用 程序 。 它 可 以 被 看 作 作 为 容器 运行 测试 。 一 个 完整 的 测试 计划 将 包括 一 个 
METI, Wee, VHS, Hoo Els, BOSS, EN ss, HE 
配置 元 素 。 测 斌 计划 必须 至 少 有 一 个 线程 组 。 在 下 一 章 中 ， 我 们 将 讨论 这 些 元 素 的 
细节 测试 计划 元 素 . 


按照 下 面 的 步骤 来 写 一 个 测试 计划 : 
启动 JMeter 窗 口 


打开 JMeter 窗 口 通 过 点 击 /home/manisha/apache-jmeter-2.9/bin/jmeter.sh。 
JMeter 窗 口 会 出 现 如 下 图 : 
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o ; | 
C HMIXUCOD *i-/**it te X» w«4 evt £18 os 0/0 
Test Plan — jā pr UST: 5009 E ERU " onm : LIS iag 
o = Test Plan 
i 
Name 
mment s 
f labi 
Detail Add Add from Clipboard Up Down 
Run Thread Groups consecutively (i.e. run groups one at a time) 
Run tearDown Thread Groups after shutdown of main threads 
Functional Test Mode (l.e. save Response Data and Sampler Data) 
Add directory or jar to classpath Browse. Delete Clear 


: d Ji) 983), eoi ^S JMeter 
窗口 什么 都 还 没有 添加 。 上 述 窗口 的 详细 信息 如 下 : 
e 保持 真正 的 测 斌 计划， 测试 计划 节点 。 
e 工作 台 节 点 只 是 提供 了 一 个 地 方 暂 时 存放 在 不 使 用 时 ， 测 试 元 素 复 制 /粘贴 的 目 
的 。 当 您 保存 测试 计划 ， 工 作 台 项 目 将 不 保存 它 。 
添加 /删除 元 素 


通过 右键 点 击 测试 计划 节点 ， 并 从 “add" 列 表 中 选择 一 个 新 的 元 素 ， 元 素 (将 在 下 一 
章 测试 计划 要 素 讨 论 ) ， 可 以 添加 一 个 测试 计划 。 


另外 ， 元 素 可 以 从 文件 中 加 载 ， 并 通过 选择 "上 merge” 或 "opem" 选 项 添加 。 
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例如 ， 让 我 们 添加 一 个 线程 组 元 件 测 斌 计划 如 下 所 示 : 


Elle Edit Search Run Options Help 


a TMM kk 0) +i =y bie te aa ar 


ET I : 
E werir 


Paste Test Fragment + setUp Thread Group | 

Reset Gui Config Element > teardown Thread Group 

Timer * 

Pre Processors » User Defined Variables 
Post Processors | Name 

Awsertions bl 

Listener , 








Open... 
Merge 
| Save Selection As.. 
Save Node As Image 
Save Screen As Image coo 


vat 
Disable 


Toggle 


Hk 
ma Detail | Add || Add from Clipboard | 





; Run Thread Groups consecutively (i.e. run groups one at a time) 
Run teardown Thread Groups after shutdown of main threads 
Functional Test Mode (i.e. save Response Date and Sampler Data) 

Selecting Functional Test Mode may adversely affect pertormance 


Add directory or jar to classpath Browse... | Delete | Clear | 





Lbrany 








要 删除 一 个 元 素 ， 确 保 元 素 被 选中 ， 右 键 单 击 该 元 素 ， 然 后 选择 “remove" 选 项 。 








à "HM Xx ;D *|-"^* ble b X» wW ar £8 04 oo 
" d etm = E oe BD 二 一 E = | 
| Thread Grow 
E Thread cron 1 P 
IE Worktenct Add 9) Thread Groug 
Cut pnts: 
Copy Y to be taken after a Sampler error 
Paste * Continue Start Next Thread Loop Stop Thread © Stop Test Stop Test Now 
Duplicate LL 
Reset Gui id Properties 
r of Threads (users): | 
Open... -Up Period On seconds): | 
"e r t , 
Save Selection As... TAN: om 
Save Node As Image lay Thread creation until needed 
Save Screen As image Ste veduler 
nabile 
Disable 
Toggle 
Help 


加 载 和 保存 元 素 


从 文件 加 载 一 个 元 素 ， 右 键 单 击 您 要 添加 的 加 载 元 件 对 现 有 树 元 素 ， 并 选 
择 "merge” 选 项。 选择 文件 保存 元 素 。 JMeter 会 合并 的 元 素 ， 放 到 树 上 。 
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à iu Xx con *-* ble ^. x»wW et £8 oa 0/0 
est Plar 
' ? E nod Thread Group 
s Worker Add * pe [Thread Group 
Cut monts: 
Copy pn to be taken after a Sampler error 


Paste ^ Continue O Start Next Thread Loop © Step Thread © Step Test O Stop Test Now 


DupBcate M 

Reset Gui bad Properties 

Remove e iber of Threads (users): ) 

Open. . 和 -Up Period Gn seconds): 1 

Save Selfction As. p Count: _ Forever 1 

Save Node As image lelay Thread creation until needed 
Save Screen As image è cheduler 


Disable 
Toggle 
Help 


ilosi eosi 


为 了 保存 树 元 素 ， 元 素 上 点 击 右键 并 选择 选择 另存 为 ... 选 项 。 JMeter 会 保存 选 定 的 
元 素 ， 再 加 上 它 下 面 的 所 有 子 元 素 。 默 认 情况 下 ， 不 保存 JMeter 的 元 素 ， 需 要 明确 
地 保存 它 ， 如 前 面 提 到 的 。 


配置 树 元 素 


目前 在 JMeter 右手 帧 的 控制 ， 可 配置 的 测试 计划 中 的 任何 元 素 。 这 些 控件 允许 配置 
特定 的 测试 元 件 的 行为 。 例 如 线程 组 可 配置 的 用 户 数量 上 升 期 等 如 下 : 





Eile Edit Search Run Options Help 


a iid x 万 | 回 | 二) 一 | 如 it te X» wW ev rH oh oe 
e rs 上 
3 ved | = | 
Paste Test Fragment * setUp Thread Group 
Reset Gui Config Element » teardown Thread Group 
Open Timer ^ 
Marge Pre Processors + User Defined Variables 
e 
, me 
Save Selection As Post Processors Name 
Avsertions » 
Save Node As image Listener $ 
Save Screen As image T 
Disable 
Toggle 
Help x 
Detail Add Add from Clipboard Up Down 





Run Thread Groups consecutively (Le. run groups one at a time) 
Run tearDown Thread Groups after shutdown of main threads 
Functional Test Mode (e. save Response Data and Sampler Data) 
| Selecting Functional Test Mode may adversely affect pertormance 
| Add directory or jar to classpath. Browse... | Delete Clear 


brary 


保存 测试 计划 


您 可 以 保存 整个 测试 计划 ， 可 以 通过 使 用 “Save "或 “Save Test Plan As ....”M“3Z 
FRX., 





tie Edit Search Run Options Help 
Close 
Qpen 
Merge 


Save 
| Save Test Plan ax cs 


Save Selection As 


| * 


1 Users. mx 
2 Meter Users. mx 
J FirstTest-Visit Google. jms 


Exit 


P 


E 
AE, 


一 | 多 |> t 5 x» aù 
Test Plan 
Name: Test Pis 


Comments: 


User Defined Variables 


Detail Add Add from Clipboard 


Run Thread Groups consecutively We run groups one at a time) 
Run teardown Thread Groups after shutdown of main threads 
Functional Test Mode (Le. save Response Data and Sampler Data) 
(ting Functional Test Mode may edversety affect performance 


Add directory or jar to dasspath Browse... Delete Clear 


行 一 个 测试 计划 


21 n 测试 计划 从 Run 菜 单项 中 选择 “Start ”( 控 制 + R) 。 
它 显示 了 一 | 个 绿色 的 小 盒 子 ， AFi MATERA, 只 是 在 菜单 栏 下 。 
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Down 


0/0 
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ú a ME | Remote Start 


AL 


X workBench 
$ 8 


Remote Start All 
I 


Remote Stop 

Remote Stop All 
Remote Shutdown 
Remote Shutdown All +» 
emote Exit 

Remote Exit All 

Clear 

Chegr Al 
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User Defined Variables 


Det ail Add Add from Clipboard 


Run Thread Groups consecutively (i.e. run groups one at a time) 
fun teardown Thread Groups after shutdown of main threads 
Functional Test Mode Oe. save Response Data and Sampler Data) 
Selecting Funcbonal Test Mode may adversely affect performanc 
Add directory or jar to classpath Browse.. Delete Clear 


Libran 


up 


oà 0/1 


Down 


左 侧 的 绿色 方块 的 数字 是 活动 线程 /线程 总 数 的 数量 。 这 些 只 适用 于 本 地 运行 的 测 
试 ， 他 们 不 包括 任何 远程 系统 上 使 用 客户 - 服务 器 模式 时 启动 的 线程 。 


停止 


停止 
e 使 用 stop (Control +'.') 。 
e 使 用 shutdown (Control +',') 。 


测试 


测试 方法 有 两 种 : 


这 立即 停止 线程 如 果 可 能 的 话 。 
这 就 要 求 线程 停止 在 任何 当前 工作 的 结束 。 
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在 本 章 中 ， 我 们 将 看 到 如 何 创建 一 个 简单 的 测 斌 计划， 测试 数据 库 服务 器 。 对 于 我 
们 的 测试 目的 ， 我 们 使 用 MySQL 数 据 库 服务 器 。 您 可 以 使 用 任何 其 他 数据 库 进 行 测 
试 。MYSQ 的 安装 和 创建 表 ， 请 参阅 MYSQL 教 程 。 


安装 MySQL 以 后 ， 请 按照 以 下 步骤 设置 数据 库 : 
e 创建 一 个 数据 库 名 称 "tutorial". 
e 创建 一 个 表 tutorials tbl. 
e 插入 记录 到 tutorials_tbl : 


mysql&gt; use TUTORIALS; 

Database changed 

mysql&gt; INSERT INTO tutorials_tbl 
-&gt;(tutorial_title, tutorial_author, submission_date) 
-&gt ; VALUES 
-&gt;("Learn PHP", "John Poul", NOW()); 

Query OK, 1 row affected (0.01 sec) 

mysql&gt; INSERT INTO tutorials tbl 
-&gt;(tutorial title, tutorial author, submission date) 
-&gt ; VALUES 
-&gt;("Learn MySQL", "Abdul S", NOW()); 

Query OK, 1 row affected (0.01 sec) 

mysql&gt; INSERT INTO tutorials tbl 
-&gt;(tutorial title, tutorial author, submission date) 
-&gt ; VALUES 
-&gt;("JAVA Tutorial", "Sanjay", '2007-05-06'); 

Query OK, 1 row affected (0.01 sec) 

mysql&gt; 


e 复制 JDBC 驱 动 程 序 到 /home/manisha/apache-jmeter-2.9/lib. 


创建 JMeter 测 试 计划 


HA, iR é JMeter /home/manisha/apache-jmeter-2.9/bin/jmeter.sh. 


添加 用 户 


现在 ， 创 建 一 个 线程 组 ， 右 键 点 击 Test Plan > Add> Threads(Users)> Thread 
Group. 根据 测试 计划 节点 将 添加 线程 组 。 重 命名 此 线程 为 JDBC 用 户 。 


Apache JMeter (2.9 1437961) 





Eile Edit Search Run Options Help 


um "Hid az oo 4 * |t 5 Ja e*t UH oa on 
be r m CS Thread Group 
RTT Nam " 
Comm 
Action to be taken af Sampi 
* Continue Start Next Thread Loop Stop Thread Stop Test Stop Test Now 


Delay Thread creation until needed 


Scheduler 





A921, eos 


我 们 不 会 改变 线程 组 的 默认 属性 。 


添加 JDBC 请 求 


现在 ， 我 们 已 经 定义 了 我 们 的 用 户 ， 它 是 时 间 来 定义 ， 他 们 将 要 执行 的 任务 。 在 本 


节 中 将 指定 JDBC 请 求 执行 。 JDBC Users 元 件 上 右 击 ， 选 择 Add > Config 
Element > JDBC Connection Configuration. 


设置 以 下 字段 (我 们 使 用 的 是 MySQL 数 据 库 教 程 ) 


e 变量 名 绑 定 到 池 。 这 需要 唯一 地 标识 该 配置 。 它 是 用 来 由 JDBC 采 样 器 ， 以 确 


定 要 使 用 的 配置 。 作 为 测试 ， 我 们 把 它 命 名 为 test 
e Database URL: jdbc:mysql://localhost:3306/tutorial 
e JDBC Driver class: com.mysgql.jdbc.Driver 
e 用户 名 : root 
e 密码 : root 的 密码 
在 屏幕 上 的 其 他 领域 ， 可 以 留 为 默认 值 ， 如 下 所 示 : 


Eile Edit Search Run Options Help 


m Hid a git -l »it 5 Já eot uH oà 0/17] 
S Test Se 
| » sie os JOBC Connection Configuration 
dan SCO CONNU | Mame: MG Connector qur abor 
gi wer Bench Comments: 
Variable Name Bound to Pool 
Variable Name: dor 
Connection Pool Configuration 
Max Number of Connections: | 0 
Pool Timeout: : 00 
idle Cleanup Interval (ers): 500€ 


Auto Commit: True - 





Transaction Isolation: DEFAULT - 
Connection Validation by Pool 
Keep-Alive: True - 
Max Connection age (ms): | : 
Validation Query: Soect 1 
Database Connection Configuration 
Database URL: jdbcmysal Post 
ID&C Driver dass: com mysql abe Dover 
Username: 
Password: +++ 





Is ; /iouLeorni 


添加 一 个 JDBC 请 求 是 指 上 面 定义 的 JDBC 配 置 池 。 选 择 JDBC Users 元 件 ， 单 击 鼠 
标 右 键 得 到 添加 菜单 ， 然 后 选择 Add > Sampler > JDBC Request. 然后 ， 选 择 这 个 
新 的 元 素 ， 以 查看 它 的 控制 面板 。 编 辑 属性 如 下 : 


e 变量 名 绑 定 到 池 。 这 需要 唯一 地 标识 该 配置 。 它 是 用 来 由 JDBC 采 样 器 ， 以 确 
定 要 使 用 的 配置 。 我 们 将 其 命名 为 test 


e Name: Learn 

e Enter the Pool Name: test (same as in the configuration element) 
e Query Type: Select statement 

e Enter the SQL Query String field. 





ishaWork/tutorialspoint /iMeter/meter_results/db_ test jmx)- Apache JMeter (2.9 r1437961) 


Eile Edit Search Run Options Help 
篇 | "Hid 2.00 *-/* be 5 »* evt E oà en 


t E sere JOBC Request 


日 

da so nect figurat | Mame: Les 
^ 

P 
n 


r 
+? 


Leam! Comments 
' , Variable Name Bound to Pool 
Variable Mame: cop 
SOL Query 
Query Type: Select Statement - 


Query 
als tbi where tutoria k 


Parameter values 
Parameter types 
Variable names: 


h . Result variable name WAT 6 Osi 





创建 侦 听 器 


现在 添加 Listener 元 素 。 此 元 素 负 责 存储 所 有 JDBC 请 求 的 结果 ， 在 一 个 文件 中 ， 并 
呈现 出 可 视 化 的 数据 模型 。 


选择 JDBC Users 元 件 ， 并 添加 一 个 查看 结果 树 监 听 器 (Add > Listener > View 
Results Tree). 


JMeter (2.9 r1437961) 


db test jmx (home/menisha/work /ManishaWork/tutorialspoint IMeter/meter_results/db_ test jenx) - Apache 





Eile Edit Search Run Options Help 


w Hid a Ol +i -i* bie 5 X» wW et uH oà onn 
hi py = shia m View Results Tree 
aso hect figural | Mame: View Pescity Tree 
"ls Comments 
3j View Moovtts Tree Write results to file / Read from file 
1 ene Filename Dremea LogiDisplay Only Errors Successes Contigure 


Samplor result 





Text - 
y + 


| +I » 
re SEU recat ZioüLtdcori 





保存 并 执行 测试 计划 
现在 保存 的 以 上 测试 计划 db _test.jmx。 执行 本 测试 计划 使 用 Run > Start 选项 . 


校 验 输出 


TutorialsPoint Java 技术 教程 


jb test jmx (/ ye /rm he 
File Edit Search Bun Options Help 
ju "M 21500 + -* ole 


Test Plan 
EE nec or 


dij "SOC Connection Configured 
rd 











l Š View Results Tree 


Mame; iun Aosty Tres 



























pK m Comments: 
E View Rewatts Tree Write results to file / Read from file — =. 
S werttench Filename | || peewee | LogiDisplay Only: O Errors |] Successes | Contiques 





|| Sampler result | Request | Response data | 
Thread Name: JDGC Users 1-1 
Sample Start: 2013-09-04 17:08:26 IST 
Load time 2 
Latency 1 
Sire in bytes 125 
Headers sie in bytes: 0 
Body site in bytes 125 
Sample Count: 1 
Error Court: 0 
Response code, 200 
Response message: OK 






















Response headers 
com mysql jdbc JOB C AConnactiongi33tc aeds 


Semplefie s ft heids 
ContentType text íplain 
Dataencodng: UTAS 


Text Ty) 
L Scroll automatically? 














it t jmx ne/rr } 


File Edit Search Run Options Help 
i uiid Xi *i-l* »[vre o 


La Roos 


t ponc oen 
dij SOC Connection Cosfigurat 


View Results Tree 
Name: view Rent Tree 





A eam Comments: 
= M Write results to file / Road from fite — — — 
3 Werktench Filename | if 


Drewes. | LogDisplay Only: _ Errors. | Successes | Configure 





| Sampler result | Request | Response data | 


Select Statement| select * from tutorials tof where tu£orsal ttie lke ‘earn 































ib test.jmx ul manisha 
File Edit Search Run Options Help 
ida "MM IUD | *i-i* eee o 
Test Plan 


E JDBC Users 


dii (SOC Connection Comfigurat 
^ 






te 
t 


View Results Tree 


Mame: ew Aeudty Tree 


* team Comments: 
E Vin Paste Tree) Write results to flle / Read from fte  ć 一 
M werktench Filename | || mem. |LogiDisplay Only: Errors [C Successes | Configure 





Response data | 
tutore ttie tutoris author submession dte 
team PHP — john Poul 2013-09-03 
Loam MySQ Abdul S 20130903 











Tae) 





[m n 


在 最 后 图 像 ， 可 以 看 到 ，2 条 记录 被 选择 。 
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让 我 们 建立 一 个 简单 的 测试 计划 ， 测 试 一 个 网 页 。 我 们 将 编写 一 个 测试 计划 ， 使 我 
们 可 以 在 Apache JMeter 的 性 能 测试 一 个 网 页 所 示 页 面 网 址 : EA E 


É 3j JMeter 


打开 JMeter 窗 口 通过 点 击 /home/manisha/apache-jmeter-2.9/bin/jmeter.sh. 
JMeter 窗 口 会 出 现 如 下 图 : 


Apache JMeter (2.9 1437961) 








file Edit Search Bun Options Help | 
a “awa O +- 4) 6 k b Jda Hg oà 0/0 
, Test Pin = 
2 m =n Test Plan 
Name: Test Plo 
ament s 


User Defined Variables 


Detail Add Add fram Clipboard Up Down 


Run Thread Groups consecutively (i.e. run groups one at a time) 
Run tearDown Thread Groups ater shutdown of main threads 


Functional Test Mode (l.e. save Response Data and Sampler Data) 


Add directory or jar to classpath Browse.. Delete Clear 





— Zia, COU 3x £a. 
JMeter 窗 口 什么 都 尚未 添加 。 上 述 窗 口 的 详细 信息 如 下 : 


e 保持 真正 的 测 斌 计划， 测试 计划 节点 。 
e 保持 工作 台 节 点 是 临时 的 东西 。 


重 命名 测试 计划 


更 改 测试 计划 节点 的 名 称 ， 在 命名 文本 框 中 样品 测试 。 必 须 改变 焦点 工作 台 节 点 和 
后 台 ， 测 试 计划 节点 看 名 字 反 映 。 






| Eile Edit Search Run Options Help 





à "HWa.D*t€-"^*b»ltk ^ A et Uu oh oo 
cL tele Tet Test Plan 

Name: Sample Test 

Comments 


User Defined Variables 


Det adi Add Add from Clipboard up Down | 
| 
Run Thread Groups consecutively (Le. run groups one at a time) 
Run tearDown Thread Groups after shutdown of main threads 
Functional Test Mode C.e. save Response Data and Sampler Data) 
t Mode may adversely fect performance h 
Add directory or jar to classpath Browse... Delete Clear | 


brary 








XN aN JU 线 程 组 


现在 ， 我 们 将 增加 在 窗口 中 的 第 一 个 元 素 。 我 们 将 添加 一 个 线程 组 ， 这 是 所 有 其 他 
元 素 ， 如 取样 器 ， 控 制 器 ， 监 听 的 占 位 符 。 可 以 配置 要 模拟 的 用 户 数 。 


在 JMeter 中 所 有 节点 的 元 素 被 添加 使 用 上 下 文 菜单 。 想 增加 一 个 子 元 素 节 点 ， 右 击 
该 元 素 。 选 择 合适 的 选项 添加 。 


右键 单 击 Sample Test(our Test Plan )> Add> E Thread Group. 将 
添加 线程 组 ， 根据 测 试 计 划 (样品 测 Nix) 节 点 。 





| Elle Ed Search Bun Options Help 
a “Wi a a + * "v 5 zá ariin oa 0/0 
. ampe Tect 7 o T 77) —— = - - —— 一 一 一 一 — 一 
E fmread Group Thread Group 
I) WorkSenct Mame: 1994 f 
Comments 





Action to be taken after a Sampler error 
* Continue Start Next Thread Loop Stop Thread Stop Test Stop Test Now 
Thread Properties 
Number of Threads (users) 
Ramp-Up Period (in seconds} 
Loop Count: Forever | 
Delay Thread creation until needed 


Scheduler 





作为 用 户 ， 我 们 将 其 命名 线程 组 。 对 于 我 们 这 个 元 素 是 指 用 户 访问 的 TutorialsPoint 
主页 。 





file Edit Search Run Options Help 





MENS D t-il ele ^ aa eo = B oà 0/0 
, Thread Group 

Name: Users 

Comment s 


Action to be taken after à Sampler error 
* Continue Start Next Thread Loop Stop Thread Stop Test Stop Test Now 
Thread Properties 
Number of Threads (users): 1 
Ramp-hp Period (in seconds | 
Loop Count: Forever | 
Delay Thread creation until needed 


Scheduler 








ADD3K 2 


现在 ， 我 们 必须 在 我 们 的 线程 组 (用 户 ) 添加 一 个 采样 。 添加 线程 组 做 导 比 较 早 ， 
这 一 次 我 们 将 开启 的 线程 组 (FH P) 节点 的 上 下 文 菜单 中 通过 右 击 并 选择 Add > 
Sampler> HTTP 请 求 选项 ， 我 们 将 添加 HTTP 请 求 采样 。 





Eile Edit Search Bun Options Help 





a HW 24.00 + -iy bie 5 »w et cg en oo 
H T | HTTP Request a 
A ETE Request! | Mame: (HTTP Request | 
a werknenct | Comments: 
Web Server n 
Server Name or P: Porn Number: Ca 


HTTP Request 
implement ation iz Protocol [http]: Mothod- |GET iz Content encoding | 
Path: | 
Redirect Automatically »« Follow Redirects ©) Use KeepAlive Use multipartiform-data for POST | 
Parameters | Post body 


Send Parameters With the Request 


Nama Value 





Detail Add Add from Clipboard l Up Down | 


Send Files With the Request: 
Mie Path 


— ——fijouLeoy 


-一 


这 将 添加 一 个 空 的 HTTP 请 求 采样 线程 组 (用户) 节点 下 。 让 我 们 配置 此 节点 元 
R: 





Eile Edit Search Rum Options Help 


o - 
- kd lA oo 口 + ^ LI & h a ^ o t i E on ore 
| 270635 HTTP Request 
6° Wait Tutorias on Home] Name ! 
"Bench Comments: 

Web Server Ti 
Server Name or IP: www tutonsispoint T Port Number Cu 
HTTP Request 


Implement ation: [e Protocol [http]: Method: GET - Content encoding 


Path: 
Redirect Automatically Follow Redirects iri Use KeepAlive Use multipart/form-dat a tor POST 
Parameters — Post fody 
Send Parameters With the Request: 


alue 


Det ast Add Add from Clipboard up Down 


Send Filles With the Request: 


Fie Patt 


Add 


oo /oub eoi 


e 名 称 : 我 们 将 改变 名 称 ， 以 反映 我 们 要 实现 的 动作 是 什么 。 我 们 将 它 命名 为 访 
问 TutorialsPoint 首 页 


e 服务 器 名 称 或 IP : 在 这 里 ， 我 们 必须 键入 Web 服 务 器 的 名 称 。 在 我 们 的 例子 
中 ， 它 是 www.yiibai.com。 【〔 包 含 http:// 部 分 不 被 宇 入 ， 这 仅仅 是 的 服务 器 的 
名 称 或 IP) 


e 协议 : 保持 空白 ， 这 里 默认 使 用 HTTP 协 议 。 

路 径 : AREA! (BA) 。 这 意味 着 访问 服务 器 的 根 页 。 

添加 侦 听 器 

我 们 将 添加 一 个 侦 听 器 。 让 我 们 添加 查看 结果 树 监听 线程 组 (用户 ) 节点 下 。 这 将 


确保 采样 的 结果 将 可 查看 该 监听 节点 元 素 。 打 开 上 下 文 菜单 上 点 击 右键 选择 Add > 
Listener > View Results Tree 选项 添加 监听 线程 组 (FH P), 








file Edit Search Hun Options Help 


a khi š 日 了 | 一 & k 5 Já aù i 8 05 ao 
i * E. viiam View Results Tree 
j t Tuto nase ^ Ham Rosuts Tr 
T] Mew Rests Tree! Comment 
Tp WorkBer 


Write results to file / head from file 


Filename Browse Lo@ Display Onty: Errors Successes Contigure 


Sampler result 
EF ———— 


Text - 


Scroll automatically? | naw | Parsed 人 iion doi 


运行 此 测试 计划 


现在 所 有 的 设置 ， 让 我 们 来 执行 测试 计划 。 随 着 线程 组 的 配置 (HP), ， 我 们 保留 
了 它 所 有 默认 值 。 这 意味 着 JMeter 的 执行 采样 一 次 。 这 将 是 像 一 个 单一 的 用 户 只 有 
一 次 。 

这 是 类 似 的 ， 喜 欢 的 用 户 通 过 浏览 器 访问 的 网 页 ， 只 有 在 这 里 ， 我 们 正在 通过 
JMeter 的 采样 。 使 用 Run > Start 选项 ， 我 们 将 执行 测试 计划 。 

Apache JMeter 的 的 要 求 我 们 在 实际 测试 开始 之 前 ， 在 磁盘 文件 保存 测试 计划 。 这 
是 很 重要 的 ， 如 果 我 们 要 运行 的 测 斌 计划， 一通 又 一 通 。 如 果 说 通过 单 击 *No " 选 
项 ， 不 保存 ， 它 将 运行 而 不 进行 保存 。 

[O90 Apache meter (29 reset | 


Elle Edit Search Run Options Help 


a kh a OO + ^ |» te si evt EE oà 0/0 
É -n | Test Plan 
ES | Nam 
T] vem lesus Tree | Comments 


f WorkBenct 
User Defined Variables 





$) You should save your test plan before running it 
CM if you are using supporting data files Go, for CSV Data Set of StringFromFile), 


then it is particularly important to first save your Lest script 
Do you want to save your test plan first? i 
yes tto pe Down 
-一 





Taun Thread Groups conseculively (Le run groups one at atime) 
Run teardown Thread Groups after shutdown of main threads 
Functional Test Mode Ue. save Response Data and Sampler Data) 

electing Functional Test Mode may adversely affect perfor 

Add directory of jar to dasspath Browse... Delete Clear 


| brary 





查看 输出 


我 们 已 经 保持 了 设置 的 线程 组 作为 单个 线程 (这 意味 着 只 有 一 个 用 户 ) 和 循环 时 间 
(这 意味 着 只 运行 一 次 ) ， 因 此 ， 我 们 将 得 到 单一 交易 中 查看 结果 树 监听 的 结果 。 
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View Results Tree 
Name: Mew Results Tree i 


Write results to file / Read from file - 
Filename | 








Thread Name: Users 1-1 
Sample Start: 2013-08-30 18:38/22 IST 


HTTPA.1 200 OK 
Date fn, 30 Aug 2013 0912/24 GMT 
Server: 


: Apache 
Last Modified: Fri, 23 Aug 2013 092212 GMT 
ETag: 223623-4/67 4649011 048473* 
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针对 名 称 访 问 TutorialsPoint 首 页 绿色 表示 成 功 。 


JMeter 已 存储 了 所 有 的 头 和 由 Web 服 务 器 发 送 响 应 ， 并 准 各 向 我 们 展示 了 在 许 
多 方面 。 


e 第 一 个 标签 是 采样 结果 。 它 显示 的 JMeter 的 数据 以 及 由 Web 服 务 器 返回 的 数 
据 。 


e 第 二 个 选项 卡 的 请 求 ， 其 中 示 出 所 有 的 数据 作为 请 求 的 一 部 分 被 发 送 到 Web 服 
4-38. 
。 最 后 一 个 标签 是 响应 数据 。 听 者 在 此 选项 卡 中 显示 了 从 服务 器 接收 到 的 数据 ， 
因为 它 是 在 文本 格式 。 
这 仅仅 是 一 个 简单 的 测 斌 计划， 执行 只 有 一 个 请 求 。 但 JMeter 真 实 实 力 ， 像 很 多 用 
Los ee eee eh S isque. 
组 (用户 ) 设置 。 


JMeter 数 据 库 测试 计划 - JMeter 教 程 


在 本 章 中 ， 我 们 将 看 到 如 何 创建 一 个 简单 的 测 斌 计划， 测试 数据 库 服务 器 。 对 于 我 
们 的 测试 目的 ， 我 们 使 用 MySQL 数 据 库 服务 器 。 您 可 以 使 用 任何 其 他 数据 库 进 行 测 
试 。MYSQ 的 安装 和 创建 表 ， 请 参阅 MYSQL 教 程 。 


安装 MySQL 以 后 ， 请 按照 以 下 步骤 设置 数据 库 : 
e 创建 一 个 数据 库 名 称 "tutorial". 
e 创建 一 个 表 tutorials tbl. 
e 插入 记录 到 tutorials_tbl : 


mysql&gt; use TUTORIALS; 

Database changed 

mysql&gt; INSERT INTO tutorials_tbl 
-&gt;(tutorial_title, tutorial_author, submission_date) 
-&gt ; VALUES 
-&gt;("Learn PHP", "John Poul", NOW()); 

Query OK, 1 row affected (0.01 sec) 

mysql&gt; INSERT INTO tutorials tbl 
-&gt;(tutorial title, tutorial author, submission date) 
-&gt ; VALUES 
-&gt;("Learn MySQL", "Abdul S", NOW()); 

Query OK, 1 row affected (0.01 sec) 

mysql&gt; INSERT INTO tutorials tbl 
-&gt;(tutorial title, tutorial author, submission date) 
-&gt ; VALUES 
-&gt;("JAVA Tutorial", "Sanjay", '2007-05-06'); 

Query OK, 1 row affected (0.01 sec) 

mysql&gt; 


e 复制 JDBC 驱 动 程 序 到 /home/manisha/apache-jmeter-2.9/lib. 


创建 JMeter 测 试 计划 


HA, iR é JMeter /home/manisha/apache-jmeter-2.9/bin/jmeter.sh. 


添加 用 户 


现在 ， 创 建 一 个 线程 组 ， 右 键 点 击 Test Plan > Add> Threads(Users)> Thread 
Group. 根据 测试 计划 节点 将 添加 线程 组 。 重 命名 此 线程 为 JDBC 用 户 。 


Apache JMeter (2.9 1437961) 





Eile Edit Search Run Options Help 


um "Hid az oo 4 * |t 5 Ja e*t UH oa on 
be r m CS Thread Group 
RTT Nam " 
Comm 
Action to be taken af Sampi 
* Continue Start Next Thread Loop Stop Thread Stop Test Stop Test Now 


Delay Thread creation until needed 


Scheduler 





A921, eos 


我 们 不 会 改变 线程 组 的 默认 属性 。 


添加 JDBC 请 求 


现在 ， 我 们 已 经 定义 了 我 们 的 用 户 ， 它 是 时 间 来 定义 ， 他 们 将 要 执行 的 任务 。 在 本 


节 中 将 指定 JDBC 请 求 执行 。 JDBC Users 元 件 上 右 击 ， 选 择 Add > Config 
Element > JDBC Connection Configuration. 


设置 以 下 字段 (我 们 使 用 的 是 MySQL 数 据 库 教 程 ) 


e 变量 名 绑 定 到 池 。 这 需要 唯一 地 标识 该 配置 。 它 是 用 来 由 JDBC 采 样 器 ， 以 确 


定 要 使 用 的 配置 。 作 为 测试 ， 我 们 把 它 命 名 为 test 
e Database URL: jdbc:mysql://localhost:3306/tutorial 
e JDBC Driver class: com.mysgql.jdbc.Driver 
e 用户 名 : root 
e 密码 : root 的 密码 
在 屏幕 上 的 其 他 领域 ， 可 以 留 为 默认 值 ， 如 下 所 示 : 


Eile Edit Search Run Options Help 


m Hid a git -l »it 5 Já eot uH oà 0/17] 
S Test Se 
| » sie os JOBC Connection Configuration 
dan SCO CONNU | Mame: MG Connector qur abor 
gi wer Bench Comments: 
Variable Name Bound to Pool 
Variable Name: dor 
Connection Pool Configuration 
Max Number of Connections: | 0 
Pool Timeout: : 00 
idle Cleanup Interval (ers): 500€ 


Auto Commit: True - 





Transaction Isolation: DEFAULT - 
Connection Validation by Pool 
Keep-Alive: True - 
Max Connection age (ms): | : 
Validation Query: Soect 1 
Database Connection Configuration 
Database URL: jdbcmysal Post 
ID&C Driver dass: com mysql abe Dover 
Username: 
Password: +++ 





Is ; /iouLeorni 


添加 一 个 JDBC 请 求 是 指 上 面 定义 的 JDBC 配 置 池 。 选 择 JDBC Users 元 件 ， 单 击 鼠 
标 右 键 得 到 添加 菜单 ， 然 后 选择 Add > Sampler > JDBC Request. 然后 ， 选 择 这 个 
新 的 元 素 ， 以 查看 它 的 控制 面板 。 编 辑 属性 如 下 : 


e 变量 名 绑 定 到 池 。 这 需要 唯一 地 标识 该 配置 。 它 是 用 来 由 JDBC 采 样 器 ， 以 确 
定 要 使 用 的 配置 。 我 们 将 其 命名 为 test 


e Name: Learn 

e Enter the Pool Name: test (same as in the configuration element) 
e Query Type: Select statement 

e Enter the SQL Query String field. 





ishaWork/tutorialspoint /iMeter/meter_results/db_ test jmx)- Apache JMeter (2.9 r1437961) 


Eile Edit Search Run Options Help 
篇 | "Hid 2.00 *-/* be 5 »* evt E oà en 


t E sere JOBC Request 
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da so nect figurat | Mame: Les 
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r 
+? 


Leam! Comments 
' , Variable Name Bound to Pool 
Variable Mame: cop 
SOL Query 
Query Type: Select Statement - 


Query 
als tbi where tutoria k 


Parameter values 
Parameter types 
Variable names: 


h . Result variable name WAT 6 Osi 





创建 侦 听 器 


现在 添加 Listener 元 素 。 此 元 素 负 责 存储 所 有 JDBC 请 求 的 结果 ， 在 一 个 文件 中 ， 并 
呈现 出 可 视 化 的 数据 模型 。 


选择 JDBC Users 元 件 ， 并 添加 一 个 查看 结果 树 监 听 器 (Add > Listener > View 
Results Tree). 


JMeter (2.9 r1437961) 


db test jmx (home/menisha/work /ManishaWork/tutorialspoint IMeter/meter_results/db_ test jenx) - Apache 





Eile Edit Search Run Options Help 


w Hid a Ol +i -i* bie 5 X» wW et uH oà onn 
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保存 并 执行 测试 计划 
现在 保存 的 以 上 测试 计划 db _test.jmx。 执行 本 测试 计划 使 用 Run > Start 选项 . 


校 验 输出 
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jb test jmx (/ ye /rm he 
File Edit Search Bun Options Help 
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E View Rewatts Tree Write results to file / Read from file — =. 
S werttench Filename | || peewee | LogiDisplay Only: O Errors |] Successes | Contiques 





|| Sampler result | Request | Response data | 
Thread Name: JDGC Users 1-1 
Sample Start: 2013-09-04 17:08:26 IST 
Load time 2 
Latency 1 
Sire in bytes 125 
Headers sie in bytes: 0 
Body site in bytes 125 
Sample Count: 1 
Error Court: 0 
Response code, 200 
Response message: OK 






















Response headers 
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在 最 后 图 像 ， 可 以 看 到 ，2 条 记录 被 选择 。 
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jMeter FTP 测 试 计划 - JMeter 教 程 


在 本 章 中 ， 我 们 将 看 到 如 何 使 用 JMeter 测试 FTP 站 点 。 让 我 们 创建 一 个 测试 计划 ， 
测 | 试 FTP 站 点 Wo 

重 命名 测试 计划 

ee 启动 JMeter 窗口 /home/manisha/apache-jmeter-2.9/bin/jmeter.sh. 点 


击 测 试 计划 节点 上 。 重 命名 此 测试 计划 节点 TestFTPSite. 


XN ds JU 线 程 组 


添加 一 个 线程 组 ， 这 是 所 有 其 他 元 素 ， 如 取样 器 ， 控 制 器 ， 监 听 的 占 位 符 。 右 键 单 
击 TestFTPSite(our Test Plan) > Add > Mr ala > Thread Group. 线程 
组 将 添加 根据 测 | 试 计划 (TestFTPSite) 的 节 P 点 。 


接 下 来 ， 让 我 们 修改 线程 组 的 默认 属性 ， 以 满足 我 们 的 测试 。 改 变 以 下 属性 : 
Name: FTPusers 

ABA (AP) :4 

Ramp-Up Period: 离开 默认 值 0 秒 。 

Loop Count:1 


ftpsite_test.jmx (/home/manisha/work/Manishawork/tutorielspolnt /sMeter/meter_results/ftpsite_test jmx) - Apache JMeter (2.9 61457961) 





* Continue Start Neat Thread Loop Stop Thread Mop Test Stop Test Now 


iios eol 


添加 采 Z HE ZS AF TP if 青 求 


现在 ， 我 们 已 经 定义 了 我 们 的 用 户 ， 它 是 时 间 来 定义 ， 他 们 将 要 执行 的 任务 。 我 们 
将 添加 FTP 请 求 元 素 。 我 们 将 添加 两 个 FTP 请 求 元 素 ， 将 检索 一 个 文件 ， 将 FTP 站 
点 上 的 文件 。 开 始 由 选择 FTPUSERS 元 素 。 点 击 鼠 标 右键 得 到 添加 菜单 ， 然 后 选择 
Add > Sampler > FTP Request. 然后 ， 选 择 FTP 请 求 树 中 的 元 素 ， 并 在 下 面 的 图 
片 编辑 下 列 属 性 : 


NpsRe best jmx (/home/manisha/work/ManishaWork /tutorielspolnt sMeter/jmeter_results/ftpsite_ test jmx) - Apache JMeter (2.9 61457961) 





T O oreesa | FTP Request 
* FTP Request Get Nama: FTP Reque 
TP Request Put | Comments 
| Server Name or Pr 124 168.74 7 Port Number 
| Remote File 
| Local File 
| Local File Contents 


® qetiRETR) puttsTOR) Use Binary mode ? Save File in Response 了 


| b /iou,eori 
这 个 元 素 中 输入 下 列 详细 信息 : 
Name: FTP Request Get 
Server Name or IP: 184.118.14.9 
Remote File: /home/manisha/sample ftp.txt 
Local File:sample ftp.txt 
Select get(RETR) 
Username:manisha 
Password:manispass32 
现在 添加 另 一 个 FTP 请 求 ， 并 在 下 面 的 图 片 编辑 的 属性 : 


NpsRe best jmx (/rome/manisha/work/Manishawork /tutorielspolnt UMeter/meter_results/ftpsite_test jmx) - Apache JMeter (2.9 1437961) 





Eile Edit Search Bun Options Help 


a "Hid a O +i- 4+ bit 5 swe» ull os 0/4 
| > green | FTP Request 
P FTP Request Ge Name juest 
J FTP Request Pur | Comments 
ivre Pewee tren | Server Mame or IP: 152 168.74.2 Port Number 


| 
| Remote File 
| Local file: (^ 


| Local File Contents: 


DetRETRI % put(STOR Use Binary mode ? Save File in Response ? 


| Login Configuration 
Username ) 


Password ««« »»e 


这 个 元 素 中 输入 下 列 详细 信息 : 

Name: FTP Request Put 

Server Name or IP: 184.168.74.29 

Remote File: /home/manisha/examplefile.txt 
Local File: /home/manisha/work/examplefile.txt 
Select put(STOR) 

Username:manisha 


Password:manisha 123 


AN DD 3 OFT d 


需要 添加 到 测试 计划 中 的 最 后 一 个 元 素 是 一 个 监听 器 。 此 元 素 是 负责 为 FTP 请 求 的 
所 有 结果 存储 在 一 个 文件 中 ， 呈 现 出 可 视 化 的 数据 模型 。 


选择 FTPusers 元 素 ， 并 添加 一 个 查看 结果 树 监 听 器 (Add > Listener > View 
Results Tree). 
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Text ~ j 
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运行 此 测试 计划 
现在 保存 的 以 上 测试 计划 ftpsite test.jmx, 执行 本 测试 计划 使 用 Run > Start 


项 。 


查看 输出 
下 面 的 输出 ， 在 监听 器 中 。 
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home/ma 


File Edit Search Bun Options 
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f Mew Renstra Trew Write results to file / Read from file 
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FTP Request Get 
FTP Request Get Thread Name: FTPusers 1-1 
Ga TP Request Get Sample Start: 2013-09-17 11:25:38 IST 
FTP Request Put Load time: 2307 
ám Request Put Latency 555 
FTP Request Put Sine in bytes 9 
FTP Request Put Headers $c in bytes: © 
Body size in bytes O 
Semple Count ] 
Error Court: O 
Response code. 200 
Response message: OK 


Response headers 
SampleRas.ft *elds. 


Cortent Type 
DataEncodng: rail 
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FTP Request Get 
FTP Request Get | 
FTP Request Get Thread Name: FTPusers 1-4 
aa FTP Request Get Sample Start: 201 3-09-1 7 11:25:42 167 
FTP Request Put Load time: 3947 
FTP Request Put Latency: 560 


FTP Request Put Sue in bytes $ 
SFTP Request Put Headers sco in bytes: Ó 
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Semple Count 1 
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Response message: OK 


Response headers. 


SampleRasut elds 
Cortent Type 
DataEncodng: rail 
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四 点 要 求 的 每 个 FTP 请 求 测试 成 功 。 GET 请 求 检索 文件 存储 在 bin 文 件 


夹 中 。 在 我 们 的 例子 中 ， 这 将 是 /home/manisha/apache-jmeter-2.9/bin/. PUT 请 
求 ， 上 传 文件 的 路 径 为 lIhome/manisha/. 
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jMeter Webservice 3] ix i+ x! - JMeter 教 程 


在 本 章 中 ， 我 们 将 学 习 如 何 创建 一 个 测 斌 计划， 测试 一 个 WebService。 对 于 我 们 的 
测试 目的 ， 我 们 已 经 创建 了 一 个 简单 的 Web 服务 项 目 ， 并 将 其 部 署 在 Tomcat 服务 
器 上 本 地 。 


创建 WebService 项 目 


要 创建 一 个 Web 服务 项 目 中 ， 我 们 使 用 了 Eclipse IDE。 首 先 编写 服务 端 接口 
HelloWorld 包 下 com.yiibai.ws。 HelloWorld.java 的 内 容 如 下 : 


package com.yiibai.ws; 


import javax.jws.WebMethod; 

import javax.jws.WebService; 

import javax.jws.soap.SOAPBinding; 
import javax.jws.soap.SOAPBinding.Style; 


//Service Endpoint Interface 
QwebService 

@SOAPBinding(style = Style.RPC) 
public interface HelloWorld{ 


QwebMethod String getHelloworldMessage(String string); 


j 


这 个 服务 有 一 个 的 方法 getHelloWorldMessage 需要 字符 串 参数 。 
下 一 步 创建 实现 类 HelloWorldlmpl.java 在 包 com.yiibai.ws 下 。 


package com.yiibai.ws; 
import javax.jws.WebService; 


@wWebService(endpointInterface="com.yiibai.ws.Helloworld" ) 
public class HelloworldlImpl implements Helloworld { 
@Override 
public String getHelloWorldMessage(String myName) { 
return("Hello "+myName+" to JAX WS world"); 
j 


作为 下 一 个 步 又， 让 本 地 发 布 此 Web 服 务 通过 创建 端点 出 版 商 和 公开 此 服务 的 服务 
att. 


publish 方 法 有 两 个 参数 : 
e 端点 URL 字 符 串 。 


e 实现 程序 对 象 HelloWorld 实现 类 ， 在 这 种 情况 下 ， 这 是 作为 一 个 Web 服 务 公 
开 在 以 上 参数 中 提 到 的 由 URL 标 识 的 端点 。 


HelloWorldPublisher.java 内 容 如 下 所 示 : 


package com.yiibai.endpoint; 

import javax.xml.ws.Endpoint; 

import com.yiibai.ws.HelloWorldImp1; 
public class HelloWorldPublisher { 


public static void main(String[] args){ 
Endpoint.publish("http://localhost:9000/ws/hello", new Hel. 





接 下 来 修改 web.xml 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, 
Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/j2ee/dtds/web-app_2_3.dtd"> 
«web app» 
«listener» 
<listener-class> 
com.sun.xml.ws.transport.http.servlet.WSServletConl 
«/listener-class» 
</listener> 
<servlet> 
<servlet -name>hello</servlet -name> 
<servlet-class> 
com.sun.xml.ws.transport.http.servlet.WSServlet 
</servlet-class> 
<load-on-startup>1</load-on-startup> 
</servlet> 
<servlet -mapping> 
<servlet -name>hello</servlet -name> 
<url-pattern>/hello</url-pattern> 
</servlet -mapping> 
<session-config> 
<session-timeout>120</session-timeout> 
</session-config> 
</web-app> 


了 — 3} 





要 部 署 的 web 服务 应 用 程序 ， 我 们 需要 sun-jaxws.xml 配置 文件 ， 这 个 文件 的 内 容 
如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<endpoints 
xmins="http://java.sun.com/xml/ns/jax-ws/ri/runtime" 
version="2.0"> 
<endpoint 
name-"HelloWorld" 
implementation-"com.yiibai.ws.HelloworldImpl" 
url-pattern="/hello"/> 
</endpoints> 


现在 ， 所 有 文件 都 准备 好 目录 结构 看 起 来 会 像 下 面 的 图 片 : 
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E Wd amid Rn yeh eos 
现在 ， 这 个 应 用 程序 创建 一 个 WAR 文 件 。 选 择 project > right click > Export > 
WAR 文 件 。hello.war 文件 保存 Tomcat 服务 器 webapps 文 件 夹 下 。 现 在 启动 
Tomcat 服 务 器 。 在 服务 器 启动 后 ， 你 应 该 能 够 访问 web 服 务 可 以 通过 以 下 网 址 : 


http://localhost:8080/hello/hello 
创建 JMeter 测 试 计划 
现在 ， 让 我 们 创建 一 个 测试 计划 ， 测 试 上 面 的 web 服 务 。 


重 命名 测试 计划 


通过 点 击 启动 JMeter 的 窗口 /home/manisha/apache-jmeter-2.9/bin/jmeter.sh. 点 击 
测试 计划 节点 上 。 重 命名 此 测试 计划 节点 WebserviceTest. 


m “aida O +- 4 & & 5 dù e*t 5g bA 0/2 
Fervent 
rE Test Plan 
New 
5 Ome: 
tired 
ot 
et 4d Add trom Chg m Down 
- TI n groups at a tima) 
h d upas ate dom: f m n thread: 
Mod Re D d Sample stal 
i 
A58 d i ah Det jos 


ilosi col 


添加 线程 组 


添加 一 个 线程 组 ， 这 是 所 有 其 他 元 素 ， 如 取样 器 ， 控 制 器 ， 监 听 的 占 位 符 。 右 键 单 
击 我 们 的 测试 计划 WebserviceTest(our Test Plan) > Add > Threads(Users) > 
Thread Group。 线 程 组 将 添加 根据 测试 计划 (WebserviceTest) 的 节点 。 


接 下 来 ， 让 我 们 修改 线程 组 的 默认 属性 ， 以 满足 我 们 的 测试 。 改 变 以 下 属性 : 
Name: webservice User 

Number of Threads (Users): 2 

Ramp-Up Period: leave the the default value of 0 seconds. 

Loop Count:2 
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添加 SAMPLER-SOAP/XML RPC i# 3k 


现在 ， 我 们 已 经 定义 了 用 户 ， 它 是 时 间 定 义 ， 他 们 将 要 执行 的 任务 。 我 们 将 添加 
SOAP/ XML-RPC 请 求 元 素 。 点 击 鼠 标 右键 得 到 添加 菜单 ， 然 后 选择 Add > 
Sampler > SOAP/XML-RPC Request， 选 择 元 素 树 中 的 SOAP/ XML-RPC 请 求 ， 并 
在 下 面 的 图 片 编辑 下 列 属性 : 


这 个 元 素 中 输入 下 列 详细 信息 : 

Name: SOAP/XML-RPC Request 

URL: http://localhost:8080/hello/hello? wsdl 
Soap/XML-RPC Data: Enter the below contents 


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/er 
<soapenv: Header /> 
«soapenv: Body» 
«web: getHelloworldMessage- 
<arg0>Manisha</arg0> 


«/web:getHelloWorldMessage» 
«/soapenv: Body» 
«/soapenv Envelope» 
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添加 监 监 听 aa 


需要 添加 到 测试 计划 中 的 最 后 一 个 元 素 是 一 个 监听 器 。 此 元 素 是 负责 所 有 的 HTTP 
请 求 的 结果 存储 在 一 个 文件 中 ， 并 呈现 出 可 视 化 的 数据 模型 。 


选择 webservice 用 户 元 素 ， 并 添加 一 个 查看 结果 树 监 听 器 (Add > Listener > View 
Results Tree). 
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运行 此 测试 计划 
在 保存 的 以 上 测试 计划 test_webservice.jmx。 执 行 本 测试 计划 使 用 Run > Start 
项 


o 


现 
选 


查看 输出 
下 面 的 输出 ， 可 以 看 到 在 监听 器 中 。 
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可 以 看 到 在 过 去 的 图 像 响 应 消息 "Hello Manisha to JAX WS world". 
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jMeter JMS 测 斌 计划 - JMeter 教 程 
在 本 章 中 ， 我 们 将 学 习 如 何 写 一 个 简单 的 测 斌 计划， 测试 JMS (Java 消 息 服务 ) 。 
谁 不 知道 JMS 请 阅读 本 章 之 前 ， 让 自己 熟悉 的 JMS。 JMS 支 持 两 种 类 型 的 消息 : 


e 点 到 点 消息 : 一 般 用 于 交易 发 件 人 期 望 的 响应 队列 消息 。 邮 件 系统 是 完全 不 同 
于 普通 的 HTTP 请 求 。 在 HTTP 中 ， 单 个 用 户 发 送 一 个 请 求 并 得 到 响应 。 


@ 主题 消息 : " 发 布 /订阅 消息 被 俗称 为 主题 的 消息 。 主题 消息 一 般 使 用 情况 下 ， 消 
息 发 布 由 生产 者 和 消费 由 多 个 用 户 。 


让 我 们 来 看 看 这 些 为 每 个 测试 的 例子 。 测 试 JMS 的 先决 条 件 是 : 


hctiveMQ St 
Software Foundation 





e 我 们 将 在 我 们 的 例子 中 使 用 的 是 Apache ActiveMQ, 虽然 也 有 其 他 JMS 服 务 
器 ， 如 IBM 的 WebSphere MQ (以 前 称 为 MQSeries) ，TIBCO 等 下 载 Apache 
网 站 的 ActiveMQ 二 进 制 文件 . 


e ER Sx, CREAR, BADR Maias ActiveMQ 服 
FAR : 


.inactivemq start 


可 以 验证 ， 如 果 ActiveMQ 服务 器 已 经 开始 在 以 下 地 址 
http://localhost:8161/admin/ 访问 管理 界面 。 如 果 要 求 进行 身份 验证 输入 用 户 
ID 和 密码 为 admin。 屏 幕 将 类 似 于 如 下 : 


e 现在 复制 activemq-all-x.x.x.jar (XXX 的 版 本 而 定 ) 从 ActiveMQ 的 解压 目录 
/home/manisha/apache-jmeter-2.9/lib. 


通过 上 述 的 设置 ， 让 我 们 构建 的 测试 计划 : 
e JMS 点 到 点 对 点 测试 计划 
e JMS 主 题 测试 计划 
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在 本 章 中 ， 我 们 将 讨论 有 关 如 何 创建 使 用 JMeter 测 斌 计划， 监控 Web 服 务 器 。 利 
用 监视 器 测试 是 : 


e 监视 器 是 有 用 的 压力 测试 和 系统 管理 
。 用 于 压力 测试 ， 监 视 器 服务 器 性 能 提供 了 额外 的 信息 。 
e 监视 器 可 以 更 容易 地 看 到 在 客户 端 服务 器 的 性 能 和 响应 时 间 之 间 的 关系 


e 系统 管理 工具 ， 显 示 器 提供 了 一 个 简单 的 方法 来 从 一 个 控制 台 监 视 器 多 台 服 务 
AÑ. 


我 们 将 需要 一 个 Tomcat 5 或 以 上 版 本 进行 监测 。 对 于 我 们 的 测试 目的 ， 将 监视 
ww un 服务 器 。 可 以 测试 任何 servlet 容 器 支持 JMX (Java 管 理 扩 展 ) 。 让 
我 们 写 一 个 测试 案例 监视 器 Tomcat 服务 器 。 但 在 此 之 前 ， 让 我 们 先 来 设立 tomcat 
DERE 


及 置 Tomcat 服 务 器 


我 们 先 从 “打开 ?Tomcat 服 务 状 态 。 要 做 到 这 一 点 ， 编 辑 的 配置 文件 用 户 
<TOMCAT_HOME>/conf/tomcat-users.xml. 此 文件 包含 一 个 tomcat 的 用 户 部 分 
(评论 ) 如 下 : 


<tomcat -users> 


alloc 
<role rolename="tomcat"/> 
«role rolename="rolei"/> 
<user username="tomcat" password="tomcat" roles="tomcat"/> 
<user username="both" password="tomcat" roles="tomcat, rolei"/> 
«user username="rolei" password="tomcat" roles="rolei"/> 

T> 

</tomcat -users> 


我 们 需要 改变 这 部 分 ， 添 加 管理 员 的 角色 ，manager，manager-gui 和 分 配 用 
户 *admin”。 修 订 后 的 文件 如 下 : 


<tomcat -users> 


«role rolename="manager -gui"/> 

«role rolename="manager-script"/> 

«role rolename="manager - jmx"/> 

«role rolename="manager-status"/> 

«user username="admin" password-"admin" roles="manager - gui, manage 


</tomcat -users> 


«| ni 








现在 启动 tomcat 服务 器 <TOMCAT_HOME>/bin/startup.sh 在 Linux 平 台 F, 
<TOMCAT_HOME>/bin/startup.bat 在 Window. — EH. £ zj, 4& & Tomcat 监管 工作 进 
入 下 面 的 链接 (在 浏览 器 中 打开 ) : 


http://localhost:8080/manager/status?XML-true 


验证 窗口 出 现在 浏览 器 中 ， 进 入 tomcat 登录 名 和 密码 相关 (在 我 们 的 案例 中 ， 它 是 
admin) 。 然 后 ， 浏 览 器 显示 Tomcat 作 为 下 面 的 执行 状态 : 






'ormcat Staten 


€ c aaPost 


Tomcat Status 


JVMi frees] 31314605 tal 21101775092 max:900399 104 

Memory Peak 

Name:PS Edes Spece Typest eap memory Initial: 1574 1% Committed: 157000080 Mace: HH 142608 Used: 15 M06 
Names Old Gen Typectioup cemory mitial:42 205154 Commsitted:42 205154 Maximum 75782944 Used: 25251280 








k262 1440 C omunimed: 1 15620165 Maxine: | 1862016 Used: 
715/944 Commimed: 27525 12 MaximmmóU13] 6:35 Used: 25535 36 


Name:PS Savior Space Tvpe-Heag 
Names ode Cache Type:Non-he 


Names Perm Gen TypeNonh SPOR Command 16071152 Marima: 590 17 17 Used S120 
Connector — “ap dio 0007 
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requestinio max Timer!) processing Tine? requessCaunt:t ermorieantt bytesReceneed:o bysestsentzt 
Stage Time R Sent B Recy Client v Host Request 


Connector — ipeo SM 
threadinfo max mss ) current ThreadiC oum? current ThereadsBusy: | 


requestinfo max Tine:420 processing Hime: 2) requetiCoum:? errmri oun: | bytedteceiveds) IrytesSent:d | 1A 


fun Teen bt quer Chet — VHosu — 
5 2 127 0.0.1 localhost GET manager XML *trueH TT? 1 


从 上 面 的 图 片 中 ， 我 们 可 以 注意 几 件 事情 : 


e 在 URL 中 ， XML = true (注意 区 分 大 小 写 ) 注意 ， 可 以 清晰 地 显示 JMeter 运作 
需要 监视 Tomcat。 


° a 注意 ， 默 认 有 两 个 连接 器 。 加 上 Apache httpd 的 mod_jk 前 端 模块 ， 这 
常用 的 HTTP 连接 器 通过 端口 8080 连接 器 直接 访问 到 Tomcat 的 AJP 连 接 
器 ， 


编写 JMeter 测 斌 计划 


让 我 们 监视 器 Tomcat 服 务 器 通过 编写 测试 计划 如 下 : 


重 命名 测试 计划 

通过 点 击 启动 JMeter 的 窗口 eden. 9/bin/jmeter.sh. 点 击 
测 iA t Xll P 点 上 。 如 解释 在 下 一 步 添加 一 个 线程 组 。 

aN AND 线 程 组 


添加 一 个 线程 组 。 右 键 单 击 Test Plan > Add > Threads(Users) > Thread Group. 根 
据 测 试 计划 节点 将 添加 线程 组 。 改 变 永远 循环 计数 (或 大 量 ) ， 以 便 产 生 足 够 的 样 


o 





nitor test. jm: (/home/manisha/work /Manishawork/tutorialspoint /JMeter/jmeter results/monitor test jmx) - Apache JMeter (2.9 r14 


Eile Edit Search Bun Options Help J 
a Hid xioa- eo 680 ww e * CUM & an 


bad E Tied E Thread Group 


Comments 
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HTTP 授 权 管 理 器 


添加 了 HTTP 授 权 管 理 到 线程 组 元 素 Add > Config element > HTTP hd 
Manager. 此 元 素 管 理 认证 要 求 浏览 器 中 看 到 Tomcat 服 务 器 的 状态 。 选 择 HTTP 
Authorization Manager 并 编辑 以 下 细节 : 


e Username : admin 管理 员 (取决 于 tomcat-users.xml 文 件 中 的 配置 ) 
e Password: admin (取决 于 配置 tomcat-users.xml 文 件 ) 


。 其 他 字段 都 留 空 。 


-E HTTP Authorization Manager 
are ? à 


Authorzations Stored in the Authorization Manager 


Add Delete Lead Save pI 963), COW 


添加 采样 器 的 HTTP 请 求 

现在 ， 我 们 已 经 定义 了 我 们 的 用 户 ， 它 是 时 间 来 定义 ， 他 们 将 要 执行 的 任务 。 我 们 
将 增加 HTTP 请 求 元 素 。 点 击 鼠 标 右键 得 到 添加 菜单 ， 然 后 选择 Add > Sampler > 
HTTP Request. 然后 ， 选 择 HTTP 请 求 树 中 的 元 素 ， 并 在 下 面 的 图 片 编辑 以 下 属 
性 : 


这 个 元 素 中 输入 下 列 详细 信息 : 
e Name : 服务 器 状态 
e Server Name or IP : localhost 
e Port : 8080 
e Path : /manager/status 
e Parameters : 添加 请 求 参 数 名 为 XML” 大 写 。 给 它 一 个 小 写 “true” 值 。 
e Optional Tasks : 检查 采样 底部 的 “监视 器 ”。 
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添加 音量 计时 器 


要 定期 要 求 服务 器 状态 ， 添 加 的 常量 元 素 ， 这 将 使 每 个 请 求 之 间 的 时 间 间 陋 定时 
器 。 这 个 线程 组 中 添加 一 个 计时 器 Add > Timer > Constant Timer. 


输入 5000 之 秒 在 线程 的 延迟 框 中 。 在 一 般 情 况 下 ， 使 用 短 的 间隔 超过 5 秒 将 添加 到 
服务 器 的 压力 。 搞 清楚 什么 是 可 接受 的 间隔 ， 在 生产 环境 中 部 署 监视 器 。 





monitor test jmx (/home/manisha/work /Manishawork/tutorialspoint /JMeter/jmeter results/monit 
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添加 监听 器 


需要 添加 到 测试 计划 中 的 最 后 一 个 元 素 是 一 个 监听 器 。 我 们 将 两 种 类 型 的 监听 器 。 
结果 存储 在 一 个 文件 中 的 第 二 个 显示 的 图 形 视图 中 的 结果 。 


选择 线程 组 元 素 ， 并 添加 一 个 简单 的 数据 写 入 器 监听 Add > Listener > Simple Data 
Writer. 下 一 步 ， 指 定 输 出 文件 的 目录 和 文件 名 (在 我 们 的 案例 中 为 


/home/manisha/work/sample.csv) 





Eile Edit Search Run Options Help 
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Manege Name: Simple Data wter 


Comments 





Write results to file / Read from file 
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让 我 们 添加 另 一 个 监听 器 ， 通 过 选择 测试 计划 元 件 Add > Listener > Monitor 
Results. 





Eile Edit Search Run m Help 
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运行 此 测试 计划 


现在 保存 的 以 上 测试 计划 monitor testjmx 。 执 行 本 测试 计划 使 用 Run > Start 选 
H. 





查看 输出 


结果 将 被 保存 在 /home/manisha/work/sample.csv 的 文件 。 在 下 面 的 图 片 ， 你 还 可 


以 看 到 I 一 个 图 形 化 的 结果 的 监测 结果 监听 
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请 注意 图 中 有 字幕 图 形 的 两 侧 上 。 在 左边 是 %， 右 边 是 dead/healthy。 如 果 记 忆 线 
尖峰 迅速 下 降 ， 这 可 能 表明 内 存 颠 艇 。 在 这 些 情况 下 ， 与 Borland Optimizeit 的 


JProbe 的 分 析 应 用 程序 。 和 希望 看 到 的 是 一 个 普通 的 负载 ， 内 存 和 线程 模式 。 任 何不 
稳定 的 行为 通常 表明 表现 欠 佳 或 某 种 形式 的 错误 。 


jMeter 4 It 25 - JMeter 教 程 
监听 器 提供 JMeter 有 关 JMeter 的 运行 测试 用 例 ， 同 时 收集 信息 的 访问 。 结 果 还 是 
监听 器 所 收集 的 信息 可 以 显示 的 形式 : 
e hj (tree) 
e X (tables) 
e 图 形 (graphs) 
e 日 志文 件 
当 它 被 指定 ， 所 有 侦 听 器 相同 的 原始 数据 写 入 到 输出 文件 中 。 


默认 配置 


要 保存 的 默认 项 可 以 定义 : 
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e Ítjmeter.properties (sXuser.properties) 文件 中 。JMeter 的 /bin 文 件 夹 中 ， 这 
个 文件 是 存在 。 要 更 改 默认 格式 ， 发 现 以 下 行 jmeterproperties 文件 : 


jmeter.save.saveservice.output format- 


e 或 通过 使 用 配置 弹出 下 面 的 图 片 所 示 : 


JMeter 创建 JTL (JMeter 的 文本 日 志 ) 试 运行 的 结果 。 这 些 通常 被 称 为 JTL Xd, 
因为 这 是 默认 的 扩展 名 - 但 可 以 使 用 任何 扩展 名 。 


如 果 使 用 相同 的 输出 文件 名 ， 那 么 JMeter 自动 追加 新 的 数据 到 文件 末尾 的 运行 多 


个 测试 。 


监听 器 器 可 以 记录 到 一 个 文件 中 ， 而 不 是 到 UI 结果 。 它 的 目的 是 记录 数据 GUI 的 
开销 ， 从 而 提 供 一 种 有 效 的 手段 。 


当 运 行 在 : 
e GUI 模式 : 使 用 监听 器 器 简单 的 数据 写 入 
e。 非 GUI 模式 : -| 标志 ， 可 用 于 创建 数据 文件 。 


监听 器 可 以 使 用 大 量 的 内 存 ， 如 果 有 很 多 的 样品 。 为 了 尽量 减少 所 需 的 内 存量 ， 使 
用 简单 的 数据 写 入 ， 并 使 用 CSV 格 式 。 


CSV 日 志 格 式 


CSV 格 式 的 日 志 格式 取决 于 数据 项 中 选择 配置 。 只 有 指定 的 数据 项 被 记录 在 文件 
中 。 外 观 上 的 列 的 顺序 是 固定 的 ， 如 下 所 示 : 


字段 描述 示例 值 
timeStamp in milliseconds since 1/1/1970 1354223881017 
elapsed in milliseconds 1858 
label sampler label HTTP Request 
responseCode e.g. 200, 404 200 
responseMessage e.g. OK OK 
threadName Thread Group 1-1 
dataType e.g. text text 
success true or false true 
failureMessage if any 
bytes number of bytes in the sample 34908 

number of active threads in this 
gipihredes thread group í 
AlliHreads total number of active threads in all 1 
groups 
URL http://yiibai.com 
Filename if Save Response to File was used 
latency time to first response 132 
encoding utf-8 
sampiecount | Murberofsarpes e N 
Seon users Co E 
Hostname where the sample was generated LaptopManisha 
idieTime number of milliseconds of 'Idle' time 
(normally 0) 
Variables if specified 


保存 响应 数据 


响应 数据 可 以 被 保存 在 XML 中 的 日 志文 件 (如 果 需 要 ) 。 但 它 也 有 限制 ， 当 文件 很 
大 ， 也 不 能 包含 图 像 。 在 这 种 情况 下 ， 使 用 后 处 理 器 Save_Responses_to_a_file。 
这 会 产生 一 个 新 的 文件 ， 对 每 个 样品 ， 样 品 保存 的 文件 名 。 样 品 中 的 日 志 输 出 的 文 


件 名 可 以 被 包含 。 这 些 数 据 将 被 从 文件 示例 日 志文 件 时 ， 如 果 有 必要 被 重新 检索 。 


数据 加 载 ( 读 取 ) 响应 数据 


要 查看 现 有 结果 文件 ， 可 以 使 用 “文件 "浏览 .按钮 选择 一 个 文件 。 如 果 有 必要 ， 只 
需 创建 一 个 虚拟 测试 计划 ， 在 合适 的 监听 器 。 


GUI 数 据 保存 监听 器 


JMeter 是 能 够 保存 任何 监听 器 器 作为 一 个 PNG 文 件 。 要 做 到 这 一 点 ， 在 左 侧面 板 中 
选择 监听 器 ， Edit > Save As Image. 


会 出 现 一 个 文件 对 话 框 。 输 入 所 需 的 名 称 和 保存 的 监听 器 。 


JMeter/2X - JMeter 教 程 


JMeter] H > % Æ 


e JMeter HAE AR RER a8 SRL ICSE iA FRIR R — T ER 
数 调用 看 起 来 像 这 样 : 


${__ FunctionName(vari, var2,var3)} 


e functionName RANA KMAR. PZ $( threadNum}. 
e UMR-THRSRaAS—-T2asS, ABH”, MRAM, 


${__time(EEE, d MMM yyyy)} 


e 引用 变量 : 
${VARIABLE} 
Eg AN Ze 
FRIJE ST — 22K RUBUS A : 
函数 类 型 名 称 注释 
Information threadNum get thread number 
Information | samplerName get the sampler name (label) 
Information | machinelP get the local machine IP address 
Information | machineName get the local machine name 


return current time in various 


Information time 
formats 


log (or display) a message (and 
Information log return the value) 


log (or display) a message (empty 


Information logn 
return value) 


Input StringFromFile read a line from a file 


Input 
Input 


Calculation 
Calculation 
Calculation 
Calculation 
Calculation 
Calculation 
Scripting 

Scripting 


Scripting 


Properties 
Properties 
Properties 
Variables 
Variables 


Variables 


Variables 


String 


String 


String 


String 


String 
String 


CSVRead 
XPath 


counter 
intSum 
longSum 
Random 
RandomString 
UUID 
BeanShell 


javaScript 
jexl, jexl2 


property 

P 
setProperty 
split 

V 


eval 


evalVar 


regexFunction 


escapeOroRegexpChars 


char 


unescape 


unescapeHtml 


escapeHtml 


read from CSV delimited file 


Use an XPath expression to read 
from a file 


generate an incrementing number 
add int numbers 

add long numbers 

generate a random number 
generate a random string 
generate a random type 4 UUID 
run a BeanShell script 

process JavaScript (Mozilla Rhino) 


evaluate a Commons Jexl 
expression 


read a property 

read a property (shorthand method) 
set a JMeter property 

Split a string into variables 

evaluate a variable name 

evaluate a variable expression 


evaluate an expression stored in a 
variable 


parse previous response using a 
regular expression 


quote meta chars used by ORO 
regular expression 


generate Unicode char values from 
a list of numbers 


Process strings containing Java 
escapes (e.g. & ) 


Decode HTML-encoded strings 


Encode strings using HTML 
encoding 


String TestPlanName Return name of current test plan 


e AAF BARN : 
o 用 户 定义 的 静态 值 (或 变量 ) 
o ABE 


e. 用 户 定义 的 静态 值 允 许 用 户 定义 变量 时 被 替换 为 静态 的 值 测试 树 编译 并 提交 运 
行 。 


e 需要 注意 的 是 ， 变 量 目 前 无 法 做 套 ， 即 ${Var${N} 不 起 作用 。 
e V (变量 ) WR 〈 版 本 2.2 后 ) 可 用 于 执行 此 操作 : ${V(Var${N})}. 
e 这 种 类 型 的 替换 可 能 没有 函数 ， 但 更 方便 ， 更 直观 


函数 和 变量 可 以 在 哪里 使 用 ? 
e 画 数 和 变量 可 以 被 写 人 到 任何 领域 的 任何 测试 部 件 。 
。 下 面 的 事 数 测试 计划 应 确定 工作 : 
o intSum 
o longSum 


machineName 


o 


o BeanShell 


o 


javaScript 
o jexl 


random 


o 


o time 


o property functions 


o 


log functions 


> 测试 计划 使 用 的 功能 有 一 些 限 制 。JMeter 的 线程 变量 没有 被 完全 成 立 义理 功能 

时 ， 不 会 设置 变量 名 作为 参数 传递 ， 将 无 法 正常 工作 和 变量 引用 ， 所 以 split() 和 

regex() 变量 赋值 事 数 不 会 工作 。 threadNum() 函数 闻 不 能 工作 (没有 任何 意义 在 
测试 计划 级 别 ) 。 


引用 变量 及 函数 
e 引用 的 变量 中 的 测试 元 件 是 通过 包围 在 变量 名 '9( and}. 


APSHA, BARRI, BMRA FA, MEHR 
用 户 值 的 名 称 。 


有 些 孙 数 带 参数 的 配置 ， 而 这 些 括号 中 ， 有 逗号 分 隔 。 如 果 阔 数 没有 参数 ， 括 号 
可 以 省 略 。 对 于 例如 : 


${__ BeanShell(vars.put("name", "value" ) )} 


e 另外 ， 可 以 定义 你 的 脚本 作为 一 个 变量 ， 例 如 测试 计划 : 


SCRIPT vars.put("name", "value" ) 


e 然后 ， 该 脚本 可 以 被 引用 如 下 : 


${__BeanShell(${SCRIPT})} 


函数 辅助 对 话 框 


JMeter 选项 tab" 可 从 豆 数 助手 对 话 框 。 


e 使 用 图 数 助 手 ， 可 以 选择 一 个 图 数 从 拉 下 来 ， 并 指派 其 参数 值 。 左 边 的 表 中 的 
列 的 参数 ， 简 要 说 明和 右 列 是 你 写 在 该 参数 的 值 。 不 同 范 数 的 不 同人 参数 。 


e 一 旦 这 样 做 了 ， 点 击 “ 生 成 "按钮 ， 并 产生 相应 的 字符 串 复制 粘贴 到 测试 计划 。 
预定 义 变 量 
JMeter 内 部 定义 的 一 些 变量 。 它 们 分 别 是 

e COOKIE cookiename - 包含 cookie 的 值 


e JMeterThread.last sample ok - 与 否 的 最 后 一 个 样本 是 确定 的 - true/false. 
注 : 这 是 更 新 后 的 后 处 理 和 断言 已 经 运行 。 


e START 变量 


预先 定义 的 特性 


一 些 内 置 的 的 属性 定义 JMeter。 下 面 列 出 了 这 些 。 为 方便 起 见 ， 启 动 的 属性 也 被 复 
制 到 具有 相同 名 称 的 变量 。 


e START.MS - JMeter 启动 时 间 (毫秒 ) 
e START.YMD - JMeter 启动 时 间 为 yyyyMMdd 
e START.HMS - JMeter 启动 时 间 为 HHmmss 


e TESTSTART.MS - 测试 开始 时 间 (毫秒 ) 


请 注意 ， 开 始 变量 /属性 代表 JMeter 的 启动 时 间 ， 而 不 是 测试 开始 时 间 。 它 们 主要 
适用 于 使 用 文件 名 等 。 


jMeter 正 则 表达 式 - JMeter 教 程 

使 用 正则 表达 式 搜 索 和 操纵 文本 ， 基 于 模式 。 JMeter 解释 正则 表达 式 的 形式 或 模 
式 被 用 于 整个 JMeter 测试 计划 ， 包 括 模式 匹配 软件 Apache Jakarta ORO. 

使 用 正则 表达 式 ， 我 们 当然 可 以 节省 大 量 的 时 间 ， 并 实现 更 大 的 灵活 性 ， 因 为 我 们 
建立 或 加 强 一 个 测试 计划 。 正 则 表达 式 提 供 了 一 种 简单 的 方法 来 获取 信息 页 面 时 ， 
它 是 不 可 能 或 很 难 预 测 结果 。 


使 用 表达 式 的 标准 用 法 的 例子 是 从 服务 器 响应 得 到 一 个 会 话 ID。 如 果 服 务 器 返回 一 
个 唯一 的 会 话 密 钥 ， 我 们 可 以 很 容易 地 得 到 我 们 的 负载 脚本 中 使 用 表达 式 。 


要 使 用 正则 表达 式 在 测试 计划 ， 需 要 使 用 正则 表达 式 提 取 在 JMeter。 可 以 将 正则 表 
达 式 在 测试 计划 中 的 任何 组 件 使 用 。 


这 是 值得 强调 的 包含 和 比赛 之 间 的 差异 ， 如 用 于 响应 断言 测试 元 件 : 


e 包含 表示 正则 表达 式 匹 配 至 少 有 一 些 目标 的 一 部 分 ， 所 以 ' 字 母 " 包 含 "ph.b. 因 
为 正则 表达 式 匹 配 'phabe"”。 


e 匹配 正则 表达 式 匹 配 整 个 目标 。 因 此 , “alphabet “mit, 
假设 想 匹 配 一 个 Web 页 的 以 下 部 分 : 


name="file" value="readme. txt" 


要 提取 readme.txt。 一 个 合适 的 正则 表达 式 如 : 


name-"file" value="(.+?7)"> 


上 述 的 特殊 字符 是 : 
e (and ) - 这 些 匹 配 字符 串 括 起 来 的 部 分 要 返回 
e . -匹配 任何 字符 


m 一 次 或 更 多 次 
e ? - 停止 在 第 一 个 匹配 成 功 时 


CREATE JMeter 测 试 计划 


让 我 们 了 解 在 正则 表达 式 中 使 用 正则 表达 式 提 取 后 义理 器 的 元 素 ， 编 写 一 个 测试 计 
划 。 此 元 素 会 从 当前 页 面 使 用 正则 表达 式 识别 文字 图 案 所 需 的 元 素 ， 符 合 提取 文 
本 。 


首先 ， 我 们 将 写 人 名 单 和 他 们 的 电子 邮件 ID 是 一 个 HTML 页 面 。 它 部 署 到 tomcat AR 
务 器 。 HTML (index.htmll) 上 的 内 容 如 下 : 


«html» 

«head» 

</head> 

<body> 

<table style="border: 1px solid #000000; "> 

«th style="border: 1px solid #000000;">ID</th><th style="border: 1 
<tr><td id="ID" style="border: 1px solid #000000;">3</td><td id="Né 
<tr><td id="ID" style="border: 1px solid #000000;">4</td><td id="Né 
</table> 

</body> 

</html> 


4 — 
部 署 在 Tomcat 服务 器 上 ， 这 个 页 面 会 看 起 来 像 在 下 面 的 快照 : 





在 我 们 的 测试 计划 中 ， 我 们 将 选择 人 以 上 列表 页 中 看 到 的 人 表 的 第 一 行 的 人 。 为 了 
捕捉 这 个 人 的 ID， 让 我 们 首先 确定 的 模式 ， 我 们 会 发 现在 第 二 排 的 人 。 在 下 面 的 快 
照 中 可 以 看 出 ， 第 二 个 人 的 ID 被 包围 <td id="ID"> 的 和 </TD>， 它 是 具有 这 种 模式 的 
数据 的 第 二 行 。 我 们 可 以 用 它 来 完全 匹配 的 模式 ， 我 们 希望 从 中 提取 信息 。 正 如 我 
们 要 提取 两 条 信息 从 当前 页 的 ， 该 人 ID 和 该 人 的 姓名 ， 字 段 定义 如 下 : 


启动 JMeter， 添 加 一 个 线程 组 Test Plan > Add» Threads(Users)> Thread Group. 


接 下 来 ， 添 加 一 个 采样 器 的 HTTP 请 求 ， 右 键 单 击 选择 的 测试 计划 Add > Sampler > 
HTTP pum 站 人 详情 如 下 : 


e Name: Manage 
e Server Name or IP: localhost 
e Port Number: 8080 


e Protocol: We will keep this blank, which means we want HTTP as the 
protocol. 


e Path: jmeter/index.htmll 


接 下 来 ， 添 加 一 个 正则 表达 式 提取 。 选 择 HTTP 请 求 采样 器 (SH) , Atma 
Add > Post Processor > Regular Expression Extractor. 


上 述 快照 详情 如 下 : 


Field 


Reference 
Name 


Regular 
Expression 


Template 


Match No. 


Default 


学 


fü 
所 提取 的 测试 将 被 存储 在 其 中 的 变量 的 名 称 (refname) 。 


对 文本 提取 模式 将 匹配 。 文 字 组 ， 将 提取 的 字符 '(' 和 ') ' 所 包 
围 。 我 们 使 用 '+ ?' 由 <td..>..</ TD> 标 签 包围 的 文本 来 表示 一 个 单 
一 实例 。 在 我 们 的 例子 中 的 表达 式 为 : <tdid="ID"> (+) </TD> 
S<td id="Name"> (+) </TD>S 


提取 的 文本 的 每 个 组 将 被 放置 作为 成 员 变 量 person,“ ("FN") ” 括 
起 来 的 模式 各 组 的 顺序 之 后 。 每 个 组 存储 为 refname_g##， 其 中 
refname 是 你 输入 的 字符 串 作 为 参考 名 称 ，## 是 组 号 。 $1$ 指 组 

1，$24 是 指 第 2 组 ，$0$ 是 指 无 论 整个 表达 式 匹 配 。 在 这 个 例子 

中 ， 我 们 所 提取 的 ID 将 被 保持 于 Person_g1， 而 “名 称 "的 值 将 被 

存储 在 Person_g2。 


既然 我 们 打算 只 提取 第 二 次 出 现 的 这 种 模式 ， 相 匹配 的 第 二 项 ， 
我 们 使 用 值 2。 值 0 将 随机 匹配 ， 而 在 foreach 控 制 器 需要 使 用 负 
值 。 

如 果 该 项 目 没有 找到 ， 这 将 是 默认 值 。 这 是 一 个 可 选 字段 。 可 能 
会 让 它 空 白 。 


添加 一 个 监听 器 来 捕捉 这 个 测 斌 计划 的 结果 。 右 键 单 击 线程 组 选择 Add > Listener 
> View Results Tree 选项 添加 监听 器 。 


保存 测试 计划 为 reg_express_testjmx 和 运行 测试 。 输 出 将 是 一 个 成 功 ， 因 为 在 下 


面 的 快照 : 


JMeter f= 3: Ek - JMeter 教 程 


JMeter 尤其 是 当 它 运行 在 分 布 式 环境 中 具有 一 定 的 局 限 性 。 遵 循 这 些 指导 原则 将 有 


助 于 创造 


一 个 真正 的 和 持续 的 负载 : 


e 使 用 JMeter 多 个 实例 的 线程 数 较 多 的 情况 下 。 
e 检查 的 范围 规则 ， 并 进行 相应 的 设计 。 

。 总 是 使 用 命名 约定 的 所 有 元 素 。 

。 检查 默认 浏览 器 的 连接 设置 ， 执 行 脚本 之 前 。 
e jx H H zs. 

e 下 面 是 一 些 建议 ， 以 减少 资源 的 要 求 : 


o 


o 


o 


o 


o 


o 


o 


使 用 非 GUI 模 式 : jmeter -n -t test.jmx -| test jtl. 
使 用 为 监听 器 尽 可 能 少 ;如 果 使 用 -| 标志 如 上 ， 他 们 都 可 以 被 删除 或 禁用 。 


禁用 “查看 结果 树 ” 监 听 器 ， 因 为 它 消耗 了 大 量 的 内 存 ， 并 可 能 导致 在 控制 
台 冻 结 或 JMeter 的 运行 内 存 。 它 是 ， 但 是 ， 安 全 使 用 "查看 结果 树 " 监 听 器 
只 用 错误 检查 。 


而 不 是 使 用 很 多 类 似 的 采样 ， 在 一 个 循环 中 使 用 相同 的 采样 和 使 用 变量 的 
(CSV 数 据 集 ) ， 以 不 同 的 样品 。 或 许 使 用 访问 日 志 取 样 。 


不 要 使 用 功能 模式 。 

使 用 CSV 输 出 ， 而 不 是 XML。 
只 保存 你 需要 的 数据 。 

使 用 尽 可 能 尽 可 能 少 的 断言 。 


茶 用 所 有 的 JMeter 图 ， 因 为 他 们 消耗 了 大 量 的 内 存 。 可 以 查看 所 有 在 Web 
界面 使 用 JTLs 标 签 的 实时 图 形 。 


不 要 忘 了 删除 的 本 地 路 径 设 置 配置 如 果 使 用 CSV 数 据 。 


每 次 测试 运行 前 清理 “文件 ”选项 卡 。 


JOGL 教 程 
本 章 介 绍 了 OpenGL，Java OpenGL (GL4java, LWJGL, JOGL) 和 JOGL 比 
其 他 的 OpenGL 的 优点 。 


Java 支 持 OpenGL (JOGL) 是 近期 在 Java OpenGL 图 形 API 结 合 。 它 是 一 个 包装 
库 ， 它 可 以 访问 OpenGL API， 并 且 它 被 设计 来 创建 Java 编 码 的 2D 和 3D 图 形 应 用 程 
序 。 JOGL 是 前 麻 省 理工 学 院 的 研究 生 肯 : 拉 塞 尔 和 克 里 斯 : 克 莱恩 最 初 开 发 的 一 个 
开源 库 。 后 来 发 布 到 Sun Microsystems， 现 在 它 是 Java 图 形 和 音频 义理 
(JOGAMP) 。 用 于 各 种 操作 系统 ， 如 Windows，Solaris 和 Mac OS X 和 Linux ( 基 
于 x86) JOGL 功 能 。 


OpenGL 是 什么 ? 
OpenGL 代 表 开 放 图 形 库 ， 用 来 创建 2D 和 3D 图 形 的 集合 。 在 OpenGL 中 ， 可 以 创建 
一 个 使 用 非常 基本 的 图 元 ， 如 点 ， 线 ， 多 边 形 ， 位 图 和 图 像 复 末 的 三 维 形状 。 
下 面 是 OpenGL 的 几 个 特点 : 

e 它 可 以 在 多 个 平台 上 工作 。 

。 它 有 几 种 语言 ， 如 C ++，Python 绑 定 等 。 

e 它 可 以 呈现 2D 和 3D 矢 量 图 形 。 

e 它 与 图 形 义理 单元 (GPU) 实现 快速 ， 高 品质 的 泻 染 。 “〈 演 染 是 指 创建 从 一 

个 二 维 或 三 维 模型 的 图 像 的 过 程 。) 

° P ETEA 例如 ， 游 戏 ， 屏 幕 保 护 程序 
它 包 含 约 150 个 命令 ， 程 序 员 可 以 使 用 指定 的 对 象 和 操作 来 开发 应 用 程序 。 
e 它 包 含 了 OpenGL 实 用 库 (GLU) ， 提 供 各 种 建 模 功 能 ， 如 二 次 曲面 和 NURBS 
曲线 。 GLU 是 OpenGL 的 一 个 标准 组 件 。 
OpenGL 的 设计 重点 是 效率 ， 效 益 和 实现 使 用 多 语言 在 多 个 平台 。 保 持 一 个 
OpenGL API 的 简单 框架 ， 不 包括 窗口 的 任务 。 因 此 ，OpenGL 依 赖 于 其 他 编 
程 语言 对 加 窗 的 任务 。 


Java 绑 定 OpenGL API 


它 是 一 个 Java 规 范 请 求 〈JSR) 的 API 规 范 ， 它 允许 使 用 OpenGL 在 Java 平 台 上 。 


产品 规格 详细 
JSR 231 Java E ax Java SE 平台 。 
JSR 239 Java 绑 定 包 支持 Java ME 平台 。 


在 Java 中 有 各 种 OpenGL 的 绑 定 。 他 们 是 : 


GL4java 


这 是 被 称 为 OpenGL 的 Java 技 术 。 它 链接 OpenGL1.3 和 几乎 所 有 的 供应 商 扩 展 。 此 
外 ， 它 可 以 用 于 抽象 窗口 工具 包 (AWT) 和 摆动 。 它 是 一 个 游戏 聚焦 OpenGL 结 
合 ， 这 是 一 个 显示 全 屏幕 应 用 程序 的 单个 窗口 。 
LWJGL 

e 轻 量 级 的 Java 游 戏 库 (LWJGL) ， 使 用 OpenGL1.5， 并 结合 Java 最 新 版 本 。 
e 它 可 以 使 用 JSE1.4 的 全 屏 功 能 。 但 它 对 于 AWT/Swings 的 支持 有 限 。 
e 它 适 用 于 重量 轻 的 设备 ， 如 移动 电话 ， 舱 人 式 设 备 等 。 


JOGL 
e JOGL 只 专注 于 2D 和 3D 泻 染 。 人 处 理 声音 和 输入 输出 的 接口 不 包括 在 JOGL。 


e 它 包括 图 形 工具 库 (GLU) ，GL 实 用 工具 包 (GLUT) ， 和 自身 APl-native 窗 
口 工 具 包 (NEWT) 。 


为 什么 要 用 JOGL? 


e 它 提 供 了 完全 访问 的 OpenGL API (版 本 1.0，4.3，ES1，ES2 ES3) , LARIL 
乎 所 有 的 供应 商 扩 展 。 因 此 ， 在 OpenGL 中 的 所 有 功能 都 包含 在 JOGL。 


e JOGL 集 成 了 AWT，Swing 和 标准 窗口 小 部 件 工 具 箱 (SWT) 。 它 也 包括 它 自 
己 的 本 机 窗口 工具 包 (NEWT) 。 因 此 ， 它 提供 窗口 的 完整 支持 。 


JOGL 万 史 


e 1992 - Silicon Graphics 公 司 发 布 了 第 一 个 OpenGL 的 规范 。 
e 2003 - Java.net 网 站 推出 的 新 功能 和 JOGL 发 表 首 次 在 同一 网 站 上 。 


e 2010 一 自 2010 年 以 来 ， 它 一 直 在 BSD 许 可 证 下 独立 的 开源 项 目 ， 它 是 计算 机 
软件 一 个 自由 的 许可 证 。 
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本 章 介 绍 了 设置 环境 以 使 用 JOGL 使 用 不 同 的 集成 开发 环境 (IDE)， 在 您 的 系统 上 。 


Ie JOGL 
对 于 JOGL 安 装 ， 需 要 有 以 下 系统 要 求 : 
系统 要 求 
第 一 个 要 求 是 要 在 机 器 上 安装 Java Development Kit (JDK) 。 
要 求 描述 
JDK 版 本 1.4 或 以 上 
内 存 没有 最 小 限制 
硬盘 大 小 没有 最 小 限制 
操作 系统 没有 最 小 限制 


需要 按照 设置 给 定 的 步骤 ， 从 配置 环境 入 手 JOGL 应 用 程序 开发 : 


第 1 步 - 在 机 器 上 验证 Java 安 装 
系统 的 开放 式 控制 台 ， 并 执行 下 面 的 Java 命 令 : 


平台 任务 命令 
Windows 打开 命令 控制 台 C:\>java-version 
Linux 打开 命令 终端 $java- version 
MAC 打开 终端 Machine:~ joseph$ java -version 


验证 在 各 操作 系统 的 输出 。 


平台 输出 
Java “1.6.0.21"java(TM) SE Runtime Environment(build 


Windows . 1..6.0 21-b07)Java HotSpot(TM) Client VM(buld 17.0-b7,mixed 
mode, sharing) 


Java "1.6.0.21"java(TM) SE Runtime Environment(build 
Linux 1..6.0 21-b07)Java HotSpot(TM) Client VM(buld 17.0-b7,mixed 
mode ,sharing) 


Java “1.6.0.21”java(TM) SE Runtime Environment(build 
MAC 1..6.0 21-b07)Java HotSpot(TM) Client VM(buld 17.0-b7,mixed 
mode ,sharing) 


52:5 - 安装 Java 开 发 工具 包 (JDK) 


如 果 Java 未 在 你 的 机 器 上 安装 ， 则 需要 从 Oracle 网 站 上 下 载 安 装 Java SDK : 
www.oracle.com/technetwork/java/javase/downloads/. 您 可 以 从 下 载 的 文件 安装 
JDK 说 明 。 需 要 按照 安装 和 配置 设置 的 指示 。 最 后 ， 设 置 PATH 和 JAVA_HOME 环 境 
变量 指向 包含 的 java.exe 和 javac.exe 文 件 的 目录 ， 它 们 分 别 为 : java install dir/bin 
和 java_install_dir。 


设置 Java-home 环 境 变量 指向 的 基本 目录 的 位 置 相同 的 路 径 ， 安 装 在 机 器 上 的 Java 
程序 。 


平台 $4 
Windows ， 设 置 环 境 变 量 JAVA HOME to C:\ProgramFiles\Java\Jdk1.6.0_ 21 
Linux Export JAVA_HOME=/usr/local/java-current 
MAC Export JAVA_HOME=/Library/Java/Home 


附加 的 Java 编 译 器 位 置 ， 系 统 路 径 如 下 : 


wo AA 
= AR T 
Rts . d 
Windows 添加 字符 串 ;%JAVA_HOME% bin at the end of the system 
variable and path 
Linux Export PATH=$PATH:$JAVA_HOME/bin/ 
MAC Not required 


第 3 步 - 下 载 JOGL 
e 可 以 从 网 站 上 下 载 JOGL 的 最 新 版 本 www.jogamp.org 


e 前 往 主 页 www.jogamp.org 
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e 点 击 Builds/Downloads > Current (zip). 
[[Blicsemp- Googie w JogAmp.org - Java graph x V =— 


© > Q [D jogamp.org r 三 














WN d 
a 
P ocom graphies, QUOIO, MEDIA ano proceanng ubraner 


Home Gluegen JOAL JOGL JOCL Wiki Blogs Streams Forum 


Sponsors 
Welcome Bo 
JogAmp is the home of high performance Java™ libraries for 3D Graphics, Multimedia and Processing. 
JOGL, JOCL and JOAL provide cross platform Java™ language bindings to the OpenGL®, OpenCL™, OpenAL and OpenMAX APIs. 
Modules: GlueGen, JOAL, JOGL, JOCL, JNLPAppletLauncher (retired) 


«ccT 


Community 


Meet us @ sicGnAPH 2014 Py " 














ds ei Forum / Mailinglist 
IRC Chatroom 
Streams 
D ] Blogs 
ocumentation Roadmaps dens 
> Wiki Page Releases 2.3.0, 2.2.0, 2.1.5, 2.1.4, 2.1.3, 2.1.2, 2.1.1, 2.1.0, 2.0.2 ideae 
* How To Build [ JOGL, JOCL ] * JogAmp SIGGRAPH 2012 - 2013 Improvements 
* How To Contribute 
? Licenses [ GlueGen, JOAL JOGL JOCL ] Builds / Downloads Seatied 
» API Docs [ GlueGen, JOAL, JOGL, JOCL] 
» Tutorials [ JOGL, JOCL ] Archive | release aster branch 
* JOGL [ Userguide, Deployment ] » Autobuilds 
"BEDS Contacts and Maintaine 
* OpenGL Evolution & JOGL (UML) 
» SIGGRAPH - BOF [2014, 2013, 2012, 2011, 2010] Commercial Support & Funding 











» FOSDEM - Talk [2014, 2013] m " 
» Res.Ind. NIIRRS ® GPII [naner. slidesl TT R: x 


可 以 看 到 网 站 所 维护 的 所 有 jar 文件 的 API 列 表 。 


E jogamp - Google Search Xx / W Index of /deployment/jog x \ ^ 


€ > Q |D jogamp.org/deployment/jogamp-current/archive/ Y? 








Index of /deployment/jogamp-current/archive 
Name Last modified Size Description 


> Parent Directory 

GQ ChangeL ogs! 07-Aug-2014 03:12 

[^3 Sources! 07-Aug-2014 03:13 

P gluegen-javadoc.7z 07-Aug-2014 00:24 305K 
joal-demos.7z 07-Aug-2014 0243 1.2M 

Eil joal-javadoc.7z 07-Aug-2014 00:25 104K 

国 jocl-demos.7z 07-Aug-2014 02:44 552K 

[2 jocl-javadoc.7z 07-Aug-2014 00:39 181K 

[2| jogamp-all-platforms.7z 07-Aug-2014 02:44 _ 29M | 

[2 jogl-demos.7z 07-Aug-2014 02:43 25M 

P| iogl-javadoc.7z 07-Aug-2014 00:38 1.6M 

©) test-results! 07-Aug-2014 02:44 





Apache/2.2.22 (Debian) Server at jogamp.org Port 80 
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e FRE .jarxftjogamp-all-plattorms.7z, JAVAX#4OpenGL X glugen- 
javadoc.7z 和 JOGL JOGL-javadocs.7z. 


e 提取 使 用 任何 压缩 解压 软件 下 载 的 ,jar 文件 。 
e 当 打 开 解 压 文件 夹 ， 会 发 现 jar 文件 夹 ， 源 代码 和 其 他 文件 。 
































ACTA = | jogamp-all-platforms = 地 
Home Share View @ | 
© - T Jd « KAS... > jogamp... vo Search jogamp-all-platforms Ap 
"X Favorites Name b Date modified ^ 
是 jnlp-files 2014 6:14 A 
di; Cada 此 lib 8/7/2014 6:14 ^ 
|_| aggregated.artifact.properties.sorted 8/7/2014 6:14 ^ 
wj Homegroup |_| all.artifact.properties.sorted 8/7/2014 6:14 ^ 
|_| gluegen.artifact.properties 8/7/2014 3:51 ^ 
pM This PC |_| gluegen.LICENSE.txt 8/7/2014 3:51 ^ 
je Desktop 8/7/2014 3:51 ^ 
.K] Documents Lj joal.artifact.properties 8/7/2014 3:55 ^ 
Jg. Downloads | L] joal.LICENSE.b«t 8/7/2014 3:55 A 
A) Music |_| joa. README.txt 8/7/2014 3:55 ^ 
©) Pictures = joal-java-src.zip 9/7/2014 3:55 ^ 
(E Videos |_| jocl.artifact.properties ITT 20 Tet 
iis OS (C) į] jocl.LICENSE.txt 2014 5:43 A 
ex KASYAP (F:) |_| Joc README.txt 8/7/2014 5:43 A 
= jocl-java-src.zip /7/2014 5:43 A 
€i Network |. | jogl.artifact.properties 8/7/2014 4:07 ^ 
EE Jogl.LICENSE.txt 8/7/2014 4:07 ^ 
EE jogl.README.txt 8/7/2014 4:07 ^ 
/7/2014 4:07 ^ 
do EELE TA OTE nia 407 A Y | 
< 

23 items | 

e 获取 源 代码 gluegen-java-src.zip 和 jogl-java-src.zip 支 持 IDE。 这 是 可 选 的 。 

e 文件 夹 中 的 jar， 有 多 个 .jar 文 件 。 文 件 的 集合 属于 Glugen 和 JOGL。 

。 JOAMP 提 供 支持 多 种 操作 系统 ， 如 Windows，Solraris，Linux 和 Android 原 生 
库 。 因 此 ， 需 要 采取 适当 的 jar 文 件 ， 这 些 文件 可 以 在 需要 的 平台 上 执行 。 例 
如 ， 如 果 使 用 的 是 Windows64 位 操作 系统 ， 那 么 可 以 通过 jarfolder 以 下 .jar 文 
ft - 

e gluegenrt.jar 


e jogl-all.jar 
e gluegen-rt-natives-windows-amd64. jar 
jogl-all-natives-windowsamd64.jar 


Home 


© 


Share 
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View 


»- m 出 < KASYAP (F:) » jogamp-all-platforms » jar 


Search jar 





* Favorites 


f& OneDrive 


Homegrou 
group 


jM This PC 
(f^ arshad (tp008) 


Rm Desktop 
E Documents 


" Downloads 
|i) Music 


È Pictures 


Ji atomic 


[&|gluegen jar 

| é;gluegen-rtjer | 

| S| gluegen-rt-android,jar 

图 gluegen-rt-android-natives-android-armv6,jar 
图 gluegen-rt-android-natives-linux-amd64,jar 
图 gluegen-rt-android-natives-linux-armv6.jar 
图 gluegen-rt-android-natives-linux-armv6hf.jar 
图 gluegen-rt-android-natives-linux-i586,jar 

图 gluegen-rt-android-natives-macosx-universal.jar 
图 gluegen-rt-android-natives-solaris-amd64.jar 
图 gluegen-rt-android-natives-solaris-i586,jar 


| S| gluegen-rt-android-natives-windows-amd64,jar 


epe syed javed (tp005) 图 gluegen-rt-android-natives-windows-i586.jar 
国 Videos 
& 05 (C) 
a KASYAP (F:) 


图 gluegen-rt-natives-android-armv6,jar 
图 gluegen-rt-natives-linux-amd64,jar 
| S| gluegen-rt-natives-linux-armv6.jar 
图 gluegen-rt-natives-linux-armv6hf.jar 


图 gluegen-rt-natives-linux-i586,jar 


Gu Network 
| S| gluegen-rt-natives-macosx-universal.jar 
图 gluegen-rt-natives-solaris-amd64.jar 
图 gluegen-rt-natives-solaris-i586.jar 


« 


52items — 4items selected 3.51 MB 


Eclipse4.4;x i& JOGL 
按照 给 定 的 程序 设置 JOGL : 
添加 以 下 类 库 


1. 打开 eclipse. 
2. 创建 一 个 新 工程 


gluegen-rt-natives-windows-i586,jar 
5| gluegen-test-util.jar 
[iogan | 
|S) jogl-all-android.jar 
| S|jogl-all-mobile-natives-windows-amd64,jar 
| S|jogl-all-mobile-natives-windows-i586,jar 
| S| jogl-all-natives-android-armv6,jar 
| S| jogl-all-natives-linux-amd64,jar 
| S| jogl-all-natives-linux-armvé6.jar 
| S)jogl-all-natives-linux-armv6hf.jar 
| S)jogl-all-natives-linux-i586,jar 
| S| jogl-all-natives-macosx-universal,jar 
| S| jogl-all-natives-solaris-amd64,jar 
jogl-all-natives-solaris-i586.jar 
jogl-all-natives-windows-amd64,jar 
£,|jogl-all-natives-windows-i586.jar 
| S)jogl-all-noawt jar 
| S| jogl-all-noawt-natives-android-armvé6,jar 
| S| jogl-all-noawt-natives-linux-amd64.jar 
| S| jogl-all-noawt-natives-linux-armv6,jar 
| S)jogl-all-noawt-natives-linux-armv6hf.jar 


> 
=) 





3. 创建 一 个 名 为 ib 目录 在 项 目 文件 夹 中 的 新 文件 夹 。 
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4. 复制 文件 gluegen-rt-natives-windows-amd64. jar, gluegen-rt.jar, jogl-all- 
natives-windowsamde64 jar 和 jogl-all.jar 到 lib 目录 。 


File Edit Source Refactor Navigate Search Project Run Window Help 


ea L i%~OvQ-' # T EAA 
: H-E- PETS 





[J] *Basicframejava 23 
33 Eclipselink JPA 
4 ie Myproject public class Basicframe { 
4 @ src E public static void main(String args[]){} 
4 —§ (default package) 
» [J] Basicframejava 
> wa JRE System Library [JavaSE-1.6] 


[2] gluegen-rt-natives-windows-amd64 jar 











5. 现在 选择 这 些 文件 ， 然 后 右键 单 击 鼠 标 按钮 。 将 显示 一 个 快捷 菜单 ， 其 中 包含 
Build Path > Add to Build Path. 








File Edit Source Refactor Navigate Search Project Run Window Help 




















Alt+Shift+W > 


Copy Ctrl+C 
Copy Qualified Name 
Paste 
Delete 





> $2 Eclipselink JPA 
4 号 Myproject 





Ctri+Alt+ Shift- Down 
Ctrl+Alt+ Shift-- Up 





. Remove from Context 





Mark as Landmark 





Assign Working Sets... 


Validate 
Show in Remote Systems view 
Run As 

Debug As 

Profile As 

Team 

Compare With 

Replace With 







-—— i-o Se oe 





JOGLZX - JOGL 教 程 
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6. 为 了 可 以 在 其 他 项 目 中 可 以 使 用 所 有 的 .jar 文 件 ， 进 入 主 菜单 。 选 择 Window > 


Preferences. 出 现在 首选 项 窗口 。 















































© Java - Myproject/src/Basicframe.java - Eclipse = de 
File Edit Source Refactor Navigate Search Project Run Help 
ri~ Ee g-u- wg eem E3 |& Java | i Java EE 
- -*50v X New Editor 
Hi Pagan Explorer 33 z% JE es D | Open Perspective » = 
3: Eclipselink JPA Show View | 
lm ceri : Customize Perspective... 3 , 
4 È src L : In(String args[]){} 
4 E} (default package) Save Perspective As... 
[J] Basicframejava Reset Perspective... 
wi, JRE System Library [JavaSE-1.6] Close Perspective 
4 (Z lib Close All Perspectives 





S| gluegen-rt-natives-windows-amd64.jar 
j Navigation > 








Preferences 








4 items selected 





. 在 首选 项 窗口 ， 在 下 拉 菜 单 上 的 左 侧 菜单 中 ， 按 照 hierarchy- Java-> Build 


Path -> User X. 


. Ra “New...” #242. 

. 这 将 打开 一 个 对 话 框 。 输 入 库 名 称 jogl2.1. 
10. 
11. 


添加 jar 文件 glugen-rt.jar 和 jogl-all.jar 使 用 按钮 “Add External JARs...”. 
这 将 创建 一 个 名 为 新 的 用 户 库 jogl2.1. 


以 同样 的 方式 ， 我 们 可 以 为 添加 .jar 文 件 添加 的 java 文 件 和 源 代码 。 


aN aJ 本 地 库 


1. 


展开 jogl-all.jar 的 节点 上 ， 选 择 Javadoc 位 置 (无 ) 。 


2. 点 击 “New...” 钮 ， 输 入 JOGL Java 文 件 的 名 称 。 
3. 
4 


ibid "Add External JARs...” #244. 
这 将 打开 你 需要 选择 JOGL Java 文 档 ， 我 们 已 经 先前 下 载 的 位 置 的 对 话 框 。 


添加 源 代码 


1. 选 
2. 
3. 


节点 本 地 库 的 位 置 : (None). 
Rd "New..." 按钮 . 
本 地 库 和 点 击 输 入 姓名 “OK” 按钮 . 


4. Fad "Add External JARs...” 按钮. 


5. 现在 选择 的 路 径 ， 其 中 原生 库 文件 ('gluegen-rt-natives-windows-amd64.jar 
and joglall-natives-windows-amd64 jar’) 位 置 . 


6. 重复 同样 的 程序 源 代码 。 


7T. 上 文 两 个 本 地 库 文件 ， 我 们 可 以 设置 为 Javadoc， 源 代码 和 jar 文 件 的 位 置 以 相 
同 的 方式 在 glegen-rt.jar 和 glugen-natives-windows-amd64.jar. 


Netbeans4.4 设 置 JOGL 
让 我 们 通过 以 下 步骤 来 设置 JOGL 针 对 NetBeans4.4 : 


AN DO 


1. 在 主 菜单 中 ， 选 择 Tools > Libraries. 
OQ 





Myproject - NetBeans IDE 8.0 -5 
| File Edit View Navigate Source Refactor Run Debug Profile Team Tools | Window Help [Q Search (Ctrl+1) | 


| Ta Fd (asl i E) © = «defaut config» "n 9 Apply Diff Patch... 


| T 4 Add to Favorites 
|| Projects X — || Start Page X | [8 JavaApplication1.java | vo 
| | Source | History | B-S-|% Analyze Javadoc alje mis = m 


C-[]& Source Packages 


















































E 1 Internationalization » ^m 
i = Ed javaapplication1 2 package javaapplicat 
由 B Libraries 3 Java Platforms 
4| E Ant Variables 
5 Libraries = 
6 = Servers 
7| L 
Cloud Provid 
8 public class JavaApp Siete sae 
9 Templates 
10| [- ^ DTDs and XML Schemas 
11 á Eder Palette Es 
ES - 
23 [= public static va Plugins 1 
14 TOL 
15| L } Options 
16 
17 ) 
18 v 
< > 











S 
x 
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2. 这 使 得 Ant Library Manager. 
oO Ant Library Manager 





Libraries location: Global Libraries vi 


Libraries: 











‘Absolute Layout A | Library Name: Absolute Layout 





E) Beans Binding | Classpath | Sources | Javadoc 


^) CopyLibs Task 
1] EdipseLink (JPA 2.1) | Library Classpath: 

‘fi EdipseLink-ModelGen (J Dam File<weteesossn 
E Groovy 2.1.7 

ER Hibernate 4.x 

1) Hibernate 4.x Modelge 
f) Hibernate 4.x(JPA2.0) 


| € Java EE 6 API Library 


ES Java EE 6 Endorsed AP 








| | Add JAR/Folder... | 











Add URL... 








| Remove 














Move Up 


Move Down 














1f) Java EE Web 7 API Library 
^19) Java ME Common Ant Tasks 

















| € || canei | Hep | 





. 在 Classpath 选 项 卡 ， 单 击 位 于 左下 角 新 建 库 按钮 。 它 会 打开 一 个 小 对 话 框 。 
. 输入 库 名 称 JoGI2.0. 

， 点击“OK” 按钮 . 

. 点击 “Add JAR/Folder...” #242. 

. 选择 在 jar 文件 jogl.alljar 和 gluegen-rtjar 所 在 的 路 径 。 

包括 JOGL 库 到 每 一 个 项 目 ， 请 执行 以 下 步骤 : 
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1. 在 项 目 名 称 上 单 击 右 键 。 它 显示 一 个 快捷 菜单 。 


File Edit View Navigate Source Refactor Run Debug profile Team Tools Window Help Qy Search (Ctrl) 
fire OE 9 — Vy Bd BH @- 


Files Servic..| — 加 JavaApplication1. java E wr 
f zm New TO M MELA EAA- N 四 























Aug 
Build e javaapplicationi; 

Clean and Build 
Clean 


Generate Javadoc 
thor Krishna Kasyap 


Run 


Debug class JavaApplicationi { 


Profile M 
Test Gparam args the command line arguments 


Set Configuration 
Iblic static void main(String[] args) { 
Open Required Projects // TODO code application logic here 


Close 


Rename... 
Move... 


Copy... 
Delete 























Find... Ctrl+F 
Inspect and Transform... 
Versioning d 
History id 





2. 选择 属性 。 它 打开 了 一 个 名 为 Project Properties O. 

3. 从 左 侧 的 类 别 中 选择 库 

4. 选择 编译 选项 卡 ， 并 单 击 “添加 库 ...” 按 钮 。 添 加 库 对 话 框 出 现 。 
5. 现在 添加 JOGL2.0 库 ， 先 前 创建 的 。 





包括 每 个 项 目的 本 地 库 


按照 给 定 的 步 又， 包括 在 每 个 项 目 中 机 库 : 
这 使 得 项 目 属 性 窗口 。 
用 鼠标 右键 单 击 该 项 目 。 
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2. 选择 Set Configuration > Customize... 





Q Myproject - NetBeans IDE 8.0 
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| File Edit View Navigate Source Refactor Run Debug Profile Team Tools Window Help|Q Search (Ctrl 
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Clean and Build 





kage javaapplicationi; 


Clean 


Generate Javadoc author Krishna Kasyap 


Run lic class JavaApplicationi { 
Debug 
Profile 


Test Alt+F6 PRSE 











Open Required Projects WL Customize... 





Close 


| Rename... 





| L Move... 








Copy... 上 a) S 


Lay | M ELA TAI ETE EET TIER: 


Set Configuration [e] «default config» |; 4 main(String[] args) { 


> 
国 
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Delete Delete 


Find... Ctrl+F 
Inspect and Transform... 
Versioning » 


History > 


Properties 


3. 在 右手 边 ， 在 VM 选项 ， 点 击 “Customize” 按 钮 。 


4. 浏览 包含 JOGL 本 地 库 的 路 径 gluegen-rt-natives-windows-amd64.jar" 和 'jogl- 


all-natives-windows-amd64.jar. 


添加 本 地 库 Java 文 档 
需要 再 次 打开 Ant 库 管理 ， 使 源 代 码 和 Javadoc 可 用 于 每 个 项 目 。 按 上 


添加 本 地 库 的 源 代码 


1. 打开 main menu. 

2. 选择 Tools > Libraries. 这 使 Library manager 

3. 在 JavaDoc 下 面 选项 卡 中 ， 单 击 “New Library...” 按钮 . 
4. 输入 JOGLJavadoc 名 称 . (可 以 输入 任何 所 需 的 名 称 ) 
5. maid: "Add jars/libraries..." 按钮 . 


AB 4A 
n 
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给 定 的 步骤 : 


6. 其 中 ， 选 择 解压 后 的 文件 JOGL 代 码 所 在 的 路 径 。 


7. 在 Sources 下 面 的 选项 卡 中 ， 单 击 “New Library...” 按钮 。 进 入 JOGLsources 
名 称 . 


8. rad “Add jars/libraries..." 按钮 ， 选 择 解压 缩 源 代码 所 在 的 路 径 。 
自 定义 JDK 编 辑 


1. 设置 类 路 径 的 文件 jogl.all.jar 和 gluegen-rt.jar。 


2. 设置 路 径 ， 本 地 库 gluegen-rt-natives-windows-amd64.jar 和 jogl-all-natives- 
windowsamd64.jar 复 制 并 将 其 粘贴 到 JSE lib 下 载 文件 夹 中 的 所 有 jar 文 件 。 


JOGL 基 本 模板 - JOGL 教 程 


本 章 介 绍 了 编写 JOGL 基 本 模板 的 概念 。 


重要 的 接口 和 类 


为 了 使 程序 能 够 使 用 JOGL 图 形 API， 需 要 实现 GLEventListener 接 口 。 


GLEventListener 接 口 


可 以 在 javax.media.opengl 包 找到 GLEventListener 接 口 。 
Interface: GLEventListener 
Package: javax.media.opengl 


下 表 给 出 了 各 种 方法 和 GLEventListener 接 口 的 详细 描述 : 


Sr. 


No. 方法 和 说 明 


Void display(GLAutoDrawable drawable) 这 就 是 所 谓 
1 GLAutoDrawable 接 口 的 对 象 ， 由 客户 机 发 起 OpenGL 演 染 。 也 就 是 说 ， 
该 方法 包含 用 于 绘制 使 用 OpenGL API 的 图 形 元 素 的 退 辑 。 


Void dispose(GLAutoDrawable drawable) 这 种 方法 的 信号 监听 执行 每 
各 GLContext， 所 有 的 OpenGL 释 放 资 源 ， 如 内 存 缓冲 区 和 GLSL 程 序 。 


Void init(GLAutoDrawble drawble) 这 就 是 所 谓 GLAutoDrawable 接 口 
OpenGL 上 下 文 被 初始 化 之 后 的 对 象 。 


Void reshape(GLAutoDrawble drawble,in tx,int y,int width ,int 
4 height) 第 一 重 画 过 程 中 它 被 称 为 GLAutoDrawable 接 口 的 对 象 的 组 件 大 
小 后 。 它 也 被 称 为 每 当 窗口 上 的 部 件 的 位 置 变化 。 


GLEventListener 所 有 的 方法 都 需要 GLAutoDrawable 接 口 作为 参数 的 对 象 。 


GLAutoDrawable 接口 


这 个 接口 提供 一 个 基于 事件 机 制 (GLEventListener) ， 用 于 执行 OpenGL 泻 染 。 
GLAutoDrawable 自 动 创 建 一 个 与 GLAutoDrawable 为 对 象 的 生命 周期 相关 联 的 一 个 
主要 呈现 上 下 文 。 


Interface: GLAutoDrawble 


Package: javax.media.opengl 


3n 方法 和 说 明 


No. 

1 GL getGL() 此 方法 返回 所 使 用 的 GLAutoDrawable 接 口 的 当前 对 象 的 GL 
管道 对 象 。 

2 Void addGLEventListener(GLEventListener Listener) 这 种 方法 增加 
了 给 定 侦 听 器 到 当前 绘制 队列 的 末尾 。 

3 Void addGLEventListener(int index,GLEventListener listener) 这 种 
方法 增加 了 给 定货 听 器 这 个 队列 中 绘制 的 给 定 索 引 处 。 

4 Void destroy() 这 种 方法 会 破坏 GLAutoDrawable 接 口 名 为 此 对 象 ， 包 括 


GLContext 相 关联 的 所 有 资源 。 
注 : 有 在 这 个 包 的 其 他 方法 。 只 有 很 少 的 关于 模板 的 重要 方法 是 在 此 界面 中 进行 讨 


论 o 


GLCanvas # 


GLCanvas 和 GLJpanel ZJOGL GUI 两 大 类 实现 GLAutoDrawable 接口 ， 这 让 他 
们 可 以 用 作 拉 丝 表 面 的 OpenGL 命 倒 。 


GLCanvas 是 一 个 重量 级 AWT 组 件 ， 它 提供 了 OpenGL 的 泻 染 支 持 。 这 是 一 
AWTAutoGLDrawable 接 口 的 主 执 行 。 它 还 是 java.awt.Canvas 继 承 类 。 因 为 它 是 一 
个 重量 级 的 组 成 部 分 ， 在 某 些 情况 下 ，GLJCanvas 可 能 无 法 与 Swing 组 件 正 确 地 结 
合 起 来 。 因 此 ， 必 须 递 愤 使 用 ， 同 时 它 与 Swing 共用 。 每 当面 临 GLJCanvas 问 题 ， 
那么 必须 使 用 GLJPanel 类 。 


GLCanvas 类 的 分 层 图 可 以 如 下 所 示 : 


GLCanvas implements the GLCanvas inherits the 
above interface hierarchy above class hierarchy 


javax.media.opengl.awt.GLCanvas 


e GLEventistener 接 口 工 作 以 及 GLCanvas 类 ， 它 响应 变化 GLCanvas 类 并 由 它们 
制 成 要 求 的 图 纸 。 


。 每 当 GLCanvas 的 类 被 实例 化 ， 调 用 GLEventListener 的 init() 方 法 。 可 以 覆盖 此 
方法 来 初始 化 OpenGL 的 状态 。 


e 每 当 GLCanvas 的 初始 绘制 (实例 化 ) ， 或 调整 大 小 ， 则 执行 GLEventListener 
的 reshape() 方 法 。 它 用 来 初始 化 OpenGL 的 视 口 和 投影 算 阵 。 它 也 被 调用 被 改 
变 来 组 件 的 位 置 。 


e GLEventListener() 方 法 显示 包含 泻 染 3D 场 景 的 代码 。 它 被 调用 时 调用 
GLCanvas 的 display() 方 法 。 


class: GLCanvas 
package: javax.media.opengl.awt 


Contructor 


**GLCanvas()** 


它 与 OpenGL 功 能 的 默认 设置 创建 一 个 新 的 GLCanvas 组 成 部 分 ， 使 用 默认 的 
OpenGL 功 能 选择 机 制 ， 在 默认 的 屏幕 设备 上 。 


**GLCanvas(GLCapabilitiesImmutable)** 


它 创建 了 一 个 新 的 GLCanvas 成 分 与 所 请 求 的 一 套 OpenGL 的 功能 ， 使 用 默认 的 
OpenGL 功 能 选择 机 制 ， 在 默认 的 屏幕 设备 上 。 


Sr. 


No. 方法 及 描述 


一 


1 Void addGLEventListener(GLEventListener listenenm) 它 增加 了 给 定 侦 
听 器 来 绘制 这 个 队列 的 末尾 


2 Void addGLEventListener(int indexGLEventListener listener) € 78 
加 了 给 定 侦 听 器 这 个 队列 中 绘制 的 给 定 索 引 处 。 


要 实例 化 GLCanvas 类 ， 需 要 GLCapabilitiesIimmutable 接 口 ， 它 指定 一 个 不 可 变 的 
集合 的 OpenGL 性 能 的 目的 。 


来 获得 Capabilitieslmmutable 接口 的 对 象 的 一 个 方式 是 实例 GLCapabilities 类 ， 
它 实现 接口 。 GLCapabilities 类 的 实例 可 以 用 来 服务 。 
GLCapabilities 类 


此 类 指定 一 组 的 OpenGL 性 能 。 它 需要 GLCapabilities 对 象 作为 参数 。 该 
GLCapabilities 类 描述 泻 染 上 下 文 必须 支持 所 期 望 的 功能 ， 例 如 OpenGL 的 轮廓 。 
class: GLCapabilities 

package: javax.media.opengl 


Constructor 


**GLCapabilities(GLProfile glprofile)** 


创建 一 个 GLCapabilities 对 象 。 


要 实例 化 GLCanvas 类 ， 需 要 GLCapabilitiesIimmutable 接 口 ， 它 指定 一 个 不 可 变 的 
集合 的 OpenGL 性 能 的 目的 。 


获得 CapabilitiesImmutable 接 口 的 对 象 的 一 种 方式 是 实例 化 GLCapabilities 类 并 实现 
接口 。 GLCapabilities 类 的 实例 ， 可 以 用 来 以 服务 为 目的 。 
GLCapabilities 类 


此 类 指定 一 组 OpenGL 性 能 。 它 需要 GLCapabilities 对 象 作为 参数 。GLCapabilities 
类 描述 泻 染 上 下 文 必须 支持 所 期 望 的 功能 ， 例 如 OpenGL 的 轮廓 。 


class: GLCapabilities 
package: javax.media.opengl 


Constructor 


**GLCapabilities(GLProfile glprofile)** 


GLCapabilities 类 又 需要 GLProfile 对 象 。 


GLProfile 类 


由 于 几 个 版 本 的 OpenGL API 发 布 ， 需 要 指定 OpenGL 的 API 确 切 版 本 被 用 在 你 的 程 
序 到 Java 虚 拟 机 (JVM) 。 这 是 通过 使 用 GLProfile 类 。 这 个 类 的 get() 方 法 接受 不 同 
的 预定 义 的 String 对 象 作为 参数 。 每 一 个 String 对 象 是 一 个 接口 的 名 称 ， 每 个 接口 支 
持 OpenGL 的 某 些 版 本 。 如 果 初 始 化 这 个 类 的 静态 和 单 例 ， 这 个 类 提供 了 每 个 可 用 
JOGL 单 例 GLProfile 对 象 。 


class: GLProfile 


package: javax.media.opengl 


Method and 描述 
Static GLProfile get(String profile) 使 用 默认 设备 。 


因为 这 是 一 个 静态 方法 ， 需 要 使 用 类 名 来 调用 它 ， 它 需要 一 个 预定 义 的 静态 字符 串 
变量 作为 参数 。 有 在 这 12 级 这 样 的 变量 ， 分 别 代表 GL 接 口 的 独立 实现 。 


GLProfile.get(GLProfile.GL2); 


下 表 显 示 GLProfile 类 的 get() 方 法 的 字符 串 参 数 : 


预定 义 的 字符 串 值 (接口 名 称 ) 和 描述 

1 GL2 这 种 接口 包含 所 有 的 OpenGL[1.0 ...3.0] 的 方法 ， 以 及 它 的 大 多 数 扩 
展 中 定义 在 本 说 明 书 中 的 时 间 。 

2 GLES1 这 种 接口 包含 所 有 的 OpenGL ES[1.0 .…1.1] 的 方法 ， 以 及 它 的 大 
多 数 扩展 中 定义 在 本 说 明 书 中 的 时 间 

3 GLES2 这 种 接口 包含 所 有 的 OpenGL ES 2.0 的 方法 ， 以 及 它 的 大 部 分 在 
本 说 明 书 中 的 时 间 定 义 的 扩展 。 

4 GLES3 这 种 接口 包含 所 有 的 OpenGL ES3.0 的 方法 ， 以 及 它 的 大 部 分 在 


本 说 明 书 中 的 时 间 定义 的 扩展 。 

5 GL2ES1 此 接口 包含 GL2 和 GLES1 的 公共 子 集 。 

6 GL2ES2 此 接口 包含 GL3，GL2 和 GLES2 的 公共 子 集 。 

7 GL2GL3 此 接口 包含 核心 GL3 (OpenGL 的 3.1+) 和 GL2 的 公共 子 集 。 
GL3 这 种 接口 包含 所 有 的 OpenGL[3.1...3.3] 核 心 方法 ， 以 及 它 的 大 部 分 


8 在 本 说 明 书 中 的 时 间 定义 的 扩展 。 

9 GL3bc 这 种 接口 包含 所 有 的 OpenGL[3.1...3.3] 的 相 容 性 的 方法 ， 以 及 它 
的 大 部 分 在 本 说 明 书 中 的 时 间 定义 的 扩展 。 

10 GL3ES3 接 口 含 有 核心 GL3 (OpenGL 的 3.1+) 和 GLES3 (OpenGL 
ES3.0) 的 公共 子 集 。 

1 GL4 这 种 接口 包含 所 有 的 OpenGL[4.0...4.3] 核 心 方 法 ， 以 及 它 的 大 部 分 
在 本 说 明 书 中 的 时 间 定 义 的 扩展 。 

42 GL4bc 这 种 接口 包含 所 有 的 OpenGL[4.0...4.3] 相 容 性 分 布 ， 以 及 它 的 大 
部 分 在 本 说 明 书 中 的 时 间 定 义 的 扩展 。 

13 GL4ES3 接 口 含 有 核心 GL4 (OpenGL 的 4.0+) 和 GLES3 (OpenGL 


ES3.0) 的 公共 子 集 。 


现在 一 切 都 被 设置 在 使 用 JOGL 的 第 一 个 程序 中 。 


使 用 画布 与 AWT 的 基本 模板 


使 用 JOGL 的 编程 ， 可 以 绘制 各 种 图 形 形 状 ， 例 如 直线 ， 三 角形 ， 三 维 形状 ， 包 括 
特殊 效果 ， 如 旋转 ， 照 明 ， 色 彩 等 。 
JOGL 编 程 的 基本 模板 如 下 : 


步骤 1 : 创建 一 个 类 


最 初创 建 一 个 实现 GlEventListener 接口 的 类 ， 并 导入 包 javax.media.opengl, 3: 
现 所 有 四 种 方法 display(), dispose(), reshape(), init()。 由 于 这 是 基本 框架 ， 基 本 任 
务 ， 如 创建 Canvas 类 ， 将 其 添加 到 框架 进行 了 讨论 。 所 有 GLEVentListener 接 口 的 
方法 留 下 未 实现 。 

第 二 步 : 准备 画布 


(a) 构 建 GLCanvas 类 和 对 象 


final GLCanvas glcanvas = new GLCanvas( xxxxxxx ); 


//here capabilities obj should be passed as parameter 


(b) 实例 化 GLCapabilities 类 


GLCapabilities capabilities = new GLCapabilities( xxxxx ); 


//here profile obj should be passed as parameter 


生成 GLProfile 对 象 
因为 这 是 静态 方法 ， 它 是 使 用 类 名 调用 。 由 于 本 教程 是 关于 JOGL2， 产 生 GL2 接 口 
对 象 。 


final GLProfile profile = GLProfile.get( GLProfile.GL2 ); 
// both, variable and method are static hence both are called usint 


二 
让 我 们 看 到 了 代码 片段 画布 





//getting the capabilities object of GL2 profile 

final GLProfile profile = GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities - new GLCapabilities(profile); 
// The canvas 

final GLCanvas glcanvas - new GLCanvas(capabilities); 


BJE) 


现在 ， 使 用 方法 addGLEventListener() 添 加 GLEventListener 到 画布 。 此 方法 需 
GLEventListener 接 口 参数 的 对 象 。 因 此 ， 通 过 实现 GLEventListener 类 的 对 象 。 





BasicFrame basicframe=newBasic Frame( );// class which implements 
GLEventListener interface 
glcanvas.addGLEventListener( basicframe ); 


l = | > 








tt FHsetSize()75 35 4k K Bl javax.media.opengl.awt.AWTGLAutoDrawable 
GLCanvas 框 架设 置 大 小 。 


glcanvas.setSize( 400, 400 ); 


现在 ， 还 可 以 用 GLCanvas。 


第 三 步 : 创建 框架 
通过 实例 JSE AWT 框 架 组 件 的 Frame 类 对 象 创建 的 框架 。 
添加 画布 ， 使 框架 可 见 


//creating frame 

final Frame frame = new frame( " Basic Frame" ); 
//adding canvas to frame 

frame.add( glcanvas ); 
frame.setVisible( true ); 


第 4 步 : 在 全 屏 观 看 帧 


对 于 帧 的 全 屏 视图 ， 使 用 java.awt.Toolkit 中 的 类 得 到 默认 的 屏幕 大 小 。 现 在 ， 使 用 
这 些 默 认 的 屏幕 大 小 尺寸 ， 使 用 setSize() 方 法 设置 帧 的 大 小 。 


Dimension screenSize = 
Toolkit .getDefaultToolkit().getScreenSize(); 
frame.setSize(screenSize.width, screenSize.height); 


让 我 们 通过 在 程序 使 用 AWT 来 生成 基本 的 框架 : 


import 
import 
import 
import 
import 
import 
public 


javax 
javax 
javax 
javax 
javax 


javax. 


class 


QOverride 
public void display(GLAutoDrawable arg0O) ( 
// method body 


} 


QOverride 
public void dispose(GLAutoDrawable arg0O) ( 


} 


//method body 


@Override 
public void init(GLAutoDrawable arg0) { 
// method body 


} 


@Override 
public void reshape(GLAutoDrawable argO, int argi, int arg2, inl 
// method body 


} 


.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
JFrame; 


GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 


BasicFrame implements GLEventListener{ 


public static void main(String[] args) { 

//getting the capabilities object of GL2 profile 

final GLProfile profile - GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities - new GLCapabilities(profile); 


// The canvas 


final GLCanvas glcanvas - new GLCanvas(capabilities); 
BasicFrame b - new BasicFrame(); 
glcanvas.addGLEventListener(b); 

glcanvas.setSize(400, 400); 

//creating frame 


final JFrame frame 


new JFrame (" Basic Frame"); 


//adding canvas to frame 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 





如 果 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 它 显示 了 当 我 们 用 GLCanvas 类 与 
AWT 形 成 一 个 基本 的 框架 : 





使 用 画布 与 Swing 


使 用 Canvas 与 AWT 提 供 了 一 个 图 形 化 的 框架 与 重量 级 的 功能 。 对 于 具有 轻 量 级 的 
图 形 框 架 ， 同 时 采用 GLCanvas 与 Swing， 可 以 将 GLCanvas 会 在 窗口 JFrame 直 接 
使 用 ， 也 可 以 将 其 添加 到 JPanel 中 。 


下 面 的 程序 将 生成 使 用 GLCanvas 与 Swing 窗口 的 基本 框架 : 


import 
import 
import 
import 
import 
import 


public 


javax 
javax 
javax 
javax 
javax 


javax. 


class 


QOverride 
public void display(GLAutoDrawable arg0) { 
// method body 


j 


QOverride 
public void dispose(GLAutoDrawable arg0) { 


} 


//method body 


@Override 
public void init(GLAutoDrawable arg0O) { 
// method body 


} 


@Override 
public void reshape(GLAutoDrawable arg0O, int argi, int arg2, inl 
// method body 


.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
JFrame; 


GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 


BasicFrame implements GLEventListener{ 


public static void main(String[] args) { 

//getting the capabilities object of GL2 profile 

final GLProfile profile = GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities - new GLCapabilities(profile); 


ei) 


// The canvas 


final GLCanvas glcanvas = new GLCanvas(capabilities); 
BasicFrame b = new BasicFrame(); 
glcanvas.addGLEventListener(b); 

glcanvas.setSize(400, 400); 

//creating frame 


final JFrame frame 


new JFrame (" Basic Frame"); 


//adding canvas to it 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 
}//end of classimport 





如 果 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 它 显示 了 当 我 们 用 GLCanvas 与 
Swing 窗口 形成 一 个 基本 的 框架 。 





GLJPanel # 


它 是 一 个 轻 量 级 的 Swing 组 件 ， 它 提供 了 OpenGL 的 ; 
兼容 性 。 


GLJPanel 类 层次 结构 





eu 


BR 


java 


支持 。 它 提供 了 与 Swing 的 


.lang.Object 


javax.swing.JPanel 


GLJPanel implements the 
above interface hierarchy 


javax.media.opengl.awt.GLJPanel 


class: GLJPanel 


package: javax.media.opengl.awt 


GLJPanel inherits the 
above class hierarchy 


Contructors 


GJPanel() 


创建 一 个 用 OpenGL 功能 的 默认 设置 一 个 新 的 GLJPanel 组 成 部 分 。 


(GLCapabilitiesImmutable) 


创建 一 个 具有 指定 一 组 OpenGL 性 能 的 新 GLJPanel 组 件 。 


GLJPanel(GLCapabilitiesImmutable userCapsRequest, 
GLCapabilitiesChooser chooser) 


创建 一 个 新 的 GLJPanel 组 件 。 
方法 及 描述 


Void addGLEventListener(GLEventListener listener) 此 方法 将 给 定 的 侦 听 
器 ， 以 这 种 绘制 队列 的 末尾 。 


Void addGLEventListener(int indexGLEventListener listener) 这 种 方法 绘制 
该 队列 的 特定 索引 处 添加 指定 的 侦 听 器 。 


使 用 GLJPanel 与 Swing 窗 口 
让 我 们 来 看 看 生成 使 用 GLJPanel 与 Swing 窗 口 基本 框架 方案 : 


import 
import 
import 
import 
import 
import 
public 


javax 
javax 
javax 
javax 
javax 


class 


QOverride 
public void display(GLAutoDrawable arg0O) { 
// method body 


j 


QOverride 
public void dispose(GLAutoDrawable arg0) { 


} 
@Ov 


//method body 


erride 


.media. 
.media 
.media. 
.media. 
.media 
javax. 


opengl. 


-opengl. 


opengl. 
opengl. 


-opengl. 
swing. 


JFrame; 


GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 


BasicFrame implements GLEventListener{ 


public void init(GLAutoDrawable arg0O) { 
// method body 


} 
@Ov 


erride 


public void reshape(GLAutoDrawable arg@, int argi, int arg2, inl 
int arg4) ( 
// method body 


j 


public static void main(String[] args) { 

//getting the capabilities object of GL2 profile 

final GLProfile profile - GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities - new GLCapabilities(profile); 


二 EN - 


// The canvas 


final GLCanvas glcanvas - new GLCanvas(capabilities); 
BasicFrame b - new BasicFrame(); 
glcanvas.addGLEventListener(b); 

glcanvas.setSize(400, 400); 

//creating frame 


final JFrame frame 


new JFrame (" Basic Frame"); 


//adding canvas to it 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 
}//end of classimport 





如 果 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 这 表明 ， 当 我 们 使 用 GLJPanel swing 
窗口 形成 一 个 基本 框架 : 





JOGL 图 形 形 状 - JOGL 教 程 


本 教程 介绍 了 绘制 直线 ， 用 直线 的 各 种 形状 。 OpenGL 的 API 提 供 了 原始 的 方法 ， 
用 这 些 方法 ， 可 以 开发 形状 ， 如 三 角形 ， 多 边 形 和 圆 形 绘制 基本 图 形 元 素 如 点 ， 项 
点 ， 线 等 。 或 者 二 维和 三 维 。 


图 形 对 象 
要 访问 程序 特定 于 硬件 和 操作 系统 平台 ， 以 及 其 他 语言 编写 ， 上 比如 C 和 C++( 原 生 应 


用 ) 库 ，Java 使 用 一 种 称 为 Java 本 地 接口 (JN1) 编 程 框架 的 工作 。 JOGL 内 部 使 用 此 
#%O, MAP RRNA Riz Ph] OpenGL. 


Java Native Interface (JNI) 





OpenGl(functions] 


GLEventListener 接 口 的 所 有 四 种 方法 让 代码 (Java JOGL 方 法 )， 它 内 部 调用 
OpenGL 图 数 ， 这 些 JOGL 方 法 的 命名 也 类 似 于 OpenGL 命名 约定 。 如 果 在 
OpenGL 中 的 画 数 名 是 在 glBegin()， 它 被 用 作 gl.glBegin()。 


只 要 gl.glBegin() 的 Java JOGL 的 方法 被 调用 时 ， 它 在 内 部 调用 OpenGL 的 glBegin() 
方法 。 这 是 在 安装 JOGL 的 时 间 对 用 户 的 系统 上 安装 本 地 库 文件 的 原因 。 


Display() 方法 


这 是 其 中 包含 用 于 开发 图 形 的 代码 的 一 个 重要 方法 。 这 就 要 求 GLAutoDrawable 接 
口 对 象 作为 参数 。 


Display() 方 法 中 ， 首 先 得 到 使 用 GL 接口 的 对 象 的 OpenGL 上 下 文 (GL 继承 GLBase 
接口 ， 该 接口 包含 的 方法 来 生成 所 有 的 OpenGL 上 下 文 对 象 ) 。 由 于 本 教程 是 关于 
JOGL2 让 我 们 产生 GL2 对 象 。 


让 我 们 通过 代码 片段 获取 GL2 对 象 : 


//Generating GL object 

GL gl-drawable.getGL(); 

GL gl-drawable.getGL(); 

//Using this Getting the G12 Object 

//this can be written in a single line like 
final GL2 gl - drawable.getGL().getGL2(); 


使 用 GL2 接 口 的 对 象 ， 就 可 以 访问 GL2 接 口 的 成 员 ， 而 这 又 提供 了 访问 
OpenGL[1.0 ...3.0] 功 能 。 


绘制 一 条 线 


GL2 接 口 包 含 的 方法 和 列表 ， 但 这 里 的 三 个 主要 方法 的 重要 论述 ， 即 函数 是 
glBegin()glVertex()#0glEnd(). 


Sr. R VR 
No. 方法 及 描述 


一 


glBegin() 此 方法 开始 画 线 过 程 。 它 采用 预定 义 的 字符 串 整 


! 数 ‘GL_LINES" 作 为 一 个 参数 ， 它 是 由 GL 接口 继承 。 
2 glVertex3f()/glVertex2f() 此 方法 创建 的 顶点 ， 我 们 必须 通过 坐标 参数 3f 


和 2f,， 这 表示 3 维 的 浮 点 坐标 和 2 维 浮 点 分 别 坐标 。 
3 glEnd() 行 结尾 


让 我 们 通过 程序 来 绘制 一 条 直线 : 


import 
import 
import 
import 
import 
import 
import 


public 


javax 
javax 
javax 
javax 
javax 
javax 


javax. 


class 


@Override 
public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin (GL2.GL LINES);//static field 
gl.glVertex3f(0.50f, -0.50f,0); 
gl.glVertex3f(-0.50f,0.50f,0); 

gl.glEnd(); 


} 


@Override 
public void dispose(GLAutoDrawable arg0O) { 


j 


@Ov 


//method body 


erride 


.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
JFrame; 


GL2; 
GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 


Line implements GLEventListener{ 


public void init(GLAutoDrawable arg0) { 
// method body 


} 
@Ov 


erride 


public void reshape(GLAutoDrawable arg0O, int argi, int arg2, inl 
// method body 


j 


public static void main(String[] args) ( 

//getting the capabilities object of GL2 profile 

final GLProfile profile - GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities - new GLCapabilities(profile); 


«| 


// The canvas 


final GLCanvas glcanvas - new GLCanvas(capabilities); 
Line 1 = new Line(); 
glcanvas.addGLEventListener(1); 
glcanvas.setSize(400, 400); 

//creating frame 


final JFrame frame 


new JFrame ("straight Line"); 


//adding canvas to frame 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 
}//end of classimport javax.media.opengl.GL2; 


Sa 











使 用 GL_LINES 绘 制 形状 


让 我 们 通过 一 个 程序 使 用 GL_LINES 绘 制 一 个 三 角形 : 


Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 


javax 
javax 
javax 
javax 
javax 
javax 


javax. 


class 


@Override 
public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin (GL2.GL LINES); 

//drawing the base 
gl.glBegin (GL2.GL LINES); 
gl.glVertex3f(-0.50f, -0.50f, 0); 
gl.glVertex3f(0.50f, 
gl.glEnd(); 
//drawing the right edge 
gl.glBegin (GL2.GL LINES); 
gl.glVertex3f(Of, 0.50f, 0G); 
gl.glVertex3f(-0.50f, -0.50f, 0); 
gl.glEnd(); 
//drawing the 1ft edge 
gl.glBegin (GL2.GL LINES); 


.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
JFrame; 


6L2; 
GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 


Triangle implements GLEventListener{ 


-0.50f, 0); 


gl.glVertex3f(Of, 0.50f, 0); 
gl.glVertex3f(0.50f, -0.50f, 0); 
gl.glEnd(); 
gl.glFlush(); 

} 

@Override 

public void dispose(GLAutoDrawable arg0) ( 
//method body 

} 


@Override 

public void init(GLAutoDrawable arg0) { 

// method body 

} 

@Override 

public void reshape(GLAutoDrawable arg0O, int argi, int arg2, inl 

int arg4) { 

// method body 

} 

public static void main(String[] args) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities = new GLCapabilities(profile); 
// The canvas 
final GLCanvas glcanvas = new GLCanvas(capabilities); 
Triangle 1 = new Triangle(); 
glcanvas.addGLEventListener(1); 
glcanvas.setSize(400, 400); 
//creating frame 
final JFrame frame - new JFrame ("Triangle"); 
//adding canvas to frame 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 

}//end of classimport javax.media.opengl.GL2; 


B — ————————————s i! 


如 果 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 它 示 出 了 使 用 glBegin() 方 法 的 
GL_LINES 画 出 一 个 三 角形 。 








让 我 们 通过 一 个 程序 中 使 用 GL_LINES 画 一 个 菱形 : 


import javax.media.opengl.GL2; 

import javax.media.opengl.GLAutoDrawable; 
import javax.media.opengl.GLCapabilities; 
import javax.media.opengl.GLEventListener; 
import javax.media.opengl.GLProfile; 
import javax.media.opengl.awt.GLCanvas; 
import javax.swing.JFrame; 


public class Rhombus implements GLEventListener{ 
@Override 
public void display( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 
//edge1 
gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( 0.0f,0.75f,0 ); 
gl.glVertex3f( -0.75f,0f,0 ); 
gl.glEnd(); 
//edge2 
gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( -0.75f,0f,0 ); 
gl.glVertex3f( Of,-0.75f, © ); 
gl.glEnd(); 
//edge3 
gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( Of,-0.75f, © ); 
gl.glVertex3f( 0.75f,O0f, © ); 
gl.glEnd(); 
//edge4 


gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( 0.75f,O0f, © ); 
gl.glVertex3f( 0.0f,0.75f,0 ); 
gl.glEnd(); 
gl.glFlush(); 

} 

@Override 

public void dispose( GLAutoDrawable argO ) { 
//method body 

} 


@Override 

public void init(GLAutoDrawable argO ) { 
// method body 

} 


@Override 
public void reshape( GLAutoDrawable argO, int argi, int arg2, ir 
// method body 


public static void main( String[] args ) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities = new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas = new GLCanvas( capabilities ); 
Rhombus rhombus = new Rhombus(); 
glcanvas.addGLEventListener( rhombus ); 
glcanvas.setSize( 400, 400 ); 
//creating frame 
final JFrame frame = new JFrame ( "Rhombus" ); 
//adding canvas to frame 
frame.getContentPane().add( glcanvas ); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 

)//end of main 

)//end of class 


一 


如 果 编 译 并 执行 以 上 程序 ， 会 得 到 下 面 的 输出 。 它 示 出 了 使 用 在 glBegin() 方 法 的 
GL LINES; £—^7 3E, 








让 我 们 通过 一 个 程序 使 用 GL_LINES 画 一 所 房子 : 


import javax.media.opengl.GL2; 

import javax.media.opengl.GLAutoDrawable; 
import javax.media.opengl.GLCapabilities; 
import javax.media.opengl.GLEventListener; 
import javax.media.opengl.GLProfile; 
import javax.media.opengl.awt.GLCanvas; 
import javax.swing.JFrame; 


public class House implements GLEventListener{ 

@Override 

public void display( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 
//drawing top 
gl.glBegin ( GL2.GL LINES ); 
gl.glVertex3f( -0.3f, 0.3f, © ); 
gl.glVertex3f( 0.3f,0.3f, © ); 
gl.glEnd(); 
//drawing bottom 
gl.glBegin( GL2.GL_LINES ); 
gl.glVertex3f( -0.3f,-0.3f, © ); 
gl-glvertex3f( 0.3f,-0.3f, © ); 
gl.glEnd(); 
//drawing the right edge 
gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( -0.3f,0.3f, © ); 
gl.glVertex3f( -0.3f,-0.3f, © ); 
gl.glEnd(); 
//drawing the left edge 


gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( 0.3f,0.3f,0 ); 
gl.glVertex3f( 0.3f,-0.3f,0 ); 
gl.glEnd(); 
//building roof 
//building 1ft dia 
gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( Of,0.6f, © ); 
gl.glVertex3f( -0.3f,0.3f, © ); 
gl.glEnd(); 
//building rt dia 
gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( Of,0.6f, © ); 
gl.glVertex3f( 0.3f,0.3f, © ); 
gl.glEnd(); 
//building door 
//drawing top 
gl.glBegin ( GL2.GL LINES ); 
gl.glVertex3f( -0.05f, 0.05f, © ); 
gl.glVertex3f( 0.05f, 0.05f, © ); 
gl.glEnd(); 
//drawing the left edge 
gl.glBegin ( GL2.GL LINES ); 
gl.glVertex3f( -0.05f, 0.05f, © ); 
gl.glVertex3f( -0.05f, -0.3f, © ); 
gl.glEnd(); 
//drawing the right edge 
gl.glBegin ( GL2.GL LINES ); 
gl.glVertex3f( 0.05f, 0.05f, © ); 
gl.glVertex3f( 0.05f, -0.3f, 0 ); 
gl.glEnd(); 

} 

@Override 

public void dispose( GLAutoDrawable argO ) { 
//method body 

} 

@Override 

public void init( GLAutoDrawable argO ) { 
// method body 

} 

@Override 

public void reshape( GLAutoDrawable arg0, int argi, int arg2, ir 
// method body 

j 


public static void main( String[] args ) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile - GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities - new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas - new GLCanvas( capabilities ); 
House house - new House(); 
glcanvas.addGLEventListener( house ); 
glcanvas.setSize(400, 400); 


//creating frame 
final JFrame frame = new JFrame( "House" ); 
//adding canvas to frame 
frame.getContentPane().add( glcanvas ); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 
}//end of main 
}//end of class 


«| am 








如 果 编 译 并 执行 以 上 程序 ， 会 得 到 下 面 的 输出 。 它 示 出 了 使 用 GL_LINES() 方 法 生 
成 一 所 房子 的 图 。 





使 用 glIBegin() 更 多 的 参数 绘画 出 更 多 的 形状 


除了 GL_LINES 预 定义 的 字符 串 参 数 ，glBegin() 方 法 接受 八 个 参数 。 可 以 用 它 来 绘 
制 不 同 的 形状 。 这 些 用 于 相同 GL_LINES。 


下 表 显 示 了 glBegin() 方 法 的 参数 和 描述 : 


Sr. 
No. 


GL_LINES 创 建 每 对 顶点 作为 一 个 独立 的 线段 。 
GL_LINE_STRIP 绘 制 线段 的 连接 组 从 第 一 顶点 到 最 后 。 


GL_LINE_LOOP 绘 制 线段 的 从 第 一 顶点 到 最 后 一 个 连接 组 再 次 回 到 第 一 
个 点 


INO 


GL_TRIANGLES 把 顶点 的 每 一 三 元 组 作为 一 个 独立 的 三 角形 。 


GL_TRIANGLE_STRIP 绘 制 三 角形 的 连接 组 。 一 个 三 角形 被 定义 为 所 述 
第 一 两 个 顶点 后 呈现 的 每 个 顶点 。 


RANEES FAN 绘 制 三 角形 的 连接 组 。 一 个 三 角形 被 定义 为 所 述 第 
一 两 个 顶点 后 呈现 的 每 个 顶点 。 


GL_QUADS 将 每 个 组 的 四 个 顶点 作为 一 个 独立 的 四 边 形 。 


GL _QUAD_STRIP 绘 制 四 边 形 的 连接 组 。 一 个 四 边 形 被 定义 为 每 对 所 述 
第 一 对 后 呈现 的 顶点 。 

GL _POLYGON 绘 制 一 个 单一 的 ， 凸 多 边 形 。 顶 点 1，...，NN 定 义 这 个 多 
边 形 。 


让 我 们 来 看 看 使 用 glBegin() 参 数 的 一 些 例子 


ie Fr IBI 


线 带 钢 : 


import 
import 
import 
import 
import 
import 
import 


public 


javax 
javax 
javax 
javax 
javax 
javax 


javax. 


class 


@Override 
public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin (GL2.GL LINE STRIP); 
gl.glVertex3f(-0.50f,-0.75f, 0); 
gl.glVertex3f(0.7f,0.5f, 0); 
gl.glVertex3f(0.70f,-0.70f, 0); 
gl.glVertex3f(0f,0.5f, 0); 

gl.glEnd(); 


} 
@Ov 


erride 


.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
JFrame; 


GL2; 
GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 


LineStrip implements GLEventListener( 


public void dispose(GLAutoDrawable arg0O) ( 


} 
@Ov 


//method body 


erride 


public void init(GLAutoDrawable arg0) { 
// method body 


} 
@Ov 


erride 


public void reshape(GLAutoDrawable argO, int argi, int arg2, inl 
// method body 


j 


public static void main(String[] args) { 

//getting the capabilities object of GL2 profile 

final GLProfile profile - GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities - new GLCapabilities(profile); 


J 


// The canvas 


final GLCanvas glcanvas = new GLCanvas(capabilities); 


LineStrip r 


final JFrame frame 


new LineStrip(); 
glcanvas.addGLEventListener(r); 
glcanvas.setSize(400, 400); 

//creating frame 


new JFrame ("LineStrip"); 


//adding canvas to frame 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 
}//end of classimport javax.media.opengl.GL2; 


_ = 








如 果 编 译 并 执行 上 面 的 代码 ， 生 成 以 下 输出 : 





代码 片段 display() 方 法 来 绘制 线路 回路 : 


public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin (GL2.GL LINE LOOP); 
gl.glVertex3f( -0.50f, -0.75f, 0); 
gl.glVertex3f(0.7f, .5f, 0); 
gl.glVertex3f (0.70f,  -0.70f, 0); 
gl.glVertex3f(Of, 0.5f, 0); 
gl.glEnd(); 


如 果 用 上 面 的 代码 替换 任何 基本 的 模板 方案 的 display() 方 法 ， 编 译 并 执行 它 ， 下 面 
的 输出 生成 : 





代码 片段 display() 方 法 使 用 GL_TRIANGLES 画 三 角形 


public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin(GL2.GL TRIANGLES); // Drawing Using Triangles 
gl.glVertexa3f(0.5f,0.7f,0.0f); // Top 
gl.glVertex3f(-0.2f,-0.50f,0.0f); // Bottom Left 
gl.glVertexS3f(0.5f,-0.5f,0.0f); //Bottom Right 
gl.glEnd(); 


) 
4 — Oen 


zc. es Ee a 编译 并 执行 它 ， 下 面 的 输 
出 生成 : 





代码 片段 display() 方 法 来 绘制 三 角形 : 


public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin (GL2.GL TRIANGLE STRIP); 
gl.glVertex3f(0f,0.5f,0); 
gl.glVertex3f(-0.50f, -0.75f,0); 
gl.glVertex3f(0.28f,0.06f,0); 
gl.glVertex3f(0.7f,0.5f,0); 
gl.glVertexa3f(0.7f,-0.7f,0); 
gl.glEnd(); 


如 果 要 更 换 显 示 器 的 任何 与 上 面 的 代码 的 基本 模板 方案 的 方法 ， 编 译 并 执行 它 ， 下 
面 的 输出 生成 : 





代码 片段 display() 方 法 来 绘制 四 边 形 : 


public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin(GL2.GL QUADS); 
gl.glVertexaf( 0.0f,0.75f,0); 
gl.glVertex3f(-0.75f,0f,0); 
gl.glVertex3f(0f, -0.75f,0); 
gl.glVertex3f(0.75f,0f,0); 
gl.glEnd(); 


~ a 编译 并 执行 它 ， 下 面 的 输 
出 生成 : 





代码 片段 display() 方 法 来 绘制 多 边 形 : 


public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glBegin(GL2.GL POLYGON); 
gl.glVertex3f(0f,0.5f,0f); 
gl.glVertex3f(-0.5f,0.2f,0f); 
gl.glVertex3f(-0.5f,-0.2f,0f); 
gl.glVertex3f(O0f, -0.5f,0f); 
gl.glVertex3f(0f,0.5f,0f); 
gl.glVertexa3f(0.5f,0.2f,0f); 
gl.glVertex3f(0.5f, -0.2f,0f); 
gl.glVertex3f (0f, -0.5f,0f); 
gl.glEnd(); 


如 果 用 上 面 的 代码 替换 任何 基本 的 模板 方案 的 display() 方 法 ， 编 译 并 执行 它 ， 
成 以 下 输出 





JOGL 转 化 对 象 - JOGL 教 程 


OpenGL 提 供 了 更 多 的 功能 ， 比 如 色彩 应 用 到 一 个 对 象 ， 比 例 ， 灯 光 ， 旋 转 的 物体 
等 。 本 章 介绍 了 一 些 变换 使 用 JOGL 的 对 象 。 


移动 对 象 的 窗口 
在 前 面 的 章节 中 ， 我 们 讨论 的 方案 画 线 ， 用 简单 的 线条 绘制 各 种 形状 。 以 这 种 方式 
过 


创建 的 形状 可 被 显示 在 该 窗口 内 的 任何 位 置 。 它 是 通过 使 用 glTranslatef (float x, 
float y, float z) 方法 完成 。 


这 种 方法 属于 GLMatrixFunc 接 口 ， 它 在 javax.media.opengl.fixedfunc 包 。 


GLMatrixFunc 接口 


interface: GLMatrixFunc 
package: javax.media.opengl.fixedfunc 
让 我 们 来 看 看 这 个 接口 的 一 些 重要 方法 : 


Sr. 


No 方法 和 说 明 
void glRotatef(float angle, float x, float y, float z) 这 个 方法 旋转 当 
前 矩阵 。 
2 void glScalef(float x, float y, float z) 此 方法 用 于 缩放 当前 和 矩阵 。 
3 void glTranslatef(float x, float y,float z) 此 方法 用 于 转换 的 当前 和 矩 
阵 。 
4 void glILoadldentity() 此 方法 加 载 当 前 矩阵 与 单位 矩阵 。 


glTranslate() 方 法 的 移动 坐标 系 的 原点 ， 以 通过 所 述 参数 (x, y, z) ， 传 递 给 
glITranslate() 方 法 作为 参数 指定 的 点 。 保 存 和 恢复 的 未 翻译 的 坐标 系 ， 
glPushMatrix() 和 glPopMatrix() 方 法 被 使 用 。 


gl.glTranslatef(Of, Of, -2.5f); 


只 要 glTranslate() 方 法 被 使 用 时 ， 它 改变 了 组 件 的 屏幕 上 的 位 置 。 因 此 ， 
GLEventListener 界面 的 reshape() 方 法 点 该 重 守 和 OpenGL 视 口 和 投影 矩阵 应 该 初 
始 化 。 


下 面 的 代码 显示 初始 化 视 口 和 投影 矩阵 模板 : 


public void reshape(GLAutoDrawable drawable, int x, int y, int wic 
final GL2 gl = drawable.getGL().getGL2(); 
// get the OpenGL 2 graphics object 
if(height <=0) 

height =1; 

//preventing devided by © exception height =1; 
final float h = (float) width / (float) height; 
// display area to cover the entire window 
gl.glViewport(0, ©, width, height); 
//transforming projection matrix 
gl.glMatrixMode(GL2.GL  PROJECTION); 
gl.glLoadIdentity(); 
glu.gluPerspective(45.0f, h, 1.0, 20.0); 
//transforming model view gl.glLoadIdentity(); 
gl.glMatrixMode(GL2.GL MODELVIEW); 
gl.glLoadIdentity(); 





运用 颜色 的 对 象 
要 应 用 颜色 的 物体 ， 使 用 GL2 类 的 glColor() 方 法 。 


语法 


gl.glColorxyY(if,0f, Of); 


例子 
如 果 通 过 颜色 值 (1，0，0) ， 那 么 得 到 的 红色 和 (1, 1, 0) 的 值 给 定 为 黄色 。 


e Xx 表示 使 用 的 颜色 数 ， 3 (red, blue, green) or 4(red, blue, green, alpha)。 为 了 
得 到 不 同 的 颜色 组 合 ， 这 些 颜 色 值 作为 参数 传递 。 颜 色 参 数 的 序列 必须 是 维护 
的 顺序 。 


e y 表 示 它 接受 的 参数 ， 如 字 节 byte(b), double(d), float(f), int(i), short(s), 
ubyte(ub), uint(ui), ushort(us)。 


gl.glColor3f(1if, Of, Of); //gives us red 
gl.glColor3f(O0f,1f,0f); //gives us blue 
gl.glColor3f(0f,0f,1f); //gives us green 


如 果 三 角形 ， 可 以 为 每 个 顶点 应 用 不 同 的 颜色 。 
让 我 们 通过 程序 的 颜色 应 用 到 一 个 三 角形 : 


si 


import 
import 
import 
import 
import 
import 
import 


public 


javax.media.opengl.GL2; 
javax.media.opengl.GLAutoDrawable; 
javax.media.opengl.GLCapabilities; 
javax.media.opengl.GLEventListener; 
javax.media.opengl.GLProfile; 
javax.media.opengl.awt.GLCanvas; 
javax.swing.JFrame; 


class TriangleColor implements GLEventListener { 


@Override 


pub 


} 
@Ov 
pub 


} 
@Ov 
pub 


} 
@Ov 
pub 


j 
pub 


Ww 
}//end 


lic void display( GLAutoDrawable drawable ) { 

final GL2 gl = drawable.getGL().getGL2(); 

gl.glBegin( GL2.GL TRIANGLES ); // Drawing Using Tri: 
gl.glColor3f( 1.0f，0.0f，0.0f ); 7 7Red 

gl.glVertex3f( 0.5f,0.7f,0.0f ); // Top 

gl.glColor3f( 0-0f 1-Of O-Ot ); //blue 


gl.glVertex3f( -0.2f,-0.50f,0.0f ); // Bottom Le 
gl.glColor3f( 0.0f,0.0f,1.0f ); //green 
gl.glVertex3f( 0.5f,-0.5f,0.0f ); //Bottom Right 


gl.glEnd(); 


erride 
lic void dispose( GLAutoDrawable argO ) { 
//method body 


erride 
lic void init( GLAutoDrawable argO ) { 
// method body 


erride 
lic void reshape( GLAutoDrawable arg0, int argi, int arg2, ir 
// method body 


lic static void main( String[] args ) { 

//getting the capabilities object of GL2 profile 

final GLProfile profile - GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities - new GLCapabilities( profile ); 
// The canvas 

final GLCanvas glcanvas - new GLCanvas( capabilities ); 
TriangleColor triangle - new TriangleColor(); 
glcanvas.addGLEventListener( triangle ); 

glcanvas.setSize( 400, 400 ); 

//creating frame 

final JFrame frame - new JFrame (" Colored Triangle"); 
//adding canvas to it 

frame.getContentPane().add( glcanvas ); 

frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 

end of main 

of class 








当 编 译 并 执行 以 上 程序 ， 会 得 到 如 下 彩色 三 角形 : 





应 用 颜色 为 多 边 形 


让 我 们 通过 程序 的 颜色 应 用 到 多 边 形 : 


import 
import 
import 
import 
import 
import 
import 


public 


javax 
javax 
javax 
javax 
javax 
javax 


javax. 


class 


@Override 
public void display( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glColor3f( if,Of,Of ); //applying red 
gl.glBegin( GL2.GL POLYGON ); 

gl.glVertex3f( Of,0.5f,0f ); 

gl.glVertex3f( -0.517,0.27,0f ); 
gl.glVertex3f( -0.5f,-0.2f,0f ); 
gl.glVertex3f( Of, -0.5f,O0f ); 

gl.glVertex3f( Of,0.5f,0f ); 

gl.glVertex3f( 0.5f,0.2f,0f ); 

gl.glVertex3f( 0.5f,-0.2f,O0f ); 
gl.glVertex3f( Of, -0.5f,0f ); 

gl.glEnd(); 


.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


opengl.GL2; 
opengl.GLAutoDrawable; 
opengl.GLCapabilities; 
opengl.GLEventListener; 
opengl.GLProfile; 
opengl.awt.GLCanvas; 
JFrame; 


PolygonColor implements GLEventListener{ 


} 


@Override 

public void dispose( GLAutoDrawable argO ) { 
//method body 

} 


@Override 

public void init( GLAutoDrawable argO ) { 
// method body 

} 


QOverride 

public void reshape( GLAutoDrawable argO, int argi, int arg2, ir 
// method body 

} 


public static void main( String[] args ) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities = new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas = new GLCanvas( capabilities ); 
PolygonColor polygon = new PolygonColor(); 
glcanvas.addGLEventListener( polygon ); 
glcanvas.setSize( 400, 400 ); 
//creating frame 
final JFrame frame - new JFrame ( "Colored Polygon" ); 
//adding canvas to frame 
frame.getContentPane().add( glcanvas ); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 

)//end of main 

)//end of class 


SSS EE, 
当 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 : 





缩放 





缩放 对 象 是 通过 使 用 GLMatrixFunc 接 口 的 void glScalef(float x, float y, float z) 方法 
进行 。 该 方法 接受 三 个 浮 点 参数 ， 使 用 我 们 指定 轴 治 x，y 和 z 比 例 因 子 。 


例如 ， 在 下 面 的 程序 中 ， 一 个 三 角形 是 减弱 至 50%。 在 这 里 ，50 传 递 的 是 治 所 有 扫 


的 参数 。 


让 我 们 通过 


Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 


javax 
javax 
javax 
javax 
javax 
javax 


class 


@Override 
public void display( GLAutoDrawable drawable ) { 

final GL2 gl = drawable.getGL().getGL2(); 

gl.glScalef( 0.50f,0.25f,0.50f ); 

gl.glBegin( GL2.GL TRIANGLES ); // Drawing Using Triang 
gl.glColor3f( 1.0f, 0.0f, 0.0f ); //Red 

gl.glVertex3f( 0.5f,0.7f,0.0f ); // Top 

gl.glColor3f( 0-0T 1-OT O-OT ); //blue 

gl.glVertex3f( -0.2f,-0.50f,0.0f ); // Bottom Left 
gl.glColor3f( 0.0f,0.0f,1.0f ); //green 


.media.opengl. 
.media.opengl. 
.media.opengl. 
.media.opengl. 
.media.opengl. 
.media.opengl. 
javax. 


swing.JFrame; 


程序 来 扩展 一 个 三 角形 : 


GL2; 
GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 


Scaling implements GLEventListener{ 


gl.glVertex3f( 0.5f,-0.5f,0.0f ); //Bottom Right 
gl.glEnd(); 


QOverride 

public void dispose( GLAutoDrawable argO ) ( 
//method body 

} 


@Override 

public void init( GLAutoDrawable argO ) { 
// method body 

} 


QOverride 

public void reshape( GLAutoDrawable argO, int argi, int arg2, ir 
// method body 

} 


public static void main( String[] args ) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities - new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas - new GLCanvas( capabilities ); 
Scaling scaling - new Scaling(); 
glcanvas.addGLEventListener( scaling ); 
glcanvas.setSize( 400, 400 ); 
//creating frame 
final JFrame frame - new JFrame (" Dimnished Triangle (Scalir 
//adding canvas to it 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 

}//end of classimport javax.media.opengl.GL2; 


I — —M Án 


编译 和 执行 上 面 的 程序 ， 我 们 得 到 以 下 输出 。 在 这 里 ， 可 以 看 到 一 个 三 角形 的 减弱 
相 比 ， 由 TriangleColor.java 生 产 的 原 三 角形 : 








旋转 


对 象 旋转 可 以 治 任意 3 轴 来 完成 ， 使 用 GLMatrixFunc 接 口 的 void glRotatef(float 
angle, float x, float y, float z) 方法 。 需 要 传递 的 旋转 以 及 X，y，z 轴 的 角度 作为 参数 
传递 给 该 方法 。 


下 面 的 步骤 指导 成 功 地 旋转 对 象 : 


e 清除 颜色 缓存 和 深度 缓存 最 初 使 用 
gl.glClear (GL2.GL COLOR BUFFER BIT| 
GL2.GL DEPTH BUFFER BIT) 方法 。 此 方法 擦 除 对 象 的 先前 状态 。 使 视图 
清晰 。 


。 复 位 用 glLoadldentity() 方 法 的 投影 矩阵 。 
实例 化 的 动画 类 和 使 用 start() 方 法 启动 动画 。 


FPSAnimator 类 


Class: 

FPSAnimator 

Package: javax.media.opengl.util 
构造 方法 


FPSAnimator(GLAutoDrawable drawable, int fps) 


创建 给 定 的 目标 帧 每 秒 的 值 和 初始 绘制 的 动画 一 个 FPSAnimator。 


FPSAnimator(GLAutoDrawable drawable, int fps, boolean cheduleAtFixe 


«| E 








创建 一 个 具有 给 定 的 目标 帧 每 秒 的 值 ， 初 始 绘制 动画 ， 和 一 个 标志 ， 指 示 是 否 使 用 
Brus o 


FPSAnimator(int fps) 


创建 由 给 定 的 目标 帧 每 秒 值 的 FPSAnimator。 


FPSAnimator(int fps, boolean scheduleAtFixedRate) 


创建 由 给 定 的 目标 帧 每 秒 的 值 和 一 个 标志 ， 指 示 是 否 使 用 固定 速率 的 调度 
FPSAnimator。 


start() 和 stop() 在 这 个 类 中 的 两 个 重要 的 方法 。 
让 我 们 通过 程序 来 旋转 一 个 三 角形 : 


import javax.media.opengl.GL2; 
import javax.media.opengl.GLAutoDrawable; 
import javax.media.opengl.GLCapabilities; 
import javax.media.opengl.GLEventListener; 
import javax.media.opengl.GLProfile; 
import javax.media.opengl.awt.GLCanvas; 
import javax.swing.JFrame; 
import com.jogamp.opengl.util.FPSAnimator; 
public class TriangleRotation implements GLEventListener{ 
private float rtri; //for angle of rotation 
@Override 
public void display( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glClear (GL2.GL_COLOR_BUFFER_BIT | GL2.GL_DEPTH_BUFFER_BI™ 
// Clear The Screen And The Depth Buffer 


gl.glLoadIdentity(); // Reset The View 
gl.glRotatef( rtri, 0.0f, 1.0f, 0.0f );//triangle rotation 
gl.glBegin( GL2.GL TRIANGLES ); // Drawing Using Tri: 


gl.glColor3f( 1.0f，0.0f，0.0f ); //Red 
gl.glVertex3f( 0.5f,0.7f,0.0f ); // Top 
gl.glColor3f( 0.0f,1.0f,0.0f ); //blue 


gl.glVertex3f( -0.2f,-0.50f,0.0f ); // Bottom Le 
gl.glColor3f( 0.0f,0.0f,1.0f ); //green 
gl.glVertex3f( 0.5f,-0.5f,0.0f ); // Bottom Rigt 


gl.glEnd(); 

gl.glFlush(); 

rtri --0.2f; //assigning the angle 
} 


@Override 


public void dispose( GLAutoDrawable argO ) { 
//method body 
} 


@Override 

public void init( GLAutoDrawable argO ) { 
// method body 

} 


QOverride 

public void reshape( GLAutoDrawable drawable, int x, int y, int 
// method body 

} 


public static void main( String[] args ) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities = new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas = new GLCanvas( capabilities ); 
TriangleRotation triangle = new TriangleRotation(); 
glcanvas.addGLEventListener( triangle ); 
glcanvas.setSize( 400, 400 ); 
//creating frame 
final JFrame frame = new JFrame ( "Rotating Triangle" ); 
//adding canvas to it 
frame.getContentPane().add( glcanvas ); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 
//Instantiating and Initiating Animator 
final FPSAnimator animator = new FPSAnimator( glcanvas, 300,1 
animator.start(); 

)//end of main 

)//end of class 


[gi E m 中 


如 果 编 译 并 执行 上 述 程序 ， 它 会 生成 以 下 输出 。 在 这 里 ， 可 以 看 到 周围 Xx 轴 旋转 彩 
色 三 角形 的 各 个 快照 。 








灯光 


要 设置 灯光 ， 使 用 过 glIEnable() 方 法 初步 启用 的 照明 。 然 后 应 用 照明 的 对 象 ， 使 用 
GLLightingFunc 接 口 的 glLightfv(int light, int pname, float[] params, int 
params_offset) 方法 。 这 个 方法 有 四 个 参数 。 


下 表 描 述 了 gllightfv() 方 法 的 参数 。 


Sr. 


No. 参数 名 称 和 描述 
1 Light 指 定 的 光 。 灯 的 数量 依赖 于 实现 ， 但 至 少 八 个 灯 支 持 。 它 接受 10 个 
值 ， 这 些 参数 是 在 一 个 名 为 下 面 给 出 的 光源 参数 表 中 单独 讨论 。 
2 Pname 指 定 一 个 单 值 的 光源 参数 。 光 源 有 10 个 参数 ， 如 下 所 述 。 
3 Params 指 定 的 指针 被 设置 到 的 光源 的 参数 pname 的 一 个 或 多 个 值 。 
4 Light source parameter 可 以 使 用 以 下 任何 给 定 的 光源 参数 。 
光源 参数 : 
参数 及 描述 
1 GL_AMBIENT 它 包含 指定 的 光 的 环境 亮度 的 参数 。 
2 GL_DIFFUSE 它 包含 指定 的 光 的 漫 反 射 的 强度 的 参数 。 
3 GL_SPECULAR 它 包含 指定 的 光 的 镜面 反射 强度 的 参数 。 
4 GL_POSITION 它 包含 指定 的 均 质 物体 坐标 的 光 的 位 置 的 4 个 整数 或 浮 点 
值 。 
5 GL_SPOT_DIRECTION 它 包含 在 均 质 物体 坐标 指定 的 光 的 方向 的 参数 。 
6 GL_SPOT_EXPONENT 此 参数 指定 的 光 的 强度 分 布 。 
7 GL_SPOT_CUTOFF 这 种 单 参 数 指定 的 光 的 最 大 发 散 角 。 
GL_CONSTANT_ATTENUATION or GL_LINEAR_ATTENUATION or 
8 GL_QUADRATIC_ATTENUATION 可 以 使 用 任意 的 衰减 系数 ， 它 是 由 一 


个 单一 的 值 来 表示 。 


照明 被 启用 并 使 用 过 glEnable() 方 法 和 glDisable() 男 数 以 及 参数 GL_LIGHTING 禁 


o 


下 面 的 模板 ， 给 出 了 灯光 : 


gl.glEnable(GL2.GL LIGHTING); 
gl.glEnable(GL2.GL LIGHTO); gl.glEnable(GL2.GL NORMALIZE); 


float[] ambientLight 


gl.glLightfv(GL2.GL LIGHTO, GL2.GL AMBIENT, ambientLight, 0); 


float[] diffuseLight 


= ( 1f,2f,1f,Of }; //multi-color diffuse 


gl.glLightfv(GL2.GL LIGHTO, GL2.GL DIFFUSE, diffuseLight, 0); 


3j 


= { 0.1f, 0.f, O.f,O0f }; // weak RED ambient 


zz] ji 





施加 光 到 一 个 旋转 多 角 


遵循 用 于 将 光 以 一 个 旋转 多 


使 用 旋转 glRotate() 方 法 的 多 


gl.glClear(GL2.GL COLOR BUFFER BIT | GL2.GL DEPTH BUFFER BIT); 


2 ATEN DHE, 


多 边 形 : 


// Clear The Screen And The Depth Buffer 
gl.glLoadIdentity(); 

// Reset The View 
gl.glRotatef(rpoly, 0.0f, 1.0f, 0.0f); 


让 我 们 通 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 


javax 
javax 
javax 
javax 
javax 
javax 


javax. 
com. jogamp.opengl.util.FPSAnimator; 


.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


过 程序 将 光 应 用 到 旋转 面 : 


opengl .GL2; 
opengl.GLAutoDrawable; 
opengl.GLCapabilities; 


opengl.GLEventListener; 


opengl.GLProfile; 
opengl.awt.GLCanvas; 
JFrame; 


class PolygonLighting implements GLEventListener{ 
private float rpoly; 
QOverride 
public void display( GLAutoDrawable drawable ) { 


final GL2 gl = 


drawable.getGL().getGL2(); 
gl.glColor3f(if,0f,Of); //applying red 


// Clear The Screen And The Depth Buffer 
gl.glClear( GL2.GL_COLOR_BUFFER_BIT | GL2.GL_DEPTH_BUFFER_BI™ 
gl.glLoadIdentity(); 
gi-glRotatet( rpoly, 0.0f, 1.0f, 0.0f ); 
gl.glBegin( GL2.GL_POLYGON ); 
gl.glVertex3f( Of,0.5f,0f ); 
gl.glVertex3f( -0-5f 0-2T,O0f ); 
gl.glVertex3f( -0.5f,-0.2f,0f ); 
gl.glVertex3f( Of,-0.5f,Of ); 
gl.glVertex3f( Of,0.5f,0f ); 
gl.glVertex3f( 0.5f,0.2f,O0f ); 


// Reset The View 


gl.glVertex3f( 0.5f,-0.2f,Of ); 
gl.glVertex3f( Of, -0.5f,Of ); 
gl.glEnd(); 
gl.glFlush(); 
rpoly +=0.2f; //assigning the angle 
gl.glEnable( GL2.GL_LIGHTING ); 
gl.glEnable( GL2.GL LIGHTO ); 
gl.glEnable( GL2.GL_NORMALIZE ); 
float[] ambientLight = 0.1f, O.f, O.f,O0f }; // weak RED amb: 
gl.glLightfv( GL2.GL LIGHTO, GL2.GL AMBIENT, ambient-Light, ( 
float[] diffuseLight = ( 1f,2f,1f,Of }; //multi color diffuse 
gl.glLightfv( GL2.GL LIGHTO, GL2.GL DIFFUSE, diffuse-Light, ( 
} 
@Override 
public void dispose( GLAutoDrawable argO ) ( 
//method body 
} 


@Override 

public void init( GLAutoDrawable argO ) { 
// method body 

} 


@Override 

public void reshape( GLAutoDrawable argO, int argi, int arg2, ir 
// method body 

J 


public static void main( String[] args ) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile - GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities - new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas - new GLCanvas( capabilities ); 
PolygonLighting polygonlighting - new PolygonLighting(); 
glcanvas.addGLEventListener( polygonlighting ); 
glcanvas.setSize( 400, 400 ); 
//creating frame 
final JFrame frame - new JFrame ( " Polygon lighting " ); 
//adding canvas to it 
frame.getContentPane().add( glcanvas ); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 
//Instantiating and Initiating Animator 
final FPSAnimator animator = new FPSAnimator(glcanvas, 300,t! 
animator.start(); 

)//end of main 

)//end of class 


Ro f 


如 果 编 译 并 执行 上 述 程序 ， 它 会 生成 以 下 输出 。 在 这 里 ， 可 以 观察 到 一 个 旋转 的 多 
边 形 灯光 的 各 种 快照 。 








JOGL 3D A 7% - JOGL 教 程 


在 本 章 中 ， 让 我 们 来 学 习 如 何 义理 3D 图 形 。 


绘制 3D 线 


让 我 们 绘制 与 z 轴 成 简单 的 线 ， 看 到 2D 和 3D 线 之 间 的 差 值 。 先 画 一 条 简单 的 直线 ， 
再 画 第 二 条 线 3 个 单元 到 窗口 中 。 


让 我 们 通过 程序 来 绘制 3D 线 : 


import javax.media.opengl.GL2; 

import javax.media.opengl.GLAutoDrawable; 
import javax.media.opengl.GLCapabilities; 
import javax.media.opengl.GLEventListener; 
import javax.media.opengl.GLProfile; 
import javax.media.opengl.awt.GLCanvas; 
import javax.media.opengl.glu.GLU; 

import javax.swing.JFrame; 


public class Line3d implements GLEventListener{ 

private GLU glu - new GLU(); 

@Override 

public void display( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glTranslatef( of, Of, -2.5f 57 
gl.glBegin( GL2.GL_LINES ); 
gl.glVertex3f( -0.75f,0f,0 ); 
gl.glVertex3f( 0f,-0.75f, © ); 
gl.glEnd(); 
//3d line 
gl.glBegin( GL2.GL LINES ); 
gl.glVertex3f( -0.75f,0f,3f );// 3 units into the window 
gl.glVertex3f( Of, -0.75f,3f ); 
gl.glEnd(); 

} 

@Override 

public void dispose( GLAutoDrawable argO ) { 
//method body 

} 

QOverride 

public void init( GLAutoDrawable argO ) { 
// method body 

} 

@Override 

public void reshape( GLAutoDrawable drawable, int x, int y, int 
GL2 gl = drawable.getGL().getGL2(); 
if( height <=0 ) 


height =1; 

final float h = ( float ) width / ( float ) height; 
gl.glViewport( 0, 0, width, height ); 
gl.glMatrixMode( GL2.GL_PROJECTION ); 
gl.glLoadIdentity(); 
glu.gluPerspective( 45.0f, h, 1.0, 20.0 ); 
gl.glMatrixMode( GL2.GL MODELVIEW ); 
gl.glLoadIdentity(); 

} 

public static void main( String[] args ) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities - new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas - new GLCanvas( capabilities ); 
Line3d line3d = new Line3d(); 
glcanvas.addGLEventListener( line3d ); 
glcanvas.setSize( 400, 400 ); 
//creating frame 
final JFrame frame - new JFrame (" 3d line"); 
//adding canvas to it 
frame.getContentPane().add( glcanvas ); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 

)//end of main 

)//end of class 


4 NEN 





当 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 : 





3D 形 状 可 以 通过 glVertex3f() 方 法 ， 该 方法 产生 上 述 观 点 的 Z- 象 限 赋予 非 需 值 绘制 。 
现在 加 入 剩余 行 会 导致 一 个 三 维 边 缘 。 


程序 开发 3D 优 势 : 


import javax.media.opengl.GL2; 

import javax.media.opengl.GLAutoDrawable; 
import javax.media.opengl.GLCapabilities; 
import javax.media.opengl.GLEventListener; 
import javax.media.opengl.GLProfile; 
import javax.media.opengl.awt.GLCanvas; 
import javax.media.opengl.glu.GLU; 

import javax.swing.JFrame; 


public class Edge1 implements GLEventListener{ 

private GLU glu = new GLU(); 

@Override 

public void display(GLAutoDrawable drawable) { 
// TODO Auto-generated method stub 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glTranslatef(Of, Of, -2.5f); 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(-0.75f,0f,0); 
gl.glVertex3f(O0f,-0.75f, 0); 
gl.glEnd(); 
//3d line 
gl.glBegin(GL2.GL LINES); 
//3 units in to the window 
gl.glVertex3f(-0.75f,0f,3f); 
gl.glVertex3f(Of,-0.75f,3f); 
gl.glEnd(); 
//top 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(-0.75f,0f,0); 
gl.glVertex3f(-0.75f,0f,3f); 
gl.glEnd(); 
/ /bottom 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0f,-0.75f, 0); 
gl.glVertex3f(O0f, -0.75f,3f); 
gl.glEnd(); 

} 

@Override 

public void dispose(GLAutoDrawable arg0) { 
//method body 

} 


@Override 

public void init(GLAutoDrawable arg0O) { 
// method body 

} 


QOverride 
public void reshape(GLAutoDrawable drawable, int x, int y, int v 


GL2 gl = drawable.getGL().getGL2(); 
if(height <=0) 
height =1; 

final float h = (float) width / (float) height; 
gl.glViewport(0, ©, width, height); 
gl.glMatrixMode(GL2.GL_PROJECTION) ; 
gl.glLoadIdentity(); 
glu.gluPerspective(45.0f, h, 1.0, 20.0); 
gl.glMatrixMode(GL2.GL MODELVIEW); 
gl.glLoadIdentity(); 

} 

public static void main(String[] args) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities = new GLCapabilities(profile); 
// The canvas 
final GLCanvas glcanvas - new GLCanvas(capabilities); 
Edge1 b = new Edge1(); 
glcanvas.addGLEventListener(b); 
glcanvas.setSize(400, 400); 
//creating frame 
final JFrame frame - new JFrame (" 3d edge"); 
//adding canvas to it 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 

)//end of class 


4] _ m 
当 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 : 








以 同样 的 方式 ， 由 显影 3D 边 缘 到 对 应 的 任何 二 维 四 边 形 的 侧面 和 连接 相 邻 顶点 ， 就 
可 以 得 到 一 个 3D 四 边 形 。 


让 我 们 通过 程序 来 绘制 一 个 菱形 : 


import javax.media.opengl.GL2; 

import javax.media.opengl.GLAutoDrawable; 
import javax.media.opengl.GLCapabilities; 
import javax.media.opengl.GLEventListener; 
import javax.media.opengl.GLProfile; 
import javax.media.opengl.awt.GLCanvas; 
import javax.media.opengl.glu.GLU; 

import javax.swing.JFrame; 


public class Rhombus implements GLEventListener{ 

private GLU glu - new GLU(); 

@Override 

public void display(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glTranslatef(Of, Of, -2.5f); 
//drawing edge1..... 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(-0.75f,0f,0); 
gl.glVertex3f(0f,-0.75f, 0); 
gl.glEnd(); 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(-0.75f,0f,3f);// 3 units into the window 
gl.glVertex3f(O0f,-0.75f,3f); 
gl.glEnd(); 


gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(-0.75f,0f,0); 
gl.glVertex3f(-0.75f,0f,3f); 
gl.glEnd(); 

/ /bottom 

gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0f,-0.75f, 0); 
gl.glVertex3f(Of, -0.75f, 3f); 
gl.glEnd(); 

//edge 2.... 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0f,-0.75f, 0); 
gl.glVertex3f(0.75f,0f, 0); 
gl.glEnd(); 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0f,-0.75f, 3f); 
gl.glVertex3f(0.75f,0f, 3f); 
gl.glEnd(); 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0f,-0.75f, 0); 
gl.glVertex3f(0f,-0.75f, 3f); 
gl.glEnd(); 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0.75f,0f, 0); 
gl.glVertex3f(0.75f,0f, 3f); 
gl.glEnd(); 


gl.glBegin(GL2.GL LINES); 
gl.glVertex3f( 0.0f,0.75f,0); 
gl.glVertex3f(-0.75f,0f,0); 
gl.glEnd(); 

gl.glBegin(GL2.GL LINES); 
gl.glVertex3f( 0.0f,0.75f,3f); 
gl.glVertex3f(-0.75f,0f,3f); 
gl.glEnd(); 

gl.glBegin(GL2.GL LINES); 
gl.glVertex3f( 0.0f,0.75f,0); 
gl.glVertex3f( 0.0f,0.75f,3f); 
gl.glEnd(); 

gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(-0.75f,0f,0); 
gl.glVertex3f(-0.75f,0f,3f); 
gl.glEnd(); 


gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0.75f,0f, 0); 
gl.glVertex3f( 0.0f,0.75f,0); 
gl.glEnd(); 

gl.glBegin(GL2.GL LINES); 
gl.glVertex3f(0.75f,0f,3f); 
gl.glVertex3f( 0.0f,0.75f,3f); 
gl.glEnd(); 

gl.glBegin(GL2.GL LINES); 


gl.glVertex3f(0.75f,0f, 0); 
gl.glVertex3f(0.75f,0f,3f); 
gl.glEnd(); 
gl.glBegin(GL2.GL LINES); 
gl.glVertex3f( 0.0f,0.75f,0); 
gl.glVertex3f( 0.0f,0.75f,3f); 
gl.glEnd(); 
} 

@Override 

public void dispose(GLAutoDrawable arg0) { 
//method body 

} 


@Override 

public void init(GLAutoDrawable arg0) { 
// method body 

} 


@Override 

public void reshape(GLAutoDrawable drawable, int x, int y, int \ 
// TODO Auto-generated method stub final 
GL2 gl = drawable.getGL().getGL2(); 
if(height <=0) 
height =1; 
final float h = (float) width / (float) height; 
gl.glViewport(3, 6, width, height); 
gl.glMatrixMode(GL2.GL  PROJECTION); 
gl.glLoadIdentity(); 
glu.gluPerspective(45.0f, h, 1.0, 20.0); 
gl.glMatrixMode(GL2.GL MODELVIEW); 
gl.glLoadiIdentity(); 

} 

public static void main(String[] args) { 
//getting the capabilities object of GL2 profile 
final GLProfile profile = GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities = new GLCapabilities(profile); 
// The canvas 
final GLCanvas glcanvas = new GLCanvas(capabilities); 
Rhombus b = new Rhombus(); 
glcanvas.addGLEventListener(b); 
glcanvas.setSize(400, 400); 
//creating frame 
final JFrame frame = new JFrame (" Rhombus 3d"); 
//adding canvas to it 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 

)//end of main 

}//end of classimport javax.media.opengl.GL2; 


El um m 
当 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 它 显示 了 一 个 使 用 3D 线 条 绘制 的 蓉 形 








glBegin() 方 法 的 预定 义 参 数 可 用 于 绘制 3D 形 状 。 


让 我 们 通过 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 


javax 
javax 
javax 
javax 
javax 
javax 
javax 


javax. 


.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


程序 绘制 一 个 3D 三 角 (无 深度 测试 ) 


opengl .GL2; 

opengl .GLAutoDrawable; 
opengl.GLCapabilities; 
opengl.GLEventListener; 
opengl.GLProfile; 
opengl.awt.GLCanvas; 
opengl.glu.GLU; 

JFrame; 


com.jogamp.opengl.util.FPSAnimator; 


public class Triangle3d implements GLEventListener{ 
private GLU glu 
private float rtri -0.0f; 
@Override 
public void display(GLAutoDrawable drawable) { 

final GL2 gl = drawable.getGL().getGL2(); 

// Clear The Screen And The Depth Buffer 

gl.glClear( GL2.GL COLOR BUFFER BIT | GL2.GL DEPTH BUFFER BI 


gl.glLoadIdentity(); 


- new GLU(); 


// Reset The View 


gl.glTranslatef( -0.5f, 0.0f, -6.0f ); // Move the ti 
gl.glRotatef( rtri, 0.0f, 1.0f, 0.0f ); 

gl.glBegin( 
//drawing triangle in all dimensions 
// Front 
gl.glColor3f( 1.0f, 0.0f, 8-01 ); // Red 

gl.glVertex3f( 1.0f, 2.0f, 0.0f ); // Top Of Triangle (Front: 
gl.glColor3f( 0.0f, 1-07, O-8f ); 7/7 Green 


GL2.GL_TRIANGLES ); 


gl.glVertex3f( -1.0f, -1.0f, 1.0f ); // Left Of Triangle (Fr 
gl.glColor3f( 0.0f, 0.0f, 1.0f ); // Blue 
gl.glVertex3f( 1.0f, -1.0f, 1.0f ); // Right Of Triangle (Fr« 
// Right 
gl.glColor3f( 1.0f，0.0f，0.0f je 77 Red 
gl.glVertex3f( 1.0f, 2.0f, 0.0f ); // Top Of Triangle (Right: 
gl.glColor3f( 0.0f，0.0f，1.0f ); 77 Blue 
gl.glVertex3f( 1.0f, -1.0f, 1.0f ); // Left Of Triangle (Rigl 
gl.glColor3f( 0.0f, 1.0f, 0.0f ); // Green 
gl.glVertex3f( 1.0f, -1.0f, -1.0f ); // Right Of Triangle (R: 
// Left 
gl.glColor3f( 1.0f，0.0f，0.0f ); 7 Red 
gl.glVertex3f( 1.0f, 2.0f, 0.0f ); // Top Of Triangle (Back) 
gl.glColor3f( 0.0f, 1.0f, 0.0f ); // Green 
gl.glVertex3f( 1.0f, -1.0f, -1.0f ); // Left Of Triangle (Bac 
gl.glColor3f( 0.0f，0.0f，1.0f ); // Blue 
gl.glVertex3f( -1.0f, -1.0f, -1.0f ); // Right Of Triangle (Et 
//left 
gl.glColor3f( 0.0f, 1:07, 0-0f ); // Red 
gl.glVertex3f( 1.0f, 2.0f, O.O0f ); // Top Of Triangle (Left) 
gl.glColor3f( 0.0f，0.0f，1.0f ); // Blue 
gl.glVertex3f( -1.0f, -1.0f, -1.0f ); // Left Of Triangle (Lt 
gl.glColor3f( 0.0f, 1.0f, 0.0f ); // Green 
gl.glVertex3f( -1.0f, -1.0f, 1.0f ); // Right Of Triangle (Lt 
gl.glEnd(); // Done Drawing 3d triangle (Pyramid) 
gl.glFlush(); 
rtri +=0.2f; 

} 

@Override 


public void dispose( GLAutoDrawable drawable ) { 
//method body 


} 


@Override 
public void init( GLAutoDrawable drawable ) { 
//method body 


} 


@Override 

public void reshape( GLAutoDrawable drawable, int x, int y, int 
final GL2 gl = drawable.getGL().getGL2(); 

if(height <=;) 


} 


height =1; 


final float h = ( float ) width / ( float ) height; 


gl. 
gl. 
gl. 


glViewport( 0, 0, width, height ); 
glMatrixMode( GL2.GL_PROJECTION ); 
glLoadIdentity(); 


glu.gluPerspective( 45.0f, h, 1.0, 20.0 ); 


gl. 
gl. 


glMatrixMode( GL2.GL_MODELVIEW ); 
glLoadIdentity(); 


public static void main( String[] args ) { 
final GLProfile profile - GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities - new GLCapabilities( profile ); 


// 


The canvas 


final GLCanvas glcanvas = new GLCanvas( capabilities ); 
Triangle3d triangle = new Triangle3d(); 
glcanvas.addGLEventListener( triangle ); 

glcanvas.setSize( 400, 400 ); 

final JFrame frame - new JFrame ( "3d Triangle (shallow)" ), 
frame.getContentPane().add( glcanvas ); 

frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 

final FPSAnimator animator = new FPSAnimator( glcanvas, 300,1 
animator.start(); 





当 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 在 这 里 ， 有 旋转 的 3D 三 角形 的 快照 。 由 
于 该 程序 不 包含 深度 测试 ， 三 角形 生成 空洞 。 





为 了 使 实心 的 三 角形 ， 需 要 使 用 过 glEnable (GL_DEPTH_TEST) ， 以 实现 深度 测 
试 。 启 用 深度 缓冲 给 出 黑屏 。 方 法 | 这 可 以 同时 清除 使 用 

glClear (GL DEPTH BUFFER BIT GL COLOR BUFFERBIT) 的 颜色 被 清除 。 
要 启用 深度 测试 中 的 init() 方 法 或 glDisplay() 方 法 ， 编 写 如 下 代码 : 


public void init(GLAutoDrawable drawable) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glShadeModel(GL2.GL SMOOTH); 
gl.glClearColor(Of, Of, Of, Of); 
gl.glClearDepth(1.0f); 
gl.glEnable(GL2.GL DEPTH TEST); 
gl.glDepthFunc(GL2.GL LEQUAL); 
gl.glHint(GL2.GL PERSPECTIVE CORRECTION HINT, GL2.GL NICEST); 


让 我 们 通过 程序 绘制 一 个 3D 三 角 (深度 测试 ) 


import javax.media.opengl.GL2; 
import javax.media.opengl.GLAutoDrawable; 
import javax.media.opengl.GLCapabilities; 


import 
import 
import 
import 
import 
import 


javax.media.opengl.GLEventListener; 
javax.media.opengl.GLProfile; 
javax.media.opengl.awt.GLCanvas; 
javax.media.opengl.glu.GLU; 
javax.swing.JFrame; 
com.jogamp.opengl.util.FPSAnimator; 


public class Triangledepthtest implements GLEventListener( 
private GLU glu - new GLU(); 
private float rtri -0.0f; 
QOverride 
public void display( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 


.glShadeModel( GL2.GL SMOOTH ); 

.glClearColor( of, of, of, Of ); 

.glClearDepth( 1.0f ); 

.glEnable( GL2.GL_DEPTH_TEST ); 

.glDepthFunc( GL2.GL LEQUAL ); 

.glHint( GL2.GL PERSPECTIVE CORRECTION HINT, GL2.GL NICEST 


Clear The Screen And The Depth Buffer 


.glClear( GL2.GL COLOR BUFFER BIT | GL2.GL DEPTH BUFFER BI 
.glLoadIdentity();  // Reset The View 

.glTranslatef( -0.5f,0.0f,-6.0f ); // Move the triangle 
.glRotatef( rtri, 0.0f, 1.0f, 0.0f ); 

.glBegin( GL2.GL_TRIANGLES ); 


//drawing triangle in all dimentions 
//front 


.glColor3f( 1.0f, 0.0f, 0.0f ); // Red 
.glVertex3f( 1.0f, 2.0f, 0.0f ); // Top 
.glColor3f( 0.0f, 1.0f, 0.0f ); // Green 
.glVertex3f( -1.0f, -1.0f, 1.0f ); // Left 
.glColor3f( 0.0f, 0.0f, 1.0f ); // Blue 
.QlVertex3f( 1.0f, -1.0f, 1.0f ); // Right) 


.glColor3f( 1.0f, 0.0f, 0.0of ); 
.glVertex3f( 1.0f, 2.0f, 0.0f ); // Top 
.glColor3f( 0.0f, 0.0f, 1.0f ); 
.glVertex3f( 1.0f, -1.0f, 1.0f ); // Left 
.glColor3f( 0.0f，1.0f，0.0f ); 
.glVertex3f( 1.0f, -1.0f, -1.0f ); // Right 


//left 


gl. 
.glVertex3f( 1.0f, 2.0f, 0.0f ); // Top 
.glColor3f( 0.0f，1.0f，0.0f ); 

.glVertex3f( 1.0f, -1.0f, -1.0f ); // Left 
.glColor3f( 0.0f, 0.0f, 1.0f ); 

.glVertex3f( -1.0f, -1.0f, -1.0f ); // Right 


glColor3f( 1.0f，0.0f，0.of ); 


//top 


gl. 
gl. 
gl. 
gl. 
gl. 


glColor3f( 0.of, 1.0f, 0207.) 

glVertex3f( 1.0f, 2.0f, 0.0f ); // Top 
glColor3f( 0.of, 0.0f, 1.0f ); 

glVertex3f( -1.0f, -1.0f, -1.0f ); // Left 
glColor3f( 0.0f，1.0f，0.0f ); 


gl.glVertex3f( -1.0f, -1.0f, 1.0f ); // Right 
gl.glEnd(); // Done Drawing 3d triangle (Pyramid) 
gl.glFlush(); 
rtri +=0.2f; 
} 
@Override 
public void dispose( GLAutoDrawable drawable ) { 
//method body 
} 
@Override 
public void init( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 
gl.glShadeModel( GL2.GL SMOOTH ); 
gl.glClearColor( Of, Of, Of, Of ); 
gl.glClearDepth( 1.0f ); 
gl.glEnable( GL2.GL DEPTH TEST ); 
gl.glDepthFunc( GL2.GL LEQUAL ); 
gl.glHint( GL2.GL PERSPECTIVE CORRECTION HINT, GL2.GL NICEST 
} 
@Override 
public void reshape( GLAutoDrawable drawable, int x, int y, int 
final GL2 gl = drawable.getGL().getGL2(); 
if( height <=0 ) 
height =1; 
final float h = ( float ) width / ( float ) height; 
gl.glViewport( 0, 0, width, height ); 
gl.glMatrixMode( GL2.GL PROJECTION ); 
gl.glLoadIdentity(); 
glu.gluPerspective( 45.0f, h, 1.0, 20.0 ); 
gl.glMatrixMode( GL2.GL MODELVIEW ); 
gl.glLoadIdentity(); 
} 
public static void main( String[] args ) { 
// TODO Auto-generated method stub 
final GLProfile profile = GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities = new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas = new GLCanvas( capabilities ); 
Triangledepthtest triangledepthtest = new Triangledepthtest(: 
glcanvas.addGLEventListener( triangledepthtest ); 
glcanvas.setSize( 400, 400 ); 
final JFrame frame = new JFrame ( "3d Triangle (solid)" ); 
frame.getContentPane().add(glcanvas); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 
final FPSAnimator animator = new FPSAnimator( glcanvas, 300,1 
animator.start(); 


j 
«| m 
当 编 译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 








在 这 里 ， 可 以 看 到 旋转 的 3D 三 角形 的 快照 。 由 于 该 计划 包括 用 于 深度 测试 代码 ， 三 
角形 生成 固体 。 





绘制 一 个 3D 立 方 体 


以 同 祥 的 方式 ， 让 我 们 得 出 一 个 3D 立 方 体 和 应 用 颜色 。 通 过 程序 来 创建 一 个 3D 立 


方 体 : 


Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 
pub 


pri 
pri 


java.awt.DisplayMode; 
javax.media.opengl.GL2; 
javax.media.opengl.GLAutoDrawable; 
javax.media.opengl.GLCapabilities; 
javax.media.opengl.GLEventListener; 
javax.media.opengl.GLProfile; 
javax.media.opengl.awt.GLCanvas; 
javax.media.opengl.glu.GLU; 
javax.swing.JFrame; 
com.jogamp.opengl.util.FPSAnimator; 


class Cube implements GLEventListener{ 
lic static DisplayMode dm, dm old; 


vate GLU glu = new GLU(); 
vate float rquad-0.0f; 


@Override 


pub 


lic void display( GLAutoDrawable drawable ) { 

final GL2 gl = drawable.getGL().getGL2(); 

gl.glClear( GL2.GL COLOR BUFFER BIT | GL2.GL DEPTH BUFFER BI 
gl.glLoadIdentity(); 

gl.glTranslatef( Of, Of, -5.0f ); 

gl.glRotatef( rquad, 1.0f, 1.0f, 1.0f ); // Rotate The Cube ( 
//giving different colors to different sides 

gl.glBegin( GL2.GL QUADS ); // Start Drawing The Cube 
gl.glColor3f( TR On On //red color 

gl.glVertex3f( 1.0f, 1.0f, -1.0f ); // Top Right Of The Quad 
gl.glVertex3f( -1.0f, 1.0f, -1.0f); // Top Left Of The Quad | 
gl.glVertex3f( -1.0f, 1.0f, 1.0f ); // Bottom Left Of The Qu: 
gl.glVertex3f( 1.0f, 1.0f, 1.0f ); // Bottom Right Of The Qu: 


.glColor3f( Of,i1f,0f ); //green color 


gl.glVertex3f( 1.0f, -1.0f, 1.0f ); // Top Right Of The Quad 
gl.glVertex3f( -1.0f, -1.0f, 1.0f ); // Top Left Of The Quad 
gl.glVertex3f( -1.0f, -1.0f, -1.0f ); // Bottom Left Of The ( 
gl.glVertex3f( 1.0f, -1.0f, -1.0f ); // Bottom Right Of The ( 
gl.glColor3f( Of,Of,1f ); //blue color 
gl.glVertex3f( 1.0f, 1.0f, 1.0f ); // Top Right Of The Quad | 
gl.glVertex3f( -1.0f, 1.0f, 1.0f ); // Top Left Of The Quad | 
gl.glVertex3f( -1.0f, -1.0f, 1.0f ); // Bottom Left Of The Qı 
gl.glVertex3f( 1.0f, -1.0f, 1.0f ); // Bottom Right Of The Qi 
gl.glColor3f( 1f,if,Of ); //yellow (red + green) 
gl.glVertex3f( 1.0f, -1.0f, -1.0f ); // Bottom Left Of The Qt 
gl.glVertex3f( -1.0f, -1.0f, -1.0f ); // Bottom Right Of The 
gl.glVertex3f( -1.0f, 1.0f, -1.0f ); // Top Right Of The Qua 
gl.glVertex3f( 1.0f, 1.0f, -1.0f ); // Top Left Of The Quad | 
gl.glColor3f( 1f,0f,1f ); //purple (red + green) 
gl.glVertex3f( -1.0f, 1.0f, 1.0f ); // Top Right Of The Quad 
gl.glVertex3f( -1.0f, 1.0f, -1.0f ); // Top Left Of The Quad 
gl.glVertex3f( -1.0f, -1.0f, -1.0f ); // Bottom Left Of The ( 
gl.glVertex3f( -1.0f, -1.0f, 1.0f ); // Bottom Right Of The ( 
gl.glColor3f( Of,if, 1f ); //sky blue (blue +green) 
gl.glVertex3f( 1.0f, 1.0f, -1.0f ); // Top Right Of The Quad 
gl.glVertex3f( 1.0f, 1.0f, 1.0f ); // Top Left Of The Quad 
gl.glVertex3f( 1.0f, -1.0f, 1.0f ); // Bottom Left Of The Qu: 
gl.glVertex3f( 1.0f, -1.0f, -1.0f ); // Bottom Right Of The ( 
gl.glEnd(); // Done Drawing The Quad 
gl.glFlush(); 
rquad --0.15f; 

} 

QOverride 


public void dispose( GLAutoDrawable drawable ) { 
// TODO Auto-generated method stub 


} 


@Override 
public void init( GLAutoDrawable drawable ) { 
final GL2 gl = drawable.getGL().getGL2(); 


gl.glShadeModel( GL2.GL_SMOOTH ); 

gl.glCclearColor( Of, Of, Of, Of ); 

gl.glClearDepth( 1.0f ); 

gl.glEnable( GL2.GL. DEPTH TEST ); 

gl.glDepthFunc( GL2.GL LEQUAL ); 

gl.glHint( GL2.GL PERSPECTIVE CORRECTION HINT, GL2.GL NICEST 
} 
@Override 


public void reshape( GLAutoDrawable drawable, int x, int y, int 
final GL2 gl = drawable.getGL().getGL2(); 
if( height <=0 ) 


height =1; 


final float h = ( float ) width / ( float ) height; 


gl. 
gl. 
gl. 


glViewport( 0, 0, width, height ); 
glMatrixMode( GL2.GL PROJECTION ); 
glLoadIdentity(); 


glu.gluPerspective( 45.0f, h, 1.0, 20.0 ); 


gl.glMatrixMode( GL2.GL MODELVIEW ); 
gl.glLoadIdentity(); 


public static void main( String[] args ) { 
final GLProfile profile - GLProfile.get( GLProfile.GL2 ); 
GLCapabilities capabilities - new GLCapabilities( profile ); 
// The canvas 
final GLCanvas glcanvas - new GLCanvas( capabilities ); 
Cube cube - new Cube(); 
glcanvas.addGLEventListener( cube ); 
glcanvas.setSize( 400, 400 ); 
final JFrame frame - new JFrame ( " Multicolored cube" ); 
frame.getContentPane().add( glcanvas ); 
frame.setSize( frame.getContentPane().getPreferredSize() ); 
frame.setVisible( true ); 
final FPSAnimator animator = new FPSAnimator( glcanvas, 300,1 
animator.start(); 





当 编译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 这 说 明 一 个 彩色 3D 立 方 体 。 





应 用 质感 的 立方 体 


给 出 下 面 的 步骤 来 应 用 质感 的 立方 体 : 


File file=new File(“c:\\pictures\\boy.jpg”); 
Texture t-texturelO.newTexture(file, true); 
texture=t.getTextureObject(gl); 


e 可 以 要 求 纹理 
制 对 象 的 接口 方法 的 立方 体 。 


结合 使 用 gl.glBindTexture (GL2.GL TEXTURE 2D。 纹 理 ) 绘 


e 这 种 方法 需要 的 纹理 (INT) 参数 以 及 GL2.GL_ TEXTURE 2D (INT) 
e 执行 display() 创 建 需要 纹理 变量 。 


e 在 init() 方 法 或 在 glDisplay() 方 法 中 的 起 始 行 ， 使 用 
gl.glEnable (GL2.GL_TEXTURE_2D) 方法 的 纹理 。 


一 个 文件 对 象 作为 人 参数， 而 这 又 需要 用 作 纹 理 的 对 象 的 


。 创建 纹理 对 象 ， 它 需 


图 像 的 路 径 。 
e 处 理 未 发 现 异常 文件 。 


让 我 们 通 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


前 过 程序 应 用 纹理 到 多 维 数据 集 : 


java.awt.DisplayMode; 
java.io.File; 
java.io.IOException; 


javax 
javax 
javax 
javax 
javax 
javax 
javax 


javax. 


.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
.media. 
swing. 


opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
opengl. 
JFrame; 


GL2; 
GLAutoDrawable; 
GLCapabilities; 
GLEventListener; 
GLProfile; 
awt.GLCanvas; 
glu.GLU; 


com.jogamp.opengl.util.FPSAnimator; 
com.jogamp.opengl.util.texture.Texture; 
com.jogamp.opengl.util.texture.TextureIO; 


class CubeTexture implements GLEventListener { 
public static DisplayMode dm, dm old; 

private GLU glu 
private float xrot,yrot,zrot; 
private int texture; 
@Override 
public void display(GLAutoDrawable drawable) { 

final GL2 gl = drawable.getGL().getGL2(); 
gl.glClear(GL2.GL COLOR BUFFER BIT | GL2.GL_DEPTH_BUFFER_BIT 


gl.glLoadIdentity(); 


- new GLU(); 


// Reset The View 


gl.glTranslatef(Of, Of, -5.0f); 
gl.glRotatef(xrot, 
gl.glRotatef(yrot, 
gl.glRotatef(zrot, 
gl.glBindTexture(GL2.GL TEXTURE 2D, texture); 


1,06, 1.0f, 1.0f); 
0.0f, 1.0f, 0.0f); 
0.0f, 0.0f, 1.0f); 


gl.glBegin(GL2.GL QUADS); 
// Front Face 


gl.glTexCoord2f(0.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 1.0f); gl. 
// Back Face 
gl.glTexCoord2f(1.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 0.0f); gl. 
// Top Face 
gl.glTexCoord2f(0.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 1.0f); gl. 
// Bottom Face 
gl.glTexCoord2f(1.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 0.0f); gl. 
// Right face 
gl.glTexCoord2f(1.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 0.0f); gl. 
// Left Face 
gl.glTexCoord2f(0.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 0.0f); gl. 
gl.glTexCoord2f(1.0f, 1.0f); gl. 
gl.glTexCoord2f(0.0f, 1.0f); gl. 


gl.glEnd(); 
gl.glFlush(); 
//change the speeds here 
xrot+=.1f; 
yrot+=.1f; 
Zrott= 1f; 

} 

@Override 

public void dispose(GLAutoDrawable 
// method body 

} 


@Override 


glVertex3f(-1. 
glVertex3f( 1. 
glVertex3f( 1. 
glVertex3f(-1. 


glVertex3f(-1. 
glVertex3f(-1. 
glVertex3f( 1. 
glVertex3f( 1. 


glVertex3f(-1. 
glVertex3f(-1. 
glVertex3f( 1. 
glVertex3f( 1. 


glVertex3f(-1. 
glVertex3f( 1. 
glVertex3f( 1. 
glVertex3f(-1. 


glVertex3f( 1. 
glVertex3f( 1. 
glVertex3f( 1. 
glVertex3f( 1. 


glVertex3f(-1. 
glVertex3f(-1. 
glVertex3f(-1. 
glVertex3f(-1. 


drawable) { 


public void init(GLAutoDrawable drawable) { 


final GL2 gl = drawable.getGL(). 
gl.glShadeModel(GL2.GL SMOOTH); 
gl.glClearColor(Of, Of, Of, Of); 
gl.glClearDepth(1.0f); 
gl.glEnable(GL2.GL DEPTH TEST); 
gl.glDepthFunc(GL2.GL LEQUAL); 


getGL2(); 


Of, 
lh? 
ee, 
iste 


NUS 
Of, 
[RE 
Of, 


Of, 
ibn 
Of, 
BU 


LR. 
„Of, 
or 
Of, 


ist, 
BU 
Of, 
Ae, 


ih? 
ist, 
HORE. 
„Of, 


一 一 一 一 


一 一 一 一 


一 一 一 一 


一 一 一 一 


一 一 一 一 


一 一 一 一 


gl.glHint(GL2.GL PERSPECTIVE CORRECTION HINT, GL2.GL NICEST), 


gl.glEnable(GL2.GL TEXTURE 2D); 


File im = new File("E:\\office\\boy.jpg "); 
Texture t = TexturelO.newTexture(im, true); 
texture- t.getTextureObject(gl); 


} 
catch(IOException e) 
{ 
e.printStackTrace(); 
} 
} 
@Override 


public void reshape(GLAutoDrawable drawable, int x, int y, int v 
final GL2 gl = drawable.getGL().getGL2(); 
if(height <=0) 

height =1; 

final float h = (float) width / (float) height; 
gl.glViewport(0, ©, width, height); 
gl.glMatrixMode(GL2.GL_PROJECTION) ; 
gl.glLoadIdentity(); 
glu.gluPerspective(45.0f, h, 1.0, 20.0); 
gl.glMatrixMode(GL2.GL MODELVIEW); 
gl.glLoadIdentity(); 

j 

public static void main(String[] args) { 
final GLProfile profile - GLProfile.get(GLProfile.GL2); 
GLCapabilities capabilities - new GLCapabilities(profile); 
// The canvas 
final GLCanvas glcanvas - new GLCanvas(capabilities); 
CubeTexture r = new CubeTexture( ); 
glcanvas.addGLEventListener(r); 
glcanvas.setSize(400, 400); 
final JFrame frame - new JFrame (" Textured Cube"); 
frame.getContentPane().add(glcanvas); 
frame.setSize(frame.getContentPane().getPreferredSize()); 
frame.setVisible(true); 
final FPSAnimator animator = new FPSAnimator(glcanvas, 300,ti! 
animator.start(); 





当 编译 并 执行 上 述 程序 ， 将 生成 以 下 输出 。 可 以 看 到 一 个 3D 立 方 体 与 应 用 上 所 需 的 
纹理 。 





附录 


GPU - 图 形 处 理 单元 ， 它 是 促进 图 像 的 呈现 一 个 特殊 的 电子 设备 。 
JNI - Java 本 地 接口 。 使 用 它 ，Java 可 以 访问 本 地 方法 。 

模型 - 它们 是 从 基本 的 图 形 元 素 ， 如 点 ， 线 和 多 边 形 构造 的 对 象 。 
像素 - 显示 在 屏幕 上 看 到 的 最 小 单位 。 

IT - 映射 对 象 的 坐标 的 二 维 平 面 的 方法 ， 被 称 为 凸 起 。 

投影 矩阵 - 它 是 二 维 表 面 上 的 物体 的 线性 变换 。 

JE - 由 计算 机 从 模型 生成 的 图 像 的 过 程 。 

视 口 - 视 区 是 计算 机 图 形 学 的 屏幕 上 观看 区 域 。 


JPAATE 
任何 企业 应 用 程序 通过 存储 和 检索 大 量 数据 进行 数据 库 操作 。 尽 管 所 有 的 存储 管理 
提供 技术 ， 应 用 程序 开发 人 员 通常 很 难 有 效 地 执行 数据 库 操作 。 


一 般 情况 下 ，Java 开 发 人 员 使 用 大 量 的 代码 ， 或 使 用 专 有 的 架构 与 数据 库 进 行 交 
互 ， 而 使 用 JPA 与 数据 库 绑 定 交互 负担 显著 降低 。 它 形成 (EER) 对 象 模型 
之 间 的 桥梁 (Java F) 和 关系 模型 。 


天 系 型 和 对 象 模型 之 间 的 不 匹配 
关系 对 象 表示 以 表格 的 形式 ， 而 对 象 模型 表示 的 对 象 格式 的 相互 连接 的 图 形 。 而 存 
储 和 检索 来 自 关 系数 据 库 的 对 象 模型 ， 一 些 不 匹配 的 发 生 是 由 于 以 下 原因 : 

e 粒度 : 对 象 模型 比 关 系 模型 更 精细 。 

e 73): 亚 型 〈 指 继承 ) 所 有 类 型 的 关系 数据 库 不 支持 。 

e 标识 : 如 对 象 模型 ， 关 系 模型 并 没有 同时 编写 暴露 身份 。 

e 关联 : 关系 模型 无 法 确定 多 重 关系 ， 同 时 寻找 到 一 个 对 象 域 模 型 。 

e 数据 导航 : 在 一 个 对 象 网 络 对 象 之 间 的 数据 导航 是 在 这 两 种 模式 中 有 所 不 同 。 


JPA 是 什么 ? 


Java 持 久 性 API( 简 称 JAP) 是 类 和 方法 的 集合 ， 以 海量 数据 关系 映射 持久 并 存储 到 数 
据 库 ， 这 是 由 Oracle 公 司 提供 方案 技术 。 


在 哪里 使 用 JPA ? 


为 了 减少 编写 代码 ， 对 象 关 系 管理 的 负担 ， 程 序 员 遵 循 “JPA 提 供 者 "框架 ， 它 可 以 
方便 地 与 数据 库 实例 的 交互 。 这 里 所 需要 的 框架 接管 JPA。 


JPA 万 史 
早期 版 本 的 EJB， 定 义 持久 层 结合 使 用 javax.ejb.EntityBean 接口 作为 业务 逻辑 
层 。 


e。 同 时 引入 EJB3.0 的 持久 层 分 离 ， 并 指定 为 JPA1.0 (Java 持 久 性 API) 。 这 个 
API 规 范 随 着 JAVA EE5 对 2006 年 5 月 11 日 使 用 JSR220 规 范 发 布 。 


e JPA2.0 的 JAVA EE 6 规范 发 布 于 2009 年 12 月 10 日 并 成 Java Community 
Process JSR317 的 一 部 分 。 


e JPA2.1 使 用 JSR338 的 JAVA EE7 的 规范 发 布 于 2013 年 4 月 22 日 。 


JPA 提 供 者 


JPA 是 一 个 开源 的 API， 因 此 各 企业 厂商 如 Oracle，Redhat，Eclipse 等 ， 通 过 增加 
JPA 持续 性 ， 在 提供 JPA 的 新 产品 。 这 些 产 品 包括 : 


Hibernate, Eclipselink, Toplink, Spring Data JPA, etc. 
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JPA(Java 持 久 性 APl) 是 存储 业务 实体 关联 的 实体 的 来 源 。 它 显示 了 如 何 定义 一 个 面 
向 普通 Java 对 象 (POJO) 作 为 一 个 实体 ， 以 及 如 何 与 管理 关系 实体 。 


X HAR AA 


下 图 显示 了 JPA 的 类 的 层次 结构 。 它 显示 核心 类 和 JPA 接 口 。 


Javax.persistence ] PA API 


Entity Manager 





Factory 


B 


Entity Manager 


Persistence 





下 表 描 述 了 每 个 在 上 述 架构 的 显示 单元 。 


单元 描述 
, 这 是 一 个 EntityManager 的 工厂 类 。 它 创建 并 管理 多 
EntityManagerFactory 个 EntityManager 实 例 。 


这 是 一 个 接口 ， 它 管理 的 持久 化 操作 的 对 象 。 它 的 


ne 工作 原理 类 似 工厂 的 查询 实例 。 
Entity 实体 是 持久 性 对 象 是 存储 在 数据 库 中 的 记录 。 

它 与 EntityManager 是 一 对 一 的 关系 。 对 于 每 一 个 
EntityTransaction EntityManager， 操 作 是 由 EntityTransaction 类 维 

Po 

3 IN 米 => APE Ht i a 
Perc cience 八 类 包含 静态 方法 来 获取 EntityManagerFactory 实 


该 接口 由 每 个 JPA 供 应 商 ， 能 够 获得 符合 标准 的 关系 
Query 对 象 。 


TutorialsPoint Java 技术 教条 


上 述 的 类 和 接口 用 于 存储 实体 到 数据 库 的 一 个 记录 。 帮 助 程序 员 通 过 减少 自己 编写 
代码 将 数据 存储 到 数据 库 中 ， 使 他 们 能 够 专注 于 更 重要 的 业务 活动 代码 ， 如 数据 库 
表 映 射 的 类 编写 代码 。 


JPA 类 关系 


在 上 述 体系 结构 中 ， 类 和 接口 之 间 的 关系 属于 javax.persistence 包 。 下 图 显示 了 它 
们 之 间 的 关系 。 









EntityManagerFactory EntityTransaction 


Query 


EntityManager 


Persistence 


Javax.persistence 


。 EntityManagerFactory 和 EntityManager 的 关系 是 1 对 多 。 这 是 一 个 工厂 类 
EntityManager 实 例 。 


e EntityManager 和 EntityTransaction 之 间 的 关系 是 1 对 1。 对 于 每 个 
EntityManager 操 作 ， 只 有 一 个 EntityTransaction 实 例 。 


。 EntityManager 和 Query 之 间 的 关系 是 1 对 多 。 查 询 数 众多 可 以 使 用 一 个 
EntityManager 实 例 执行 。 


e EntityManager 实 体 之 间 的 关系 是 1 对 多 。 一 个 EntityManager 实 例 可 以 管理 多 
个 实体 。 
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JPA ORM 组 件 - JPA 教 程 


最 现代 的 应 用 程序 使 用 关系 型 数据 库 来 存储 数据 。 最 近 ， 许 多 厂商 改 用 对 象 数据 
库 ， 以 减少 其 对 数据 的 维护 负担 。 这 意味 着 对 象 数据 库 或 对 象 关系 技术 正在 存储 ， 
检索 ， 更 新 和 维护 数据 的 照顾 。 这 个 对 象 关 系 型 技术 的 核心 部 分 是 映射 orm.xml 中 
的 文件 。 随 着 XML 不 需要 编译 ， 可 以 很 容易 地 进行 修改 多 个 数据 源 较 少 的 管理 。 


Xt RA AAR A 


对 象 关 系 映射 (ORM) 简 要 地 告诉 什么 是 ORM 以 及 它 是 如 何 工 作 。 ORM 是 从 对 象 类 
型 的 数据 隐蔽 到 关系 型 ， 反 之 亦 然 编程 能 


ORM 主 要 特征 是 映射 或 绑 定 一 个 目的 是 它 的 数据 库 中 的 数据 。 而 上 映射， 我 们 要 考虑 
的 任何 其 他 表 中 的 数据 ， 数 据 的 类 型 ， 并 具有 自 一 个 或 多 个 实体 的 关系 。 


高 级 功能 
e 惯用 的 持久 性 : 它 使 您 能 够 编写 使 用 面向 对 象 的 类 持久 性 类 。 
e 高 性 能 : 它 有 许多 抓 取 技术 和 充满 希望 的 锁定 技术 。 
e 可 靠 的 : 它 是 高 度 稳 定 的 ， 被 很 多 专业 程序 员 。 
ORM 架 构 


在 ORM 架 构 如 下 所 示 。 
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在 上 述 体系 结构 解释 了 如 何 对 象 数据 存储 到 关系 数据 库 中 的 三 个 阶段 。 


第 1 阶段 


第 一 阶段 ， 命 名 为 对 象 数据 阶段 ， 包 括 POJO 类 ， 服 务 接口 和 类 。 它 是 主要 的 业务 
组 件 野 ， 其 具有 业务 逻辑 操作 和 属性 。 


例如 ， 让 我 们 举 个 员工 数据 库 的 架构 。 


e Employee POJO 类 包含 属性 ， 如 ID， 姓 名 ， 工 资 和 标识 。 它 也 包含 类 似 属性 
setter 和 getter 方 法 。 


e Employee DAO/ 服 务 类 包含 服务 方法 ， 如 建立 员工 ， 发 现 员工 和 删除 员工 。 


第 2 阶段 


第 二 阶段 ， 称 为 映射 或 持久 性 的 阶段 ， 包 括 JPA 提 供 者 ， 映 射 文件 (orm.xml) , 
JPA 装 载 器 和 对 象 网 格 。 


e JPA 提 供 者 : 这 是 一 个 包含 了 JPA (javaxpersistence) 供应 的 产品 。 例 如 
EclipseLink，Toplink，Hibernate 等 。 


e 映射 文件 : 映射 文件 〈orm.xml 中 ) 包含 在 关系 数据 库 中 的 一 个 POJO 类 的 数据 
和 数据 之 间 的 映射 配置 。 


e JARRA : 在 JPA 加 载 器 的 工作 原理 就 像 一 个 高 速 缓冲 存储 器 。 它 可 以 加 载 
关系 网 格 数据 。 它 的 工作 原理 类 似 数 据 库 的 副本 与 服务 类 POJO 数 据 (POJO 
类 的 属性 ) 进行 交互 。 


e 对 象 网 格 : 它 是 可 存储 的 天 系数 据 的 副本 ， 如 高 速 缓冲 存储 器 的 临时 位 置 。 对 
a Ae a 只 有 提交 它 才 会 影响 到 主 数 
[ym 


第 3 阶段 


第 三 阶段 是 关系 数据 相关 。 它 包含 在 逻辑 上 连接 到 所 述 业务 组 件 的 关系 数据 。 如 上 
所 讨论 的 ， 仅 当 业 务 组 件 提交 该 数据 ， 它 被 存储 到 数据 库 中 的 物理 。 在 此 之 前 ， 已 
e CAPRA ee 在 获取 数据 的 过 程 和 存储 
数据 是 相同 的 。 


上 述 三 个 阶段 的 编程 交互 的 机 制 被 称 为 对 象 关系 映射 。 


Mapping.xml 


mapping.xml 文 件 指示 JPA 的 供应 者 来 映射 实体 类 与 数据 库 表 。 
让 我 们 以 Employee 实 体 包含 四 个 属性 的 一 个 例子 。POJO 类 Employee 实 体 的 命名 
为 : Employee.java， 如 下 : 
public class Employee 
private int eid; 
private String ename; 
private double salary; 
private String deg; 
public Employee(int eid, String ename, double salary, String de 
super( ); 
this.eid - eid; 
this.ename - ename; 
this.salary - salary; 
this.deg - deg; 
} 
public Employee( ) 
{ 


super(); 


public int getEid( ) 
return eid; 

public void setEid(int eid) 
this.eid = eid; 


public String getEname( ) 


return ename; 


public void setEname(String ename) 


{ 
this.ename = ename; 
} 
public double getSalary( ) 
{ 


return salary; 


} 
public void setSalary(double salary) 
{ 


} 


this.salary = salary; 


public String getDeg( ) 
{ 


return deg; 


public void setDeg(String deg) 


{ 
this.deg = deg; 





上 面 的 代码 是 Employee 实 体 POJO 类 。 它 包含 四 个 属性 eid, ename,salary, 和 
deg。 考 虑 这 些 属性 为 表 的 字段 ， 并 且 eid 作 为 该 表 的 主键 。 现 在 ， 我 们 要 设计 
Hibernate 映 射 文件 了 。 了 映射 文件 名 为 mapping.xml 如 下 : 


OO 08 950-0099 095 X: SUUSEXCLLLLLLLLLLLLLILILLLIZÓILILLIULIILIILLILULUZQSISUISSBBISUE] 


<? xml version="1.0" encoding="UTF-8" ?> 
<entity-mappings xmlns="http://java.sun.com/xml/ns/persistence/orm' 


xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://java.sun.com/xml/ns/persistence/orm 
http://java.sun.com/xml/ns/persistence/orm. 
version="1.0"> 
<description> XML Mapping file</description> 
<entity class="Employee"> 
<table name="EMPLOYEETABLE"/> 
<attributes> 
<id name="eid"> 
<generated-value strategy="TABLE"/> 
</id> 
<basic name="ename"> 
«column name="EMP_NAME" length="100"/> 
</basic> 
<basic name="Salary"> 
</basic> 
<basic name="deg"> 
</basic> 
</attributes> 
</entity> 


</entity-mappings> 





上 述 脚 本 用 于 与 数据 库 表 的 映射 实体 类 。 在 该 文件 中 


<entity-mappings> : 标签 定义 的 模式 定义 ， 人 允许 实体 标记 为 XML 文 件 。 
«description» : 标签 提供 了 有 关上 应 用 程序 的 描述 。 


«entity» : 标签 定义 要 转换 成 数据 库 表 中 的 实体 类 。 属 性 类 定义 了 POJO 实 体 类 
的 名 称 。 


«table» : 标签 定义 的 表 名 。 如 果 想 有 两 个 类 相同 的 名 称 以 及 该 表 中 ， 则 该 标签 
是 没有 必要 的 。 


«attributes» : 标签 定义 的 属性 (在 表 中 的 字段 ) 。 


«id» : 标记 定义 表 中 的 主键 。 在 <generated-value> 标 记 定 义 了 如 何 将 主键 值 赋 
值 ， 如 Automatic, Manual 或 者 使 用 Sequence。 


<basic> : 标签 用 于 定义 其 余 属 性 在 表 中 。 
<column-name> : 标签 被 用 来 在 表 中 定义 用 户 定 义 表 的 字段 名 。 


一 般 的 XML 文件 用 于 配置 特定 的 组 件 ， 或 者 映射 两 种 不 同 规格 的 组 件 。 在 我 们 的 例 
子 中 ， 我 们 要 分 别 保持 在 一 个 框架 的 XML 文件 。 这 意味 着 在 写 一 个 映射 的 XML 文 
件 ， 我 们 需要 比较 用 mapping.xml 文 件 实体 标签 的 POJO 类 的 属性 。 

这 里 是 解决 方案 。 在 类 定义 中 ， 我 们 可 以 使 用 注释 写 配 置 的 一 部 分 。 注 解 用 于 类 ， 
属性 和 方法 。 注 释 以 '@' 符 号 在 类 ， 属 性 或 方法 的 注释 中 声明 之 前 。 JPA 的 所 有 批 
注 在 javax.persistence 包 定义 。 


在 这 里 ， 在 我 们 的 实例 中 使 用 的 注释 列表 如 下 。 


@Entity 
@Table 
@Basic 


@Embedded 


@ld 


@GeneratedValue 


@Transient 


@Column 


@SequenceGenerator 


@TableGenerator 


@Access Type 


@JoinColumn 


@UniqueConstraint 
@ColumnResult 
@ManyToMany 
@ManyToOne 
@OneToMany 
@OneToOne 
@NamedQueries 
@NamedQuery 


Java Bean 标 准 
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声明 类 为 实体 或 表 。 

声明 表 名 。 

指定 非 约 束 明确 的 各 个 字段 。 

指定 类 或 它 的 值 是 一 个 可 府 入 的 类 的 实例 的 实体 的 属 


指定 的 类 的 属性 ， 用 于 识别 (一 个 表 中 的 主键 ) 。 


指定 如 何 标识 属性 可 以 被 初始 化 ， 例 如 自动 ， 手 动 ， 
或 从 序列 表 中 获得 的 值 。 


指定 的 属性 ， 它 是 不 持久 的 ， 即 ， 该 值 永远 不 会 存储 
在 数据 库 中 。 


指定 持久 属性 栏 属性 。 


指定 在 @GeneratedValue 注 解 中 指定 的 属性 的 值 。 它 
创建 了 一 个 序列 。 


指定 在 @GeneratedValue 批 注 指定 属性 的 值 发 生 器 。 
它 创造 了 的 值 生 成 的 表 。 

这 种 类 型 的 注释 用 于 设置 访问 类 型 。 如 果 设 置 
@AccessType (FIELD) ， 然 后 进入 FIELD 明 智 的 。 
如 果 设 置 @AccessType (PROPERTY) ， 然 后 进入 
属性 发 生 明智 的 。 


指定 一 个 实体 组 织 或 实体 的 集合 。 这 是 用 在 多 对 一 和 
一 对 多 关联 。 


指定 的 字段 和 用 于 主要 或 辅助 表 的 唯一 约束 。 
参考 使 用 select 子 句 的 SQL 查询 中 的 列 名 。 
定义 了 连接 表 之 间 的 多 对 多 一 对 多 的 关系 。 
定义 了 连接 表 之 间 的 多 对 一 的 关系 。 

定义 了 连接 表 之 间 存 在 一 个 一 对 多 的 关系 。 
定 交 了 连接 卖 之 间 有 一 个 一 对 一 的 关系 : 
指定 命名 查询 的 列表 。 

指定 使 用 静态 名 称 的 查询 。 


Java 类 封装 了 实例 的 值 及 其 行为 为 对 象 称 为 一 个 单元 。 Java Bean 是 一 个 临时 的 存 
储 和 可 重用 的 组 件 或 对 象 。 它 是 有 一 个 默认 的 构造 画 数 和 getter 和 setter 方 法 来 初始 
化 实例 序列 化 的 类 单独 的 属性 。 


Bean 约 定 


bean 包 含 其 默认 构造 函数 或 包含 序列 化 实例 的 文件 。 因 此 ， 一 个 bean 可 以 实 
例 化 另 一 个 bean。 


bean 属 性 可 以 被 隔离 成 布尔 属性 或 者 非 布 尔 属性 。 
非 布尔 属性 包含 getter 和 setter 方 法 。 
布尔 属性 包含 setter 和 方法 。 


任何 字段 的 getter 方 法 应 从 小 字母 get (Java 方 法 的 公约 ) 开始 ， 之 后 使 用 大 写 
字母 开头 的 字段 名 。 例 如 ， 字 段 名 为 salary， 因 此 这 一 字段 的 getter 方 法 为 
getSalary()。 


任何 属性 的 setter 方 法 应 该 先 从 小 字母 的 集合 (Java 方 法 公约 ) 开始 ， 继 续 以 
大 写字 母 ， 参 数值 设置 为 字段 开头 的 字段 名 。 例 如 ， 字 段 名 为 salary， 因 此 这 
一 字段 的 setter 方 法 是 setSalary (double sal ) 。 


对 于 布尔 型 属性 ， 方 法 是 检查 它 是 否 是 true 或 false。 例 如 ，Boolean 属 性 为 
空 ， 则 该 字段 的 就 是 方法 isEmpty()。 


JPA 安 装配 置 - JPA 教 程 


本 章 将 指导 完成 JPA 在 Windows 和 Linux 系 统 的 设置 过 程 。 JPA 可 以 很 容易 地 安装 并 
集成 而 无 需 任 何 复杂 的 设置 程序 ， 简 单 几 个 步骤 在 当前 的 Java 环 境 。 在 安装 时 用 户 


管理 是 必需 的 。 


系统 要 求 


JDK Java SE 2 JDK 1.5 或 以 上 

AF 1 GB RAM (推荐 ， 小 了 慢 了 不 要 怪我 ) 
硬盘 没有 最 小 要 求 

系统 版 本 Windows XP 或 以 上 , Linux 


现在 让 我 们 继续 安装 JPA， 如 下 几 个 步骤 。 


第 一 步 : 确认 已 经 Java 安 装 

首先 ， 需 要 在 系统 上 安装 Java 软 件 开发 工具 包 (SDK) 。 为 了 验证 这 一 点 ， 根 据 所 
使 用 的 平台 执行 以 下 两 个 命令 。 

如 果 Java 安 装 已 正确 守成， 那么 它 会 显示 Java 安 装 的 当前 版 本 。 示 例 输出 如 下 表 


Windows 


HARRES, AAAA : 


>java -version 


Java version "1.7.0 60" 
Java (TM) SE Run Time Environment (build 1.7.0 60-b19) 
Java Hotspot (TM) 64-bit Server VM (build 24.60-b09,mixed mode) 


Linux 


打开 命令 终端 ， 输 入 : 


$java -version 


java version "1.7.0 25" 
Open JDK Runtime Environment (rhel-2.3.10.4.e16 4-x86 64) 
Open JDK 64-Bit Server VM (build 23.7-b01, mixed mode) 


e 假设 本 教程 的 读者 已 把 Java SDK 版 本 1.7.0_60 安装 在 他 们 的 系统 中 。 
e 如 果 还 没有 安装 Java SDK， 从 


http://www.oracle.com/technetwork/java/javase/downloads/index.html 下 载 当 
前 版 本 并 安装 它 。 


第 2 步 : 设置 Java 环 境 
设置 环境 变量 JAVA_HOME 指向 到 安装 在 机 器 上 的 Java 目录 的 位 置 。 例 如 ， 


平台 描述 
Windows 设置 JAVA HOME 指向 C:\ProgramFiles\java\jdk1.7.0_60 
Linux Export JAVA_HOME=/usr/local/java-current 


添加 Java 编 译 器 位 置 的 完整 路 径 到 系统 路 径 。 


Th 描述 
Windows 添加 字符 串 "C:\Program Files\Java\jdk1.7.0_60\bin" 到 系统 变量 
PATH 的 尾部 . 
XU Export PATH=$PATH:$JAVA_HOME/bin/ 


在 命令 提示 符 下 执行 命令 java-version 如 上 所 述 。 


第 3 步 : 安装 JPA 


可 以 使 用 任何 JPA 提 供 者 ， 从 本 教程 中 ， 如 EclipseLink，Hibernate 都 经 过 JPA 安 
装 。 让 我 们 使 用 EclipseLink 遵 循 JPA 安 装 。 对 于 JPA 编 程 需要 遵循 特定 的 文件 夹 架 
构 ， 因 此 最 好 是 使 用 IDE。 


下 载 Eclipse IDE 如 下 面 的 链接 https://www.eclipse.org/downloads/ 选择 
EclipselDE 对 JavaEE 开发 者 是 Eclipse indigo. 


解压 缩 Eclipse 的 zip 文 件 。 打 开 Eclipse IDE。 


L 
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安装 使 用 EclipseLink JPA 


EclipseLink 是 一 个 库 ， 因 此 我 们 不 能 直接 将 其 添加 到 Eclipse IDE。 安 装 JPA 使 用 
EclipseLink 需 要 按照 下 面 给 出 的 步 又。 


e 创建 一 个 新 的 JPA 项 目 在 Eclipse IDE 中 ， 首 先 选择 File->New->JPA 项 目 如 下 : 
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。 得 到 一 个 名 为 新 建 JPA 项 目的 对 话 框 。 输 入 项 目 名 称 yiibai_JPA_Eclipselink， 
检查 JRE 版 本 ， 然 后 单 击 下 一 步 : 
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e 在 下 载 库 对 话 框 中 选择 EclipseLink 库 的 最 新 版 本 ， 点 击 下 一 步 ， 如 下 所 示 : 
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e 下 载 开 始 作 为 显示 在 下 面 的 屏幕 截图 。 
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e 最 后 得 到 Package Explorer 中 的 Eclipse IDE 项 目 文件 。 提 取 所 有 文件 ， 得 到 的 


文件 夹 和 文件 的 层次 结构 如 下 所 示 : 
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加 入 MySQL 连 接 到 项 目 

我 们 在 这 里 讨论 的 例子 需要 连接 数据 库 。 让 我 们 看 看 MySQL 数据库 进行 数据 库 操 
作 。 它 需要 使 用 mysql-connector jar 与 Java 程 序 进行 交互 。 

按照 以 下 步骤 配置 数据 库 的 jar 在 项 目 中 。 


e 转 到 项 目 属性 - 通过 右 击 它 > Java 构 建 路 径 。 会 得 到 一 个 对 话 框 ， 显 示 在 下 面 
的 屏幕 截图 。 单 击 添加 外 部 JAR。 
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e 去 到 jar 在 系统 的 位 置 ， 选 择 该 文件 ， 然 后 单 击 打开 。 


TutorialsPoint Java 技术 教程 


fie dde jome Men ljg Sah Bronct Bun Boden 
"HOS S-O-G- TG" GZ SOF" PJ t 


(a Coteratgijove TD bmpleymimn | Hi pense 





uU 
L4 
5 
L4 
3 
- 
w 


COET: ECO 





e 单 击 确定 在 属性 对 话 框 。 将 获得 MySQL 的 连接 器 jar 在 项 目 。 现 在 ， 可 以 使 用 
MySQL 数 据 库 操作 。 
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本 章 将 使 用 一 个 简单 的 例子 来 说 明 JPA 是 如 何 工 作 的 。 让 我 们 来 考虑 以 员工 管理 为 
例 。 假 设 员工 管理 分 别 创建 ， 更 新 ， 查 找 和 删除 员工 的 记录 操作 。 正 如 前 面 提 到 
的 ， 使 用 MySQL 数 据 库 进 行 数 据 库 操 作 。 
对 于 此 示例 中 的 主要 模块 如 下 : 
e 模型 或 POJO 
Employee.java 
e 持久 化 
Persistence.xml 
e 服务 
CreatingEmployee.java 
UpdatingEmployee.java 
FindingEmployee.java 
DeletingEmployee.java 


让 我 们 看 看 ， 我 们 已 经 使 用 了 JPA 安 装 EclipseLink 包 的 层次 。 按 照 分 层 结 构 的 此 示 
例 中 ， 如 下 所 示 : 
Pet PA top = = 
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创建 实体 


实体 是 什么 ?无非 是 bean 或 model。 在 这 个 例子 中 ， 我 们 将 使 用 员工 作为 一 个 实 
体 。 eid, ename, salary, 和 deg 是 实体 的 属性 。 它 包含 一 个 默认 的 构造 画 数 ， 以 及 
这 些 属性 的 setter 和 getter 方 法 。 


在 上 图 所 示 的 层次 结构 ， 创 建 一 个 名 为 “com.yiibai.eclipselink.entity' 包 ， 在 'src' 中 
( 源 ) 封 装 。 给 包 下 创建 一 个 名 为 Employee java 类 ， 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Table; 


QEntity 
QTable 
public class Employee 
{ 
@Id 
@GeneratedValue(strategy= GenerationType.AUTO) 
private int eid; 
private String ename; 
private double salary; 
private String deg; 
public Employee(int eid, String ename, double salary, String de 


t 
super( ); 
this.eid - eid; 
this.ename - ename; 
this.salary - salary; 
this.deg - deg; 

} 

public Employee( ) 

{ 


super(); 


public int getEid( ) 
{ 


return eid; 


public void setEid(int eid) 
{ 


} 
public String getEname( ) 


{ 


this.eid = eid; 


return ename; 


public void setEname(String ename) 


{ 
this.ename = ename; 
} 
public double getSalary( ) 
{ 


return salary; 


} 
public void setSalary(double salary) 


{ 
this.salary = salary; 
} 
public String getDeg( ) 
{ 


return deg; 
} 
public void setDeg(String deg) 


this.deg = deg; 
} 
@Override 
public String toString() { 
return "Employee [eid=" + eid + ", ename=" + ename + ", sal: 
+ salary + ", deg=" + deg + "J"; 





在 上 面 的 代码 中 ， 我 们 使 用 @Entity 注 解 ， 使 这 个 POJO 类 为 实体 。 
在 断 续 下 一 个 模块 前 ， 我 们 需要 对 关系 实体 关联 ， 它 记录 在 persistence.xml 文件 
数据 库 中 并 创建 数据 库 。 打 开 MySQL 工作 台 ， 然 后 键入 下 面 的 查询 。 


create database jpadb 
Use jpadb 


Persistence.xml 


这 个 模块 起 着 JPA 概 念 至 关 重 要 的 作用 。 在 这 个 XML 文件 中 ， 我 们 将 注册 数据 库 ， 
并 指定 实体 类 。 


另外 ， 在 上 述 所 示 的 包 的 层次 结构 ， 根 据 JPA 的 内 容 包含 在 persistence.xml 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
«persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persi: 
<persistence-unit name="Eclipselink_JPA" 
transaction-type="RESOURCE_LOCAL"> 
<class>com.yiibai.eclipselink.entity.Employee</class> 
<properties> 
«property name-"javax.persistence.jdbc.url" 
value="jdbc:mysql://localhost:3306/jpadb"/> 
«property name="javax.persistence.jdbc.user" value="root 
<property name="javax.persistence.jdbc.password" value="1 
«property name="javax.persistence.jdbc.driver" 
value-"com.mysql.jdbc.Driver"/» 
«property name="eclipselink.logging.level" value="FINE", 
«property name="eclipselink.dd1l-generation" 
value="create-tables"/> 
</properties> 
</persistence-unit> 
</persistence> 





在 上 面 的 XML，<persistence-unit> 标 签 定 义 JPA 持 久 性 的 特定 名 称 。<class> 标 记 
定义 了 包 名 的 实体 类 。<properties> 标 签 定义 的 所 有 属性 ， 而 <property> 标 记 的 每 
个 属性 定义 ， 例 如 数据 库 注 册 ，URL 规 范 ， 用 户 名 和 密码 。 这 些 是 EclipseLink 属 
性 。 此 文件 将 配置 数据 库 。 


持久 化 操作 


用 于 与 一 个 数据 库 进行 交互 持久 性 操作 ， 它 们 加 载 和 存储 操作 。 在 一 个 业务 组 件 ， 
所 有 的 持久 化 操作 属于 服务 类 。 


在 上 面 的 图 示 包 层次 结构 ， 创 建 一 个 名 为 “com.yiibai.eclipselink.service' 包 ， 
在 'src' 中 ( 源 ) 封装 。 所 有 命名 为 CreateEmloyee.java，UpdateEmployee.java， 
FindEmployee.java 和 DeleteEmployee.java 服务 类 。 来 自给 定 的 包 下 ， 如 下 所 示 : 


创建 Employee 


下 面 的 代码 段 说 明了 如 何 创建 一 个 名 为 CreateEmployee.java 的 一 个 Employee 类 。 


package com. yiibai.eclipselink.service; 


import javax.persistence.EntityManager ; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.Employee; 


public class CreateEmployee 


public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager = emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 


Employee employee - new Employee( ); 
employee.setEid( 1201 ); 
employee.setEname( "Gopal" ); 
employee.setSalary( 40000 ); 
employee.setDeg( "Technical Manager" ); 
entitymanager.persist( employee ); 
entitymanager.getTransaction( ).commit( ); 


entitymanager.close( ); 
emfactory.close( ); 


在 上 面 的 代码 中 createEntityManagerFactory() 通 过 提供 我 们 在 persistent.xml 文件 
提供 持久 化 单元 相同 唯一 的 名 称 创建 一 个 持久 性 单元 。 EntityManagerFactory 对 象 
将 由 usingcreateEntityManager() 方 法 创建 entitymanger 实 例 。 EntityManager 对 象 
创建 entitytransactioninstance 事务 管理 。 通 过 使 用 EntityManager 对 象 ， 我 们 可 
以 持久 化 实体 到 数据 库 中 。 


编译 和 执行 上 述 程序 后 ， 会 从 库 中 的 EclipseLink 得 到 通知 在 Eclipse IDE 的 控制 台 
板 上 。 


对 于 结果 ， 打 开 MySQL 工作 台 ， 然 后 输入 以 下 的 查询 。 


use jpadb 
select * from employee 


命名 为 employee 受 影响 的 数据 库 表 将 显示 在 表格 格式 如 下 : 


Eid Ename Salary Deg 
1201 Gopal 40000 Technical Manager 


更 新 Employee 


要 更 新 员工 的 记录 ， 我 们 需要 检索 现 有 记录 形成 数据 库 ， 进 行 修改 ， 最 后 提交 到 数 
据 库 中 。 名 为 UpdateEmployee.java 类 如 下 所 示 : 


package com.yiibai.eclipselink.service; 


import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.Employee; 


public class UpdateEmployee 


public static void main( String[ ] args ) 
d 
EntityManagerFactory emfactory - Persistence. 
createEntityManagerFactory( "Eclipselink JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 
Employee employee-entitymanager. 
find( Employee.class, 1201 ); 
//before update 
System.out.println( employee ); 
employee.setSalary( 46000 ); 
entitymanager.getTransaction( ).commit( ); 
//after update 
System.out.println( employee ); 
entitymanager.close(); 
emfactory.close(); 


编译 和 执行 上 述 程 序 后， 会 从 库 中 的 EclipseLink 得 到 通知 在 Eclipse IDE 的 控制 台面 
板 上 。 


对 于 结果 ， 打 开 MySQL 工 作 台 ， 然 后 输入 以 下 的 查询 。 


Use jpadb 
select * from employee 


命名 为 employee 受 影响 的 数据 库 表 将 显示 在 表格 格式 如 下 : 


Eid Ename Salary Deg 
1201 Gopal 46000 Technical Manager 


员工 的 工资 为 1201 将 更 新 为 46000。 


查找 Employee 


找 一 个 履 员 的 记录 ， 从 数据 库 中 检索 现 有 数据 并 显示 它 。 在 该 操作 中 ， 
EntityTransaction 未 在 检索 的 记录 中 应 用 。 


命名 类 FindEmployee.java 如 下 。 


package com.yiibai.eclipselink.service; 


import javax.persistence.EntityManager ; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.Employee; 


public class FindEmployee 


{ 
public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence 
.createEntityManagerFactory( "Eclipselink JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager(); 
Employee employee - entitymanager. 
find( Employee.class, 1201 ); 
System.out.println("employee ID = "-employee.getEid( )); 
System.out.println("employee NAME = "+employee.getEname( )), 
System.out.println("employee SALARY = "+employee.getSalary/( 
System.out.println("employee DESIGNATION = "-employee.getDet( 
j 
j 





编译 并 执行 上 述 程序 后 ， 从 库 中 的 EclipseLink 会 得 到 以 下 输出 在 Eclipse IDE 控制 
台面 板 上 。 


employee ID = 1201 

employee NAME = Gopal 

employee SALARY = 46000.0 

employee DESIGNATION = Technical Manager 


删除 员工 


要 删除 一 个 员工 的 记录 ， 首 先 我 们 会 发 现 现 有 的 记录 ， 然 后 删除 它 。 这 里 
EntityTransaction 起 着 重要 的 作用 。 


命名 DeleteEmployee.java 类 如 下 : 


package com.yiibai.eclipselink.service; 


import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.Employee; 


public class DeleteEmployee 
{ 
public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager = emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 
Employee employee-entitymanager. 
find( Employee.class, 1201 ); 
entitymanager.remove( employee ); 
entitymanager.getTransaction( ).commit( ); 
entitymanager.close( ); 
emfactory.close( ); 


编译 和 执行 上 述 程序 后 ， 会 得 到 Eclipse IDE 控 制 台 面板 上 ， 从 EclipseLink 库 中 的 
通知 。 


对 于 结果 ， 打 开 MySQL 的 工作 台 ， 然 后 键入 以 下 的 查询 。 


use jpadb 
select * from employee 


受 影响 的 数据 库 命名 为 employee 的 记录 为 空 。 
在 此 示例 中 所 有 的 模块 完成 后 ， 将 包 和 文件 的 层次 结构 如 下 所 示 : 
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JPA JPQL/ 持 久 化 查询 语言 - JPA 教 程 


本 章 介 绍 有 关 JPQL 和 它 的 工作 原理 与 持久 性 单元 。 在 这 一 章 中 ， 给 出 的 例子 遵循 
相同 的 包 层 次 结构 ， 和 我 们 在 前 面 的 章节 中 使 用 一 样 。 
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Java 持 久 化 查询 语言 
JPQL 代 表 Java 持 久 化 查询 语言 。 它 被 用 来 创建 针对 实体 的 查询 存储 在 关系 数据 库 
中 。 JPQL 是 基于 SQL 语法 的 发 展 。 但 它 不 会 直接 影响 到 数据 库 。 


JPQL 可 以 检索 使 用 SELECT 子 句 中 的 数据 ， 可 以 使 用 UPDATE 子 句 做 批量 
UPDATE 和 DELETE 子 句 。 


查询 结构 


JPQL 语 法 非常 类 似 于 SQL 语法 。SQL 的 语法 是 一 个 优势 ， 因 为 SQL 很 简单 ， 被 广 
泛 使 用 。 SQL 工作 直接 针对 关系 数据 库 表 ， 记 录 和 字段 ， 而 JPQL 适 用 于 Java 类 和 
实例 。 


例如 ，JPQL 查 询 可 以 检索 实体 对 象 ， 而 不 是 从 一 个 数据 库 中 设置 字段 结果 ， 作 为 
与 SQL。 该 JPQL 查 询 结 构 如 下 。 


SELECT ... FROM ... 
[WHERE ...] 
[GROUP BY ... [HAVING ...]] 


[ORDER BY ...] 


JPQL 的 结构 ，DELETE 和 UPDATE 查 询 ， 如 下 所 示 。 


DELETE FROM ... [WHERE ... ] 


UPDATE 2... “SET =) 4 WHERE: - 22] 


标量 和 聚合 函数 


标量 函数 返回 基于 输入 值 所 得 的 数值 。 集 合 画 数 ， 通 过 计算 输入 值 返回 的 结果 值 。 


员工 管理 ， 在 前 面 的 章节 。 在 这 里 将 通过 使 用 JPQL 的 标量 
MRAKA  # 


让 我 们 假定 jpadb.employee 表 包 含 下 述 记 录 。 


Eid Ename Salary Deg 
1201 Gopal 40000 技术 经 理 
1202 Manisha 40000 接待 员 
1203 Masthanvali 40000 技术 作家 
1204 Satish 30000 技术 作家 
1205 Krishna 30000 技术 作家 
1206 Kiran 35000 接待 员 


创建 一 个 在 com yiibai.eclipselink.service 包 命名 为 
ScalarandAggregateFunctions.java 类 如 下 。 


package com.yiibai.eclipselink.service; 


import java.util.List; 

import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import javax.persistence.Query; 


public class ScalarandAggregateFunctions 
{ 
public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager = emfactory. 
createEntityManager(); 
//Scalar function 
Query query - entitymanager. 
createQuery("Select UPPER(e.ename) from Employee e"); 
List<String> list=query.getResultList(); 


for(String e:list) 
{ 


J 
//Aggregate function 


Query queryi = entitymanager. 

createQuery("Select MAX(e.salary) from Employee e"), 
Double result-(Double) queryi.getSingleResult(); 
System.out.println("Max Employee Salary :"+result); 


System.out.println("Employee NAME :"+e); 


j 
Ei" | 
编译 和 执行 上 面 的 程序 ， 在 Eclipse IDE 的 控制 台面 板 上 会 得 到 以 下 输出 。 


Employee NAME :GOPAL 
Employee NAME :MANISHA 
Employee NAME :MASTHANVALI 
Employee NAME :SATISH 
Employee NAME :KRISHNA 
Employee NAME :KIRAN 

Max Employee Salary :40000.0 


Between, And, Like 关键 词 


Between, And, 和 Like 是 JPQL 的 主要 关键 字 。 这 些 关键 字 在 查询 子 句 后 使 用 。 


创建 一 个 名 为 BetweenAndLikeFunctions.java 类 在 com.yiibai.eclipselink.service 
包 下 ， 如 下 所 示 : 


package com.yiibai.eclipselink.service; 


import 
import 
import 
import 
import 
import 


public 
{ 


java.util.List; 
javax.persistence.EntityManager ; 
javax.persistence.EntityManagerFactory; 
javax.persistence.Persistence; 
javax.persistence.Query; 

com. yiibai.eclipselink.entity.Employee; 


class BetweenAndLikeFunctions 


public static void main( String[ ] args ) 


( 


} 
zj 


EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager = emfactory. 
createEntityManager(); 
/ /Between 
Query query - entitymanager. 
createQuery( "Select e " + 
"from Employee e " + 
"where e.salary " + 
"Between 30000 and 40000" ) 
List«Employee» list=(List<Employee>)query.getResultList( ); 


for( Employee e:list ) 


System.out.print("Employee ID :"+e.getEid( )); 
System.out.println("Nt Employee salary :'-*e.getSalary( 


j 


//Like 
Query queryi = entitymanager. 
createQuery("Select e " + 
"from Employee e " + 
"where e.ename LIKE 'M%'"); 
List<Employee> list1=(List<Employee>)query1.getResultList ( 
for( Employee e:listi ) 


System.out.print("Employee ID :"+e.getEid( )); 
System.out.println("Nt Employee name :"+e.getEname( )); 








编译 并 执行 上 述 程序 后 ， 将 在 Eclipse IDE 的 控制 台面 板 下 面 输出 以 下 内 容 。 


Employee ID :1201 Employee salary :40000.0 
Employee ID :1202 Employee salary :40000.0 
Employee ID :1203 Employee salary :40000.0 
Employee ID :1204 Employee salary :30000.0 
Employee ID :1205 Employee salary :30000.0 
Employee ID :1206 Employee salary :35000.0 
Employee ID :1202 Employee name :Manisha 
Employee ID :1203 Employee name :Masthanvali 


排序 


要 排序 JPQL 中 的 记录 ， 我 们 使 用 ORDER BY 子 句 。 这 一 个 子 句 的 使 用 类 似 于 SQL 


中 的 用 法 ， 


但 它 涉及 的 实体 。 下 面 的 示例 演示 了 如 何 使 用 ORDER BY 子 句 。 


在 com.yiibai.eclipselink.service 包 中 创建 类 Ordering.java 如 下 : 


package com.yiibai.eclipselink.service; 


import 
import 
import 
import 
import 
import 


public 
{ 


java.util.List; 
javax.persistence.EntityManager ; 
javax.persistence.EntityManagerFactory; 
javax.persistence.Persistence; 
javax.persistence.Query; 

com. yiibai.eclipselink.entity.Employee; 


class Ordering 


public static void main( String[ ] args ) 


{ 


EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager(); 
/ /Between 
Query query - entitymanager. 
createQuery( "Select e " + 
"from Employee e " + 
"ORDER BY e.ename ASC" ); 
List«Employee» list-(List«Employee»)query.getResultList( ); 


for( Employee e:list ) 


System.out.print("Employee ID :"+e.getEid( )); 
System.out.println("Nt Employee Name :"+e.getEname( )); 








编译 和 执行 上 面 的 程序 ， 在 Eclipse IDE 的 控制 台面 板 会 产生 下 面 的 输出 。 


Employee ID :1201 Employee Name :Gopal 
Employee ID :1206 Employee Name :Kiran 
Employee ID :1205 Employee Name :Krishna 
Employee ID :1202 Employee Name :Manisha 
Employee ID :1203 Employee Name :Masthanvali 
Employee ID :1204 Employee Name :Satish 


命名 查询 


@NamedQuery 注 解 被 定义 为 一 个 预定 义 的 查询 字符 串 ， 它 是 不 可 改变 的 查询 。 相 
反 ， 动 态 查询 ， 命 名 查询 可 以 通过 POJO 分 离 JPQL 坦 询 字 符 串 提高 代码 的 组 织 。 它 
也 传送 的 查询 参数 ， 而 不 是 动态 地 艇 入 文本 到 查询 字符 串 ， 并 因此 产生 更 高 效 的 查 
询 。 


首先 ，@NamedQuery 注 解 添加 到 com.yiibai.eclipselink.entity 包 中 的 Employee 3 
体 ， 类 名 为 Employee.java 下 ， 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.NamedQuery; 
import javax.persistence.Table; 


QEntity 

@Table 

@NamedQuery(query = "Select e from Employee e where e.eid = :id", 
name = "find employee by id") 

public class Employee 

{ 
@Id 


@GeneratedValue(strategy= GenerationType.AUTO) 

private int eid; 

private String ename; 

private double salary; 

private String deg; 

public Employee(int eid, String ename, double salary, String det 


{ 
super( ); 
this.eid - eid; 
this.ename - ename; 
this.salary - salary; 
this.deg - deg; 

} 


public Employee( ) 


super(); 


public int getEid( ) 
{ 


return eid; 


j 
public void setEid(int eid) 
{ 


} 


this.eid = eid; 


public String getEname( ) 
{ 


return ename; 


public void setEname(String ename) 


{ 
this.ename = ename; 
} 
public double getSalary( ) 
{ 


return salary; 


public void setSalary(double salary) 


{ 
this.salary = salary; 
} 
public String getDeg( ) 
{ 


return deg; 
} 
public void setDeg(String deg) 


this.deg = deg; 
} 
@Override 
public String toString() { 
return "Employee [eid=" + eid + ", ename=" + ename + ", Sali 
+ salary + ", deg=" + deg + "J"; 





创建 一 个 名 为 com.yiibai.eclipselink.service 包 下 的 NamedQueries.java 类 ， 如 下 所 
小 : 


package com.yiibai.eclipselink.service; 


import java.util.List; 

import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import javax.persistence.Query; 

import com.yiibai.eclipselink.entity.Employee; 


public class NamedQueries 


{ 
public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager(); 
Query query - entitymanager.createNamedQuery( 
"find employee by id"); 
query.setParameter("id", 1204); 
List<Employee> list = query.getResultList( ); 
for( Employee e:list ) 
System.out.print("Employee ID :"+e.getEid( )); 
System.out.println("Nt Employee Name :"+e.getEname( )); 
} 
} 
} 


LEN | 
经 过 编译 和 执行 上 面 的 程序 ， 在 Eclipse IDE 的 控制 台面 板 上 会 得 到 下 面 的 输出 。 


Employee ID :1204 Employee Name :Satish 


加 入 上 述 所 有 类 后 ， 包 层次 结构 如 下 所 示 : 


fie (de Bon Sape Project Bun inde 


"0"% JG- G- Sopy . "Ge . "| PA :* ea HE 

















Wi Dato tasare bwanw SIN e ud eB 


急切 和 延迟 Jn 3X, 


JPA 中 最 重要 的 概念 是 为 了 使 数据 库 的 副本 在 高 速 缓冲 存储 器 中 。 虽 然 有 一 个 数据 
库 事务 ， 但 JPA 首 先 创建 一 个 重复 的 数据 集 ， 只 有 当 它 使 用 实体 管理 提交 ， 所 做 的 
更 改 影响 到 数据 库 中 。 


从 数据 库 中 获取 记录 有 两 种 方式 。 


预先 抓 取 
在 预先 抓 取 ， 相 关 的 子 对 象 获取 一 个 特定 的 记录 自动 上 传 。 


延迟 加 载 


在 延迟 装载 ， 涉 及 的 对 象 不 会 自动 上 传 ， 除 非 你 特别 要 求 他 们 。 首 先 ， 它 检查 相关 
对 象 和 通知 可 用 性 。 以 后 ， 如 果 调 用 任何 实体 的 getter 方 法 ， 那 么 它 获 取 的 所 有 记 
录 。 


迟 装 载 可 能 在 第 一 次 党 斌 获取 记录 。 这 样 一 来 ， 在 整个 记录 的 副本 已 经 被 存储 在 
高 速 缓冲 存储 器 中 。 性 能 方面 ， 延 迟 装载 最 好 。 


JPA 高 级 映射 - JPA 教 程 


JPA 是 一 种 发 布 使 用 Java 规 范 的 库 。 因 此 ， 它 支持 所 有 的 面向 对 象 的 概念 实体 ， 持 
久 性 。 到 现在 为 止 ， 我 们 已 经 完成 了 对 象 关系 映射 的 基本 知识 。 本 章 将 完成 对 象 和 
关系 单位 之 间 的 高 级 映射 。 


继承 策略 

继承 是 任何 面向 对 象 语言 的 核心 理念 ， 因 此 我 们 可 以 用 实体 之 间 的 继承 关系 和 策 
略 。JPA 支 持 三 种 类 型 的 继承 策略 : SINGLE_TABLE，JOINED_TABLE 和 
TABLE PER CONCRETE CLASS, 


让 我 们 考虑 一 个 例子 。 下 图 显示 了 三 个 等 级 ， 即 Staff, TeachingStaff, and 
NonTeachingStaff 和 他 们 之 间 的 关系 。 


Staff 


* Sid 
* Sname 


TeachingStaff NonTeachingStaff 


* Qualification * AreaExpertise 


* SubjectExpertise 





在 上 面 的 图 中 ， 员 工 是 一 个 实体 ， 而 TeachingStaff 和 NonTeachingStaff 是 工作 人 员 
的 子 实体 。 在 这 里 ， 我 们 将 使 用 上 面 的 例子 来 演示 继承 的 全 部 三 个 策略 。 


X — ARES 


单 表 策略 采取 所 有 类 的 字段 (包括 超级 亚 类 )， 并 将 它们 映射 成 称 为 SINGLE_TABLE 
策略 一 个 表 。 这 里 的 鉴别 值 起 着 区 分 在 一 个 表 中 三 个 实体 的 值 的 关键 作用 。 


让 我 们 考虑 上 面 的 例子 。TeachingStaff 和 NonTeachingStaff 是 Staff 的 子 类 。 按 照 继 
承 的 概念 ， 一 个 子 类 继承 其 超 类 中 的 属性 。 因 此 sid 和 sname 属 于 TeachingStaff 和 
NonTeachingStaff 字段 。 创 建 JPA 项 目 。 在 这 个 项 目 中 的 所 有 模块 ， 如 下 所 示 : 


创建 实体 


创建 一 个 名 为 “src”( 源 ) 在 “com.yiibai.eclipselink.entity' 包 下 。 创 建 一 个 名 为 
Staff.jjava 新 的 Java 类 。 工 作 人 员 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
@Entity 
@Table 


java.io.Serializable; 


javax. 
javax. 
javax. 
javax. 
javax. 
javax. 
javax. 
javax. 


persistence. 
persistence. 
persistence. 
persistence. 
persistence. 
persistence. 
persistence. 
. Table; 


persistence 


DiscriminatorColumn; 
Entity; 
GeneratedValue; 
GenerationType; 

Id; 

Inheritance; 
InheritanceType; 


@Inheritance( strategy = InheritanceType.SINGLE TABLE ) 
@DiscriminatorColumn( name="type" ) 
public class Staff implements Serializable 


{ 
@Id 


@GeneratedValue( strategy = GenerationType.AUTO ) 
private int sid; 

private String sname; 
public Staff( int sid, String sname ) 


( 


super( ); 
this.sid - sid; 
this.sname - sname; 


J 
public Staft( ) 


$ 


super( ); 


public int getSid( ) 


i 


return sid; 


public void setSid( int sid ) 


{ 
} 


this.sid = sid; 


public String getSname( ) 


i 


return sname; 


public void setSname( String sname ) 


{ 
} 


this.sname = sname; 


在 上 面 的 代码 @DescriminatorColumn 指 定 字段 名 称 (类 型 ) 和 它 的 值 显 示 剩 余 
(Teaching 和 NonTeachingStaff) 字段 。 


创建 Staff 类 的 一 个 子 类 叫 TeachingStaff.java 在 com.yiibai.eclipselink.entity 包 下 。 
TeachingStaff 实体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.DiscriminatorValue; 
import javax.persistence.Entity; 


@Entity 
QDiscriminatorValue( value="TS" ) 
public class TeachingStaff extends Staff 
t 
private String qualification; 
private String subjectexpertise; 


public TeachingStaff( int sid, String sname, 
String qualification,String subjectexpertise ) 


{ 
super( sid, sname ); 
this.qualification - qualification; 
this.subjectexpertise - subjectexpertise; 
j 
public TeachingStaff( ) 
{ 


super( ); 


public String getQualification( ) 


{ 
return qualification; 
j 
public void setQualification( String qualification ) 
{ 
this.qualification = qualification; 
j 
public String getSubjectexpertise( ) 
{ 
return subjectexpertise; 
j 
public void setSubjectexpertise( String subjectexpertise ) 
f 
this.subjectexpertise - subjectexpertise; 
j 


创建 Staff 的 一 个 子 类 (类 ) 类 叫 NonTeachingStaff.java 在 
com.yiibai.eclipselink.entity 包 下 。 NonTeachingStaff 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.DiscriminatorValue; 
import javax.persistence.Entity; 


@Entity 

@DiscriminatorValue( value = "NS" ) 

public class NonTeachingStaff extends Staff 
{ 


private String areaexpertise; 


public NonTeachingStaff( int sid, String sname, 
String areaexpertise ) 


{ 
super( sid, sname ); 
this.areaexpertise - areaexpertise; 
} 
public NonTeachingStaff( ) 
{ 


Super( ); 


public String getAreaexpertise( ) 


{ 
} 


return areaexpertise; 


public void setAreaexpertise( String areaexpertise ) 


{ 
} 


this.areaexpertise = areaexpertise; 


Persistence.xml 


persistence.xml 中 包含 数据 库 的 配置 信息 和 实体 类 的 注册 信息 。 XML 文件 如 下 所 
小 : 


<?xml version="1.0" encoding="UTF-8"?> 
«persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persi: 
<persistence-unit name="Eclipselink_JPA" 
transaction-type="RESOURCE_LOCAL"> 
«class»com.yiibai.eclipselink.entity.Staff«/class» 
«class»com.yiibai.eclipselink.entity.NonTeachingStaff«/clas: 
<class>com.yiibai.eclipselink.entity.TeachingStaff</class> 
<properties> 
«property name="javax.persistence. jdbc.url" 
value="jdbc:mysql://localhost :3306/jpac 
«property name="javax.persistence.jdbc.user" value="roo1 
«property name="javax.persistence.jdbc.password" 
value="root"/> 
«property name="javax.persistence. jdbc.driver" 
value="com.mysql.jdbc.Driver"/> 
<property name="eclipselink.logging.level" value="FINE", 
«property name="eclipselink.ddl-generation" 
value-"create-tables"/» 
«/properties» 
</persistence-unit> 
</persistence> 


局 
服务 类 


服务 类 业务 组 件 的 实现 部 分 。 创 建 com.yiibai.eclipselink.service“ 包 在 'src" 下 。 


创建 一 个 给 定 的 包 下 名 为 SaveClient.java 用 来 存储 Staff，TeachingStaff 和 
NonTeachingStaff 类 字段 类 。SaveClient 类 如 下 所 示 : 





package com. yiibai.eclipselink.service; 


import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 

import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.NonTeachingStaff; 
import com.yiibai.eclipselink.entity.TeachingStaff; 


public class SaveClient 


( 


public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 


//Teaching staff entity 

TeachingStaff tsi=new TeachingStaff( 
1,"Gopal","MSc MEd","Maths"); 

TeachingStaff ts2-new TeachingStaff( 

2, "Manisha", "BSc BEd", "English"); 
//Non-Teaching Staff entity 
NonTeachingStaff ntsi=new NonTeachingStaff( 

3, "Satish", "Accounts"); 
NonTeachingStaff nts2=new NonTeachingStaff( 

4, "Krishna", "Office Admin"); 


//storing all entities 
entitymanager.persist(ts1); 
entitymanager.persist(ts2); 
entitymanager.persist(nts1); 
entitymanager.persist(nts2); 
entitymanager.getTransaction().commit(); 
entitymanager.close(); 
emfactory.close(); 


编译 并 执行 上 述 程序 后 ，Eclipse IDE 的 控制 台面 板 上 会 得 到 通知 。 检 查 MySQL 工 
作 台 的 输出 。 以 表格 格式 的 输出 如 下 所 示 : 


Sid Type  Sname Areaexpertise Qualification Subjectexpertise 


1 TS Gopal MSC MED Maths 
2 TS Manisha BSC BED English 
3 NS Satish Accounts 

4 NS Krishna Office Admin 


最 后 ， 会 得 到 一 个 包含 所 有 三 个 类 字段 鉴别 列 命名 类 型 字段) 一 个 胡 。 
注册 策略 表 


(Ce E ME | 用 的 列 包含 唯一 值 的 加 入 表 并 进行 便捷 事务 。 让 我 们 考虑 与 
上 述 相同 的 例子 


创建 JPA 项 目 。 所 有 工程 的 模块 如 下 所 示 。 


创建 实体 


在 “src" 下 创建 一 个 名 为 com.yiibai.eclipselink.entity' 的 包 。 创 建 一 个 名 为 Staff.java 
新 的 Java 类 。Staff 实体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import java.io.Serializable; 

import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Inheritance; 
import javax.persistence.InheritanceType; 
import javax.persistence.Table; 


QEntity 
QTable 
QInheritance( strategy - InheritanceType.JOINED ) 
public class Staff implements Serializable 
{ 
@Id 
@GeneratedValue( strategy = GenerationType.AUTO ) 
private int sid; 
private String sname; 
public Staff( int sid, String sname ) 
{ 
super( ); 
this.sid - sid; 
this.sname - sname; 


} 
public Staff( ) 
{ 


super( ); 


public int getSid( ) 
{ 


return sid; 


public void setSid( int sid ) 
{ 


} 
public String getSname( ) 


{ 


this.sid = sid; 


return sname; 


public void setSname( String sname ) 


{ 
} 


this.sname = sname; 


创建 Staff 类 的 一 个 子 类 叫 TeachingStaff.java 在 com.yiibai.eclipselink.entity 包 下 。 
TeachingStaff 实体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.DiscriminatorValue; 
import javax.persistence.Entity; 


@Entity 
QPrimaryKeyJoinColumn(referencedColumnName-"sid") 
public class TeachingStaff extends Staff 


{ 
private String qualification; 
private String subjectexpertise; 
public TeachingStaff( int sid, String sname, 
String qualification, String subjectexpertise ) 
{ 
super( sid, sname ); 
this.qualification = qualification; 
this.subjectexpertise = subjectexpertise; 
j 
public TeachingStaff( ) 
{ 
super( ); 
j 
public String getQualification( ) 
t 
return qualification; 
j 
public void setQualification( String qualification ) 
f 
this.qualification - qualification; 
j 
public String getSubjectexpertise( ) 
{ 
return subjectexpertise; 
j 
public void setSubjectexpertise( String subjectexpertise ) 
{ 
this.subjectexpertise = subjectexpertise; 
j 
j 


创建 Staff 的 一 个 子 类 (3X) 类 叫 NonTeachingStaff.java 在 
com.yiibai.eclipselink.entity 包 下 。NonTeachingStaff 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.DiscriminatorValue; 
import javax.persistence.Entity; 


@Entity 
QPrimaryKeyJoinColumn(referencedColumnName-"sid") 
public class NonTeachingStaff extends Staff 


{ 
private String areaexpertise; 
public NonTeachingStaff( int sid, String sname, 
String areaexpertise ) 
{ 
super( sid, sname ); 
this.areaexpertise = areaexpertise; 
j 
public NonTeachingStaff( ) 
{ 
super( ); 
public String getAreaexpertise( ) 
{ 
return areaexpertise; 
j 
public void setAreaexpertise( String areaexpertise ) 
{ 
this.areaexpertise = areaexpertise; 
} 
} 


Persistence.xml 


X. XML 文件 如 下 所 
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人 小 ，: 


<?xml version="1.0" encoding="UTF-8"?> 
«persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persi: 
<persistence-unit name="Eclipselink_JPA" 
transaction-type="RESOURCE_LOCAL"> 
<class>com.yiibai.eclipselink.entity.Staff</class> 
<class>com.yiibai.eclipselink.entity.NonTeachingStaff</class> 
<class>com.yiibai.eclipselink.entity.TeachingStaff</class> 
<properties> 
«property name="javax.persistence.jdbc.url" 
value="jdbc:mysql://localhost :3306/jpac 
«property name="javax.persistence.jdbc.user" value="roo1 
«property name="javax.persistence.jdbc.password" 
value="root"/> 
«property name="javax.persistence. jdbc.driver" 
value="com.mysql.jdbc.Driver"/> 
<property name="eclipselink.logging.level" value="FINE", 
«property name="eclipselink.ddl-generation" 
value-"create-tables"/» 
«/properties» 
</persistence-unit> 
</persistence> 


JE: 
服务 类 


服务 类 业务 组 件 的 实现 部 分 。 在 src 下 创建 一 个 包 com .yiibai.eclipselink.service"。 


创建 一 个 名 为 SaveClient.java 给 定 的 包 来 存储 Staff , TeachingStaff, 
NonTeachingStaff 类 来 存储 字段 。 然 后 SaveClient 类 如 下 所 示 : 





package com. yiibai.eclipselink.service; 


import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 

import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.NonTeachingStaff; 
import com.yiibai.eclipselink.entity.TeachingStaff; 


public class SaveClient 


( 


public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 


//Teaching staff entity 

TeachingStaff tsi=new TeachingStaff( 
1,"Gopal","MSc MEd","Maths"); 

TeachingStaff ts2-new TeachingStaff( 

2, "Manisha", "BSc BEd", "English"); 
//Non-Teaching Staff entity 
NonTeachingStaff ntsi=new NonTeachingStaff( 

3, "Satish", "Accounts"); 
NonTeachingStaff nts2=new NonTeachingStaff ( 
4, "Krishna", "Office Admin"); 


//storing all entities 

entitymanager.persist(ts1); 
entitymanager.persist(ts2); 
entitymanager.persist(nts1); 
entitymanager.persist(nts2); 


entitymanager.getTransaction().commit(); 


entitymanager.close(); 
emfactory.close(); 


编译 和 执行 上 述 程序 后 ， 在 Eclipse IDE 的 控制 台面 板 得 到 通知 。 对 于 输出 ， 检 查 
MySQL 工 作 台 。 


在 这 里 ， 将 创建 三 个 表 和 工作 人 员 表 的 结果 显示 在 表格 格式 。 


Sid Dtype Sname 


1 TeachingStaff Gopal 

2 TeachingStaff Manisha 
3 NonTeachingStaff Satish 

4 NonTeachingStaff Krishna 


TeachingStaff 表 的 结果 显示 如 下 : 


Sid Qualification Subjectexpertise 
1 MSC MED Maths 
2 BSC BED English 


在 上 表 中 的 sid 是 外 键 (参考 字段 工作 人 员 表 单 表 ) NonTeachingStaff 表 的 结果 显 
示 如 下 : 


Sid Areaexpertise 
3 Accounts 


4 Office Admin 


最 后 ， 使 用 各 自 字 段 中 创建 三 个 表 和 SID 字 段 由 所 有 三 个 表 共 享 。 在 员工 表 中 ，SID 
是 主键 。 在 剩 下 的 两 个 表 (TeachingStaff 和 NonTeachingStaff) ，SID 是 外 键 。 


SEP X RR 


表 每 个 类 策略 是 创建 一 个 表 中 为 每 个 子 实 体 。 Staff 表 将 被 创建 ， 但 它 会 包含 空 值 。 
Staff 表 的 字段 值 必须 同时 由 TeachingStaff 和 NonTeachingStaff 表 共享 。 


让 我 们 考虑 与 上 述 相同 的 例子 。 


创建 实体 


在 src 下 创建 一 个 名 为 “com.yiibai.eclipselink.entity' 的 包 。 创 建 一 个 名 为 Staff.java 为 
一 个 新 的 Java 类 。 Staff 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import java.io.Serializable; 

import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.Inheritance; 
import javax.persistence.InheritanceType; 
import javax.persistence.Table; 


QEntity 
QTable 
QInheritance( strategy - InheritanceType.TABLE PER CLASS ) 
public class Staff implements Serializable 
{ 
@Id 
@GeneratedValue( strategy = GenerationType.AUTO ) 
private int sid; 
private String sname; 
public Staff( int sid, String sname ) 
{ 
super( ); 
this.sid - sid; 
this.sname - sname; 


j 
public Staff( ) 
t 


super( ); 


public int getSid( ) 
{ 


return sid; 


public void setSid( int sid ) 
{ 


} 
public String getSname( ) 


{ 


this.sid = sid; 


return sname; 


public void setSname( String sname ) 


{ 
} 


this.sname = sname; 


创建 Staff 类 的 一 个 子 类 叫 TeachingStaff.java tEcom.yiibai.eclipselink.entity@ F- 
该 TeachingStaff 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.DiscriminatorValue; 
import javax.persistence.Entity; 


@Entity 
public class TeachingStaff extends Staff 
{ 

private String qualification; 

private String subjectexpertise; 


public TeachingStaff( int sid, String sname, 
String qualification, String subjectexpertise ) 


{ 
super( sid, sname ); 
this.qualification = qualification; 
this.subjectexpertise = subjectexpertise; 

} 

public TeachingStaff( ) 

{ 
super( ); 

} 

public String getQualification( ) 

{ 


return qualification; 


public void setQualification( String qualification ) 


{ 
this.qualification = qualification; 
} 
public String getSubjectexpertise( ) 
{ 
return subjectexpertise; 
} 
public void setSubjectexpertise( String subjectexpertise ) 
{ 
this.subjectexpertise = subjectexpertise; 
} 


创建 Staff 的 一 个 子 类 (类 ) 类 叫 NonTeachingStaff.java 在 
com.yiibai.eclipselink.entity 包 下 。NonTeachingStaff 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.DiscriminatorValue; 
import javax.persistence.Entity; 


@Entity 
public class NonTeachingStaff extends Staff 
{ 


private String areaexpertise; 


public NonTeachingStaff( int sid, String sname, 
String areaexpertise ) 


{ 
super( sid, sname ); 
this.areaexpertise = areaexpertise; 


} 


public NonTeachingStaff( ) 
1 


super( ); 


public String getAreaexpertise( ) 


{ 
return areaexpertise; 
j 
public void setAreaexpertise( String areaexpertise ) 
f 
this.areaexpertise - areaexpertise; 
j 


Persistence.xml 


persistence.xml 文 件 中 包含 的 实体 类 的 数据 库 和 注册 信息 的 配置 信息 。 XML 文件 如 
FB: 


<?xml version="1.0" encoding="UTF-8"?> 
«persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persi: 
<persistence-unit name="Eclipselink_JPA" 
transaction-type="RESOURCE_LOCAL"> 
<class>com.yiibai.eclipselink.entity.Staff</class> 
<class>com.yiibai.eclipselink.entity.NonTeachingStaff</class> 
<class>com.yiibai.eclipselink.entity.TeachingStaff</class> 
<properties> 
«property name="javax.persistence.jdbc.url" 
value="jdbc:mysql://localhost :3306/jpac 
«property name="javax.persistence.jdbc.user" value="roo1 
«property name="javax.persistence.jdbc.password" 
value="root"/> 
«property name="javax.persistence. jdbc.driver" 
value="com.mysql.jdbc.Driver"/> 
<property name="eclipselink.logging.level" value="FINE", 
«property name="eclipselink.ddl-generation" 
value-"create-tables"/» 
</properties> 
</persistence-unit> 
</persistence> 


JE: 
服务 类 


服务 类 业务 组 件 的 实现 部 分 。 在 src 下 创建 一 个 包 com .yiibai.eclipselink.service"。 


创建 一 个 给 定 的 包 下 名 为 SaveClient.java 用 来 存储 Staff，TeachingStaff 和 
NonTeachingStaff 类 字段 类 。 该 SaveClient 类 如 下 所 示 : 





package com. yiibai.eclipselink.service; 


import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 

import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.NonTeachingStaff; 
import com.yiibai.eclipselink.entity.TeachingStaff; 
public class SaveClient 


( 


public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 


//Teaching staff entity 
TeachingStaff tsi=new TeachingStaff( 

1, "Gopal","MSc MEd","Maths"); 
TeachingStaff ts2-new TeachingStaff( 

2, "Manisha", "BSc BEd", "English"); 
//Non-Teaching Staff entity 
NonTeachingStaff ntsi=new NonTeachingStaff ( 

3, "Satish", “Accounts ) ， 
NonTeachingStaff nts2=new NonTeachingStaff( 

4, "Krishna", "Office Admin"); 


//storing all entities 

entitymanager.persist(ts1); 
entitymanager.persist(ts2); 
entitymanager.persist(nts1); 
entitymanager.persist(nts2); 


entitymanager.getTransaction().commit(); 


entitymanager.close(); 
emfactory.close(); 


编译 并 执行 上 述 程序 后 ，Eclipse IDE 的 控制 台面 板 上 会 得 到 通知 。 对 于 输出 ， 检 查 
MySQL 的 工作 台 。 


这 里 创建 了 三 个 表 并 且 Staff 表 的 记录 为 空 。 
TeachingStaff 的 结果 显示 如 下 : 


Sid Qualification Sname Subjectexpertise 
1 MSC MED Gopal Maths 
2 BSC BED Manisha English 


上 表 TeachingStaff 包 含 Staff 和 TeachingStaff 实 体 字段 。 
NonTeachingStaff 的 结果 显示 如 下 : 
Sid Areaexpertise Sname 


3 Accounts Satish 


4 Office Admin Krishna 


上 表 NonTeachingStaff 包 含 Staff 和 NonTeachingStaff 实 体 字 段 。 


TutorialsPoint 


JPA 实 体 关 系 - JPA 教 程 


本 章 将 指导 完成 学 习 实 体 间 的 关系 。 一 般 的 关系 数据 库 中 的 表 之 间 的 更 有 效 。 这 里 
的 实体 类 都 被 视 为 关系 表 (JPA 的 概念 )， 因 此 是 实体 类 之 间 的 关系 如 下 : 


e @ManyToOne 关系 
e @OneToMany 关系 
e @OneToOne 关系 

e @ManyToMany 关系 


@ManyToOne 关系 


多 对 一 实体 之 间 存 在 的 关系 ， 其 中 一 个 实体 〈 列 或 组 列 ) 的 引用 和 与 另 一 个 实体 〈 列 
或 组 列 ) 包含 唯一 值 。 在 关系 数据 库 中 ， 这 些 关 系 是 通过 使 用 表 之 间 的 外 键 /主键 应 
用 。 

让 我 们 考虑 Employee 和 Department 实体 之 间 的 关系 的 一 个 例子 。 在 单 向 方式 ， 即 
从 员工 到 部 门 ， 多 到 一 的 关系 是 可 行 的 。 这 意味 着 员工 每 个 记录 包含 一 个 部 门 ID， 
它 应 该 是 在 部 门 表 的 主键 。 在 这 里 ， 在 Employee 表 ，Department 的 ID 是 外 键 。 


下 图 显示 了 两 个 表 之 间 的 多 对 一 关系 。 


Employee Department 


M 


* name 





在 Eclipse 中 创建 一 个 IDE JPA 项 目 命名 为 JPA_Eclipselink_MTO。 这 个 项 目的 所 有 
模块 下 面 讨论 。 


创建 实体 


遵循 用 于 创建 实体 上 面 给 出 的 图 ， 在 src 下 创 
建 "com.tutorialspoin.eclipselink.entity' 包 。 创 建 一 个 名 为 Department.java 的 类 。 类 
系 实体 如 下 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 


QEntity 
public class Department 
{ 
@Id 
QGeneratedValue( strategy=GenerationType.AUTO ) 
private int id; 
private String name; 


public int getId() 


{ 

return id; 
j 
public void setId(int id) 
{ 

this.id = id; 
j 
public String getName( ) 
{ 

return name; 
j 
public void setName( String deptName ) 
{ 

this.name = deptName; 
j 


建立 在 这 种 关系 中 的 第 二 个 实体 - 15 7; Employee.java 
在 “com.yiibai.eclipselink.entity' 包 下 的 Employee 实 体 类 。 Employee 实 体 类 如 下 所 
小 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 


import javax.persistence.ManyToOne; 


QEntity 
public class Employee 


@Id 

@GeneratedValue( strategy= GenerationType.AUTO ) 
private int eid; 

private String ename; 

private double salary; 

private String deg; 

@ManyToOne 

private Department department; 


public Employee(int eid, 
String ename, double salary, String deg) 


{ 
super( ); 
this.eid - eid; 
this.ename - ename; 
this.salary - salary; 
this.deg - deg; 

} 

public Employee( ) 

{ 


super(); 


public int getEid( ) 
{ 


return eid; 


public void setEid(int eid) 


{ 
this.eid = eid; 
j 
public String getEname( ) 
{ 


return ename; 


public void setEname(String ename) 


{ 
this.ename = ename; 
} 
public double getSalary( ) 
{ 


return salary; 


public void setSalary(double salary) 
{ 


} 


public String getDeg( ) 


this.salary = salary; 


return deg; 


public void setDeg(String deg) 


{ 


this.deg = deg; 


} 


public Department getDepartment() { 
return department; 


} 


public void setDepartment(Department department) { 
this.department = department; 


} 


Persistence.xml 


persistence.xml 文 件 需要 配置 数据 库 和 实体 类 的 注册 。 


Persitence.xml 由 Eclipse IDE 在 创建 时 由 JPA 项 目 创建 。 详 细 配 置信 息 是 用 户 的 规 
范 。 persistence.xml 文件 如 下 所 示 : 


<?xml version="1.0" encoding="UTF-8"?> 
<persistence version="2.0" 
xmins="http://java.sun.com/xml/ns/persistence" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xSi:schemaLocation="http://java.sun.com/xml/ns/persis1 
http://java.sun.com/xml/ns/persistence/persistence_2_( 
name="Eclipselink_JPA" 
transaction-type="RESOURCE_LOCAL"> 


<persistence-unit 


<class>com.yiibai. 
<class>com.yiibai. 


<properties> 
<property 


<property 
<property 


<property 


<property 
<property 


</properties> 


eclipselink. 
eclipselink. 


name="javax 


entity.Employee</class> 
entity.Department</class> 


.persistence.jdbc.url" 
value="jdbc: 
name="javax. 
name="javax. 


mysql://localhost :3306/jpadb"/> 
persistence. jdbc.user" value="roo1 
persistence. jdbc.password" 


value="root"/> 


name="javax. 


persistence. jdbc.driver" 


value="com.mysql.jdbc.Driver"/> 
name="eclipselink.logging.level" value="FINE", 
name-"eclipselink.ddl-generation" 
value="create-tables"/> 


</persistence-unit> 


</persistence> 








服务 类 


该 模块 包含 服务 类 ， 它 实现 了 使 用 属性 初始 化 关系 的 一 部 分 。 在 src 下 创建 一 个 名 
为 “com.yiibai.eclipselink.service' 包 。 创 建 一 个 名 为 ManyToOne.java 的 DAO 类 。 在 
DAO 类 如 下 所 示 : 


package com.yiibaieclipselink.service; 


import javax.persistence.EntityManager ; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.Department; 
import com.yiibai.eclipselink.entity.Employee; 


public class ManyToOne 
{ 
public static void main( String[ ] args ) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager = emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 


//Create Department Entity 

Department department - new Department(); 
department .setName("Development"); 
//Store Department 
entitymanager.persist(department); 


//Create Employeei Entity 

Employee employee1 = new Employee(); 
employee1.setEname("Satish"); 
employee1.setSalary(45000.0); 
employee1.setDeg("Technical Writer"); 
employee1.setDepartment (department); 


//Create Employee2 Entity 

Employee employee2 = new Employee(); 
employee2.setEname("Krishna"); 
employee2.setSalary(45000.0); 
employee2.setDeg("Technical writer"); 
employee2.setDepartment (department); 


//Create Employee3 Entity 

Employee employee3 - new Employee(); 
employee3.setEname("Masthanvali"); 
employee3.setSalary(50000.0); 
employee3.setDeg("Technical Writer"); 
employee3.setDepartment (department); 


//Store Employees 


entitymanager.persist(employee1); 
entitymanager.persist(employee2); 
entitymanager.persist(employee3); 
entitymanager.getTransaction().commit(); 


entitymanager.close(); 
emfactory.close(); 


编译 并 执行 上 述 程序 后 ，Eclipse IDE 控 制 台 面板 上 会 显示 的 通知 。 对 于 输出 ， 检 查 
MySQL 工 作 台 。 在 此 示例 中 ， 将 创建 两 个 表 。 


通过 在 MySQL 管 理 界面 中 执行 下 面 的 查询 ，Department 表 的 结果 显示 如 下 : 
Select * from department 


ID Name 


101 Development 


通过 在 MySQL 界 面 执行 下 面 的 查询 ，Employee 表 显示 如 下 的 结果 。 


Select * from employee 


Eid Deg Ename Salary Department Id 
102 Technical Writer Satish 45000 101 
103 Technical Writer Krishna 45000 101 
104 Technical Writer Masthanwali 50000 101 


在 上 表 中 Deparment ld 是 Department 表 的 外 键 (参考 字段 ) 。 


@OneToMany 关系 


在 这 种 关系 中 ， 一 个 实体 中 的 每 一 行 被 引用 到 其 它 实体 的 许多 子 记 录 。 最 重要 的 
是 ， 子 记录 不 能 有 多 个 父 。 在 表 A 和 表 B 之 间 的 1 对 多 的 关系 ， 在 表 A 中 的 每 一 行 都 
可 以 在 表 B 中 被 链接 到 一 个 或 多 个 行 


让 我 们 考虑 上 面 的 例子 。 假 设 Employee 和 Department 在 上 述 例子 中 的 表 连 接 在 一 
个 相反 的 单 向 方式 ， 那 么 关系 成 为 一 个 一 对 多 的 关系 。 在 Eclipse 中 创建 一 个 IDE 
JPA 项 目 命 名 JPA_Eclipselink_OTM。 这 个 项 目的 所 有 模块 下 面 讨论 。 


创建 实体 


遵循 用 于 创建 实体 上 面 给 出 的 图 ， 在 src 下 创 
建 “‘com.tutorialspoin.eclipselink.entity' 包 。 创 建 一 个 名 为 Department.java 的 类 。 类 
系 实体 如 下 : 


package com.yiibai.eclipselink.entity; 


import java.util.List; 

import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.OneToMany; 


QEntity 
public class Department 
{ 
@Id 
@GeneratedValue( strategy=GenerationType.AUTO ) 
private int id; 
private String name; 


@OneToMany( targetEntity=Employee.class ) 
private List employeelist; 


public int getId() 


{ 
return id; 
} 
public void setId(int id) 
{ 
this.id = id; 
} 
public String getName( ) 
{ 
return name; 
} 


public void setName( String deptName ) 
{ 


this.name = deptName; 


} 
public List getEmployeelist() 
{ 
return employeelist; 
} 


public void setEmployeelist(List employeelist) 
{ 


this.employeelist = employeelist; 


} 


创建 第 二 个 实体 类 关系 -Employee 实 体 类 ， 命 名 为 Employee.java 
在 “com.yiibai.eclipselink.entity' 包 下 。 Employee 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 


QEntity 
public class Employee 


( 


QId 

QGeneratedValue( strategy- GenerationType.AUTO ) 
private int eid; 

private String ename; 

private double salary; 

private String deg; 


public Employee(int eid, 
String ename, double salary, String deg) 


{ 
super( ); 
this.eid = eid; 
this.ename = ename; 
this.salary = salary; 
this.deg = deg; 

} 

public Employee( ) 

{ 


super(); 


public int getEid( ) 
{ 


return eid; 


public void setEid(int eid) 
{ 


} 


public String getEname( ) 
{ 


this.eid = eid; 


return ename; 


public void setEname(String ename) 


{ 
} 


this.ename = ename; 


public double getSalary( ) 


( 


return salary; 


public void setSalary(double salary) 


{ 
} 


this.salary = 


salary; 


public String getDeg( ) 


{ 


return deg; 


public void setDeg(String deg) 


{ 


this.deg = deg; 


} 


Persistence.xml 


persistence.xml 文 件 如 下 : 


E 


<?xml version="1.0" encoding="UTF-8"?> 
<persistence version="2.0" 
xmlns="http://java.sun.com/xml/ns/persistence" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xSi:schemaLocation="http://java.sun.com/xml/ns/persist 
http://java.sun.com/xml/ns/persistence/persistence_2_( 
name="Eclipselink_JPA" 
transaction-type="RESOURCE_LOCAL"> 


<persistence-unit 
<class>com.yiibai. 
<class>com.yiibai. 
<properties> 
<property 


<property 
<property 


<property 


<property 
<property 


</properties> 


eclipselink. 


eclipselink 


name="javax. 
value="jdbc: 


name="javax 


entity.Employee</class> 


.entity.Department«/class» 


persistence. jdbc.ur1l" 
mysql://localhost :3306/jpadb"/> 


.persistence.jdbc.user" value="roo1 
name="javax. 


persistence. jdbc.password" 


value="root"/> 


name="javax. 


persistence. jdbc.driver" 


value="com.mysql.jdbc.Driver"/> 
name="eclipselink.logging.level" value="FINE", 
name-"eclipselink.ddl-generation" 
value="create-tables"/> 


</persistence-unit> 


</persistence> 











服务 类 


该 模块 包含 服务 类 ， 它 实现 了 使 用 属性 初始 化 关系 的 一 部 分 。 在 src 下 创建 一 个 名 
为 “com.yiibai.eclipselink.service' 包 。 并 在 包 下 创建 一 个 名 为 OneToMany.java 的 
DAO 类 。 在 DAO 类 如 下 所 示 : 


package com.yiibaieclipselink.service; 


import java.util.List; 

import java.util.ArrayList; 

import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.Department; 
import com.yiibai.eclipselink.entity.Employee; 


public class OneToMany 
{ 
public static void main(String[] args) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 


//Create Employeei Entity 

Employee employee1 = new Employee(); 
employee1.setEname("Satish"); 
employee1.setSalary(45000.0); 
employee1.setDeg("Technical Writer"); 


//Create Employee2 Entity 

Employee employee2 = new Employee(); 
employee2.setEname("Krishna"); 
employee2.setSalary(45000.0); 
employee2.setDeg("Technical Writer"); 


//Create Employee3 Entity 

Employee employee3 - new Employee(); 
employee3.setEname("Masthanvali"); 
employee3.setSalary(50000.0); 
employee3.setDeg("Technical Writer"); 


//Store Employee 

entitymanager.persist(employee1); 
entitymanager.persist(employee2); 
entitymanager.persist(employee3); 


//Create Employeelist 
List<Employee> emplist = new ArrayList(); 
emplist.add(employeet) ; 


emplist.add(employee2) ; 
emplist.add(employee3) ; 


//Create Department Entity 

Department department- new Department(); 
department .setName ("Development"); 
department.setEmployeelist(emplist); 


//Store Department 
entitymanager.persist(department); 


entitymanager.getTransaction().commit(); 


entitymanager.close(); 
emfactory.close(); 


编译 和 执行 上 述 程序 后 ， 在 Eclipse IDE 的 控制 台面 板 中 得 到 通知 。 对 于 输出 检查 
MySQL 工 作 台 如 下 。 


在 这 个 项 目 中 创建 三 个 表 。 通 过 在 MySQL 界 面 查询 ，department_employee 表 的 结 
果 显 示 如 下 : 


Select * from department_Id; 


Department_ID Employee_Eid 
254 251 
254 252 
254 253 


在 上 表 中 ，deparment id 和 employee id 是 部 门 和 员工 表 的 外 键 (参考 字段 ) 。 
通过 在 MySQL 界 面 下 面 查询 ，department 表 的 结果 将 显示 如 下 表格 格式 。 


Select * from department; 


ID Name 


254 Development 
通过 在 MySQL 界 面 下 面 查询 ，employee 表 的 结果 显示 如 下 : 


Select * from employee; 


Eid Deg Ename Salary 


251 Technical Writer Satish 45000 
252 Technical Writer Krishna 45000 
253 Technical Writer Masthanwali 50000 


@OneToOne 关系 


在 一 对 一 关系 ， 一 个 项 可 以 链接 到 只 能 另 一 个 项 。 这 意味 着 一 个 实体 中 的 每 一 行 被 
称 为 一 个 且 仅 一 个 行 对 另 一 个 实体 。 


让 我 们 考虑 上 面 的 例子 。Employee 和 Department 在 反 向 单 向 的 方式 ， 关 系 是 一 对 
一 的 关系 。 这 意味 着 每 个 员工 只 能 属于 一 个 部 门 。 在 Eclipse 中 创建 一 个 IDE IPAM 
目 命名 JPA_Eclipselink_OTO。 这 个 项 目的 所 有 模块 下 面 讨论 。 


创建 实体 


遵循 用 于 创建 实体 上 面 给 出 的 图 。 在 src 下 创建 一 个 名 
为 “com.tutorialspoin.eclipselink.entity' 的 包 。 在 这 个 包 下 创建 类 名 为 : 
Department.java。 类 系 实体 被 示 为 如 下 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 


QEntity 
public class Department 
{ 
@Id 
QGeneratedValue( strategy=GenerationType.AUTO ) 
private int id; 
private String name; 


public int getId() 


{ 

return id; 
j 
public void setId(int id) 
{ 

this.id = id; 
j 
public String getName( ) 
{ 

return name; 
j 
public void setName( String deptName ) 
{ 

this.name = deptName; 
j 


创建 第 二 个 实体 类 关系 -Employee 实 体 类 ， 命 名 为 Employee.java 
在 “com.yiibai.eclipselink.entity' 包 下 。 Employee 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.OneToOne; 


QEntity 
public class Employee 


í 


@Id 

@GeneratedValue( strategy= GenerationType.AUTO ) 
private int eid; 

private String ename; 

private double salary; 

private String deg; 


@OneToOne 
private Department department; 


public Employee(int eid, 
String ename, double salary, String deg) 


{ 
super( ); 
this.eid - eid; 
this.ename - ename; 
this.salary - salary; 
this.deg - deg; 

} 

public Employee( ) 

{ 


super(); 


public int getEid( ) 
{ 


return eid; 


public void setEid(int eid) 
{ 


} 


public String getEname( ) 
{ 


this.eid = eid; 


return ename; 


public void setEname(String ename) 


{ 
this.ename = ename; 
} 
public double getSalary( ) 
{ 


return salary; 


public void setSalary(double salary) 
{ 


} 


public String getDeg( ) 


this.salary = salary; 


return deg; 


public void setDeg(String deg) 


{ 
this.deg = deg; 
} 
public Department getDepartment() 
{ 
return department; 
} 
public void setDepartment(Department department) 
{ 
this.department = department; 
} 
} 
Persistence.xml 


persistence.xml 文 件 ， 如 下 所 示 : 


<?xml version="1.0" encoding="UTF-8"?> 
<persistence version="2.0" 
xmlns-z"http://java.sun.com/xml/ns/persistence" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
XSi:schemaLocation="http://java.sun.com/xml/ns/persist 
http://java.sun.com/xml/ns/persistence/persistence 2 ( 
«persistence-unit name-"Eclipselink JPA" 
transaction-type="RESOURCE_LOCAL"> 
<class>com.yiibai.eclipselink.entity.Employee</class> 
<class>com.yiibai.eclipselink.entity.Department</class> 
<properties> 
«property name-"javax.persistence.jdbc.url" 
value="jdbc:mysql://localhost :3306/jpadb"/> 
«property name="javax.persistence.jdbc.user" value="root 
«property name="javax.persistence.jdbc.password" 
value="root"/> 
«property name="javax.persistence. jdbc.driver" 
value="com.mysql.jdbc.Driver"/> 
<property name="eclipselink.logging.level" value="FINE", 
«property name="eclipselink.ddl-generation" 
value="create-tables"/> 
</properties> 
</persistence-unit> 
</persistence> 


«| = 











服务 类 


在 src 下 创建 一 个 名 为 “com.yiibai.eclipselink.service' 的 包 。 在 这 个 包 下 创建 一 个 名 
为 OneToOne.java 的 DAO 类 。 在 DAO 类 如 下 所 示 : 


package com.yiibaieclipselink.service; 


import javax.persistence.EntityManager; 

import javax.persistence.EntityManagerFactory; 
import javax.persistence.Persistence; 

import com.yiibai.eclipselink.entity.Department; 
import com.yiibai.eclipselink.entity.Employee; 


public class OneToOne 


public static void main(String[] args) 
{ 
EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 
EntityManager entitymanager - emfactory. 
createEntityManager( ); 
entitymanager.getTransaction( ).begin( ); 


//Create Department Entity 
Department department - new Department(); 
department .setName ("Development"); 


//Store Department 
entitymanager .persist(department); 


//Create Employee Entity 

Employee employee = new Employee(); 
employee.setEname("Satish"); 
employee.setSalary(45000.0); 
employee.setDeg("Technical Writer"); 
employee.setDepartment(department); 


//Store Employee 
entitymanager.persist(employee); 


entitymanager.getTransaction().commit(); 
entitymanager.close(); 
emfactory.close(); 


编译 和 执行 上 述 程序 后 ， 在 Eclipse IDE 控 制 台 面板 的 显示 通知 。 对 于 输出 ， 检 查 
MySQL 工 作 台 如 下 。 


在 上 面 的 例子 中 ， 将 创建 两 个 表 。 通 过 在 MySQL 的 界面 下 面 的 查询 ，department 表 
的 结果 显示 如 下 : 


TutorialsPoint Java 技术 教程 
Select * from department 


ID Name 


301 Development 
通过 在 MySQL 界 面 下 面 查 询 ，employee 表 的 结果 显示 如 下 : 


Select * from employee 


Eid Deg Ename Salary Department_id 
302 Technical Writer Satish 45000 301 


@ManyToMany 关系 


多 对 多 的 关系 ， 就 是 从 一 个 实体 中 的 一 个 或 多 个 行 与 其 他 实体 的 多 个 行 相关 联 。 


让 我 们 考虑 两 个 实体 之 间 的 关系 的 一 个 例子 : 班级 和 教 病 。 以 双向 的 方式 ， 既 班级 
和 教 病 有 多 对 一 的 关系 。 这 意味 着 类 中 的 每 个 记录 由 教 病 组 (教师 ID) ， 这 应 该 是 
在 教 病 表 中 的 主键 和 存储 在 Teacher_Class 表 ， 反 之 亦 然 简称 。 在 这 里 ， 
Teachers_Class 表 包含 外 键 字段 。 在 Eclipse 中 创建 一 个 IDE JPA 项 目 命名 
JPA_Eclipselink_MTM。 这 个 项 目的 所 有 模块 下 面 讨论 。 


Teacher 


* tname 
subject 


Teacher_Class 
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创建 实体 


按照 上 面 的 图 中 所 示 的 方案 中 创建 的 实体 。 在 src 下 创建 一 个 名 
为 “com.tutorialspoin.eclipselink.entity' 的 包 。 创 建 一 个 名 为 Class.java 的 类 在 这 个 包 
下 。 类 系 实体 显示 如 下 : 


package com.yiibai.eclipselink.entity; 


import java.util.Set; 

import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.ManyToMany; 


QEntity 
public class Clas 
{ 
@Id 
@GeneratedValue( strategy = GenerationType.AUTO ) 
private int cid; 
private String cname; 


@ManyToMany(targetEntity=Teacher.class) 
private Set teacherSet; 


public Clas() 
{ 


super(); 


public Clas(int cid, 
String cname, Set teacherSet) 


{ 
super(); 
this.cid - cid; 
this.cname - cname; 
this.teacherSet - teacherSet; 
} 
public int getCid() 
{ 


return cid; 


public void setCid(int cid) 


{ 
this.cid = cid; 
j 
public String getCname() 
{ 


return cname; 


public void setCname(String cname) 


( 


this.cname = cname; 


} 
public Set getTeacherSet() 


{ 


return teacherSet; 


public void setTeacherSet(Set teacherSet) 


{ 
} 


this.teacherSet = teacherSet; 


创建 第 二 个 实体 这 种 关系 的 Employee 实 体 类 ， 命 名 为 Teacher.java 
在 “com.yiibai.eclipselink.entity' 包 下 。 Employee 实 体 类 如 下 所 示 : 


package com.yiibai.eclipselink.entity; 


import java.util.Set; 

import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 

import javax.persistence.ManyToMany; 


QEntity 
public class Teacher 
{ 
@Id 
@GeneratedValue( strategy = GenerationType.AUTO ) 
private int tid; 
private String tname; 
private String subject; 


@ManyToMany(targetEntity=Clas.class) 
private Set clasSet; 


public Teacher() 
f 


super(); 


public Teacher(int tid, String tname, String subject, 
Set clasSet) 
{ 
super(); 
this.tid = tid; 
this.tname = tname; 
this.subject = subject; 
this.clasSet = clasSet; 


public int getTid() 
{ 


return tid; 


public void setTid(int tid) 


{ 
this.tid = tid; 
j 
public String getTname() 
f 


return tname; 


public void setTname(String tname) 


{ 
this.tname = tname; 
} 
public String getSubject() 
{ 


return subject; 


public void setSubject(String subject) 


{ 
this.subject = subject; 
} 
public Set getClasSet() 
{ 


return clasSet; 


public void setClasSet(Set clasSet) 


{ 
this.clasSet = clasSet; 
} 
} 
Persistence.xml 


Persistence.xml 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<persistence version="2.0" 


xmins="http://java.sun.com/xml/ns/persistence" 

xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xSi:schemaLocation="http://java.sun.com/xml/ns/persist 
http://java.sun.com/xml/ns/persistence/persistence 2 ( 


«persistence-unit name-"Eclipselink JPA" 


transaction-type="RESOURCE_LOCAL"> 


<class>com.yiibai.eclipselink.entity.Employee</class> 
<class>com.yiibai.eclipselink.entity.Department</class> 


<properties> 
«property name="javax.persistence.jdbc.url" 
value="jdbc:mysql://localhost :3306/jpadb"/> 
«property name="javax.persistence.jdbc.user" value-'rool 
«property name="javax.persistence.jdbc.password" 
value="root"/> 
«property name="javax.persistence. jdbc.driver" 
value="com.mysql.jdbc.Driver"/> 
<property name="eclipselink.logging.level" value="FINE", 
«property name="eclipselink.dd1l-generation" 
value="create-tables"/> 
</properties> 


</persistence-unit> 
</persistence> 


E S55 


服务 类 





在 src 下 创建 一 个 名 为 “com.yiibai.eclipselink.service' 的 包 ， 在 这 个 包 下 创建 一 个 名 
为 ManyToManyjava 的 DAO 类 。 在 DAO 类 如 下 所 示 : 


package com.yiibai.eclipselink.service; 


import 
import 
import 
import 
import 
import 
import 


public 
Y 


java.util.HashSet; 

java.util.Set; 
javax.persistence.EntityManager; 
javax.persistence.EntityManagerFactory; 
javax.persistence.Persistence; 
com.yiibai.eclipselink.entity.Clas; 
com.yiibai.eclipselink.entity.Teacher; 


class ManyToMany 


public static void main(String[] args) 


( 


EntityManagerFactory emfactory - Persistence. 
createEntityManagerFactory( "Eclipselink JPA" ); 

EntityManager entitymanager - emfactory. 
createEntityManager( ); 

entitymanager.getTransaction( ).begin( ); 


//Create Clas Entity 

Clas clasi=new Clas(0,"1ist",null); 
Clas clas2-new Clas(0,"2nd",null); 
Clas clas3-new Clas(0,"3rd",nu11); 


//Store Clas 

entitymanager.persist(clas1); 
entitymanager.persist(clas2); 
entitymanager.persist(clas3); 


//Create Clas Seti 

Set«Clas» classSet1 = new HashSet(); 
classSet1.add(clas1); 
classSet1.add(clas2); 
classSet1.add(clas3); 


//Create Clas Set2 

Set<Clas> classSet2 = new HashSet(); 
classSet2.add(clas3); 
classSet2.add(clas1); 
classSet2.add(clas2); 


//Create Clas Set3 

Set«Clas» classSet3 - new HashSet(); 
classSet3.add(clas2); 
classSet3.add(clas3); 
classSet3.add(clas1); 


//Create Teacher Entity 

Teacher teacheri = new Teacher(0, 
"Satish","Java",classSet1); 

Teacher teacher2 = new Teacher(0, 
"Krishna","Adv Java",classSet2); 

Teacher teacher3 = new Teacher(0, 
"Masthanvali", DB2",classSet3); 


//Store Teacher 

entitymanager.persist(teacher1); 
entitymanager.persist(teacher2); 
entitymanager.persist(teacher3); 


entitymanager.getTransaction( ).commit( ); 
entitymanager.close( ); 
emfactory.close( ); 


在 这 个 例子 中 工程 ， 将 创建 三 个 表 。 通 过 在 MySQL 界 面 执行 下 面 的 查询 ， 
teacher_clas 表 将 显示 如 下 的 结果 : 


Select * form teacher_clas 


Teacher_tid Classet_cid 
354 351 
355 351 
356 351 
354 352 
355 352 
356 352 
354 353 
355 353 
356 353 


在 上 表 中 teacher tid 是 从 eacher 表 的 外 键 ，classet_cid 是 class 表 的 外 键 。 因 此 不 同 
的 老病 被 分 配 到 不 同 的 班级 。 


通过 在 MySQL 的 界面 下 面 的 查询 ，teacher 表 的 结果 显示 如 下 : 


Select * from teacher 


Tid Subject Tname 
354 Java Satish 
355 Adv Java Krishna 
356 DB2 Masthanvali 


通过 在 MySQL 的 界面 执行 下 面 的 查询 , clas 表 将 显示 如 下 的 结果 : 


Select * from clas 


Cid Cname 
351 1st 
352 2nd 
353 3rd 


JPA 标 准 API - JPAA T= 


标准 是 用 来 定义 查询 实体 的 预定 义 API。 它 是 定义 JPQL 坦 询 的 另 一 种 方式 。 这 些 查 
询 是 类 型 安全 的 ， 可 移植 的 ， 类 似 于 JPQL， 它 
遵循 的 抽象 模式 (容易 编辑 模式 ) 和 艇 入 的 对 象 。 元 数据 API 是 夹杂 着 标准 的 API 模 型 
持久 性 实体 的 标准 查询 。 


标准 的 API 的 主要 优点 是 ， 错 误 可 以 较 早 在 编译 时 被 检测 到 。 基 于 字符 串 JPQL 查 询 
和 基于 查询 JPA 的 范围 是 在 性 能 和 效率 相同 。 


标准 API 历 史 


该 标准 被 纳入 因此 标准 的 每 一 步 中 JPA 的 规范 通知 所 有 版 本 JPA。 


e 在 JPA2.0 中 ， 标 准 查询 APl， 查 询 的 标准 化 开发 。 
e 在 JPA2.1， 标 准 更 新 和 删除 (批量 更 新 和 删除 ) 都 包括 在 内 


标准 查询 结构 
该 标准 与 JPQL 是 密切 相关 的 ， 并 允许 使 用 类 似 的 操作 符 在 他 们 的 查询 设计 。 它 遵 
adu quu NU 询 。 查 询 结 构 指 的 语法 条 件 查询 。 

面 简单 的 条 件 查 询 返 回 数据 源 中 的 实体 类 的 所 有 实例 。 


EntityManager em =... 

CriteriaBuilder cb = em. Mee tCni eae MENS 
CriteriaQuery<Entity class» cq = cb.createQuery(Entity.class); 
Root<Entity> from = cq.from(Entity.class); 

cq.select(Entity); 

TypedQuery<Entity> q = em.createQuery(cq); 

List<Entity> allitems = q.getResultList(); 


查询 演示 了 基本 的 步骤 来 创建 一 个 标准 。 
e EntityManager 实 例 被 用 来 创建 一 个 CriteriaBuilder 对 象 。 


e CriteriaQuery 实 例 是 用 来 创建 一 个 查询 对 象 。 这 个 查询 对 象 的 属性 将 与 该 查询 
的 细节 进行 修改 。 


e CriteriaQuery.form 方 法 被 调用 来 设置 查询 根 。 
e CriteriaQuery.select 被 调用 来 设置 结果 列表 类 型 。 
e TypedQuery<T> 实 例 是 用 来 准备 一 个 查询 执行 和 指定 的 查询 结果 的 类 型 。 


e 在 TypedQuery<T> 对 象 getResultList 方 法 来 执行 查询 。 该 查询 返回 实体 的 集 
合 ， 结 果 存 储 在 一 个 列表 中 。 


标准 API 示 例 


让 我 们 考虑 employee 数据 库 的 例子 。 让 我 们 假定 该 jpadb.employee 表 包含 以 下 记 
c 


Eid Ename Salary Deg 

401 Gopal 40000 Technical Manager 
402 Manisha 40000 Proof reader 

403 Masthanvali 35000 Technical Writer 
404  Satish 30000 Technical writer 
405 Krishna 30000 Technical Writer 
406 Kiran 35000 Proof reader 


Z 4 JPA Eclipselink Criteria Eclipse IDE 中 创建 JPA 项 目 。 这 个 项 目的 所 有 模块 
下 面 讨 论 : 


创建 实体 
在 'src' 中 创建 包 名 为 com.yiibai.eclipselink.entity 
创建 一 个 名 为 Employee.java 类 。Employee 实 体 如 下 图 所 示 : 


package com.yiibai.eclipselink.entity; 


import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 


QEntity 
public class Employee 
{ 
@Id 
@GeneratedValue(strategy= GenerationType.AUTO) 
private int eid; 
private String ename; 
private double salary; 
private String deg; 
public Employee(int eid, String ename, double salary, String det 
{ 
super( ); 
this.eid - eid; 
this.ename - ename; 
this.salary - salary; 
this.deg - deg; 


} 


public Employee( ) 
1 


super(); 


public int getEid( ) 
{ 


return eid; 


public void setEid(int eid) 


{ 
this.eid = eid; 
} 
public String getEname( ) 
{ 


return ename; 


public void setEname(String ename) 


{ 
this.ename = ename; 
} 
public double getSalary( ) 
{ 


return salary; 


public void setSalary(double salary) 


{ 
this.salary = salary; 
j 
public String getDeg( ) 
{ 


return deg; 

} 

public void setDeg(String deg) 
this.deg = deg; 


@Override 
public String toString() { 
return "Employee [eid=" + eid + ", ename=" + ename + ", sal: 
+ salary + ", deg=" + deg + "J"; 
} 
} 


«| 











Persistence.xml 


Persistence.xml 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

«persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persi: 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation-"http://java.sun.com/xml/ns/persisi 


http://java. 


sun.com/xml/ns/persistence/persistence 2 ( 


<persistence-unit name="Eclipselink_JPA" 


<class>com.yiibai. 


加 ES 


服务 类 


<properties> 


<property 


<property 
<property 


<property 


<property 
<property 


transaction-type="RESOURCE_LOCAL"> 
eclipselink.entity.Employee</class> 


name-z"javax.persistence.jdbc.url" 


value="jdbc:mysql://localhost :3306/jpadb"/> 


name="javax.persistence.jdbc.user" value="root 
name="javax.persistence. jdbc.password" 


value="root"/> 


name="javax.persistence. jdbc.driver" 


value="com.mysql.jdbc.Driver"/> 


name="eclipselink.logging.level" value="FINE", 
name-"eclipselink.ddl-generation" 


value="create-tables"/> 


</properties> 
</persistence-unit> 
</persistence> 





该 模块 包含 服务 类 ， 它 实现 了 使 用 元 数据 API 的 初始 化 条 件 查询 的 一 部 分 。 创 建 一 
个 名 为 “com.yiibai.eclipselink.service' 包 。 在 这 个 包 下 创建 一 个 类 CriteriaAPl.java。 
在 DAO 类 如 下 所 示 : 


package com.yiibai.eclipselink.service; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


public 
{ 


java.util.List; 


javax. 
javax. 
javax. 
javax. 
javax. 
javax. 
javax. 


persistence. 
persistence. 
persistence. 
persistence. 
persistence. 
persistence. 
persistence. 


EntityManager; 
EntityManagerFactory; 
Persistence; 

TypedQuery; 
criteria.CriteriaBuilder; 
criteria.CriteriaQuery; 
criteria.Root; 


com. yiibai.eclipselink.entity.Employee; 


class 


CriteriaApi 


public static void main(String[] args) 


{ 


EntityManagerFactory emfactory = Persistence. 
createEntityManagerFactory( "Eclipselink_JPA" ); 


EntityManager entitymanager = emfactory. 
createEntityManager( ); 

CriteriaBuilder criteriaBuilder = entitymanager 
.getCriteriaBuilder(); 

CriteriaQuery<Object> criteriaQuery = criteriaBuilder 
.createQuery(); 

Root«Employee» from = criteriaQuery.from(Employee.class); 


//select all records 

System.out.println("Select all records"); 

CriteriaQuery<Object> select -criteriaQuery.select(from); 

TypedQuery<Object> typedQuery = entitymanager 
.createQuery(select); 

List«Object» resultlist= typedQuery.getResultList(); 


for(Object o:resultlist) 


{ 
Employee e=(Employee)o; 
System.out.println("EID : "+e.getEid() 
+" Ename : "-e.getEname( )); 
} 


//Ordering the records 
System.out.println(“Select all records by follow ordering” 
CriteriaQuery<Object> select1 = criteriaQuery.select(from); 
selecti.orderBy(criteriaBuilder.asc(from.get("ename"))); 
TypedQuery<Object> typedQuery1 = entitymanager 
.createQuery(select); 
List«Object» resultlisti- typedQuery1.getResultList(); 


for(Object o:resultlisti) 


{ 
Employee e=(Employee)o; 
System.out.println("EID : "+e.getEid() 
+" Ename : "+e.getEname()); 
} 


entitymanager.close( ); 
emfactory.close( ); 





编译 和 执行 上 述 程序 后 ， 将 在 Eclipse IDE 的 控制 台面 板 输出 下 面 的 内 容 。 


SE All ECG 

EID : 401 Ename : Gopal 

EID : 402 Ename : Manisha 

EID : 403 Ename : Masthanvali 
EID : 404 Ename : Satish 

EID : 405 Ename : Krishna 

EID 406 Ename Kiran 
select All records by follow Ordering 
EID : 401 Ename : Gopal 

EID : 406 Ename : Kiran 

EID : 405 Ename : Krishna 

EID : 402 Ename : Manisha 

EID : 403 Ename : Masthanvali 
EID : 404 Ename : Satish 


JSP 教程 


JSP 基础 


JSP 简介 


什么 是 Java Server Pages? 


JSP 全 称 Java Server Pages， 是 一 种 动态 网 页 开发 技术 。 它 使 用 JSP 标 签 在 HTML 
网 页 中 插入 Java 人 代码。 标签 通常 以 <% 开 头 以 %> 结 束 。 


JSP 是 一 种 Java servlet， 主 要 用 于 实现 Java web 应 用 程序 的 用 户 界 面部 分 。 网 页 开 
发 者 们 通过 结合 HTML 代 码 、XHTML 代 码 、XML 元 素 以 及 炭 和 人 JSP 操作 和 命令 来 编 
BJSP. 


JSP 通 过 网 页 表单 获取 用 户 输入 数据 、 访 问 数据 库 及 其 他 数据 源 ， 然 后 动态 地 创建 
网 页 。 


JSP 标 签 有 多 种 功能 ， 比 如 访问 数据 库 、 记 录用 户 选择 信息 、 访 问 JavaBeans 组 件 
等 ， 还 可 以 在 不 同 的 网 页 中 传递 控制 信息 和 共享 信息 。 


为 什么 使 用 JSP ? 


JSP 程 序 与 CGI 程序 有 着 相似 的 功能 ， 但 和 CGI 程序 相 比 ，JSP 程 序 有 如 下 优势 : 


e Eau Al% JSP RT LABHEHTMLA n FP zb ARATE OR 
引用 CGI 文件 。 

e 服务 器 调用 的 是 已 经 编译 好 的 JSP 文 件 ， 而 不 像 CGI/Perl 那 样 必须 先 载 入 解释 
器 和 目标 脚本 。 

e JSP 基 于 Java Servlets API， 因 此 ，JSP 拥 有 各 种 强大 的 企业 级 Java API, € 
括 JDBC，JNDI，EJB，JAXP 等 等 。 

e JSP 页 面 可 以 与 处 理 业务 逻辑 的 servlets 一 起 使 用 ， 这 种 模式 被 Java servlet 模 
板 引 警 所 支持 。 


最 后 ，JSP 是 Java EE 不 可 或 缺 的 一 部 分 ， 是 一 个 完整 的 企业 级 应 用 平台 。 这 意味 
着 JSP 可 以 用 最 简单 的 方式 来 实现 最 复杂 的 应 用 。 


JSP 的 优势 


以 下 列 出 了 使 用 JSP 带 来 的 其 他 好 处 : 


e 与 ASP 相 比 : JSP 有 两 大 优势 。 首 先 ， 动 态 部 分 用 Java 编 写 ， 而 不 是 VB 或 其 他 
MS 专 用 语言 ， 所 以 更 加 强大 与 易 用 。 第 二 点 就 是 JSP 易 于 移植 到 非 MS 平 台 
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e 与 纯 Servlets 相 比 : JSP 可 以 很 方便 的 编写 或 者 修改 HTML 网 页 而 不 用 去 面 对 
大 量 的 println 语 句 。 

。 与 SSI 相 比 : SSI 无 法 使 用 表单 数据 、 无 法 进行 数据 库 链 接 。 

e 与 JavaScript 相 比 : 虽然 JavaScript 可 以 在 客户 端 动 态 生 成 HTML， 但 是 很 难 与 


服务 器 交互 ， 因 此 不 能 提供 复杂 的 服务 ， 比 如 访问 数据 库 和 图 像 处 理 等 等 。 
e 与 静态 HTML 相 比 : 静态 HTML 不 包含 动态 信息 。 


接 下 来 呢 ? 
我 们 将 会 带 您 一 步 一 步 地 来 搭建 JSP 运 行 环境 ， 这 需要 有 一 定 的 Java 基 础 。 
如 果 您 还 未 学 过 Java， 可 以 先 学 习 我 们 为 您 提供 的 Java 教 程 。 


JSP 开发 环境 搭建 


JSP 开 发 环境 是 您 用 来 开发 、 测 试 和 运行 JSP 程 序 的 地 方 。 
本 节 将 会 带 您 搭建 JSP 开 发 环境 ， 具 体 包 括 以 下 几 个 步骤 。 


配置 Java 开 发 工具 (JDK) 


一 步 涉 及 Java SDK 的 下 载 和 PATH 环境 变量 的 配置 。 
您 可 以 从 Oracle 公 司 的 Java 页 面 中 下 载 SDK : Java SE Downloads 


Java SDK 下 载 完 后 ， 请 按照 给 定 的 指示 来 安装 和 配置 SDK。 最 后 ， "d 了 设置 PATH 
和 JAVA_HOME 环 境 变量 来 指明 包括 java 和 javac 的 文件 夹 路 径 ， 通 常 
java_install_diwbin 和 java_install_dir。 


假如 您 用 的 是 Windows 系 统 并 且 SDK 的 安装 目录 为 C:NMjdk1.5.0 _ 20， 那么 您 就 需要 
在 C:\autoexec.bat 文件 中 添加 以 下 两 行 : 


set PATH=C:\jdk1i.5.0_20\bin;%PATH% 
set JAVA_HOME=C:\jdk1.5.0_20 


或 者 ， 在 Windows NT/2000/XP 下 ， 您 可 以 直接 右 击 我 的 电脑 图 标 ， 选 择 属 性 ， 然 
后 高 级 ， 然 后 环境 变量 ， 接 下 来 您 就 可 以 很 方便 地 设置 PATH 变量 并 且 确 定 退 出 就 
行 了 。 


如 果 SDK 的 安装 目录 7j lusr/local/jdk1 .5.0_20 并 且 使 用 的 是 C 
shell, 么 您 ; A mss SRI. cshrc 文 件 中 添加 以 下 两 行 : 


setenv PATH /usr/local/jdk1.5.0 20/bin:$PATH 
setenv JAVA HOME /usr/local/jdk1.5.0_20 


或 者 ， 假 如 您 正在 使 用 类 似 于 Borland JBuilder, Eclipse, IntelliJ IDEA 和 Sun ONE 
Studioit JE IRB £F, 可 以 试 着 编译 并 运行 一 个 简单 的 程序 来 确定 IDE ( 集 
成 开发 环境 ) 是 否 已 经 知道 SDK 的 安装 目录 。 


本 步骤 你 也 可 以 参考 本 站 Java 开 发 环境 配置 章节 的 教程 。 
x faWebik 42s : Tomcat 


目前 ， 市 场 上 有 很 多 支持 JSP 和 Servlets 开 发 的 Web 服 务 器 。 他 们 中 的 一 些 可 以 免 
费 下 载 和 使 用 ，Tomcat 就 是 其 中 之 一 。 
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Apache Tomcat 是 一 个 开源 软件 ， 可 作为 独立 的 服务 器 来 运行 JSP 和 Servlets， 也 可 
以 集成 在 Apache Web Server 中 。 以 下 是 Tomcat 的 配置 方法 : 


e 下 载 最 新 版 本 的 Tomcat : http://tomcat.apache.org/. 


e 下 载 完 安装 文件 后 ， 将 压缩 文件 解压 到 一 个 方便 的 地 方 ， 比 如 Windows 下 的 
C'apache-tomcat-5.5.29 El 3t SX xrLinux/Unix F ÉS/usr/local/apache-tomcat- 
5.5.29 目 录 ， 然 后 创建 CATALINA_HOME 环 境 变量 指向 这 些 目录 。 


在 Windows 机 器 下 ，Tomcat 可 以 通过 执行 以 下 命令 来 启动 : 


%CATALINA_HOME%\bin\startup.bat 
或 者 
C:\apache-tomcat-5.5.29\bin\startup.bat 


在 Linux/Unix 机 器 下 ，Tomcat 可 以 通过 执行 以 下 命令 来 启动 : 


$CATALINA_HOME/bin/startup.sh 
或 者 
/usr/local/apache-tomcat-5.5.29/bin/startup.sh 


成 功 启动 Tomcat 后 ， 通 过 访问 http:Wlocalhost:8080/ 便 可 以 使 用 Tomcat 自 带 的 一 些 
web 应 用 了 。 假 如 一 切 顺利 的 话 ， 您 应 该 能 够 看 到 以 下 的 页 面 : 


` The Apache Software Foundation 
http://www.apache.org/ 
If you're seeing this page via a web browser, It means you've setup Tomcat successfully, Congratulations! 
AS you may have guessed by now, this is the defaut Temeal home page. E can be found en he lacs! Fesystem at 
SCATALINA_HOME/webapps/ROOT/ index.html 
where “SCATALINA_MOME™ is the root of the Tamcst installation directory. H you're seeing tis page. and you dent think you should 
ba, then you're amher a user who has armed at new instalation of Tomcat, ec you're an administrator who hasnt got shar setup quite 


right Providing the later is the case, please reler to the Tomcat Docunertation for more desalted setup and admrnistalion infomation 
than is found in the INSTALL file 


NOTE: For security reasons, Saing = manager webapp is restricted to users with role "manager". Users are defined in 
SCATAL INA POND (ore £/tomcet-usere 


Induded with vs release are à host of sample Servels and JSPs (wilh associated source code], extensive documentation, and an 
introductory guide to developing web appicabans. 


Tomcat mæling lists are avaiable at tfe Tomcat proynct weh ste 


» Usorsgisomcatapache.org for general questions related te configuring and using Tomcat 
» dovgitomcatapache.org for developers warking on Temecal 


Thanks for using Tomcat! 
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更 多 关于 配置 和 运行 Tomcat 的 信息 可 以 在 Tomcat 提 供 的 文档 中 找到 ， 或 者 去 
Tomcat 官 网 查阅 : http:/tomcat.apache.org。 


在 Windows 机 器 下 ，Tomcat 可 以 通过 执行 以 下 命令 来 停止 
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%CATALINA_HOME%\bin\shutdown 
或 者 
C:\apache-tomcat-5.5.29\bin\shutdown 


在 Linux/Unix 机 器 下 ，Tomcat 可 以 通过 执行 以 下 命令 来 停止 


$CATALINA_HOME/bin/shutdown.sh 
或 者 
/usr/local/apache-tomcat-5.5.29/bin/shutdown.sh 


X TS CLASSPATH:415 x & 


由 于 servlets 不 是 Java SE 的 一 部 分 ， 所 以 您 必须 标示 出 servlet 类 的 编译 器 。 
假如 您 用 的 是 Windows 机 器 ， 您 需要 在 C:\autoexec.bat 文 件 中 添加 以 下 两 行 : 


set CATALINA=C:\apache-tomcat-5.5.29 
set CLASSPATH=%CATALINA%\common\lib\jsp-api.jar;%CLASSPATH% 


或 者 ， 在 Windows NT/2000/XP 下 ， 您 只 要 右 击 我 的 电脑 ， 选 择 属性 ， 然 后 点 击 高 
级 ， 然 后 点 击 环 境 变 量 ， 接 下 来 便 可 以 设置 CLASSPATH 变 量 并 且 确 定 退 出 即 可 。 


在 Linux/Unix 机 器 下 ， 假 如 您 使 用 的 是 C shell， 那 么 您 就 需要 在 .cshrc 文 件 中 添加 以 
下 两 行 : 


setenv CATALINA=/usr/local/apache-tomcat-5.5.29 
setenv CLASSPATH $CATALINA/common/1lib/jsp-api.jar:S$CLASSPATH 


注意 : aes n iem \JSPDev (Windows) /usr/JSPDev (Linux/Unix), 
那么 您 就 需要 将 这 些 路 径 圣 添 力 SECLASSPATH 变量 中 。 


JSP 结构 
网 络 服务 器 需要 一 个 JSP 引 擎 ， 也 就 是 一 个 容器 来 处 理 JSP 页 面 。 容 器 负责 截获 对 
JSP 页 面 的 请 求 。 本 教程 使 用 内 岩 JSP 容 器 的 Apache 来 支持 JSP 开 发 。 


JSP 容 器 与 Web 服 务 器 协同 合作 ， 为 JSP 的 正常 运行 提供 必要 的 运行 环境 和 其 他 服 
务 ， 并 且 能 够 正确 识别 专属 于 JSP 网 页 的 特殊 元 素 。 


下 图 显示 了 JSP 容 器 和 JSP 文 件 在 Web 应 用 中 所 处 的 位 置 。 


Typical Web server Web 
supporting JSP server 


Client 





ISP files < 一 一 
stored here ! ( Web server) 


JSP A Hg 


以 下 步骤 表明 了 Web 服 务 器 是 如 何 使 用 JSP 来 创建 网 页 的 : 


就 像 其 他 普通 的 网 页 一 样 ， 您 的 浏览 器 发 送 一 个 HTTP 请 求 给 服务 器 。 
Web 服 务 器 识别 出 这 是 一 个 对 JSP 网 页 的 请 求 ， 并 且 将 该 请 求 传递 给 JSP 引 
擎 。 通 过 使 用 URL 或 者 .jsp 文 件 来 完成 。 

JSP 引 警 从 磁盘 中 载 入 JSP 文 件 ， 然 后 将 它们 转化 为 servlet。 这 种 转化 只 是 简 
单 地 将 所 有 模板 文本 改 用 println() 语 句 ， 并 且 将 所 有 的 JSP 元 素 转 化 成 Java 代 
码 。 

JSP 引 擎 将 servlet 编 译 成 可 执行 类 ， 并 且 将 原始 请 求 传递 给 servlet 引 | 擎 。 
Web 服 务 器 的 某 组 件 将 会 调用 servlet 引 擎 ， 然 后 载 入 并 执行 Servlet 类 。 在 执行 
过 程 中 ，servlet 产 生 HTML 格 式 的 输出 并 将 其 内 岩 于 HTTP response 中 上 交 给 
Webik 4-28. 

Web 服 务 器 以 静态 HTML 网 页 的 形式 将 HTTP response 返 回 到 您 的 浏览 器 中 。 
e 最 终 ，Web 浏 览 器 处 理 HTTP response 中 动态 产生 的 HTML 网 页 ， 就 好 像 在 外 
理 静 态 网 页 一 样 。 


以 上 提 及 到 的 步骤 可 以 用 下 图 来 表示 : 


hello, jsp 


Server with 
JSP Container o 
Translation 
Client he. > phase 
helloServlet.java 
(1) GET /hello.jsp o Generate 
& [6] Compile < 
chiml>Hellol</html> " 


“@ F 
Request 
helloServlet.dass processing 
phase 


一 般 情 况 下 ，JSP 引 擎 会 检查 JSP 文 件 对 应 的 servlet 是 否 已 经 存在 ， 并 且 检 查 JSP 
文件 的 修改 日 期 是 否 早 于 servlet。 如 果 JSP 文 件 的 修改 日 期 早 于 对 应 的 servlet， 那 
么 容器 就 可 以 确定 JSP 文 件 没有 被 修改 过 并 且 servlet 有 效 。 这 使 得 整个 流程 与 其 他 
脚本 语言 (比如 PHP) 相 比 要 高 效 快捷 一 些 。 


总 的 来 说 ，JSP 网 页 就 是 用 另 一 种 方式 来 编写 servlet 而 不 用 成 为 Java 编 程 高 手 。 除 
了 解释 阶段 外 ，JSP 网 页 几乎 可 以 被 当成 一 个 普通 的 servlet 来 对 待 。 


JSP 生命 周期 


理解 JSP 底 层 功 能 的 关键 就 是 去 理解 它们 所 遵守 的 生命 周期 。 


JSP 生 命 周期 就 是 从 创建 到 销毁 的 整个 过 程 ， 类 似 于 servlet 生 命 周期 ， 区 别 在 于 
JSP 生 命 周 期 还 包括 将 JSP 文 件 编译 成 servlet。 


以 下 是 JSP 生 命 周 期 中 所 走 过 的 几 个 阶段 : 
。 编译 阶段 : 
servlet 容 器 编译 servlet 源 文件 ， 生 成 servlet 类 
初始 化 阶段 : 
加 载 与 JSP 对 应 的 servlet 类 ， 创 建 其 实例 ， 并 调用 它 的 初始 化 方法 
执行 阶段 : 
调用 与 JSP 对 应 的 servlet 实 例 的 服务 方法 
e 销毁 阶段 : 
调用 与 JSP 对 应 的 servlet 实 例 的 销毁 方法 ， 然 后 销毁 servlet 实 例 


很 明显 ，JSP 生 命 周期 的 四 个 主要 阶段 和 servlet 生 命 周期 非常 相似 ， 下 面 给 出 图 
小 : 


EEE 


' Initialization 
' 
LI 





gt 


i request lifecycle ! 
i 

LI 
+ 


i Request 


Main logic 


ee ee 


I 


' 
! Shutdown 
' 


JSP 44 it 


当 浏 览 器 请 求 JSP 页 面 时 ，JSP 引 警 会 首先 去 检查 是 否 需要 编译 这 个 文件 。 如 果 这 
个 文件 没有 被 编译 过 ， 或 者 在 上 次 编译 后 被 更 改过 ， 则 编译 这 个 JSP 文 件 。 


编译 的 过 程 包括 三 个 步骤 : 


e 解析 JSP 文 件 。 
e 将 JSP 文 件 转 为 servlet。 
e 编译 Servlet。 


JSP 初 始 化 


容器 载 人 JSP 文件 后 ， 它 会 在 为 请 求 提供 任何 服务 前 调用 jsplnit() 方 法 。 如 果 您 需要 
执行 自 定义 的 JSP 初 始 化 任务 ， 复 写 jsplnit() 方 法 就 行 了 ， 就 像 下 面 这 样 : 


public void jspInit(){ 
// 初始 化 代码 
} 


一 般 来 讲 程序 只 初始 化 一 次 ，servlet 也 是 如 此 。 通 常情 况 下 您 可 以 在 jsplnit() 方 法 中 
初始 化 数据 库 连 接 、 打 开 文 件 和 创建 查询 表 。 


JSP 执 行 


这 一 阶段 描述 了 JSP 生 命 周 期 中 一 切 和 与 请 求 相关 的 交互 行为 ， 直 到 被 销毁 。 

当 JSP 网 页 完成 初始 化 后 ，JSP 引 擎 将 会 调用 _jspService() 方 法 。 

_jspService() 方 法 需要 一 个 HttpServletRequest 对 象 和 一 个 HttpServletResponse 对 
象 作 为 它 的 参数 ， 就 像 下 面 这 样 : 


void _jspService(HttpServletRequest request, 
HttpServletResponse response) 


// 服务 端 处 理 代码 


_jspService() 方 法 在 每 个 request 中 被 调用 一 次 并 且 负 责 产 生 与 之 相对 应 的 
response， 并 且 它 还 负责 产生 所 有 7 个 HTTP 方 法 的 回应 ， 比 如 GET、POST、 
DELETE 等 等 。 


JSP 清 理 


JSP 生 命 周期 的 销毁 阶段 描述 了 当 一 个 JSP 网 页 从 容器 中 被 移 除 时 所 发 生 的 一 切 。 


jspDestroy() 方 法 在 JSP 中 等 价 于 servlet 中 的 销毁 方法 。 当 您 需要 执行 任何 清理 工作 
时 复写 jspDestroy() 方 法 ， 上 比如 释放 数据 库 连 接 或 者 关闭 文件 夹 等 等 。 


jspDestroy() 方 法 的 格式 如 下 : 


public void jspDestroy() 


// 清理 代码 


实例 
JSP 生 命 周期 代码 实例 如 下 所 示 : 


«949 page contentType="text/html; charset=GB2312" %> 
<html><head><title>life. jsp</title></head><body> 


<%! 
private int initVar=0; 
private int serviceVar=0; 
private int destroyVar=0; 
%> 


<%! 
public void jspInit(){ 
initVar++; 
System.out.println("jspInit(): JSP 被 初始 化 了 "+initVar+" 次 ") 


public void jspDestroy(){ 

destroyVar++; 

System.out.println("jspDestroy(): JSP% T "«destroyVar*" 7k"); 
} 


%> 


<% 
serviceVar++; 
System.out.println(" jspService(): JSP 共 响应 了 "+ServiceVar+" 次 请 求 " 


String content1=" 初 始 化 次 数 : "+initVar ; 
String content2=" 响 应 客户 请 求 次 数 : "+servicevar; 
String content3=" 销 毁 次 数 : "+destroyVar; 

%> 


<hi><%=content1 %></h1> 
<hi><%=content2 %></h1> 
<hi><%=content3 %></h1> 


«/body»«/html» 
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JSP 语法 


本 小 节 将 会 简单 地 介绍 一 下 JSP 开 发 中 的 基础 语法 。 


脚本 程序 


脚本 程序 可 以 包含 任意 量 的 Java 语 句 、 变 量 、 方 法 或 表达 式 ， 只 要 它们 在 脚本 语言 
中 是 有 效 的 。 


脚本 程序 的 语法 格式 : 


<% 代码 片段 %> 


或 者 ， 您 也 可 以 编写 与 其 等 价 的 XML 语句 ， 就 像 下 面 这 样 : 


<jsp:scriptlet> 
代码 片段 
</jsp:scriptlet> 


任何 文本 、HTML 标 签 、JSP 元 素 必须 写 在 脚本 程序 的 外 面 。 
下 面 给 出 一 个 示例 ， 同 时 也 是 本 教程 的 第 一 个 JSP 示 例 : 


<html> 

<head><title>Hello World</title></head> 

<body> 

Hello World!<br/> 

<% 

out.println("Your IP address is " + request.getRemoteAddr()); 
%> 

</body> 

</html> 


注意 : 请 确保 Apache Tomcat 已 经 安装 在 Capache-tomcat-7.0.2 目 录 下 并 且 运 行 环 
境 已 经 正确 设置 。 


将 以 上 代码 保存 在 hellojsp 中 ， 然 后 将 它 放置 在 C:\apache-tomcat- 
7.0.2\webapps\ROOT 目 录 下 ， 打 开 浏 览 器 并 在 地 址 栏 中 输入 
http://localhost:8080/hello.jsp。 运 行 后 得 到 以 下 结果 : 


i Hello World - Windows 





| [«] http://localhost:8080/hello.jsp 
Hello World 


Hello World! 
Your IP address is 127.0.0.1 


JSP = AA 


一 个 声明 语句 可 以 声明 一 个 或 多 个 变量 、 方 法 ， 供 后 面 的 Java 代 码 使 用 。 在 JSP 文 
件 中 ， 您 必须 先 声 明 这 些 变量 和 方法 然后 才能 使 用 它们 。 


JSP 声 明 的 语法 格式 : 
<%! declaration; [ declaration; ]+ ... %> 


或 者 ， 您 也 可 以 编写 与 其 等 价 的 XML 语句 ， 就 像 下 面 这 样 : 


<jsp:declaration> 
代码 片段 
</jsp:declaration> 


程序 示例 : 


<%! int i = 0; %> 
<%! int a, b, c; %> 
<%! Circle a = new Circle(2.0); %> 


JSP 表 达 陈 


一 个 JSP 表 达 式 中 包含 的 脚本 语言 表达 式 ， 先 被 转化 成 String， 然 后 插入 到 表达 式 
出 现 的 地 方 。 


由 于 表达 式 的 值 会 被 转化 成 String， 所 以 您 可 以 在 一 个 文本 行 中 使 用 表达 式 而 不 用 


去 管 它 是 否 是 HTML 标 签 。 


表达 式 元 素 中 可 以 包含 任何 符合 Java 语 言 规范 的 表达 式 ， 但 是 不 能 使 用 分 号 来 结 


JSP 表 达 式 的 语法 格式 : 


<%= 表达 式 9 


同样 ， 您 也 可 以 编写 与 之 等 价 的 XML 语句 : 


<jsp:expression> 
表达 式 
</jsp:expression> 


程序 示例 : 


«html» 

<head><title>A Comment Test</title></head> 

<body> 

<p> 

Today's date: <%= (new java.util.Date()).toLocaleString( )%> 

</p> 

</body> 

</html> 


运行 后 得 到 以 下 结果 : 


Today's date: 11-Sep-2013 21:24:25 


JSP 注 释 
JSP 注 释 主 要 有 两 个 作用 : 为 代码 作 注释 以 及 将 某 段 代码 注释 掉 。 
JSP 注 释 的 语法 格式 : 


<%-- 这 里 可 以 填写 JSP 注释 --%> 


程序 示例 : 


<html> 

<head><title>A Comment Test</title></head> 
<body> 

<h2>A Test of Comments</h2> 

<%-- 该 部 分 注释 在 网 页 中 不 会 被 显示 - -%> 

</body> 

</html> 


运行 后 得 到 以 下 结果 : 


A Test of Comments 


不 同情 况 下 使 用 注释 的 语法 规则 : 


语法 描述 
<%-- 注释 -- 


JSP 注 释 ， 注 释 内 容 不 会 被 发 送 至 浏览 器 甚至 不 会 被 编译 


%> 


"E 2 —-> HTML 注 释 ， 通过 浏览 器 查看 网 页 源 代码 时 可 以 看 见 注 释 内 


容 
<\% 代表 静态 <% 常 量 
%\> 代表 静态 %> 常量 
\ 在 属性 中 使 用 的 单 引 号 
v 在 属性 中 使 用 的 双 引 号 
JSPH SD 
JSP 指 合用 来 设置 与 整个 JSP 页 面相 关 的 属性 。 
JSP 指 邻 语法 格式 : 


«90 directive attribute="value" %> 


这 里 有 三 种 指令 标 
a 描述 


<%@ page ... %> 页 面 的 依赖 属性 ， 比 如 脚本 话 言 、error 页 面 、 缓 存 需 


<%@ include ... N 
包含 其 他 文件 
S ONO 引入 标签 库 的 定义 ， 可 以 是 自 定 义 标 签 


JSP 行 为 


JSP 行 为 标签 使 用 XML 语法 结构 来 控制 servlet 引 擎 。 它 能 够 动态 插入 一 个 文件 ， 重 
用 JavaBean 组 件 ， 引 导 用 户 去 另 一 个 页 面 ， 为 Java 插 件 产 生 相 关 的 HTML 等 等 。 


行为 标签 只 有 一 种 语法 格式 ， 它 严格 遵守 XML 标准 : 


<jsp:action_name attribute="value" /> 


行为 标签 基本 上 是 一 些 预先 就 定义 好 的 函数 ， 下 表 罗 列 出 了 一 些 可 用 的 JSP 行 为 标 
UE um 


T 


语法 描述 
jsp:include 用 于 在 当前 页 面 中 包含 静态 或 动态 资源 


jsp:useBean 寻找 和 初始 化 一 个 JavaBean 组 件 
jsp:setProperty ”设置 JavaBean 组 件 的 值 
jsp:getProperty ”将 JavaBean 组 件 的 值 插入 到 output 中 


jsbforward 。 ”从 一 个 JSP 文 件 向 另 一 个 文件 传递 一 个 包含 用 户 请 求 的 


request 对 象 
jsp:plugin 用 于 在 生成 的 HTML 页 面 中 包含 Applet 和 JavaBean 对 象 
jsp:element 动态 创建 一 个 XML 元 素 
jsp:attribute 定义 动态 创建 的 XML 元 素 的 属性 
jsp:body 定义 动态 创建 的 XML 元 素 的 主体 
jsp:text 用 于 封装 模板 数据 
JSPR A AR 


JSP 支 持 九 个 自动 定义 的 变量 ， 江 湖人 称 隐 含 对 象 。 这 九 个 隐 合 对 象 的 简介 见 
表 : 


i1 


xt 
request 
response 
out 
session 
application 


config 
pageContext 
page 


Exception 


控制 流 语句 


TEX 
HttpServletRequest 3: 89 3: fil 


Ef 


HttpServletResponse # f^ 3: (fl 
PrintWriter 类 的 实例 ， 用 于 把 结果 输出 至 网 页 上 
HttpSession 类 的 实例 
ServletContext 类 的 实例 ， 与 应 用 上 下 文 有 关 
ServletConfig 类 的 实例 


PageContext 类 的 实例 ， 提 供 对 JSP 页 面 所 有 对 象 以 及 命名 空 
间 的 访问 


类 似 于 Java 类 中 的 this 关 键 字 
Exception 类 的 对 象 ， 代 表 发 生 错误 的 JSP 页 面 中 对 应 的 异常 对 
象 


JSP 提 供 对 Java 语 言 的 全 面 支 持 。 您 可 以 在 JSP 程 序 中 使 用 Java API 甚 至 建立 Java 
代码 块 ， 包 括 判 断 语句 和 循环 语句 等 等 。 


判断 语句 


lf...else 块 ， 请 看 下 面 这 个 例子 


<%! int day = 3; %> 


<html> 


<head><title>IF...ELSE Example</title></head> 


<body> 


<% if (day == 1 | day == 7) { % 
<p> Today is weekend</p> 

<% } else { %> 
<p> Today is not weekend</p> 


<% } 95 
«/body» 
«/html» 


了 后 得 到 以 下 结果 : 


Today is not weekend 


现在 来 看 看 switch...case 块 ， 与 if...else 块 有 很 大 的 不 同 ， 它 使 用 out.printIn()， 并 且 
整个 都 装 在 脚本 程序 的 标签 中 ， 就 像 下 面 这 样 : 


<%! int day = 3; %> 

<html> 

<head><title>SWITCH...CASE Example</title></head> 

<body> 

<% 

switch(day) { 

case 0: 
out.println("ItN's Sunday."); 
break; 

case 1: 
out.println("ItN's Monday."); 
break; 

case 2: 
out.println("ItN's Tuesday."); 
break; 

case 3: 
out.println("ItN's Wednesday."); 
break; 

case 4: 
out.println("ItN's Thursday."); 
break; 

case 5: 
out.println("ItN's Friday."); 
break; 

default: 
out.println("It's Saturday."); 

} 

%> 

</body> 

</html> 


运行 后 得 出 以 下 结果 : 
It's Wednesday. 
循环 语句 


在 JSP 程 序 中 可 以 使 用 Java 的 三 个 基本 循环 类 型 : for，while， 和 do...while。 
让 我 们 来 看 看 for 循 环 的 例子 : 


<%! int fontSize; %> 

<html> 

<head><title>FOR LOOP Example</title></head> 

<body> 

<%for ( fontSize = 1; fontSize <= 3; fontSizet++){ %> 
<font color="green" size="<%= fontSize %>"> 

JSP Tutorial 

</font><br /> 

<%}%> 

</body> 

</html> 


运行 后 得 到 以 下 结果 : 


JSP Tutorial 
JSP Tutorial 
JSP Tutorial 


将 上 例 改 用 while 循 环 来 写 : 


<%! int fontSize; %> 
<html> 
<head><title>wHILE LOOP Example</title></head> 
<body> 
<%while ( fontSize <= 3){ %> 
<font color="green" size="<%= fontSize %>"> 
JSP Tutorial 
</font><br /> 
<%FontSizet+ ;%> 
<%}%> 
</body> 
</html> 


运行 后 得 到 同样 的 结果 : 
JSP Tutorial 
JSP Tutorial 
JSP Tutorial 


JSP 运 算 符 


JSP 支 持 所 有 Java 逻 辑 和 算术 运算 符 。 
下 表 罗 列 出 了 JSP 常 见 运算 符 ， 优 先 级 从 高 到 底 : 


类 别 操作 符 
后 级 () 0. (点 运算 符 ) 
=E ++--!~ 
可 乘 性 *1% 
可 加 性 ds 
移 位 >> >>> << 
关系 > >= < <= 
相等 /不 等 == |= 
位 与 & 
位 异 或 n 
位 或 | 
逻辑 与 && 
逻辑 或 | 
条 件 判断 ?: 
赋值 Sets ee) area A 
逗号 
JSP#= 
JSP 话 言 定义 了 以 下 几 个 常量 : 


Boolean : true and false 
Integer : 与 Java 中 的 一 样 
Floating point : 与 Java 中 的 一 祥 
String : 以 单 引号 或 双 引 号 开始 和 结束 。" 被 转 义 成 \，' 被 转 义 成 \，\ 被 转 义 


成 \ 
Null : null 


JSP iE TS 
JSP 指 邻 用 来 设置 整个 JSP 页 面相 关 的 属性 ， 如 网 页 的 编码 方式 和 脚本 语言 。 
语法 格式 如 下 : 

«90 directive attribute="value" %> 
指令 可 以 有 很 多 个 属性 ， 它 们 以 键 值 对 的 形式 存在 ， 并 用 过 号 隔 开 。 
JSP 中 的 三 种 指令 标签 : 

HI 描述 
<%@ page ... %> 定义 网 页 依赖 属性 ， 比如 脚本 语言 、error 页 面 、 缓 存 需 求 
等 等 
ae include ... 包含 其 他 文件 


<%@ taglib ... %> ”引入 标签 库 的 定义 


Page 指 今 


Page 指 邻 为 容器 提供 当前 页 面 的 使 用 说 明 。 一 个 JSP 页 面 可 以 包含 多 个 page 指 兮 。 
Page 指 邻 的 语法 格式 : 


«99 page attribute="value" %> 


等 价 的 XML 格式 : 


<jsp:directive.page attribute="value" /> 


属性 
下 表 列 出 与 Page 指 今 相关 的 属性 : 


属性 描述 


buffer 指定 out 对 象 使 用 缓冲 区 的 大 小 

autoFlush 控制 out 对 象 的 缓存 区 

contentType 指定 当前 JSP 页 面 的 MIME 类 型 和 字符 编码 
errorPage 指定 当 JSP 页 面 发 生 有 异常 时 需要 转向 的 错误 义理 页 面 
Ea ees ern 另 一 个 JSP 页 面 的 错误 处 理 页 
extends 指定 servlet 从 哪 一 个 类 继承 

import 导入 要 使 用 的 Java 类 

info 定义 JSP 页 面 的 描述 信息 

isThreadSafe 指定 对 JSP 页 面 的 访问 是 否 为 线程 安全 

language 定义 JSP 页 面 所 用 的 脚本 语言 ， 默 认 是 Java 

session 指定 JSP 页 面 是 否 使 用 session 

isELIgnored 指定 是 否 执行 EL 表达 式 


isScriptingEnabled ”确定 脚本 元 素 能 否 被 使 用 


Includei& 4 


JSP 可 以 通过 include 指 倒 来 包含 其 他 文件 。 被 包含 的 文件 可 以 是 JSP 文 件 、HTML 
文件 或 文本 文件 。 包 含 的 文件 就 好 像 是 该 JSP 文 件 的 一 部 分 ， 会 被 同时 编译 执行 。 


Include 指 使 的 语法 格式 如 下 : 


«90 include file="relative url" %> 


Include 指 使 中 的 文件 名 实际 上 是 一 个 相对 的 URL。 如 果 您 没有 给 文件 关联 一 个 路 
径 ，JSP 编 译 器 默认 在 当前 路 径 下 寻找 。 


等 价 的 XML 语法 : 


<jsp:directive.include file="relative url" /> 


Taglibi& 4 


JSP API 人 允许 用 户 自 定义 标签 ， 一 个 自 定义 标签 库 就 是 自 定义 标签 的 集合 。 


Taglib 指 邻 引入 一 个 自 定 义 标 签 集合 的 定义 ， 包 括 库 路 径 、 自 定义 标签 。 
Taglib 指 邻 的 语法 : 


<%@ taglib uri-"uri" prefix-"prefixOfTag" %> 


uri 属 性 确定 标签 库 的 位 置 ，prefix 属 性 指定 标签 库 的 前 级 。 
等 价 的 XML 语法 : 


<jsp:directive.taglib uri-"uri" prefix-"prefixOfTag" /> 


JSP 动作 元 素 


与 JSP 指 倒 元 素 不 同 的 是 ，JSP 动 作 元 素 在 请 求 处 理 阶段 起 作用 。JSP 动 作 元 素 是 


用 XML 语法 写成 的 。 


利用 JSP 动 作 可 以 动态 地 插入 文件 、 重 用 JavaBean 组 件 、 把 用 户 重 定向 到 另外 的 页 
面 、 为 Java 插 件 生 成 HTML 代 码 。 


动作 元 素 只 有 一 种 语法 ， 它 符合 XML 标准 : 


<jsp:action_name attribute="value" /> 


动作 元 素 基本 上 都 是 预定 义 的 函数 ，JSP 规 范 定义 了 一 系列 的 标准 动作 ， 它 用 JSP 
作为 前 级 ， 可 用 的 标准 动作 元 素 如 下 : 


语法 
jsp:include 
jsp:useBean 
jsp:setProperty 
jsp:getProperty 
jsp:forward 
jsp:plugin 
jsp:element 
jsp:attribute 
jsp:body 
jsp:text 


T UB ett 


描述 
在 页 面 被 请 求 的 时 候 引 入 一 个 文件 。 
寻找 或 者 实例 化 一 个 JavaBean。 
设置 JavaBean 的 属性 。 
输出 某 个 JavaBean 的 属性 。 
把 请 求 转 到 一 个 新 的 页 面 。 
根据 浏览 器 类 型 为 Java 插 件 生成 OBJECT 或 EMBED 标 记 。 
定义 动态 XML 元 素 
设置 动态 定义 的 XML 元 素 属 性 。 
设置 动态 定义 的 XML 元 素 内 容 。 
在 JSP 页 面 和 文档 中 使 用 写 入 文本 的 模板 


所 有 的 动作 要 素 都 有 两 个 属性 : id 属性 和 scope 属 性 。 


e id 属性 : 


id 属性 是 动作 元 素 的 唯一 标识 ， 可 以 在 JSP 页 面 中 引用 。 动 作 元 素 创 建 的 id 值 可 
以 通过 PageContext 来 调用 。 


。 scope 属 性 : 


该 属性 用 于 识别 动作 元 素 的 生命 周期 。 id 属性 和 scope 属 性 有 直接 关系 ，scope 
属性 定义 了 相关 联 id 对 象 的 寿命 。 scope 属 性 有 四 个 可 能 的 值 : (a) page， 
(b)request, (c)session, 和 (d) application. 


<jsp:include># F703 


<jsp:include> 动 作 元 素 用 来 包含 静态 和 动态 的 文件 。 该 动作 把 指定 文件 插入 正在 生 
成 的 页 面 。 语 法 格式 如 下 : 


<jsp:include page="relative URL" flush="true" /> 


前 面 已 经 介绍 过 include 指 令 ， 它 是 在 JSP 文 件 被 转换 成 Servlet 的 时 候 引入 文件 ， 
而 这 里 的 jsp:include 动 作 不 同 ， 插 入 文件 的 时 间 是 在 页 面 被 请 求 的 时 候 。 


以 下 是 include 动 作 相 关 的 属性 列表 。 


属性 描述 
page 包含 在 页 面 中 的 相对 URL 地 址 。 
flush 布尔 属性 ， 定 义 在 包含 资源 前 是 否 刷 新 缓存 区 。 
实例 
以 下 我 们 定义 了 两 个 文件 datejsp 和 main.jsp， 代 码 如 下 所 示 : 
date.jsp 文 件 代 码 : 
<p> 


Today's date: <%= (new java.util.Date()).toLocaleString( )%> 
</p> 


main.jsp 文 件 代 码 : 


«html» 

«head» 

<title>The include Action Example</title> 
«/head» 

«body» 

«center» 

<h2>The include action Example</h2> 
«jsp:include page="date.jsp" flush="true" /> 
</center> 

</body> 

</html> 


现在 将 以 上 两 个 文件 放 在 服务 器 的 根 目 录 下 ， 访 问 main.jsp 文 件 。 显 示 结 果 如 下 : 


The include action Example 
Today's date: 12-Sep-2013 14:54:22 


<jsp:useBean> 动 作 元 素 


jsp:useBean 动 作用 来 装载 一 个 将 在 JSP 页 面 中 使 用 的 JavaBean。 


这 个 功能 非常 有 用 ， 因 为 它 使 得 我 们 既 可 以 发 挥 Java 组 件 重用 的 优势 ， 同 时 也 避免 
了 损失 JSP 区 别 于 Servlet 的 方便 性 。 


jsp:useBean 动 作 最 简单 的 语法 为 : 


<jsp:useBean id="name" class="package.class" /> 


在 类 载 入 后 ， 我 们 既 可 以 通过 jsp:setProperty 和 jsp:getProperty 动作 来 修改 和 检 
索 bean 的 属性 。 


以 下 是 useBean 动 作 相关 的 属性 列表 。 


属性 描述 
class 指定 Bean 的 完整 包 名 。 
type 指定 将 引用 该 对 象 变量 的 类 型 。 


beanName ”通过 java.beans.Beans 的 instantiate() 方法 指定 Bean 的 名 字 。 
在 给 出 具体 实例 前 ， 让 我 们 先 来 看 下 jsp:setProperty 和 jsp:getProperty 动作 元 
<jsp:setProperty> 动 作 元 素 


jsp:setProperty 用 来 设置 已 经 实例 化 的 Bean 对 象 的 属性 ， 有 两 种 用 法 。 首 先 ， 你 
可 以 在 jsp:useBean 元 素 的 外 面 (后面 ) 使 用 jsp:setProperty， 如 下 所 示 : 


<jsp:useBean id="myName" ... /> 
<jsp:setProperty name="myName" property="SomeProperty" .../> 
此 时 ， 不 管 jsp:useBean 是 找到 了 一 个 现 有 的 Bean， 还 是 新 创建 了 一 个 Bean 实 


例 ，jsp:setProperty 都 会 执行 。 第 二 种 用 法 是 把 jsp:setProperty 放 入 jsp:useBean 元 
素 的 内 部 ， 如 下 所 示 : 


<jsp:useBean id="myName" ... > 
` <jsp:setProperty name="myName" property="SomeProperty" .../> 
</jsp:useBean> 
此 时 ，jsp:setProperty 只 有 在 新 建 Bean 实 例 时 才 会 执行 ， 如 果 是 使 用 现 有 实例 则 不 
执行 jsp:setProperty。 
jsp:setproperty 动 作 有 下 面 四 个 属性 ,如 下 表 : 


属性 描述 
name name 属 性 是 必需 的 。 它 表示 要 设置 属性 的 是 哪个 Bean。 


property 属 性 是 必需 的 。 它 表示 要 设置 哪个 属性 。 有 一 个 特殊 用 法 : 
property “如 果 property 的 值 是 ”“"， 表 示 所 有 名 字 和 Bean 属 性 名 字 匹 配 的 请 求 
参数 都 将 被 传递 给 相应 的 属性 set 方 法 。 


value 属性 是 可 选 的 。 该 属性 用 来 指定 Bean 属 性 的 值 。 字 符 串 数据 
会 在 目标 类 中 通过 标准 的 valueOf 方 法 自动 转换 成 数字 、boolean、 
Boolean、 byte、Byte、char、Character。 例 如 ，boolean 和 
Boolean 类 型 的 属性 值 (比如 "true") 通过 Boolean.valueOf 转 换 ， 
int 和 Integer 类 型 的 属性 值 (比如 "42") 通过 Integer.valueOf 转 换 。 
value 和 param 不 能 同时 使 用 ， 但 可 以 使 用 其 中 任意 一 个 。 


param 是 可 选 的 。 它 指定 用 哪个 请 求 参数 作为 Bean 属 性 的 值 。 如 果 
当前 请 求 没有 参数 ， 则 什么 事情 也 不 做 ， 系 统 不 会 把 null 传 递 给 
Bean 属 性 的 set 方 法 。 因 此 ， 你 可 以 让 Bean 自 己 提 供 默 认 属 性 值 ， 
只 有 当 请 求 参数 明确 指定 了 新 值 时 才 修 改 默认 属性 值 。 


value 


param 


<jsp:getProperty> 动 作 元 素 


TA a RTILTE DUSISRERDINIIUTE 转换 成 字符 串 ， 然 后 输出 。 语 法 格 
式 如 下 : 


<jsp:useBean id="myName" ... /> 


«jsp:getProperty name-"myName" property="SomeProperty" .../> 


下 表 是 与 getProperty 相 关联 的 属性 : 


属性 描述 
name 要 检索 的 Bean 属 性 名 称 。Bean 必 须 已 定义 。 


property 表示 要 提取 Bean 属 性 的 值 


实例 
以 下 实例 我 们 使 用 了 Bean: 


/* 文件 : TestBean.java */ 
package action; 


public class TestBean { 
private String message = "No message specified"; 


public String getMessage() { 
return(message); 


public void setMessage(String message) { 
this.message - message; 
j 


j 


编译 以 上 实例 并 生成 TestBean.class 文件 ， 将 该 文件 拷贝 至 服务 器 正式 存放 Java 类 
的 目录 下 ， 而 不 是 保留 给 修改 后 能 够 自动 装载 的 类 的 目录 ( 如 : C:\apache-tomcat- 
7.0.2\Wwebapps\WEB-INF\classes\action 目 录 中 ，CLASSPATH 变量 必须 包含 该 路 
f, )。 例 如 ， 对 于 Java Web Server 来 说 ，Bean 和 所 有 Bean 用 到 的 类 都 应 该 放 入 
classes 目 录 ， 或 者 封装 进 jar 文 件 后 放 入 lib 目 录 ， 但 不 应 该 放 到 servlets 下 。 

下 面 是 一 个 很 简单 的 例子 ， 它 的 功能 是 装载 一 个 Bean， 然 后 设置 / 读 取 它 的 
message 属 性 。 


现在 让 我 们 在 main.jsp 文 件 中 调用 该 Bean: 


<html> 

<head> 

<title>Using JavaBeans in JSP</title> 
</head> 

<body> 

<center> 

<h2>Using JavaBeans in JSP</h2> 


<jsp:useBean id="test" class="action.TestBean" /> 
<jsp:setProperty name="test" 
property="message" 
value="Hello JSP..." /> 
<p>Got message....</p> 
<jsp:getProperty name="test" property="message" /> 
</center> 


</body> 
</html> 


执行 以 上 文件 ， 输 出 如 下 所 示 : 


Using JavaBeans in JSP 
Got message.... 
Hello JSP... 


<jsp:forward> 动作 元 素 


jsp:forward 动 作 把 请 求 转 到 另外 的 页 面 。jsp:forward 标 记 只 有 一 个 属性 page。 语 
法 格式 如 下 所 示 : 


<jsp:forward page="Relative URL" /> 


以 下 是 forward 相 关联 的 属性 : 
属性 描述 


TUR page 属 性 包含 的 是 一 个 相对 URL。page 的 值 既 可 以 直接 给 出 ， 也 可 以 
Page ， 在 请 求 的 时 候 动 态 计算 ， 可 以 是 一 个 JSP 页 面 或 者 一 个 Java Servlet. 


实例 
以 下 实例 我 们 使 用 了 两 个 文件 ， 分 别 是 : date.jps 和 main.jsp。 
date.js 文 件 代 码 如 下 : 


<p> 
Today's date: <%= (new java.util.Date()).toLocaleString( )%> 
</p> 


main.jsp 文 件 代 码 : 


«html» 

«head» 

<title>The forward Action Example</title> 
«/head» 

«body» 

«center» 

<h2>The forward action Example</h2> 
«jsp:forward page="date.jsp" /> 

</center> 

</body> 


现在 将 以 上 两 个 文件 放 在 服务 器 的 根 目 录 下 ， 访 问 main.jsp 文 件 。 显 示 结 果 如 下 : 


Today's date: 12-Sep-2010 14:54:22 


<jsp:plugin> 动 作 元 素 
jsp:plugin 动 作用 来 根据 浏览 器 的 类 型 ， 插 入 通过 Java 插 件 运行 Java Applet 所 必需 
的 OBJECT 或 EMBED 元 素 。 


如 果 需 要 的 插件 不 存在 ， 它 会 下 载 插 件 ， 然 后 执行 Java 组 件 。 Java 组 件 可 以 是 一 
个 applet 或 一 个 JavaBean。 


plugin 动 作 有 多 个 对 应 HTML 元 素 的 属性 用 于 格式 化 Java 组 件 。param 元 素 可 用 于 
向 Applet 或 Bean 传递 参数 。 


以 下 是 使 用 plugin 动作 元 素 的 典型 实例 : 
<jsp:plugin type="applet" codebase="dirname" code="MyApplet.class" 
width="60" height="80"> 
<jsp:param name-"fontcolor" value="red" /> 
<jsp:param name="background" value="black" /> 
<jsp:fallback> 
Unable to initialize Java Plugin 
</jsp:fallback> 
</jsp:plugin> 
I a = 


如 果 你 有 兴趣 可 以 党 试 使 用 applet 来 测试 jsp:plugin 动 作 元 素 ，<fallback> 元 素 是 一 
个 新 元 素 ， 在 组 件 出 现 故 障 的 错误 是 发 送 给 用 户 错误 信息 。 


<jsp:element> 、 <jsp:attribute>、 <jsp:body> 动 作 
元 素 

<jsp:element> 、 <jsp:attribute>、 <jsp:body> 动 作 元 素 动 态 定义 XML 元 素 。 动 态 是 
非常 重要 的 ， 这 就 意味 着 XML 元 素 在 编译 时 是 动态 生成 的 而 非 静态 。 

以 下 实例 动态 定义 了 XML 元 素 : 


<%@page language-"java" contentType="text/html"%> 
«html xmlns="http://www.w3c.org/1999/xhtm1" 
xmins:jsp="http://java.sun.com/JSP/Page"> 


<head><title>Generate XML Element</title></head> 
<body> 
<jsp:element name="xmlElement"> 
<jsp:attribute name="xmlElementAttr"> 
Value for the attribute 
</jsp:attribute> 
<jsp:body> 
Body for XML element 
</jsp:body> 
</jsp:element> 
</body> 
</html> 


执行 时 生成 HTML 代 码 如 下 : 


«html xmlns="http://www.w3c.org/1999/xhtm1" 
xmins:jsp="http://java.sun.com/JSP/Page"> 


<head><title>Generate XML Element</title></head> 

<body> 

<xmlElement xmlElementAttr="Value for the attribute"> 
Body for XML element 


</xmlElement> 

</body> 

</html> 
<jsp:text> 动 作 元 素 


<jsp:text> 动 作 元 素 人 允许 在 JSP 页 面 和 文档 中 使 用 写 入 文本 的 模板 ， 语 法 格式 如 下 : 


<jsp:text>Template data</jsp:text> 


以 上 文本 模板 不 能 包含 其 他 元 素 ， 只 能 只 能 包含 文本 和 EL 表达 式 GE: EL 表达 式 
将 在 后 续 章节 中 介绍 ) 。 请 注意 ， 在 XML 文件 中 ， 您 不 能 使 用 表达 式 如 ${whatever 
> 0}， 因 为 > 符号 是 非法 的 。 你 可 以 使 用 ${whatever gt 0} 表 达 式 或 者 区 入 在 一 个 
CDATA 部 分 的 值 。 


<jsp:text><![CDATA[<br>]]></jsp:text> 


如 果 你 需要 在 XHTML 中 声明 DOCTYPE, 必 须 使 用 到 <jsp:text> 动 作 元 素 ， 实 例如 
F: 


<jsp:text><![CDATA[<!DOCTYPE html 

PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
"DTD/xhtmli-strict.dtd"»]]» 

</jsp:text> 

<head><title>jsp:text action</title></head> 
<body> 


<books><book><jsp: text> 
Welcome to JSP Programming 
</jsp:text></book></books> 


</body> 
</html> 


你 可 以 对 以 上 实例 尝试 使 用 <jsp:text> 及 不 使 用 该 动作 元 素 执行 结果 的 区 别 。 


</p ”jsp:setproperty 动 作 有 下 面 四 个 属性 ,如 下 表 : <>VM1563:1 Resource 
interpreted as Image but transferred with MIME type text/html: 
"http://googleads.g.doubleclick.net/pagead/adview? 

ai-CYd viHarVOrQGoGt8gW/1-o... 
dHQJkVOteBb6uOUXPCSK1MkoVQh3X4TKABpy. 58Kajo6JdKAGIQ&sigh-pcHB 
vVQp9GM&vis=1". ads?client=ca-pub- 

5751451 760833794&format=160x600&output=html&h=600&slotname=41062748 
65&adk=4689099...:1 


JSP 动作 元 素 


与 JSP 指 倒 元 素 不 同 的 是 ，JSP 动 作 元 素 在 请 求 处 理 阶段 起 作用 。JSP 动 作 元 素 是 


用 XML 语法 写成 的 。 


利用 JSP 动 作 可 以 动态 地 插入 文件 、 重 用 JavaBean 组 件 、 把 用 户 重 定向 到 另外 的 页 
面 、 为 Java 插 件 生 成 HTML 代 码 。 


动作 元 素 只 有 一 种 语法 ， 它 符合 XML 标准 : 


<jsp:action_name attribute="value" /> 


动作 元 素 基本 上 都 是 预定 义 的 函数 ，JSP 规 范 定义 了 一 系列 的 标准 动作 ， 它 用 JSP 
作为 前 级 ， 可 用 的 标准 动作 元 素 如 下 : 


语法 
jsp:include 
jsp:useBean 
jsp:setProperty 
jsp:getProperty 
jsp:forward 
jsp:plugin 
jsp:element 
jsp:attribute 
jsp:body 
jsp:text 


T UB ett 


描述 
在 页 面 被 请 求 的 时 候 引 入 一 个 文件 。 
寻找 或 者 实例 化 一 个 JavaBean。 
设置 JavaBean 的 属性 。 
输出 某 个 JavaBean 的 属性 。 
把 请 求 转 到 一 个 新 的 页 面 。 
根据 浏览 器 类 型 为 Java 插 件 生成 OBJECT 或 EMBED 标 记 。 
定义 动态 XML 元 素 
设置 动态 定义 的 XML 元 素 属 性 。 
设置 动态 定义 的 XML 元 素 内 容 。 
在 JSP 页 面 和 文档 中 使 用 写 入 文本 的 模板 


所 有 的 动作 要 素 都 有 两 个 属性 : id 属性 和 scope 属 性 。 


e id 属性 : 


id 属性 是 动作 元 素 的 唯一 标识 ， 可 以 在 JSP 页 面 中 引用 。 动 作 元 素 创 建 的 id 值 可 
以 通过 PageContext 来 调用 。 


。 scope 属 性 : 


该 属性 用 于 识别 动作 元 素 的 生命 周期 。 id 属性 和 scope 属 性 有 直接 关系 ，scope 
属性 定义 了 相关 联 id 对 象 的 寿命 。 scope 属 性 有 四 个 可 能 的 值 : (a) page， 
(b)request, (c)session, 和 (d) application. 


<jsp:include># F703 


<jsp:include> 动 作 元 素 用 来 包含 静态 和 动态 的 文件 。 该 动作 把 指定 文件 插入 正在 生 
成 的 页 面 。 语 法 格式 如 下 : 


<jsp:include page="relative URL" flush="true" /> 


前 面 已 经 介绍 过 include 指 令 ， 它 是 在 JSP 文 件 被 转换 成 Servlet 的 时 候 引入 文件 ， 
而 这 里 的 jsp:include 动 作 不 同 ， 插 入 文件 的 时 间 是 在 页 面 被 请 求 的 时 候 。 


以 下 是 include 动 作 相 关 的 属性 列表 。 


属性 描述 
page 包含 在 页 面 中 的 相对 URL 地 址 。 
flush 布尔 属性 ， 定 义 在 包含 资源 前 是 否 刷 新 缓存 区 。 
实例 
以 下 我 们 定义 了 两 个 文件 datejsp 和 main.jsp， 代 码 如 下 所 示 : 
date.jsp 文 件 代 码 : 
<p> 


Today's date: <%= (new java.util.Date()).toLocaleString( )%> 
</p> 


main.jsp 文 件 代 码 : 


«html» 

«head» 

<title>The include Action Example</title> 
«/head» 

«body» 

«center» 

<h2>The include action Example</h2> 
«jsp:include page="date.jsp" flush="true" /> 
</center> 

</body> 

</html> 


现在 将 以 上 两 个 文件 放 在 服务 器 的 根 目 录 下 ， 访 问 main.jsp 文 件 。 显 示 结 果 如 下 : 


The include action Example 
Today's date: 12-Sep-2013 14:54:22 


<jsp:useBean> 动 作 元 素 


jsp:useBean 动 作用 来 装载 一 个 将 在 JSP 页 面 中 使 用 的 JavaBean。 


这 个 功能 非常 有 用 ， 因 为 它 使 得 我 们 既 可 以 发 挥 Java 组 件 重用 的 优势 ， 同 时 也 避免 
了 损失 JSP 区 别 于 Servlet 的 方便 性 。 


jsp:useBean 动 作 最 简单 的 语法 为 : 


<jsp:useBean id="name" class="package.class" /> 


在 类 载 入 后 ， 我 们 既 可 以 通过 jsp:setProperty 和 jsp:getProperty 动作 来 修改 和 检 
索 bean 的 属性 。 


以 下 是 useBean 动 作 相关 的 属性 列表 。 


属性 描述 
class 指定 Bean 的 完整 包 名 。 
type 指定 将 引用 该 对 象 变量 的 类 型 。 


beanName ”通过 java.beans.Beans 的 instantiate() 方法 指定 Bean 的 名 字 。 
在 给 出 具体 实例 前 ， 让 我 们 先 来 看 下 jsp:setProperty 和 jsp:getProperty 动作 元 
<jsp:setProperty> 动 作 元 素 


jsp:setProperty 用 来 设置 已 经 实例 化 的 Bean 对 象 的 属性 ， 有 两 种 用 法 。 首 先 ， 你 
可 以 在 jsp:useBean 元 素 的 外 面 (后面 ) 使 用 jsp:setProperty， 如 下 所 示 : 


<jsp:useBean id="myName" ... /> 
<jsp:setProperty name="myName" property="SomeProperty" .../> 
此 时 ， 不 管 jsp:useBean 是 找到 了 一 个 现 有 的 Bean， 还 是 新 创建 了 一 个 Bean 实 


例 ，jsp:setProperty 都 会 执行 。 第 二 种 用 法 是 把 jsp:setProperty 放 入 jsp:useBean 元 
素 的 内 部 ， 如 下 所 示 : 


<jsp:useBean id="myName" ... > 
` <jsp:setProperty name="myName" property="SomeProperty" .../> 
</jsp:useBean> 
此 时 ，jsp:setProperty 只 有 在 新 建 Bean 实 例 时 才 会 执行 ， 如 果 是 使 用 现 有 实例 则 不 
执行 jsp:setProperty。 
jsp:setproperty 动 作 有 下 面 四 个 属性 ,如 下 表 : 


属性 描述 
name name 属 性 是 必需 的 。 它 表示 要 设置 属性 的 是 哪个 Bean。 


property 属 性 是 必需 的 。 它 表示 要 设置 哪个 属性 。 有 一 个 特殊 用 法 : 
property “如 果 property 的 值 是 ”“"， 表 示 所 有 名 字 和 Bean 属 性 名 字 匹 配 的 请 求 
参数 都 将 被 传递 给 相应 的 属性 set 方 法 。 


value 属性 是 可 选 的 。 该 属性 用 来 指定 Bean 属 性 的 值 。 字 符 串 数据 
会 在 目标 类 中 通过 标准 的 valueOf 方 法 自动 转换 成 数字 、boolean、 
Boolean、 byte、Byte、char、Character。 例 如 ，boolean 和 
Boolean 类 型 的 属性 值 (比如 "true") 通过 Boolean.valueOf 转 换 ， 
int 和 Integer 类 型 的 属性 值 (比如 "42") 通过 Integer.valueOf 转 换 。 
value 和 param 不 能 同时 使 用 ， 但 可 以 使 用 其 中 任意 一 个 。 


param 是 可 选 的 。 它 指定 用 哪个 请 求 参数 作为 Bean 属 性 的 值 。 如 果 
当前 请 求 没有 参数 ， 则 什么 事情 也 不 做 ， 系 统 不 会 把 null 传 递 给 
Bean 属 性 的 set 方 法 。 因 此 ， 你 可 以 让 Bean 自 己 提 供 默 认 属 性 值 ， 
只 有 当 请 求 参数 明确 指定 了 新 值 时 才 修 改 默认 属性 值 。 


value 


param 


<jsp:getProperty> 动 作 元 素 


jsp:getProperty 动 作 提取 指定 Bean 属 性 的 值 ， 转 换 成 字符 串 ， 然 后 输出 。 语 法 格式 
如 下 : 


<jsp:useBean id="myName" ... /> 


«jsp:getProperty name-"myName" property="SomeProperty" .../> 


下 表 是 与 getProperty 相 关联 的 属性 : 


属性 描述 
name 要 检索 的 Bean 属 性 名 称 。Bean 必 须 已 定义 。 


property 表示 要 提取 Bean 属 性 的 值 


实例 
以 下 实例 我 们 使 用 了 Bean: 


/* 文件 : TestBean.java */ 
package action; 


public class TestBean { 
private String message = "No message specified"; 


public String getMessage() { 
return(message); 


public void setMessage(String message) { 
this.message - message; 
j 


j 


编译 以 上 实例 并 生成 TestBean.class 文件 ， 将 该 文件 拷贝 至 服务 器 正式 存放 Java 类 
的 目录 下 ， 而 不 是 保留 给 修改 后 能 够 自动 装载 的 类 的 目录 ( 如 : C:\apache-tomcat- 
7.0.2\Wwebapps\WEB-INF\classes\action 目 录 中 ，CLASSPATH 变量 必须 包含 该 路 
f, )。 例 如 ， 对 于 Java Web Server 来 说 ，Bean 和 所 有 Bean 用 到 的 类 都 应 该 放 入 
classes 目 录 ， 或 者 封装 进 jar 文 件 后 放 入 lib 目 录 ， 但 不 应 该 放 到 servlets 下 。 

下 面 是 一 个 很 简单 的 例子 ， 它 的 功能 是 装载 一 个 Bean， 然 后 设置 / 读 取 它 的 
message 属 性 。 


现在 让 我 们 在 main.jsp 文 件 中 调用 该 Bean: 


<html> 

<head> 

<title>Using JavaBeans in JSP</title> 
</head> 

<body> 

<center> 

<h2>Using JavaBeans in JSP</h2> 


<jsp:useBean id="test" class="action.TestBean" /> 
<jsp:setProperty name="test" 
property="message" 
value="Hello JSP..." /> 
<p>Got message....</p> 
<jsp:getProperty name="test" property="message" /> 
</center> 


</body> 
</html> 


执行 以 上 文件 ， 输 出 如 下 所 示 : 


Using JavaBeans in JSP 
Got message.... 
Hello JSP... 


<jsp:forward> 动作 元 素 


jsp:forward 动 作 把 请 求 转 到 另外 的 页 面 。jsp:forward 标 记 只 有 一 个 属性 page。 语 
法 格式 如 下 所 示 : 


<jsp:forward page="Relative URL" /> 


以 下 是 forward 相 关联 的 属性 : 
属性 描述 


TUR page 属 性 包含 的 是 一 个 相对 URL。page 的 值 既 可 以 直接 给 出 ， 也 可 以 
Page ， 在 请 求 的 时 候 动 态 计算 ， 可 以 是 一 个 JSP 页 面 或 者 一 个 Java Servlet. 


实例 
以 下 实例 我 们 使 用 了 两 个 文件 ， 分 别 是 : date.jps 和 main.jsp。 
date.js 文 件 代 码 如 下 : 


<p> 
Today's date: <%= (new java.util.Date()).toLocaleString( )%> 
</p> 


main.jsp 文 件 代 码 : 


«html» 

«head» 

<title>The forward Action Example</title> 
«/head» 

«body» 

«center» 

<h2>The forward action Example</h2> 
«jsp:forward page="date.jsp" /> 

</center> 

</body> 


现在 将 以 上 两 个 文件 放 在 服务 器 的 根 目 录 下 ， 访 问 main.jsp 文 件 。 显 示 结 果 如 下 : 


Today's date: 12-Sep-2010 14:54:22 


<jsp:plugin> 动 作 元 素 
jsp:plugin 动 作用 来 根据 浏览 器 的 类 型 ， 插 入 通过 Java 插 件 运行 Java Applet 所 必需 
的 OBJECT 或 EMBED 元 素 。 


如 果 需 要 的 插件 不 存在 ， 它 会 下 载 插 件 ， 然 后 执行 Java 组 件 。 Java 组 件 可 以 是 一 
个 applet 或 一 个 JavaBean。 


plugin 动 作 有 多 个 对 应 HTML 元 素 的 属性 用 于 格式 化 Java 组 件 。param 元 素 可 用 于 
向 Applet 或 Bean 传递 参数 。 


以 下 是 使 用 plugin 动作 元 素 的 典型 实例 : 
<jsp:plugin type="applet" codebase="dirname" code="MyApplet.class" 
width="60" height="80"> 
<jsp:param name-"fontcolor" value="red" /> 
<jsp:param name="background" value="black" /> 
<jsp:fallback> 
Unable to initialize Java Plugin 
</jsp:fallback> 
</jsp:plugin> 
I a = 


如 果 你 有 兴趣 可 以 党 试 使 用 applet 来 测试 jsp:plugin 动 作 元 素 ，<fallback> 元 素 是 一 
个 新 元 素 ， 在 组 件 出 现 故 障 的 错误 是 发 送 给 用 户 错误 信息 。 


<jsp:element> 、 <jsp:attribute>、 <jsp:body> 动 作 
元 素 

<jsp:element> 、 <jsp:attribute>、 <jsp:body> 动 作 元 素 动 态 定义 XML 元 素 。 动 态 是 
非常 重要 的 ， 这 就 意味 着 XML 元 素 在 编译 时 是 动态 生成 的 而 非 静态 。 

以 下 实例 动态 定义 了 XML 元 素 : 


<%@page language-"java" contentType="text/html"%> 
«html xmlns="http://www.w3c.org/1999/xhtm1" 
xmins:jsp="http://java.sun.com/JSP/Page"> 


<head><title>Generate XML Element</title></head> 
<body> 
<jsp:element name="xmlElement"> 
<jsp:attribute name="xmlElementAttr"> 
Value for the attribute 
</jsp:attribute> 
<jsp:body> 
Body for XML element 
</jsp:body> 
</jsp:element> 
</body> 
</html> 


执行 时 生成 HTML 代 码 如 下 : 


«html xmlns="http://www.w3c.org/1999/xhtm1" 
xmins:jsp="http://java.sun.com/JSP/Page"> 


<head><title>Generate XML Element</title></head> 

<body> 

<xmlElement xmlElementAttr="Value for the attribute"> 
Body for XML element 


</xmlElement> 

</body> 

</html> 
<jsp:text> 动 作 元 素 


<jsp:text> 动 作 元 素 人 允许 在 JSP 页 面 和 文档 中 使 用 写 入 文本 的 模板 ， 语 法 格式 如 下 : 


<jsp:text>Template data</jsp:text> 


以 上 文本 模板 不 能 包含 其 他 元 素 ， 只 能 只 能 包含 文本 和 EL 表达 式 GE: EL 表达 式 
将 在 后 续 章节 中 介绍 ) 。 请 注意 ， 在 XML 文件 中 ， 您 不 能 使 用 表达 式 如 $(whatever 
> 0}， 因 为 > 符号 是 非法 的 。 你 可 以 使 用 ${whatever gt ORA ARARE TD 
CDATA 部 分 的 值 。 


<jsp:text><![CDATA[<br>]]></jsp:text> 


如 果 你 需要 在 XHTML 中 声明 DOCTYPE, 必 须 使 用 到 <jsp:text> 动 作 元 素 ， 实 例如 
F: 


<jsp:text><![CDATA[<!DOCTYPE html 

PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
"DTD/xhtml1-strict.dtd">]]> 

</jsp:text> 

<head><title>jsp:text action</title></head> 
<body> 


<books><book><jsp:text> 
welcome to JSP Programming 
</jsp:text></book></books> 


</body> 
</html> 


你 可 以 对 以 上 实例 党 试 使 用 <jsp:text> 及 不 使 用 该 动作 元 素 执行 结果 的 区 别 。 


JSP Bau 


JSP 降 含 对 象 是 JSP 容 器 为 每 个 页 面 提供 的 Java 对 象 ， 开 发 者 可 以 直接 使 用 它们 而 
不 用 显 式 声明 。JSP 隐 含 对 象 也 被 称 为 预定 义 变 量 。 


JSP 所 支持 的 九 大 隐 含 对 象 : 


对 象 描述 
request HttpServletRequest X: 85 3: ffl 
response HttpServletResponse # B^ & (Jl 
out PrintWriter 类 的 实例 ， 用 于 把 结果 输出 至 网 页 上 
session HttpSession 类 的 实例 
application ServletContext 类 的 实例 ， 与 应 用 上 下 午 有 关 
config ServletConfig 类 的 实例 
X pJ Se E E g H : 、 Ax Uu 
pageone PageContext X 的 实例 ， 提 供 对 JSP 页 面 所 有 对 象 以 及 命名 空 
间 的 访问 

page 类 似 于 Java 类 中 的 this 关 键 字 

: 米 As X : +o fit 15 A ERA g 
ception E rom 类 的 对 象 ， 代 表 发 生 错 误 的 JSP 页 面 中 对 应 的 异常 对 

request 对 象 


request 对 象 是 javax.servlet.http.HttpServletRequest 类 的 实例 。 每 当 客户 端 请 求 一 
个 JSP 页 面 时 ，JSP 引 擎 就 会 制造 一 个 新 的 request 对 象 来 代表 这 个 请 求 。 


request 对 象 提 供 了 一 系列 方法 来 获取 HTTP 头 信息 ，cookies，HTTP 方 法 等 等 。 


response 对 象 


response 对 象 是 javax.servlet.http.HttpServletResponse 类 的 实例 。 当 服务 器 创建 
request 对 象 时 会 同时 创建 用 于 响应 这 个 客户 端的 response 对 象 。 


response 对 象 也 定义 了 义理 HTTP 头 模块 的 接口 。 通 过 这 个 对 象 ， 开 发 者 们 可 以 添 
加 新 的 cookies， 时 间 惟 ，HTTP 状 态 码 等 等 。 


out 对 象 


outs} R= javax.servlet.jsp.JspWriter 类 的 实例 ， 用 来 在 response 对 象 中 写 人 内 
容 。 


最 初 的 JspWriter 类 对 象 根据 页 面 是 否 有 缓存 来 进行 不 同 的 实例 化 操作 。 可 以 在 
page 指 令 中 使 用 buffered= 'false' 属 性 来 轻松 关闭 缓存 。 


JspWriter 类 包含 了 大 部 分 java.io.PrintWriter 类 中 的 方法 。 不 过 ，JspWriter 新 增 了 一 
些 专 为 处 理 缓存 而 设计 的 方法 。 还 有 就 是 ，JspWriter 类 会 抛 出 IOExceptions 异 常 ， 
而 PrintWriter 不 会 。 


下 表 列 出 了 我 们 将 会 用 来 输出 boolean，char，int，double，Srtring，object 等 类 型 
数据 的 重要 方法 : 


方法 描述 
out.print(dataType dt) 输出 Type 类 型 的 值 
out.printin(dataType dt) 输出 Type 类 型 的 值 然 后 换行 
out.flush() 刷新 输出 流 
session 对 象 


session 对 象 是 javax.servlet.http.HttpSession 类 的 实例 。 和 Java Servlets 中 的 
Session 对象 有 一 样 的 行为 。 


session 对 象 用 来 跟踪 在 各 个 客户 端 请 求 间 的 会 话 。 


application 对 象 
application 对 象 直接 包装 了 servlet 的 ServletContext 类 的 对 象 ， 是 
javax.servlet.ServletContext 类 的 实例 。 


这 个 对 象 在 JSP 页 面 的 整个 生命 周期 中 都 代表 着 这 个 JSP 页 面 。 这 个 对 象 在 JSP 页 
面 初始 化 时 被 创建 ， 随 着 jspDestroy() 方 法 的 调用 而 被 移 除 。 


通过 向 application 中 添加 属性 ， 则 所 有 组 成 您 web 应 用 的 JSP 文 件 都 能 访问 到 这 些 
属性 。 


config 对 象 


config 对 象 是 javax.servlet.ServletConfig 类 的 实例 ， 直 接 包 装 了 servlet 的 
ServletConfig 类 的 对 象 。 
这 个 对 象 允 许 开 发 者 访问 Servlet 或 者 JSP 引 警 的 初始 化 参数 ， 比 如 文件 路 径 等 。 


以 下 是 config 对 象 的 使 用 方法 ， 不 是 很 重要 ， 所 以 不 常用 : 


config.getServletName(); 


它 返 回 包 含 在 <servlet-name> 元 素 中 的 servlet 名 字 ， 注意，<servlet-name> 元 素 在 
WEB-INF\web.xml 文件 中 定义 。 


pageContext 对 象 
pageContext 对 象 是 javax.servlet.jsp.PageContext 类 的 实例 ， 用 来 代表 整个 JSP 页 
面 。 

这 个 对 象 主要 用 来 访问 页 面 信 息 ， 同 时 过 滤 掉 大 部 分 实现 细节 。 


这 个 对 象 存储 了 request 对 象 和 response 对 象 的 引用 。application 对 象 ，config 对 
象 ，session 对 象 ，out 对 象 可 以 通过 访问 这 个 对 象 的 属性 来 导出 。 


pageContext 对 象 也 包含 了 传 给 JSP 页 面 的 指 今 信息 ， 包 括 缓存 信息 ，ErrorPage 
URL, ,页 面 scope 等 。 


PageContext 类 定义 了 一 些 字段 ， 包 括 PAGE_SCOPE，REQUEST SCOPE, 
SESSION_SCOPE，APPLICATION_SCOPE。 它 也 提供 了 40 余 种 方法 ， 有 一 半 
继承 自 javax.servlet.jsp.JspContext 类 。 


其 中 一 个 重要 的 方法 就 是 removeArribute()， 它 可 接受 一 个 或 两 个 参数 。 上 比如 ， 
pageContext.removeArribute("attrName") 移 除 四 个 scope 中 相关 属性 ， 但 是 下 面 这 
种 方法 只 移 除 特定 scope 中 的 相关 属性 : 


pageContext.removeAttribute("attrName", PAGE SCOPE); 


page 对 象 


这 个 对 象 就 是 页 面 实例 的 引用 。 它 可 以 被 看 做 是 整个 JSP 页 面 的 代表 。 
page 对 象 就 是 this 对 象 的 同义词 。 


exception 对 象 


exception 对 象 包装 了 从 先前 页 面 中 抛 出 的 异常 信息 。 它 通常 被 用 来 产生 对 出 错 条 
件 的 适当 响应 。 


JSP & P imik 


当 浏 览 器 请 求 一 


x 
sk 
pd 


个 网 页 时 ， 它 会 向 网 络 服务 器 发 送 一 系列 不 能 被 直接 读 取 的 信息 ， 


eee ee 部 分 来 传送 的 。 您 可 以 查阅 HTTP 协 议 来 获得 


更 多 的 信息 。 


下 表 列 出 了 浏览 器 端 信 息 关 的 一 些 重要 内 容 ， 在 以 后 的 网 络 编程 中 将 会 经 常 


些 些 信息 AUN : 

{5 息 
Accept 
Accept- 
Charset 
Accept- 
Encoding 


Accept- 
Language 


Authorization 


Connection 


Content- 
Length 


Cookie 
Host 


If-Modified- 
Since 


If- 
Unmodified- 
Since 


Referer 


User-Agent 


见 到 这 


指定 浏览 器 或 其 他 客户 端 可 以 处 理 的 MIME 类 型 。 它 的 值 通 
为 image/png = image/jpeg 


指定 浏览 器 要 使 用 的 字符 集 。 比 如 ISO-8859-1 


指定 编码 类 型 。 它 的 值 通常 为 gzip 或 compress 


指定 客户 端 首 选 语言 ，servlet 会 优先 返回 以 当前 语言 构成 的 结 
果 集 ， 如 果 servlet 支 持 这 种 语言 的 话 。 比 如 en, en-us, ru% 
等 


在 访问 受 密码 保护 的 网 页 时 识别 不 同 的 用 户 


表明 客户 端 是 否 可 以 处 理 HTTP 持 久 连 接 。 持 久 连 接 允 许 客户 
端 或 浏览 器 在 一 个 请 求 中 获取 多 个 文件 。Keep-Alive 表示 启用 
持久 连接 


仅 适 用 于 POST 请 求 ， 表 示 POST 数据 的 字 节 数 


返回 先前 发 送 给 浏览 器 的 cookies 至 服务 器 
指出 原始 URL 中 的 主机 名 和 端口 号 


表明 只 有 当 网 页 在 指定 的 日 期 被 修改 后 客户 端 才 需 要 这 个 网 
页 。 服务 器 发 送 304 码 给 zs Pam, 表示 没有 更 新 的 资源 
只 有 文档 在 指定 


0 Since 相 反 ， 日 期 后 仍 未 被 修改 


， 操 作 才 会 成 功 


标志 着 所 引用 页 面 的 URL。 上 比如， 如 果 你 在 页 面 1， 
Ree XIB?, 那么 页 面 1 的 URL 就 会 包含 在 浏览 器 
2 的 信息 头 中 


用 来 区 分 不 同 浏 览 器 或 客户 端 发 送 的 请 求 ， 并 对 不 同类 型 的 浏 
览 器 返回 不 同 的 内 容 


A ei RR af 
请 求 页 面 


HttpServletRequest # 
request 对 象 是 javax.servlet.http.HttpServletRequest 类 的 实例 。 每 当 客 户 端 请 求 一 
个 页 面 时 ，JSP 引 擎 就 会 产生 一 个 新 的 对 象 来 代表 这 个 请 求 。 


request 对 象 提 供 了 一 系列 方法 来 获取 HTTP 信 息 头 ， 包 括 表单 数据 ，cookies， 
HTTP 方 法 等 等 。 

接 下 来 将 会 介绍 一 些 在 JSP 编 程 中 常用 的 获取 HTTP 信 息 头 的 方法 。 详 细 内 容 请 见 
FE: 


方法 
Cookie[] getCookies() 


Enumeration 
getAttributeNames() 


Enumeration 
getHeaderNames() 


Enumeration 
getParameterNames() 


HttpSession getSession() 
HttpSession 
getSession(boolean 
create) 


Locale getLocale() 


Object getAttribute(String 
name) 


ServietinputStream 
getinputStream() 


String getAuthType() 


String 
getCharacterEncoding() 


String getContentType() 


String getContextPath() 
String getHeader(String 


描述 
回 客户 端 所 有 的 Cookie 的 数组 


M 


xil 


ki Ok 


返回 request 对 象 的 所 有 属性 名 称 的 集合 
返回 所 有 HTTP 头 的 名 称 集 合 


返回 请 求 中 所 有 参数 的 集合 
返回 request 对 应 的 session 对 象 ， 如 果 没 有 ， 
则 创建 一 个 


返回 request 对 应 的 session 对 象 ， 如 果 没 有 并 
且 参 数 create 为 true， 则 返回 一 个 新 的 session 
对 象 


返回 当前 页 的 Locale 对 象 ， 可 以 在 response 中 
设置 
返回 名 称 为 name 的 属性 值 ， 如 果 不 存在 则 返回 
null, 


返回 请 求 的 输入 流 


返回 认证 方案 的 名 称 ， 用 来 保护 servlet， 比 如 
"BASIC" 或 者 "SSL" sk null 如 果 JSP 没 设置 保 
护 措施 


返回 request 的 字符 编码 集 名 称 


返回 request 主 体 的 MIME 类 型 ， 若 未 知 则 返回 
null 


返回 request URI 中 指明 的 上 下 文 路 径 


name) 

String getMethod() 

String getParameter(String 
name) 

String getPathInfo() 

String getProtocol() 

String getQueryString() 
String getRemoteAddr() 
String getRemoteHost() 


String getRemoteUser() 


String getRequestURI() 


String 
getRequestedSessionld() 


String getServletPath() 


String[] 
getParameterValues(String 
name) 


返回 此 request 中 的 HTTP 方 法 ， 比 如 GET,, 
POST， 或 PUT 


返回 此 request 中 name 指 定 的 参数 ， 若 不 存在 


则 返回 null 

返回 任何 额外 的 与 此 request URL 相 关 的 路 径 
返回 此 request 所 使 用 的 协议 名 和 版 本 

返回 此 request URL 包 含 的 查询 字符 串 
返回 客户 端的 I|P 地 址 

返回 客户 端的 完整 名 称 

登录 认证 的 用 户 ， 若 用 户 未 认 


li 


返回 客户 端 通过 
证 则 返回 null 


返回 request 的 URI 
返回 request 指 定 的 session ID 
返回 所 请 求 的 servlet 路 径 


返回 指定 名 称 的 参数 的 所 有 值 ， 若 不 存在 则 返 
回 null 


Boolean eeenrel ae 否 使 用 了 加 密 通 道 ， 比 如 

int getContentkengthi) B HUM 若 未 知 的 返 
Se 返回 指定 名 称 的 request 信 息 头 的 值 

int getServerPort() 返回 服务 器 端口 号 

HTTP 信 息 头 示例 


在 这 个 例子 中 ， 我 们 会 使 用 HttpServletRequest 类 的 getHeaderNames() 方 法 来 读 取 
HTTP 信 息 头 。 这 个 方法 以 枚 举 的 形式 返回 当前 HTTP 请 求 的 头 信 息 。 


获取 Enumeration 对 象 后 ， 用 标准 的 方式 来 通 历 Enumeration 对 象 ， 用 
hasMoreElements() 方 法 来 确定 什么 时 候 停 止 ， 用 nextElement() 方 法 来 获得 每 
数 的 名 字 。 


个 参 


«99 page import="java.io.*,java.util.*" %> 
<html> 
<head> 
<title>HTTP Header Request Example</title> 
</head> 
<body> 
<center> 
<h2>HTTP Header Request Example</h2> 
<table width="100%" border="1" align="center"> 
<tr bgcolor="#949494"> 
<th>Header Name</th><th>Header Value(s)</th> 
</tr> 
<% 
Enumeration headerNames = request.getHeaderNames(); 
while(headerNames.hasMoreElements()) { 
String paramName = (String)headerNames.nextElement(); 
out.print("<tr><td>" + paramName + "</td>\n"); 
String paramValue = request.getHeader (paramName) ; 
out.println("«td» " + paramValue + "</td></tr>\n"); 
} 
%> 
</table> 
</center> 
</body> 
</html> 


访问 main.jsp， 将 会 得 到 以 下 结果 : 


<hi>HTTP Header Request Example</h1> 

<table width="100%" border="1" align="center"> 

<tbody> 

<tr><th>Header Name</th><th>Header Value(s)</th></tr> 

<tr><td>accept</td><td>*/*</td></tr> 

<tr><td>accept - language</td><td>en-us</td></tr> 

<tr><td>user -agent</td><td>Mozilla/4.0 (compatible; MSIE 7.0; Wind 

<tr><td>accept -encoding</td><td>gzip, deflate</td></tr> 

<tr><td>host</td><td>localhost :8080</td></tr> 

<tr><td>connection</td><td>Keep-Alive</td></tr> 

<tr><td>cache-control</td><td>no-cache</td></tr> 

</tbody> 

</table> 
OSS 
您 可 以 在 上 面 代 码 中 党 试 HttpServletRequest 类 的 其 它 方法 。 





JSP Hh aSr Dy 


Response Ù xt R= BH ISPH SR Ae FE JL 4 SR (E [o] 0 Pim, A bow 
response 变 量 设 置 HTTP 的 状态 和 向 客户 端 发 送 数据 ， 如 Cookie、HTTP 文 件 头 信 
息 等 。 


一 个 典型 的 响应 看 起 来 就 像 下 面 这 样 : 


HTTP/1.1 200 OK 
Content-Type: text/html 
Header2: 
HeaderN: 

(Blank Line) 
<!doctype ...> 
«html» 
<head>. . .</head> 
<body> 
</body> 
</html> 


状态 行 包 含 HTTP 版 本 信息 ， 比 如 HTTP/1.1， 一 个 状态 码 ， 比 如 200， 还 有 一 个 非 
常 短 的 信息 对 应 着 状态 码 ， 比 如 OK。 


下 表 摘 要 出 了 HTTP1.1 响 应 头 中 最 有 用 的 部 分 ， 在 网 络 编程 中 您 将 会 经 常见 至 
i] : 


qi 


响应 头 描述 

Allow 指定 服务 器 支持 的 request 方 法 (GET，POST 等 等 ) 
指定 响应 文档 能 够 被 安全 缓存 的 情况 。 通 常 取 值 为 

Cache- public**, **private no-cache 等 等 。 Public 意 味 着 文档 可 缓 

Control 存 ，Private 意 味 着 文档 只 为 单 用 户 服务 并 且 只 能 使 用 私有 缓存 。 
No-cache 意味 着 文档 不 被 缓存 。 
命 全 浏览 器 是 否 要 使 用 持久 的 HTTP 连 接 。close* 值 ** 命令 浏 览 

Connection ”器 不 使 用 持久 HTTP 连 接 ， 而 keep-alive 意味 着 使 用 持久 化 连 

Content- "pow ur BERA SIS en DLA EA NIE A 

Biscosition 让 浏览 器 要 求 用 户 将 响应 以 给 定 的 名 称 存 储 在 磁盘 中 

a ie 指定 传输 时 页 面 的 编码 规则 

Content- ri = 

DOM 表述 文档 所 使 用 的 语言 ， 比 如 en， en-us, russ 

Content- 表明 响应 的 字 节 数 。 只 有 在 浏览 器 使 用 持久 化 (keep-alive) 

Length HTTP 连接 时 才 有 用 

Content — 表明 文档 使 用 的 MIME 类 型 

ype 

Expires 旨 明 哈 时 候 过 期 并 从 缓存 中 移 除 

Last- 旨 明 文档 最 后 修改 时 间 。 客 户 端 可 以 缓存 文档 并 且 在 后 续 的 请 求 

Modified 中 提供 一 个 If-Modified-Since 请 求 头 

oe 在 300 秒 内 ， 包 含 所 有 的 有 一 个 状态 码 的 响应 地 址 ， 浏 览 器 会 自 
动 重 连 然后 检索 新 文档 

Refresh 指明 浏览 器 每 隔 多 久 请 求 更 新 一 次 页 面 。 

Retry-After 3503 (Service Unavailable) 一 起 使 用 来 告诉 用 户 多 久 后 请 求 将 
会 得 到 响应 

Set-Cookie 旨 明 当前 页 面 对 应 的 cookie 


HttpServletResponse X 


response 对 象 是 javax.servlet.http.HttpServletRequest 类 的 一 个 实例 。 就 像 服务 器 
会 创建 request 对 象 一 样 ， 它 也 会 创建 一 个 客户 端 响应 。 


response 对 象 定义 了 义理 创建 HTTP 信 息 头 的 接口 。 通 过 使 用 这 个 对 象 ， 开 发 者 们 
可 以 添加 新 的 cookie 或 时 间 戳 ， 还 有 HTTP 状 态 吗 等 等 。 


下 表 列 出 了 用 来 设置 HTTP 响 应 头 的 方法 ， 这 些 方法 由 HttpServletResponse # tz 


供 : 


方法 


String 
encodeRedirectURL(String 
url) 


String encodeURL(String url) 


boolean 
containsHeader(String 
name) 


boolean isCommitted() 


void addCookie(Cookie 
cookie) 


void addDateHeader(String 
name, long date) 


void addHeader(String name, 
String value) 


void addintHeader(String 
name, int value) 


void flushBuffer() 


void reset() 


void resetBuffer() 


void sendError(int sc) 
void sendError(int sc, String 
msg) 


void sendRedirect(String 
location) 


void setBufferSize(int size) 
void 
setCharacterEncoding(String 
charset) 


void setContentLength(int 
len) 


iE 


TEX 
对 sendRedirect() 方 法 使 用 的 URL 进 行 编码 
将 URL 编 码 ， 回 传 包 含 Session ID 的 URL 
返回 指定 的 响应 头 是 否 存在 


返回 响应 是 否 已 经 提交 到 客户 端 


添加 指定 的 cookie 至 响应 中 
添加 指定 名 称 的 响应 头 和 日 期 值 
添加 指定 名 称 的 响应 头 和 值 


添加 指定 名 称 的 响应 头 和 int 值 


将 任何 缓存 中 的 内 容 写 人 客户 端 


清除 任何 缓存 中 的 任何 数据 ， 包 括 状 态 码 和 
各 种 响应 头 


清除 基本 的 缓存 数据 ， 不 包括 响应 头 和 状态 
码 


使 用 指定 的 状态 码 向 客户 端 发 送 一 个 出 错 响 
应 ， 然 后 清除 缓存 


使 用 指定 的 状态 码 和 消息 向 客户 端 发 送 一 个 
出 错 响 应 


使 用 指定 的 URL 向 客户 端 发 送 一 个 临时 的 间 
接 响 应 


设置 响应 体 的 缓存 区 大 小 


指定 响应 的 编码 集 (MIME 字 符 集 ) ， 例 如 
UTF-8 


指定 HTTP servlets 中 响应 的 内 容 的 长 度 ， 此 
方法 用 来 设置 HTTP Content-Length 信息 头 


void setContentType(String 设置 响应 的 内 容 的 类 型 ， 如 果 响 应 还 未 被 提 
type) 交 的 话 


void setDateHeader(String bon Hr DER eer m 


void setHeader(String name, Eco 47 Hr BR on rs 1 HS RR es 
String value) 使 用 指定 名 称 和 值 设置 响应 头 的 名 称 和 内 容 


void setlntHeader(String — ae "— 二 


设置 响应 的 语言 环境 ， 如 果 响 应 尚未 被 提交 


void setLocale(Locale loc) 的 话 


void setStatus(int sc) 设置 响应 的 状态 码 


HTTP 5; k T& Fe RH 


接 下 来 的 例子 使 用 setlntHeader() 方 法 和 setRefreshHeader() 方 法 来 模拟 一 个 数字 时 


钟 : 


<%@ page import="java.io.*,java.util.*" %> 
«html» 

«head» 

<title>Auto Refresh Header Example</title> 
«/head» 

«body» 

«center» 

<h2>Auto Refresh Header Example</h2> 


<% 


%> 


// 设置 每 隔 5 秒 自动 刷新 
response.setIntHeader("Refresh", 5); 
// 获取 当前 时 间 
Calendar calendar = new GregorianCalendar(); 
String am pm; 
int hour - calendar.get(Calendar.HOUR); 
int minute - calendar.get(Calendar.MINUTE); 
int second - calendar.get(Calendar.SECOND); 
if(calendar.get(Calendar.AM PM) -- 0) 

am pm = "AM"; 
else 

am pm = "PM"; 
String CT = hourt+":"+ minute +":"+ second +" "+ am pm; 
out.println("Current Time is: " + CT + "\n"); 


</center> 
</body> 
</html> 


将 以 上 代码 保存 为 main.jsp， 然 后 通过 浏览 器 访问 它 。 它 将 会 每 隔 5 秒 显示 一 下 系统 
当前 时 间 。 


运行 结果 如 下 : 


Auto Refresh Header Example 
Current Time is: 9:44:50 PM 


您 也 可 以 自己 动手 修改 以 上 代码 ， 试 试 使 用 其 他 的 方法 ， 将 能 得 到 更 深 的 体会 。 


JSP HTTP KA 


HTTP 请 求 与 HTTP 响 应 的 格式 相近 ， 都 有 着 如 下 结构 : 


。 以 状态 行 +CRLF ( 回 车 换行 ) 开始 
。 规 行 或 多 行头 模块 +CRLF 

。 一 个 空 行 ， 比 如 CRLF 

。 可 选 的 消息 体 比 如 文件 ， 查 询 数据 ， 查 询 输 出 


举例 来 说 ， 一 个 服务 器 响应 头 看 起 来 就 像 下面 这 样 : 


HTTP/1.1 200 OK 
Content-Type: text/html 
Header2: ... 


HeaderN: ... 
(Blank Line) 

<!doctype ...> 

<html> 

<head>. ..</head> 

<body> 

</body> 

</html> 


状态 行 包含 HTTP 版 本 ， 一 个 状态 码 ， 和 状态 码 相对 应 的 短 消 息 。 

下 表 列 出 了 可 能 会 从 服务 器 返回 的 HTTP 状 态 码 和 和 与 之 关联 的 消息 : 
状 
A 


Ef 


ONN 消息 摘 ; 
码 
只 有 一 部 分 请 求 被 服务 器 接收 ， 但 只 要 没 被 服务 器 拒 


100 Continue rus : MES 
绝 ， 客 户 端 就 会 延续 这 个 请 求 


dM Festa 服务 器 交换 机 协议 
200 | OK 请 求 被 确认 
201 Created 请 求 时 完整 的 ， 新 的 资源 被 创建 
202 Accepted 请 求 被 接受 ， 但 未 义理 完 
Non- 


203 authoritative 
Information 


204 
205 


206 


300 


301 


302 
303 
304 
305 
306 


307 


400 
401 


402 


403 
404 


405 


406 


407 


408 


409 
410 


411 


No Content 
Reset Content 


Partial 
Content 


Multiple 
Choices 


Moved 
Permanently 


Found 

See Other 
Not Modified 
Use Proxy 
Unused 


Temporary 
Redirect 


Bad Request 
Unauthorized 


Payment 
Required 


Forbidden 
Not Found 


Method Not 
Allowed 


Not 
Acceptable 


Proxy 
Authentication 
Required 


Request 
Timeout 


Conflict 
Gone 


Length 
Required 


一 个 超 链接 表 ， 用 户 可 以 选择 一 个 超 链接 并 访问 ， 最 
大 支持 5 个 超 链接 


被 请 求 的 页 面 已 经 移动 到 了 新 的 URL 下 


被 请 求 的 页 面 暂 时 性 地 移动 到 了 新 的 URL 下 
被 请 求 的 页 面 可 以 在 一 个 不 同 的 URL 下 找到 


已 经 不 再 使 用 此 状态 码 ， 但 状态 码 被 保留 
被 请 求 的 页 面 暂 时 性 地 移动 到 了 新 的 URL 下 


服务 器 无 法 识别 请 求 
被 请 求 的 页 面 需 要 用 户 名 和 密码 


目前 还 不 能 使 用 此 状态 码 


禁止 访问 所 请 求 的 页 面 
服务 器 无 法 找到 所 请 求 的 页 面 


请 求 中 所 指定 的 方法 不 被 允许 


服务 器 只 能 创建 一 个 客户 端 无 法 接受 的 响应 


在 请 求 被 服务 前 必须 认证 一 个 代理 服务 器 


请 求 时 间 超 过 了 服务 器 所 能 等 待 的 时 间 ， 连 接 被 断 开 


请 求 有 矛盾 的 地 方 
被 请 求 的 页 面 不 再 可 用 


"Content-Length" 没 有 被 定义 ， 服 务 器 拒绝 接受 请 求 


412 


413 


505 


Precondition 
Failed 


Request 
Entity Too 
Large 


Request-url 
Too Long 


Unsupported 
Media Type 


Expectation 
Failed 


Internal 
Server Error 


Not 
Implemented 


Bad Gateway 


Service 
Unavailable 


Gateway 
Timeout 


HTTP Version 
Not 
Supported 


请 求 的 前 提 条 件 被 服务 器 评估 为 false 


因为 请 求 的 实体 太 大 ， 服 务 器 拒绝 接受 请 求 


服务 器 拒绝 接受 请 求 ， 因 为 URL 太 长 。 多 出 现在 
把 "POST" 请 求 转换 为 "GET" 请 求 时 所 附带 的 大 量 查 询 
信息 


服务 器 拒绝 接受 请 求 ， 因 为 媒体 类 型 不 被 支持 


请 求 不 完整 ， 服 务 器 遇见 了 出 乎 意料 的 状况 


请 求 不 完整 ， 服 务 器 不 提供 所 需要 的 功能 


请 求 不 完整 ， 服 务 器 从 上 游 服 务 器 接受 了 一 个 无 效 的 
响应 


请 求 不 完整 ， 服 务 器 暂时 重启 或 天 闭 


网 关 超时 


服务 器 不 支持 所 指定 的 HTTP 版 本 


设置 HTTP 状 态 码 的 方法 


下 表 列 出 了 HttpServletResponse 类 中 用 来 设置 状态 码 的 方法 : 


T bts Peto 
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方法 描述 
public void 此 方法 可 以 设置 任意 的 状态 码 。 如 果 您 的 响应 包含 一 
setStatus (int 个 特殊 的 状态 码 和 一 个 文档 ， 请 确保 在 用 PrintWriter 返 
statusCode ) 回 任何 内 容 前 调用 setStatus 方 法 


public void i 
sendRedirect(String 此 方法 产生 302 响 应 ， 同 时 产生 一 个 Location 头 告诉 


URL 一 个 新 的 文档 
url) 


public void 
sendError(int code, 
String message) 


此 方法 将 一 个 状态 码 (通常 为 404) 和 一 个 DAS, Ba 
插入 HTML 文 档 中 并 发 回 给 客户 端 


HTTP 状 态 码 程序 示例 


接 下 来 的 例子 将 会 发 送 407 错 误 码 给 浏览 器 ， 然 后 浏览 器 将 会 告诉 您 "Need 
authentication!!!". 


<html> 
<head> 
<title>Setting HTTP Status Code</title> 
</head> 
<body> 
<% 
eats, FARA 


E sendError(407, "Need authentication!!!" ); 
%> 


</body> 
</html> 


访问 以 上 JSP 页 面 ， 将 会 得 到 以 下 结果 : 


HTTP Status 407 - Need authentication!!! 
OTA Status report 
TETE Need authentication!!! 


MI IL Ihe client must first authenticate itself with the proxy (Need authentication!!!). 


您 也 可 以 试 试 使 用 其 他 的 状态 码 ， 看 会 不 会 得 到 什么 意 想不到 结果 。 


JSP 表单 处 理 


我 们 在 浏览 网 页 的 时 候 ， 经 常 需要 向 服务 器 提交 信息 ， 并 让 后 台 程 序 处 理 。 浏 览 器 
中 使 用 GET 和 POST 方法 向 服务 器 提交 数据 。 


GET 方法 


GET 方 法 将 请 求 的 编码 信息 添加 在 网 址 后 面 ， 网 址 与 编码 信息 通过 "?" 号 分 隔 。 如 下 
所 示 : 


http: //www.w3cschool.cc/hello?keyi-valuei1&key2-value2 


GET 方 法 是 浏览 器 默认 传递 参数 的 方法 ， 一 些 敏 感 信 息 ， 如 密码 等 建议 不 使 用 GET 


N 
ILo 


用 get 时 ， 传 输 数 据 的 大 小 有 限制 (注意 不 是 参数 的 个 数 有 限制 ) , RAA 1024F 
节 。 


POST 方法 


一 些 敏 感 信息 ， 如 密码 等 我 们 可 以 同 过 POST 方 法 传递 ，post 提 交 数 据 是 隐 式 的 。 


POST 提 交 数 据 是 不 可 见 的 ，GET 是 通过 在 url 里 面 传递 的 (可 以 看 一 下 你 浏览 器 的 
地 址 栏 ) 。 


JSP 使 用 getParameter() 来 获得 传递 的 参数 ，getinputStream() 方 法 用 来 处 理 客户 端 
的 二 进 制 数据 流 的 请 求 。 


JSP 污 取 表单 数据 


e getParameter(): 使 用 request.getParameter() 方法 来 获取 表单 参数 的 值 。 


e getParameterValues(): 获得 如 checkbox 类 (名 字 相 同 ， 但 值 有 多 个 ) 的 数 
据 。 接收 数组 变量 ， 如 checkobx 类 型 


e getParameterNames(): 该 方法 可 以 取得 所 有 变量 的 名 称 ， 该 方法 返回 一 个 
Emumeration, 


e getlnputStream(): 调 用 此 方法 来 读 取 来 自 客 户 端的 二 进 制 数据 流 。 


使 用 URL 的 GET 方法 实例 


以 下 是 一 个 简单 的 URL, 并 使 用 GET 方 法 来 传递 URL 中 的 参数 : 


http://localhost:8080/main.jsp?first name-ZARA&last name-ALI 


以 下 是 main.jsp 文 件 的 JSP 程 序 用 于 义理 客户 端 提交 的 表单 数据 ， 我 们 使 用 
getParameter() 方 法 来 获取 提交 的 数据 : 


<html> 
<head> 
<title>Using GET Method to Read Form Data</title> 
</head> 
<body> 
<center> 
<hi>Using GET Method to Read Form Data</h1i> 
«ul» 
<li><p><b>First Name:</b> 
<%= request.getParameter("first_name" )%> 
«/p»«/li» 
<li><p><b>Last Name:</b> 
<%= request.getParameter("last_name" )%> 
«/p»«/li» 
«/ul» 
«/body» 
«/html» 


接 下 来 我 们 通过 浏览 器 访问 http:/localhost:8080/main.jsp? 
first name=ZARA&last_name=ALI 输出 结果 如 下 所 示 : 


Using GET Method to Read Form Data 
First Name: ZARA 


Last Name: ALI 


使 用 表单 的 GET 方法 实例 


以 下 是 一 个 简单 的 HTML 表 单 ， 该 表单 通过 GET 方 法 将 客户 端 数据 提交 到 main.jsp 
文件 中 : 


<html> 

<body> 

<form action="main.jsp" method="GET"> 

First Name: <input type="text" name="first_name"> 
<br /> 

Last Name: <input type="text" name="last_name" /> 
<input type="submit" value="Submit" /> 

</form> 

</body> 

</html> 


将 以 上 HTML 代 码 保存 到 Hello.htm 文 件 中 。 将 该 文件 放置 于 <Tomcat 安 装 目录 
>/webapps/ROOT 目录 下 。 通过 访问 http://localhost:8080/Hello.htm， 输 出 界面 如 
TBI: 


First Name: 


Last Name: | Submit | 


在 "First Name" 4 "Last Name" 两 个 表单 中 填 入 信息 ， 并 点 击 "Submit" 按 纽 ， 它 将 
输出 结果 。 


使 用 表单 的 POST 方法 实例 


接 下 来 让 我 们 使 用 POST 方法 来 传递 表单 数据 ， 修 改 main.jsp 与 Hello.htm 文 件 代 
码 ， 如 下 所 示 : 


main.jsp 文 件 代 码 : 


<html> 
<head> 
<title>Using GET and POST Method to Read Form Data</title> 
</head> 
<body> 
<center> 
<hi>Using GET Method to Read Form Data</h1> 
«ul» 
<li><p><b>First Name:</b> 
<%= request.getParameter("first_name" )%> 
«/p»«/li» 
<li><p><b>Last Name:</b> 
<%= request.getParameter("last_name" )%> 
«/p»«/li» 
«/ul» 
«/body» 
«/html» 


以 下 是 Hello.htm 修 改 后 的 代码 : 


<html> 

<body> 

<form action="main.jsp" method="POST"> 

First Name: <input type="text" name="first_name"> 
<br /> 

Last Name: <input type="text" name="last_name" /> 
<input type="Submit" value="Submit" /> 

</form> 

</body> 

</html> 


通过 浏览 器 访问 http:/localhost:8080/Hello.htm， 输 出 如 下 : 


First Name: 


Last Name: | Submit | 


在 "First Name" 5 "Last Name" 两 个 表单 中 填 和 信息， 并 点 击 "Submit" 按 和 钮 ， 它 将 
输出 结果 。 


传递 Checkbox 数据 到 JSP 程 序 


复 选 框 checkbox 可 以 传递 一 个 其 至 多 个 数据 。 
以 下 是 一 个 简单 的 HTML 代 码 ， 并 将 代码 保存 在 CheckBox.htm 文 件 中 : 


«html» 

«body» 

«form action="main.jsp" method="POST" target="_blank"> 

<input type="checkbox" name="maths" checked="checked" /> Maths 

<input type="checkbox" name-"physics" /> Physics 

<input type="checkbox" name-"chemistry" checked="checked" /> 
Chemistry 

<input type="submit" value="Select Subject" /> 

</form> 

</body> 

</html> 


以 上 代码 在 浏览 器 访问 如 下 所 示 : 
以 下 为 main.jsp 文 件 代 码 ， 用 于 处 理 复 选 框 数 据 : 


«html» 
«head» 
<title>Reading Checkbox Data</title> 
</head> 
<body> 
<center> 
<hi>Reading Checkbox Data</h1> 
<ul> 
<li><p><b>Maths Flag:</b> 
<%= request.getParameter("maths")%> 
«/p»«/1li» 
<li><p><b>Physics Flag:</b> 
<%= request.getParameter("physics" )%> 
«/p»«/1li» 
<li><p><b>Chemistry Flag:</b> 
<%= request.getParameter("chemistry" )%> 
«/p»«/1li» 
</ul> 
</body> 
</html> 


以 上 实例 输出 结果 为 : 


v] Maths L] Physics V! Chemistry | Select Subject | 


读 取 所 有 表单 参数 
以 下 我 们 将 使 用 HttpServletRequest 的 getParameterNames() 来 读 取 所 有 可 用 的 表 
单 参 数 ,该 方法 可 以 取得 所 有 变量 的 名 称 ， 该 方法 返回 一 个 Emumeration。 


一 旦 我 们 有 了 一 个 Enumeration COE) ， 我 们 就 可 以 调用 hasMoreElements () 
方法 来 确定 何 时 停止 使 用 和 nextElement () 方法 来 获得 每 个 参数 的 名 称 。 


<%@ page import="java.io.*,java.util.*" %> 
«html» 
«head» 
<title>HTTP Header Request Example</title> 
«/head» 
«body» 
«center» 
<h2>HTTP Header Request Example</h2> 
«table width="100%" border="1" align="center"> 
«tr bgcolor="#949494"> 
<th>Param Name</th><th>Param Value(s)</th> 
</tr> 
<% 

Enumeration paramNames = request.getParameterNames(); 


while(paramNames.hasMoreElements()) { 
String paramName = (String)paramNames.nextElement(); 
out.print("<tr><td>" + paramName + "</td>\n"); 
String paramValue = request.getHeader (paramName) ; 
out.println("«td» " + paramValue + "</td></tr>\n"); 
} 
%> 
</table> 
</center> 
</body> 
</html> 


以 下 是 Hello.htm 文 件 的 内 容 : 


«html» 

«body» 

«form action="main.jsp" method="POST" target="_blank"> 

<input type="checkbox" name="maths" checked="checked" /> Maths 
<input type="checkbox" name-"physics" /> Physics 

<input type="checkbox" name-"chemistry" checked="checked" /> Chem 
<input type="submit" value-"Select Subject" /> 

</form> 

</body> 

</html> 


ee 
现在 我 们 通过 浏览 器 访问 Hello.htm 文件 并 提交 数据 ， 输 出 结果 如 下 : 


Reading All Form Parameters 


Param Name Param Value(s) 
maths on 


chemistry on 


你 可 以 尝试 使 用 以 上 的 JSP 代 码 读 取 其 它 对 象 ， 如 文本 框 ， 单 选 按钮 或 下 拉 框 等 等 
其 他 形式 的 数据 。 


JSP 过 小 在 


Servlet 和 JSP 中 的 过 滤器 都 是 Java 类 ， 它 们 存在 的 目的 如 下 : 


e 在 请 求 访问 后 端 资源 时 拦截 它 
e 管理 从 服务 器 返回 给 客户 端的 响应 


下 面 列 出 了 多 种 常用 的 过 滤器 类 型 : 


AGE We ae 
aa 

Mx Do nent 

登录 和 e 滤器 

Hee rs 滤器 
re 


过 滤器 将 会 被 插入 进 web.xml 文 件 中 ， 然 后 映射 servlet、JSP 文 件 的 名 字 ， 或 URL 
模式 。 部 署 描述 文件 web.xml 可 以 在 <Tomcat-installation-directory>\conf 目录 下 找 
到 。 


当 JSP 容 器 启动 网 络 应 用 程序 时 ， 它 会 创建 每 一 个 过 滤器 的 实例 ， 这 些 过 滤器 必须 
在 部 署 描 述 文件 web.xml 中 声明 ， 并 且 按 声明 的 顺序 执行 。 


Servlet 过 滤器 方法 


一 个 过 滤器 就 是 一 个 Java 类 ， 它 实现 了 javax.servlet.Filter 接口 。 
javax.servlet.Filter 接 口 定义 了 三 个 方法 : 


方法 描述 

public void doFilter 该 方法 在 每 次 一 个 请 求 /响应 对 因 客 户 端 在 
(ServletRequest, 链 的 末端 请 求 资 源 而 通过 链 传递 时 由 容器 
ServietResponse, FilterChain) 调用 。 
public void init(FilterConfig 该 方法 由 Web 容器 调用 ， 指 示 一 个 过 滤 
filterConfig) 器 被 放 入 服务 。 

. : 该 方法 由 Web 容器 调用 ， 指 示 一 个 过 滤 
public void destroy() 器 被 取出 服务 。 


这 个 例子 将 会 打印 IP 地 址 和 每 次 访问 JSP 文 件 的 日 期 时 间 。 当 然 ， 这 只 是 个 简单 的 
me 上 您 了 解 一 些 简单 的 过 滤器 用 法 ， 但 是 可 以 使 用 这 些 概念 来 自行 构造 更 复杂 
的 程 


// 3 引入 Java 包 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.* 
import java.util.*; 


// 实现 Filter X 
public class LogFilter implements Filter { 
public void init(FilterConfig config) 
throws ServletException{ 
/ 获取 初始 化 参数 
String testParam = config.getInitParameter("test-param"); 


// 打 印 初始 化 参数 
System.out.println("Test Param: " + testParam); 


public void doFilter(ServletRequest request, 
ServletResponse response, 
FilterChain chain) 
throws java.io.IOException, ServletException { 


/ 获取 客户 端 ip 地 址 
String ipAddress = request.getRemoteAddr(); 


// 输出 ip 地 址 及 当前 时 间 
System.out.println("IP "+ ipAddress + ", Time " 
+ new Date().toString()); 


// 传递 请 求 道 过 滤器 链 
chain.doFilter(request, response) ; 


j 
public void destroy( ){ 

/* 在 Filter 实 例 在 服务 器 上 被 移 除 前 调用 。*/ 
} 


编译 LogFilter.java 文 件 ， 然 后 将 编译 后 的 class 文 件 放 在 <Tomcat 安 装 目 录 
>/webapps/ROOT/WEB-INF/classes 目 录 下 。 


web.xml 文 件 中 的 JSP 过 滤器 映射 


过 滤器 被 定义 ， 然 后 映射 成 一 个 URL 或 JSP 文 件 名 ， ne Ni 映射 的 方 
式 差 不 多 。 在 部 署 描 述 文件 web.xml 中 ， 使 用 <filter> 标 签 来 进行 过 滤器 映射 : 


«filter» 
«filter-name»LogFilter«/filter-name» 
<filter-class>LogFilter</filter-class> 
<init -param> 

<param-name>test -param</param-name> 
<param-value>Initialization Paramter</param-value> 
</init-param> 

</filter> 

<filter -mapping> 
<filter -name>LogFilter</filter -name> 
<url-pattern>/*</url-pattern> 

</filter -mapping> 


上 述 过 滤器 将 会 应 用 在 所 有 servlet 和 和 JSP 程序 中 ， 因 为 我 们 在 配置 中 指定 了 " /*"。 
您 也 可 以 指定 一 个 servlet 或 JSP 路 径 ， 如 果 您 只 想 要 将 过 滤器 应 用 在 少数 几 个 
servlet 或 JSP 程 序 中 的 话 。 


现在 ， 像 平常 一 样 访 问 Sservlet 或 JSP 页 面 ， 您 就 会 发 现 服务 器 日 志 中 产生 了 关于 此 
次 访问 的 记录 。 您 也 可 以 使 用 Log4J 记 录 器 来 把 日 志 记 录 在 其 它 文件 中 。 


使 用 多 重 过 滤器 


您 的 网 络 应 用 程序 可 以 定义 很 多 不 同 的 过 滤器 。 现 在 ， 您 定义 了 两 个 过 小 器， 
AuthenFilter 和 LogFilter， 其 它 的 步 又 与 前 面 讲 的 一 样 ， 除 非 要 创建 一 个 不 同 的 映 
射 ， 就 像 下 面 这 样 : 


«filter» 
«filter-name»LogFilter«/filter-name» 
<filter-class>LogFilter</filter-class> 
<init -param> 
<param-name>test -param</param-name> 
<param-value>Initialization Paramter</param-value> 
</init-param> 
</filter> 


<filter> 
<filter-name>AuthenFilter</filter -name> 
<filter-class>AuthenFilter</filter-class> 
<init -param> 
<param-name>test -param</param-name> 
<param-value>Initialization Paramter</param-value> 
«/init-param» 
</filter> 


<filter -mapping> 
<filter-name>LogFilter</filter -name> 
<url-pattern>/*</url-pattern> 
</filter -mapping> 


<filter -mapping> 
<filter -name>AuthenFilter</filter -name> 
<url-pattern>/*</url-pattern> 

</filter -mapping> 


过 滤器 的 应 用 顺序 


在 web.xml 中 <filter> 元 素 的 映射 顺序 决定 了 容器 应 用 这 些 过 滤器 的 顺序 。 要 反 转 应 
用 的 顺序 ， 您 只 需要 反 转 web.xml 中 <filter> 元 素 的 定义 顺序 就 行 了 。 


比如 ， 上 面 的 例子 会 首先 应 用 LogFilter 然 后 再 应 用 AuthenFilter， 但 是 下 面 这 个 例 
子 将 会 反 转 应 用 的 顺序 : 


<filter-mapping> 
<filter-name>AuthenFilter</filter-name> 
<url-pattern>/*</url-pattern> 

</filter -mapping> 


<filter -mapping> 
<filter-name>LogFilter</filter -name> 
<url-pattern>/*</url-pattern> 
</filter -mapping> 


JSP Cookies 4418 


Cookies 是 存储 在 客户 机 的 文本 文件 ， 它 们 保存 了 大 量 轨迹 信息 。 在 servlet 技 术 基 
础 上 ，JSP 显 然 能 够 提供 对 HTTP cookies 的 支持 。 


通常 有 三 个 步骤 来 识别 回头 客 : 


e 服务 器 脚本 发 送 一 系列 cookies 至 浏览 器 。 比 如 名 字 ， 年 龄 ，1D 号 码 等 等 。 

e 浏览 器 在 本 地 机 中 存储 这 些 信息 ， 以 备 不 时 之 需 。 

e 当下 一 次 浏览 器 发 送 任 何 请 求 至 服务 器 时 ， 它 会 同时 将 这 些 cookies 信 息 发 送 给 
服务 器 ， 然 后 服务 器 使 用 这 些 信息 来 识别 用 户 或 者 干 些 其 它 事情 。 


本 章节 将 会 传授 您 如 何 去 设 置 或 重 设 cookie 的 方法 ， 还 有 如 何 访 问 它们 及 如 何 删 除 
它们 。 


Cookie®|#7 


ad sui W e (虽然 JavaScript 能 够 直接 在 浏览 器 中 设置 
cookies) 。 在 JSP 中 ， 设 置 一 个 cookie 需 要 发 送 如 下 的 信息 头 给 服务 器 : 


HTTP/1.1 200 OK 

Date: Fri, 04 Feb 2000 21:03:38 GMT 

Server: Apache/1.3.9 (UNIX) PHP/4.0b3 

Set-Cookie: name-xyz; expires-Friday, 04-Feb-07 22:03:38 GMT; 
path=/; domain-tutorialspoint.com 

Connection: close 

Content-Type: text/html 


正如 您 所 见 ，Set-Cookie 信 息 头 包含 一 个 键 值 对 ， 一 个 GMT (格林 尼 治 标准 ) 时 
间 ， 一 个 路 径 ， 一 个 域名 。 键 值 对 会 被 编码 为 URL。 有 效 期 域 是 个 指令 ， 告 诉 浏 览 
器 在 什么 时 候 之 后 就 可 以 清除 这 个 cookie。 


如 果 浏 览 器 被 配置 成 可 存储 cookies， 那 么 它 将 会 保存 这 些 信息 直到 过 期 。 如 果 用 户 
访问 的 任何 页 面 匹配 了 cookie 中 的 路 答 和 红 名 那么 浏览 器 将 会 重新 将 这 个 cookie 
回 给 服务 器 。 浏 览 器 端的 信息 头 长 得 就 像 下 面 这 样 : 


GET / HTTP/1.0 

Connection: Keep-Alive 

User-Agent: Mozilla/4.6 (X11; I; Linux 2.2.6-15apmac ppc) 
Host: zink.demon.co.uk:1126 

Accept: image/gif, */* 

Accept-Encoding: gzip 

Accept-Language: en 

Accept-Charset: iso-8859-1,*,utf-8 

Cookie: name=xyz 


li 


JSP 脚 本 通过 request 对 象 中 的 getCookies() 方 法 来 访问 这 些 cookies， 这 个 方法 会 ; 
回 一 个 Cookie 对 象 的 数组 。 


Servlet Cookies 方法 
下 表 列 出 了 Cookie 对 象 中 常用 的 方法 : 


方法 


public void 
setDomain(String 
pattern) 


public String 
getDomain() 


public void 
setMaxAge(int expiry) 


public int getMaxAge() 


public String 
getName() 


public void 
setValue(String 
newValue) 


public String 
getValue() 


public void 
setPath(String uri) 


public String getPath() 


public void 
setSecure(boolean 


flag) 
public void 


setComment(String 
purpose) 


public String 
getComment() 


Br 
EH 


设置 cookie 的 域名 ， 上 比如 w3cschool.cc 


获取 cookie 的 域名 ， 上 比如 w3cschool.cc 


设置 cookie 有 效 期 ， 以 秒 为 单位 ， 默 认 有 效 期 为 当 
前 session 的 存活 时 间 


获取 cookie 有 效 期 ， 以 秒 为 单位 ， 默 认为 -1 ， 表 明 
cookie 会 活 到 浏览 器 关闭 为 止 


返回 cookie 的 名 称 ， 名 称 创建 后 将 不 能 被 修改 


设置 cookie 的 值 


获取 cookie 的 值 


设置 cookie 的 路 径 ， 默 认为 当前 页 面目 录 下 的 所 有 
URL， 还 有 此 目录 下 的 所 有 子 目 录 
获取 cookie 的 路 径 


指明 cookie 是 否 要 加 密 传输 


设置 注释 描述 cookie 的 目的 。 当 浏览 器 将 cookie 展 
现 给 用 户 时 ， 注 释 将 会 变 得 非常 有 用 


返回 描述 cookie 目 的 的 注释 ， 若 没有 则 返回 null 


使 用 JSP 设 置 Cookies 


使 用 JSP 设 置 cookie 包 含 三 个 步骤 : 


(1) 创 建 一 个 Cookie 对 象 : 调用 Cookie 的 构造 男 数 ， 使 用 一 个 cookie 名 称 和 值 做 参 
数 ， 它 们 都 是 字符 串 。 


Cookie cookie = new Cookie("key", "value"); 
请 务必 牢记 ， 名 称 和 值 中 都 不 能 包含 空格 或 者 如 下 的 字符 : 


Dore 0 


(2) 设置 有 效 期 : 38 AsetMaxAge()e 2X BHcookiefr £ Kat i] (以 秒 为 单位 ) 内 有 
效 。 下 面 的 操作 将 有 效 期 设 为 了 24 小 时 。 


cookie. setMaxAge(60*60*24) ; 


(3) 将 cookie 发 送 至 HTTP 响 应 头 中 : 38 FHresponse.addCookie()ER GE ISIHTTP s 
应 头 中 添加 cookies。 


response.addCookie(cookie); 


<% 
// 为 first name 和 last namej;kti&cookie 
Cookie firstName = new Cookie("first name", 
request.getParameter("first name")); 
Cookie lastName - new Cookie("last name", 
request.getParameter("last name")); 


// 设置 cookie 过 期 时 间 为 24 小 时 。 
firstName.setMaxAge(60*60*24); 
lastName.setMaxAge(60*60*24); 


// 在 响应 头 部 添加 cookie 
response.addCookie( firstName ); 
response.addCookie( lastName ); 
%> 
<html> 
<head> 
<title>Setting Cookies</title> 
</head> 
<body> 
<center> 
<hi>Setting Cookies</h1> 
</center> 
<ul> 
<li><p><b>First Name:</b> 
<%= request.getParameter("first_name" )%> 
«/p»«/li» 
<li><p><b>Last Name:</b> 
<%= request.getParameter("last_name")%> 
«/p»«/li» 
</ul> 
</body> 
</html> 


将 上 面 两 个 文件 放 在 <Tomcat 安 装 目录 >/webapps/ROOT 目 录 下 ， 然 后 访问 
http://localhost:8080/hello.jsp， 将 会 得 到 如 下 输出 结 
First Name: 


Last Name: | Submit | 


试 着 输入 First Name 和 Last Name， 然 后 点 击 提交 按钮 ， 它 将 会 在 您 的 屏幕 中 显示 
first name 和 last name， 并 且 设 置 first name 和 last name 两 个 cookie， 下 一 次 点 击 提 
交 按 钮 时 会 发 给 服务 器 。 


使 用 JSP 读 取 Cookies 


想 要 读 取 cookies， 您 就 需要 调用 request.getCookies() 方 法 来 获得 一 
javax.servlet.http.Cookie 对 象 的 数组 ， 然 后 通 厉 这 个 数组 ， Re enim DES 
getValue() 方 法 来 获取 每 一 个 cookie 的 名 称 和 值 。 


让 我 们 来 读 取 上 个 例子 中 的 cookies。 


«html» 
«head» 
<title>Reading Cookies</title> 
</head> 
<body> 
<center> 
<hi>Reading Cookies</h1> 
</center> 
<% 
Cookie cookie = null; 
Cookie[] cookies = null; 
获取 cookies 的 数据 , 是 一 个 数组 
cookies = request.getCookies(); 
if( cookies != null ){ 
out.println("«h2» Found Cookies Name and Value</h2>"); 
for (int i = 0; i < cookies.length; i++){ 
cookie = cookies[i]; 


out.print("Name : " + cookie.getName( ) +", " 
out.print("Value: " + cookie.getValue( )+" <br/>"); 
} 
jelse( 
out.printin("<h2>No cookies founds</h2>") ; 
} 
%> 
</body> 
</html> 


如 果 您 把 first name cookie 设 置 成 "John"，last name 设 置 成 "Player"， 访 问 
http://localhost:8080/main.jsp， 将 会 得 到 如 下 输出 结 


Found Cookies Name and Value 
Name : first_name, Value: John 
Name : last name, Value: Player 


f& FHJSP it] KRCookies 


删除 cookies 非 常 简 单 。 如 果 您 想 要 删除 一 个 cookie， 按 照 下 面 给 的 步骤 来 做 就 行 
了 x 


e 获取 一 个 已 经 存在 的 cookie 然 后 存储 在 Cookie 对 象 中 。 
e 将 cookie 的 有 效 期 ; tE 4) 0. 
e. 将 这 个 cookie 重 新 添加 进 响 应 头 中 。 


实例 演示 


下 面 的 程序 删除 一 个 名 为 "first_name" 的 cookie， 当 您 下 次 运行 main.jsp 时 ， 
first_name 将 会 为 null。 


«html» 
«head» 
<title>Reading Cookies</title> 
</head> 
<body> 
<center> 
<hi>Reading Cookies</h1> 
</center> 
<% 
Cookie cookie = null; 
Cookie[] cookies = null; 
获取 当前 域名 下 的 cookies， 是 一 个 数组 
cookies = request.getCookies(); 
if( cookies != null ){ 
out.println("«h2» Found Cookies Name and Value</h2>"); 
for (int i = 0; i < cookies.length; i++){ 
cookie = cookies[i]; 
if((cookie.getName( )).compareTo("first name") == 0 ){ 
cookie.setMaxAge(0); 
response.addCookie(cookie); 
out.print("Deleted cookie: " + 
cookie.getName( ) + "«br/»"); 


j 
out.print("Name : " + cookie.getName( ) +", "); 
out.print("Value: " + cookie.getValue( )+" <br/>"); 


telsef{ 
out.println( 
"<h2>No cookies founds</h2>"); 
j 
%> 
</body> 
</html> 


访问 它 ， 将 会 得 到 如 下 输出 结果 : 


Cookies Name and Value 

Deleted cookie : first_name 
Name : first_name, Value: John 
Name : last_name, Value: Player 


再 次 访问 http:/localhost:8080/main.jsp， 将 会 得 到 如 下 结果 : 


Found Cookies Name and Value 
Name : last_name, Value: Player 


您 也 可 以 手动 在 浏览 器 中 删除 cookies。 点 击 Tools 菜 单项 ， 然 后 选择 Internet 
Options, = Delete Cookies， 就 能 删除 所 有 cookies 了 。 


JSP Session 

HTTP 是 无 状态 协议 ， 这 意味 着 每 次 客户 端 检 索 网 页 时 ， 都 要 单独 打开 一 个 服务 器 
连接 ， 因 此 服务 器 不 会 记录 下 先前 客户 端 请 求 的 任何 信息 。 

有 三 种 方法 来 维持 客户 端 与 服务 器 的 会 话 : 


Cookies 
网 络 服务 器 可 以 指定 一 个 唯一 的 session ID 作 为 cookie 来 代表 每 个 客户 端 ， 用 来 识 
别 这 个 客户 端 接 下 来 的 请 求 。 


这 可 能 不 是 一 种 有 效 的 方式 ， 因 为 很 多 时 候 浏 览 器 并 不 一 定 支 持 cookie， 所 以 我 们 
不 建议 使 用 这 种 方法 来 维持 会 话 。 


ERRA 


一 个 网 络 服务 器 可 以 发 送 一 个 隐藏 的 HTML 表 单 域 和 一 个 唯一 的 session ID, WRF 
面 这 样 : 


<input type="hidden" name="Sessionid" value="12345"> 


这 个 条 目 意味 着 ， 当 表单 被 提交 时 ， 指 定 的 名 称 和 值 将 会 自动 包含 在 GET 或 POST 
数据 中 。 每 当 浏览 器 发 送 一 个 请 求 ，session_id 的 值 就 可 以 用 来 保存 不 同 浏览 器 的 
轨迹 。 


这 种 方式 可 能 是 一 种 有 效 的 方式 ， 但 点 击 <A HREF> 标 签 中 的 超 链 接 时 不 会 产生 表 
单 提交 事件 ， 因 此 隐藏 表单 域 也 不 支持 通用 会 话 跟踪 。 


重 写 URL 
您 可 以 在 每 个 URL 后 面 添 加 一 些 额 外 的 数据 来 区 分 会 话 ， 服 务 器 能 够 根据 这 些 数据 
来 关联 session 标 识 符 。 


举例 来 说 ，http://w3cschool.cc/file.htm;sessionid=12345， session 标 识 符 为 
sessionid=12345， 服 务 器 可 以 用 这 个 数据 来 识别 客户 端 。 


相 比 而 言 ， 重 写 URL 是 更 好 的 方式 来 ， 就 算 浏 览 器 不 支持 cookies 也 能 工作 ， 但 缺点 
是 您 必须 为 每 个 URL 动 态 指定 session ID， 就 算 这 是 个 简单 的 HTML 页 面 。 


session 对 象 


除了 以 上 几 种 方法 外 ，JSP 利 用 servlet 提 供 的 HttpSession 接 口 来 识别 一 个 用 户 ， 存 
储 这 个 用 户 的 所 有 访问 信息 。 


默认 情况 下 ，JSP 人 允许 会 话 跟 踪 ， 一 个 新 的 HttpSession 对 象 业 会 自动 地 为 新 的 客户 
端 实例 化 。 禁 止 会 话 跟 踪 需 要 显 式 地 关 掉 它 ， 通 过 将 page 指 邻 中 session 属 性 值 设 
为 false 来 实现 ， 就 像 下 面 这 样 : 


<%@ page session="false" %> 


JSP5|E RE r& & B sessionxt 28368825 7T A A., AFH f sessioni, FRA 
可 以 方便 地 存储 或 检索 数据 。 


下 表 列 出 了 session 对 象 的 一 些 重要 方法 : 


方法 


public Object 
getAttribute(String name) 


public Enumeration 
getAttributeNames() 


public long 
getCreationTime() 


public String getld() 


public long 
getLastAccessedTime() 


public int 
getMaxlnactivelnterval() 


public void invalidate() 


public boolean isNew( 


public void 
removeAttribute(String 
name) 


public void 
setAttribute(String name, 
Object value) 


public void 
setMaxlnactivelnterval(int 
interval) 


描述 
返回 session 对 象 中 与 指定 名 称 绑 定 的 对 象 ， 
如 果 不 存 在 则 返回 null 
返回 session 对 象 中 所 有 的 对 象 名 称 
返回 session 对 象 被 创建 的 时 间 ， 以 毫秒 为 单 
位 ， 从 1970 年 1 月 1 号 凌晨 开始 算 起 
返回 session 对 象 的 ID 


返回 客户 端 最 后 访问 的 时 间 ， 以 窗 秒 为 单 
位 ， 从 1970 年 1 月 1 号 凌晨 开始 算 起 


返回 最 大 时 间 间 隔 ， 以 秒 为 单位 ，servlet 容 
器 将 会 在 这 段 时 间 内 保持 会 话 打开 


将 Session 无 效 化 ， 解 绑 任何 与 该 session 绑 定 
的 对 象 


返回 是 否 为 一 个 新 的 客户 端 ， 或 者 客户 端 是 
否 拒绝 加 入 session 


移 除 session 中 指定 名 称 的 对 象 


使 用 指定 的 名 称 和 值 来 产生 一 个 对 象 并 绑 定 
到 session 中 


用 来 指定 时 间 ， 以 秒 为 单位 ，servlet 容 器 将 
会 在 这 段 时 间 内 保持 会 话 有 效 


JSP Session % Ħ 


这 个 例子 描述 了 如 何 使 用 HttpSession 对 象 来 获取 创建 时 间 和 最 后 一 次 访问 时 间 。 我 
们 将 会 为 request 对 象 关 联 一 个 新 的 session 对 象 ， 如 果 这 个 对 象 尚未 存在 的 话 。 


<%@ page import="java.io.*,java.util.*" %> 
<% 
// 获取 session 创 建 时间 
Date createTime = new Date(session.getCreationTime()); 
// 获取 最 后 访问 页 面 的 时 间 
Date lastAccessTime = new Date(session.getLastAccessedTime()); 


String title = "Welcome Back to my website"; 
Integer visitCount = new Integer(0); 

String visitCountKey = new String("visitCount"); 
String userIDKey = new String("userID"); 

String userID = new String("ABCD"); 


// 检测 网 页 是 否 由 新 的 访问 用 户 
if (session.isNew())(1 
title = "Welcome to my website"; 
session.setAttribute(userIDKey, userID); 
session.setAttribute(visitCountKey,  visitCount); 
j 
visitCount - (Integer)session.getAttribute(visitCountKey); 
visitCount = visitCount + 1; 
userID = (String)session.getAttribute(userIDKey); 
session.setAttribute(visitCountKey,  visitCount); 
%> 
<html> 
<head> 
<title>Session Tracking</title> 
</head> 
<body> 
<center> 
<hi>Session Tracking</h1> 
</center> 
«table border="1" align="center"> 
<tr bgcolor="#949494"> 
<th>Session info</th> 
<th>Value</th> 
</tr> 
<tr> 
<td>id</td> 
<td><% out.print( session.getId()); %></td> 
</tr> 
<tr> 
<td>Creation Time</td> 
<td><% out.print(createTime); %></td> 
</tr> 
<tr> 


<td>Time of Last Access</td> 


<td><% out.print(lastAccessTime); %></td> 


</tr> 
<tr> 

<td>User ID</td> 

<td><% out.print(userID); %></td> 
</tr> 


<tr> 
<td>Number of visits</td> 
<td><% out.print(visitCount); %></td> 
</tr> 
</table> 
</body> 
</html> 


| 
试 着 访问 http://localhost:8080/main.jsp ， 第 一 次 运行 8 


Welcome to my website 


Session Infomation 


Session info value 

id 0AE3EC93FF44E3C525B4351B77ABB2D5 
Creation Time Tue Jun 08 17:26:40 GMT+04:00 2010 
Time of Last Access Tue Jun 08 17:26:40 GMT+04:00 2010 
User ID ABCD 

Number of visits 0 


再 次 访问 ， 将 会 得 到 如 下 结 


Welcome Back to my website 


Session Infomation 


info type value 

id 0AE3EC93FF44E3C525B4351B77ABB2D5 
Creation Time Tue Jun 08 17:26:40 GMT+04:00 2010 
Time of Last Access Tue Jun 08 17:26:40 GMT+04:00 2010 
User ID ABCD 

Number of visits 1 


删除 Session 数 所 


当 人 处理 完 一 个 用 户 的 会 话 数据 后 ， 您 可 以 有 如 下 选择 


DR 





会 得 到 如 下 结 


e 移 除 一 个 特定 的 属性 : 
调用 public void removeAttribute(String name) 方法 来 移 除 指 定 的 属性 。 
e 删除 整个 会 话 : 
调用 public void invalidate() 方法 来 使 整个 session 无 效 。 
设置 会 话 有 效 期 : 
调用 public void setMaxlnactivelnterval(int interval) 方法 来 设置 session 超 时 。 
e 登 出 用 户 : 


支持 servlet2.4 版 本 的 服务 器 ， 可 以 调用 logout() 方 法 来 登 出 用 户 ， 并 且 使 所 有 
相关 的 session 无 效 。 


配置 web.xml 文 件 : 
如 果 使 用 的 是 Tomcat， 可 以 向 下 面 这 样 配 置 web.xml 文 件 : 


<session-config> 
<session-timeout>15</session-timeout> 
</session-config> 


超时 以 分 钟 为 单位 ，Tomcat 中 的 默认 的 超时 时 间 是 30 分 钟 。 


Servlet 中 的 getMaxlnactivelnterval( ) 方法 以 秒 为 单位 返回 超时 时 间 。 如 果 在 
web.xml 中 配置 的 是 15 分 钟 ， 则 getMaxlnactivelnterval( ) 方法 将 会 返回 900。 


JSP 文件 上 传 


JSP 可 以 通过 HTML 的 form 表 单 上 传 文件 到 服务 器 。 文件 类 型 可 以 是 文本 文件 、 二 
进 制 文件 、 图 像 文件 等 其 他 任何 文档 。 


创建 文件 上 传 表 单 


接 下 来 我 们 使 用 HTML 标 签 来 创建 文件 上 传 表 单 ， 以 下 为 要 注意 的 点 : 


e form 表 单 method 属性 必须 设置 为 POST 方法 ， 不 能 使 用 GET 方法 。 

e form 表 单 enctype 属性 需要 设置 为 multipart/form-data。 

e form 表 单 action 属性 需要 设置 为 提交 到 后 台 处 理 文 件 上 传 的 jsp 文 件 地 址 。 例 
如 uploadFile.jsp 程序 文件 用 来 处 理 上 传 的 文件 。 

e 上 传 文件 元 素 需 要 使 用 «input .../> 标签 ， 属 性 设置 为 type="file"。 如 果 需 要 上 
传 多 个 文件 ， 可 以 在 «input .../> 标 签 中 设置 不 同 的 名 称 。 


以 下 是 一 个 上 传 文件 的 表单 ， 实 例如 下 : 


<html> 

<head> 

<title>File Uploading Form</title> 

</head> 

<body> 

<h3>File Upload:</h3> 

Select a file to upload: <br /> 

<form action="UploadServlet" method="post" 
enctype="multipart/form-data"> 

<input type="file" name="file" size="50" /> 

<br /> 

<input type="submit" value="Upload File" /> 

</form> 

</body> 

</html> 


在 你 本 地 浏览 器 访问 该 文件 ， 显 示 界 面 如 下 所 示 ， 在 你 点 击 "Upload File" 会 弹出 一 
个 窗口 让 你 选择 要 上 传 的 文件 : 


File Upload: 
Select a file to upload 


| 选择 文件 | 未 选择 文件 


| Upload File | 


后 台 JSP 久 理 脚 本 


首先 我 们 先 定义 文件 上 传 后 存储 在 服务 上 的 位 置 ， 你 可 以 将 路 径 宇 在 你 的 程序 当 
中 ， 或 者 我 们 可 以 在 web.xml 配 置 文件 中 通过 设置 context-param 元 素来 设置 文件 
存储 的 目录 ， 如 下 所 示 : 


«web - app» 


«context -param» 
<description>Location to store uploaded file</description> 
<param-name>file-upload</param-name> 
<param-value> 
c:\apache-tomcat-5.5.29\webapps\data\ 
</param-value> 
</context -param> 


</web-app> 


以 下 脚本 文件 UploadFilejsp 可 以 处 理 多 个 上 传 的 文件 ， 在 使 用 该 脚本 前 ， 我 们 需要 
注意 以 下 几 点 : 


e 以 下 实例 依赖 FileUpload, 所 以 你 需要 在 你 的 classpath 中 引入 最 新 的 
commons-fileupload.x.x.jar 包 文 件 。 下 载 地 址 
为 : http://commons.apache.org/fileupload/。 

e FileUpload 依赖 Commons IO, 所 以 你 需要 在 你 的 classpath 中 引入 最 新 的 
commons-io-x.x.jar 。 下 载 地 址 为 : http://commons.apache.org/io/. 

e 在 测试 以 下 实例 时 ， 你 需要 上 传 确认 上 传 的 文件 大 小 小 于 maxFileSize 变量 设 
置 的 大 小 ,否则 文件 无 法 上 传 成 功 。 

e 确保 你 已 经 创建 了 目录 c:\temp 和 c:\apache-tomcat-5.5.29\webapps\data 。 


«949 page import="java.io.*,java.util.*, javax.servlet.*" %> 
<%@ page import="javax.servlet.http.*" 96» 

«99 page import-"org.apache.commons.fileupload.*" 95» 

«949 page import-"org.apache.commons.fileupload.disk.*" %> 
<%@ page import-"org.apache.commons.fileupload.servlet.*" 95» 
<%@ page import-"org.apache.commons.io.output.*" %> 


<% 
File file ; 
int maxFileSize = 5000 * 1024; 
int maxMemSize = 5000 * 1024; 
ServletContext context = pageContext.getServletContext(); 
String filePath = context.getInitParameter("file-upload"); 


// 验证 上 传 内 容 了 类 型 
String contentType = request.getContentType(); 
if ((contentType.indexOf("multipart/form-data") >= 0)) { 


DiskFileItemFactory factory = new DiskFileItemFactory(); 


// 设置 内 存 中 存储 文件 的 最 大 值 
factory.setSizeThreshold(maxMemSize); 

// 本 地 存储 的 数据 大 于 maxMemSize . 
factory.setRepository(new File("c:\\temp")); 


// 创建 一 个 新 的 文件 上 传 处 理 程 序 

ServletFileUpload upload = new ServletFileUpload( factory); 
// 设置 最 大 上 传 的 文件 大 小 

upload.setSizeMax( maxFileSize ); 


try{ 
// 
Lis 


// 


解析 获取 的 文件 
t fileItems = upload.parseRequest(request); 


处 理 上 传 的 文件 


Iterator i = fileItems.iterator(); 


out 
out 
out 
out 
out 


.println("«html»"); 
.println("«head»"); 
.println("«title»2JSP File upload</title>"); 
.printin("</head>"); 
.println("«body»"); 


while ( i.hasNext () ) 


i 


} 


out 
out 
catch 


Sys 
} 


jelse( 
out.pr 
out.pr 
out.pr 


Fileltem fi = (FileItem)i.next(); 
if ( !fi.isFormField () ) 


{ 

// 获取 上 传 文件 的 参数 

String fieldName = fi.getFieldName(); 

String fileName = fi.getName(); 

boolean isInMemory = fi.isInMemory(); 

long sizeInBytes = fi.getSize(); 

// 写 入 文件 

if( fileName.lastIndexOf("\\") >= © ){ 

file = new File( filePath , 

fileName.substring( fileName.lastIndexOf("NN"))) ; 
selse{ 

file = new File( filePath , 
fileName.substring(fileName.lastIndexOf("\\")+1)) ; 
} 

fi.write( file ) ; 

out.println("Uploaded Filename: " + filePath + 
fileName + "<br>"); 


} 


.println("«/body»"); 
.println("«/html»"); 
(Exception ex) { 

tem.out.println(ex); 


intln("«html»"); 
intln("«head»"); 
intln("<title>Servlet upload</title>"); 


out.println("«/head»"); 
out.println("«body»"); 
out.println("«p»No file uploaded</p>"); 
out.println("«/body»"); 
out.println("«/html»"); 


96» 


接 下 来 让 我 们 通过 浏览 器 访问 http://localhost:8080/UploadFile.htm, SA FRE 
示 ， 并 上 传 文件 : 


File Upload: 
Select a file to upload: 


选择 文件 | 未 选择 文件 


Upload File 


如 果 你 的 JSP 脚 本 运行 正常 ， 文 件 将 被 上 传 至 c:\apache-tomcat- 
5.5.29\Wwebapps\data\ ， 你 可 以 打开 文件 夹 看 看 是 否 上 传 成 功 。 


JSP 日 期 处 理 


使 用 JSP 最 重要 的 优势 之 一 ， 就 是 可 以 使 用 所 有 Java API。 本 章 将 会 详细 地 讲述 
Java 中 的 Date 类 ， 它 在 java.util 包 下 ， 封 装 了 当前 日 期 和 时 间 。 


Date 类 有 两 个 构造 酌 数 。 第 一 个 构造 画 数 使 用 当前 日 期 和 时 间 来 初始 化 对 象 。 


Date( ) 


第 二 个 构造 画 数 接受 一 个 参数 ， 这 个 参数 表示 从 1970 年 1 月 1 日 凌晨 至 所 要 表示 时 间 


Date(long millisec) 


获取 Date 对 象 后 ， 您 就 能 够 使 用 下 表 列 出 的 所 有 方法 : 
方法 描述 


boolean after(Date 加 果 比 给 定 的 日 期 晓 ， 则 返回 rue， 否则 返回 false 


boolean os ; 

before (Date date) 如 果 比 给 定 的 日 期 早 ， 则 返回 true， 否 则 返回 false 
Object clone( ) 获取 当前 对 象 的 一 个 副本 

int 如 果 与 给 定 日 期 相等 ， 则 返回 0， 如 果 比 给 定 日 期 早 ， 则 


ata 返回 一 个 负数 ， 如 果 比 给 定 日 期 晚 ， 则 返回 一 个 正 数 


int = ; wets 
& compareTo(Date) 方法 相同 ， 如 果 obj 不 是 Date 类 或 

obj) STORE 其 子 类 的 对 象 ， 抛 出 ClassCastException 异 常 

boolean 

equals(Object 如 果 和 与 给 定 日 期 相同 ， 则 返回 true， 否 则 返回 false 

date) 

long getTime( ) 返回 从 1970 年 1 月 1 日 凌晨 至 此 对 象 所 表示 时 间 的 毫秒 数 

int hashCode( ) 返回 此 对 象 的 哈 希 码 

void setTime(long ， 使 用 给 定 参数 设置 时 间 和 日 期 ， 参 数 time 表 示 从 1970 年 

time) 1 月 1 日 凌晨 至 time 所 经 过 的 毫秒 数 


String toString( ) 将 此 对 象 转换 为 字符 串 并 返回 这 个 字符 串 


获取 当前 日 期 和 时 间 


使 用 JSP 编 程 可 以 很 容易 的 获取 当前 日 期 和 时 间 ， 只 要 使 用 Date 对 象 的 toString() 方 
法 就 行 了 ， 就 像 下 面 这 样 : 


<%@ page import="java.io.*,java.util.*, javax.servlet.*" %> 
«html» 
«head» 
<title>Display Current Date & Time</title> 
«/head» 
<body> 
<center> 
<hi>Display Current Date & Time</h1> 
</center> 
<% 
Date date = new Date(); 
out.print( "<h2 align=\"center\">" +date.toString()+"</h2>"); 
%> 
</body> 
</html> 


将 上 面 的 代码 保存 在 CurrentDate.jsp 文 件 中 ， 然 后 访问 
http://localhost:8080/CurrentDate.jsp， 运 行 结果 如 下 : 


Display Current Date & Time 
Mon Jun 21 21:46:49 GMT+04:00 2013 


刷新 http:/localhost:8080/CurrentDate.jsp， 就 可 以 发 现 每 次 刷新 所 得 到 的 秒 数 都 不 
相同 。 


日 期 比较 

就 像 我 在 开头 所 提 到 的 ， 您 可 以 在 JSP 脚 本 中 使 用 任何 Java 方 法 。 如 果 您 想 要 比较 
两 个 日 期 ， 

可 以 参照 下 面 的 方法 来 做 : 


e 使 用 getTime() 方 法 得 到 毫秒 数 ， 然 后 比较 毫秒 数 就 行 了 。 

。 使 用 before()，after()，equals() 方 法 。 上 比如 ，new Date(99,2,12).before(new 
Date(99,2,18)) 返 回 true。 

e 使 用 compareTo() 方 法 ， 这 个 方法 在 Comparable 接 口中 定义 ， 在 Date 中 实现 。 


使 用 SimpleDateFormat 格 式 化 日 期 


SimpleDateFormat 使 用 一 种 地 区 敏感 的 方式 来 格式 化 和 解析 日 期 ， 它 允许 您 使 用 自 
定义 的 模式 来 格式 化 日 期 和 时 间 。 


对 CurrentDate.jsp 稍 作 修 改 ， 得 到 如 下 修改 后 的 代码 : 


<%@ page import="java.io.*,java.util.*" %> 
<%@ page import="javax.servlet.*, java.text.*" %> 
<html> 
<head> 
<title>Display Current Date & Time</title> 
</head> 
<body> 
<center> 
<hi>Display Current Date & Time</h1> 
</center> 
<% 
Date dNow = new Date( ); 
SimpleDateFormat ft = 
new SimpleDateFormat ("E yyyy.MM.dd 'at' hh:mm:ss a zzz"); 
out.print( "<h2 align=\"center\">" + ft.format(dNow) + "</h2>") , 
%> 
</body> 
</html> 


a] a see 


再 次 编译 CurrentDate.jsp， 然 后 访问 http:/Wlocalhost:8080/CurrentDate.jsp， 就 可 以 
得 到 如 下 结 





Display Current Date & Time 
Mon 2013.06.21 at 10:06:44 PM GMT+04: 00 


SimpleDateFormat1& xt zz 
要 指定 模式 字符 串 ， 需 要 使 用 下 表 列 出 的 格式 码 : 


E 


3 EE > BE = NEM OO, 


alz m o m w le 


入 和 D 


描述 
时 代 标 识 符 
4 位 数 年 份 
月 
日 


12 小 时 制 ， A.M./P.M. (1~12) 
24 小 时 制 
分 钟 


一 年 中 的 某 天 

一 个 月 中 某 星 期 的 某 天 

一 年 中 的 某 星期 

一 个 月 中 的 某 星期 

A.M./P.M. 标记 

一 天 中 的 某 个 小 时 (1~24) 

一 天 中 的 某 个 小 时 ，A.M./P.M. (0711) 
时 区 

文本 分 隔 

单 引号 


更 多 关于 Date 类 的 详细 信息 请 查阅 Java API 文 档 。 


示例 
AD 
2001 
July or 07 


55 

234 

Tuesday 

360 

2 (second Wed. in July) 
40 


Eastern Standard Time 


Delimiter 


JSP 页 面 重 定向 


当 需 要 将 文档 移动 到 一 个 新 的 位 置 时 ， 就 需要 使 用 JSP 重 定向 了 。 


最 简单 的 重 定向 方式 就 是 使 用 response 对 象 的 SendRedirect() 方 法 。 这 个 方法 的 签 
名 如 下 : 


public void response.sendRedirect(String location) 
throws IOException 


这 个 方法 将 状态 码 和 新 的 页 面 位 置 作为 响应 发 回 给 浏览 器 。 您 也 可 以 使 用 
setStatus() 和 setHeader() 方 法 来 得 到 同 祥 的 效果 : 


String site = "http://www.w3cschool.cc" ; 
response.setStatus(response.SC MOVED TEMPORARILY); 
response.setHeader("Location", site); 


实例 演示 
这 个 例子 表明 了 JSP 如 何 进行 页 面 重 定向 : 


<%@ page import="java.io.*,java.util.*" %> 

<html> 

<head> 

<title>Page Redirection</title> 

</head> 

<body> 

<center> 

<hi>Page Redirection</h1i> 

</center> 

<% 
// 重 定向 到 新 地 址 
String site = new String("http://www.w3cschool.cc"); 
response.setStatus(response.SC MOVED TEMPORARILY); 
response.setHeader("Location", site); 

%> 

</body> 

</html> 
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将 以 上 代码 保存 在 PageRedirecting.jsp 文 件 中 ， 然 后 访问 
http://localhost:8080/PageRedirect.jsp ， 它 将 会 把 您 带 至 
http://www.w3cschool.cc/。 
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JSP radi mU 
有 时 候 我 们 需要 知道 某 个 页 面 被 访问 的 次 数 ， 这 时 我 们 就 需要 在 页 面 上 添加 页 面 统 
计 器 ， 页 面 访 问 的 统计 一 般 在 用 户 第 一 次 载 人 时 累加 该 页 面 的 访问 数 上 。 


要 实现 一 个 计数 器 ， 您 可 以 利用 应 用 程序 隐 式 对 象 和 相关 方法 getAttribute() 和 
setAttribute() 来 实现 。 


这 个 对 象 表示 JSP 页 面 的 整个 生命 周期 中 。 当 JSP 页 面 初 始 化 时 创建 此 对 象 ， 当 
JSP 页 面 调用 jspDestroy() 时 删除 该 对 象 。 


以 下 是 在 应 用 中 创建 变量 的 语法 : 


application.setAttribute(String Key, Object Value); 


您 可 以 使 用 上 述 方法 来 设置 一 个 计数 器 变量 及 更 新 该 变量 的 值 。 读 取 该 变量 的 方法 
如 下 : 


application.getAttribute(String Key); 


在 页 面 每 次 被 访问 时 ， 你 可 以 读 取 计 数 器 的 当前 值 ， 并 递增 1， 然 后 重新 设置 ， 在 
下 一 个 用 户 访问 时 就 将 新 的 值 显示 在 页 面 上 。 
实例 演示 


该 实例 将 介绍 如 何 使 用 JSP 来 计算 特定 页 面 访问 的 总 人 数 。 如 果 你 要 计算 你 网 站 使 
用 页 面 的 总 点 击 量 ， 那 么 你 就 必须 将 该 代码 放 在 所 有 的 JSP 页 面 上 。 


<%@ page import="java.io.*,java.util.*" %> 


<html> 
<head> 
<title>Applcation object in JSP</title> 
</head> 
<body> 
<% 
Integer hitsCount = 
(Integer )application.getAttribute("hitCounter"); 
if( hitsCount ==null || hitsCount == 0 ){ 
/* 第 一 次 访问 */ 
out.println("Welcome to my website!"); 
hitsCount - 1; 
jelse( 
/* 返回 访问 值 */ 
out.println("Welcome back to my website!"); 
hitsCount += 1; 


application.setAttribute("hitCounter", hitsCount); 
%> 
<center> 
<p>Total number of visits: <%= hitsCount%></p> 
</center> 
</body> 
</html> 


现在 我 们 将 上 面 的 代码 放置 于 main.jsp 文 件 上 ， 并 访问 
http:/localhost:8080/main.jsp 文 件 。 你 会 看 到 页 面 会 生成 个 计数 器 ， 在 我 们 每 次 刷 
新 页 面 时 ， 计 数 器 都 会 发 生变 化 〈 每 次 刷新 增加 1) 。 你 也 可 以 通过 不 同 的 浏览 器 
访问 ， 计 数 器 会 在 每 次 访问 后 增加 1。 如 下 所 示 : 


Welcome back to my website! 


Total number of visits: 12 


复位 计数 器 


使 用 以 上 方法 ， 在 web 服 务 器 重启 后 ， 计 数 器 会 被 复位 为 0， 即 前 面 保留 的 数据 都 会 
消失 ， 你 可 以 使 用 一 下 几 种 方式 解决 该 问题 : 


e 在 数据 库 中 定义 一 个 用 于 统计 网 页 访问 量 的 数据 表 count， 字 段 为 hitcount， 
hitcount 默 认 值 为 0， 将 统计 数据 写 入 到 数据 表 中 。 

在 每 次 访问 时 我 们 读 取 表 中 hitcount 字 段 。 

每 次 访问 时 让 hitcount 自 增 1。 

在 页 面 上 显示 新 的 hitcount 值 作为 页 面 的 访问 量 。 

如 果 你 需要 统计 每 个 页 面 的 访问 量 ， 你 可 以 使 用 以 上 逻辑 将 代码 添加 到 所 有 页 
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fmt. 
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JSP 目 动 刷新 


想象 一 下 ， 如 果 要 直播 比赛 的 比分 ， 或 股票 市 场 的 实时 状态 ， 或 当前 的 外 汇 配给 ， 
该 怎么 实现 呢 ? 显然 ， 要 实现 这 种 实时 功能 ， 您 就 不 得 不 规律 性 地 刷新 页 面 。 


JSP 提 供 了 一 种 机 制 来 使 这 种 工作 变 得 简单 ， 它 能 够 定时 地 自动 刷新 页 面 


刷新 一 个 页 面 最 简单 的 方式 就 是 使 用 response 对 象 的 setlntHeader() 方 法 。 这 个 方 
MEAT: 


public void setIntHeader(String header, int headerValue) 
这 个 方法 通知 浏览 器 在 给 定 的 时 间 后 刷新 ， 时 间 以 秒 为 单位 。 


页 面 自动 刷新 程序 示例 
这 个 例子 使 用 了 setlntHeader() 方 法 来 设置 刷新 头 ， 模 拟 一 个 数字 时 钟 : 


<%@ page import="java.io.*,java.util.*" %> 
<html> 
<head> 
<title>Auto Refresh Header Example</title> 
</head> 
<body> 
<center> 
<h2>Auto Refresh Header Example</h2> 
<% 
// Set refresh, autoload time as 5 seconds 
response.setIntHeader("Refresh", 5); 
// Get current time 
Calendar calendar = new GregorianCalendar(); 
String am pm; 
int hour - calendar.get(Calendar.HOUR); 
int minute = calendar.get(Calendar.MINUTE); 
int second - calendar.get(Calendar.SECOND); 
if(calendar.get(Calendar.AM PM) == 0) 
am pm = "AM"; 
else 
am pm = "PM"; 
String CT = hour+":"+ minute +":"+ second +" "+ am pm; 
out.println("Crrent Time: " + CT + "\n"); 
%> 
</center> 
</body> 
</html> 


把 以 上 代码 保存 在 main.jsp 文 件 中 ， 访 问 它 。 
统 当 前 时 间 。 运 行 结果 如 下 : 


Auto Refresh Header Example 
Current Time is: 9:44:50 PM 


您 也 可 以 自 己 动 手写 个 更 复杂 aR 点 的 程序 。 


hA 


已 会 


每 隔 5 秒 钟 刷新 一 次 页 面 并 获取 系 


JSP 发 送 邮 件 


虽然 使 用 JSP 实 现 邮 件 发 送 功能 很 简单 ， 但 是 需要 有 JavaMail API， 并 且 需 要 安装 
JavaBean Activation Framework。 


。 在 这 里 下 载 最 新 版 本 的 JavaMail 
e 在 这 里 下 载 最 新 版 本 的 JavaBeans Activation Framework(JAF)。 


下 载 并 解压 这 些 文件 ， 在 根 目 录 下 ， 您 将 会 看 到 一 系列 jar 包 。 将 mailjar 包 和 
activation.jar 包 加 入 CLASSPATH 变 量 中 。 


发 送 一 封 简单 的 邮件 


这 个 例子 展示 了 如 何 从 您 的 机 器 发 送 一 封 简单 的 邮件 。 它 假定 localhost 已 经 连接 至 
网 络 并 且 有 能 力 发 送 一 封 邮 件 。 与 此 同时 ， 请 再 一 次 确认 mailjar 包 和 activation.jar 
包 已 经 添加 进 CLASSPATH 变 量 中 。 


<%@ page import="java.io.*,java.util.*, javax.mail.*"%> 
«99 page import="javax.mail.internet.*, javax.activation. *"%> 
«99 page import="javax.servlet.http.*, javax.servlet.*" %> 
<% 
String result; 
// 收 件 人 的 电子 邮件 
String to = "abcd@gmail.com"; 


// 发 件 人 的 电子 邮件 


String from = "mcmohd@gmail.com"; 


// 假设 你 是 从 本 地 主机 发 送 电 子 邮 件 
String host = "localhost"; 


// 获取 系统 属性 对 象 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session 对 象 。 
Session mailSession = Session.getDefaultInstance(properties); 


tryt 
// 创建 一 个 默认 的 MimeMessage 对 象 。 
MimeMessage message = new MimeMessage(mailSession) ; 
// 设置 From: 头 部 的 header 字 段 
message.setFrom(new InternetAddress(from)); 
// 设置 To: 头 部 的 header 字 段 
message.addRecipient(Message.RecipientType.TO, 


new InternetAddress(to)); 
// 设置 Subject: header $F 
message.setSubject("This is the Subject Line!"); 
// 现在 设置 的 实际 消息 
message.setText("This is actual message"); 
// 发 送 消息 
Transport.send(message); 
result - "Sent message successfully...."; 
catch (MessagingException mex) { 
mex.printStackTrace(); 
result - "Error: unable to send message...."; 
} 
%> 
<html> 
<head> 
<title>Send Email using JSP</title> 
</head> 
<body> 
<center> 
<hi>Send Email using JSP</h1> 
</center> 
<p align="center"> 
<% 
out.println("Result: " + result + "\n"); 
%> 
</p> 
</body> 
</html> 


现在 访问 http://localhost:8080/SendEmailjsp ， 它 将 会 发 送 一 封 邮件 给 
abcd@gmail.com 并 显示 如 下 结果 : 


Send Email using JSP 
Result: Sent message successfully.... 


如 果 想 要 把 邮件 发 送 给 多 人 ， 下 面 列 出 的 方法 可 以 用 来 指明 多 个 邮箱 地 址 : 


void addRecipients(Message.RecipientType type, 
Address[] addresses) 
throws MessagingException 


参数 的 描述 如 下 : 


e type : 这 个 值 将 会 被 设置 成 TO，CC, 或 BCC。CC 代 表 副 本 ，BCC 代 表 黑 色 副 
本 ， 例 子 程序 中 使 用 的 是 TO。 

e addresses : 这 是 一 个 邮箱 地 址 的 数组 ， 当 指定 邮箱 地 址 时 需要 使 用 
InternetAddress() 方 法 。 


发 送 一 封 HTML 邮 件 


这 个 例子 发 送 一 封 简单 的 HTML 邮 件 。 它 假定 您 的 localhost 已 经 连接 至 网 络 并 且 有 
能 力 发 送 邮 件 。 和 与 此 同时 ， 请 再 一 次 确认 mailjar 包 和 activation.jar 包 已 经 添加 进 
CLASSPATH 2A, 


这 个 例子 和 前 一 个 例子 非常 相似 ， 不 过 在 这 个 例子 中 我 们 使 用 了 setContent() 方 
法 ， 将 "text/html" 做 为 第 二 个 参数 传 给 它 ， 用 来 表明 消息 中 包含 了 HTML 内 容 。 


<%@ page import="java.io.*,java.util.*, javax.mail.*"%> 
«99 page import="javax.mail.internet.*, javax.activation. *"%> 
<%@ page import="javax.servlet.http.*, javax.servlet.*" %> 


<% 


String result; 
// 收 件 人 的 电子 邮件 
String to = "abcd@gmail.com"; 


// 发 件 人 的 电子 邮件 


String from = "mcmohd@gmail.com"; 


// 假设 你 是 从 本 地 主机 发 送 电子 邮件 
String host = "localhost"; 


// 获取 系统 属性 对 象 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session 对 象 。 
Session mailSession = Session.getDefaultInstance(properties); 


try{ 

// 创建 一 个 默认 的 MimeMessage 对 象 。 
MimeMessage message = new MimeMessage(mailSession); 
// 设置 From: 头 部 的 header 字 段 
message.setFrom(new InternetAddress(from)); 
// 设置 To: 头 部 的 header 字 段 
message.addRecipient(Message.RecipientType.TO, 

new InternetAddress(to)); 
// 设置 Subject: header 字 段 
message.setSubject("This is the Subject Line!"); 


// 设置 HTML 消 息 
message.setContent("«hi»This is actual message</hi>", 
"text/html" ); 
// 发 送 消息 
Transport.send(message) ; 
result = "Sent message successfully...."; 
jcatch (MessagingException mex) { 
mex.printStackTrace(); 


result = "Error: unable to send message...."; 
} 
%> 
«html» 
«head» 
<title>Send HTML Email using JSP</title> 
«/head» 
«body» 
«center» 
<hi>Send Email using JSP</h1> 
</center> 
<p align="center"> 
<% 
out.println( Results ”+ result + "\n"); 
%> 
</p> 
</body> 
</html> 


现在 你 可 以 尝试 使 用 以 上 JSP 文 件 来 发 送 HTML 消 息 的 电子 邮件 。 


在 邮件 中 包含 附件 
这 个 例子 告诉 我 们 如 何 发 送 一 封包 含 附件 的 邮件 。 


<%@ page import="java.io.*,java.util.*,javax.mail.*"%> 
<%@ page import="javax.mail.internet.*, javax.activation.*"%> 
<%@ page import="javax.servlet.http.*, javax.servlet.*" %> 
<% 
String result; 
// 收 件 人 的 电子 邮件 
String to = "abcd@gmail.com"; 


// 发 件 人 的 电子 邮件 


String from = "mcmohd@gmail.com"; 


// 假设 你 是 从 本 地 主机 发 送 电子 邮件 
String host = "localhost"; 


// 获取 系统 属性 对 象 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session 对 象 。 


Session mailSession = Session.getDefaultInstance(properties); 


try{ 
// 创建 一 个 默认 的 MimeMessage 对 象 。 


MimeMessage message = new MimeMessage(mailSession) ; 


// 设置 From: 头 部 的 header 字 段 
message.setFrom(new InternetAddress(from)); 


// 设置 To: 头 部 的 header 字 段 
message.addRecipient(Message.RecipientType.TO, 
new InternetAddress(to)); 


// 设置 Subject: header 字 段 
message.setSubject("This is the Subject Line!"); 


// 创建 消息 部 分 
BodyPart messageBodyPart = new MimeBodyPart(); 


// 填充 消息 
messageBodyPart.setText("This is message body"); 


// 创建 多 媒体 消息 
Multipart multipart = new MimeMultipart(); 


// 设置 文本 消息 部 分 
multipart .addBodyPart(messageBodyPart ); 


// 附件 部 分 

messageBodyPart = new MimeBodyPart(); 

String filename = "file.txt"; 

DataSource source = new FileDataSource( filename) ; 
messageBodyPart.setDataHandler(new DataHandler(source)); 
messageBodyPart.setFileName( filename) ; 

multipart .addBodyPart(messageBodyPart ); 


// 发 送 完 整 消息 
message.setContent(multipart ) 


// 发 送 消息 
Transport.send(message) ; 
String title = "Send Email"; 
result = "Sent message successfully...."; 
}catch (MessagingException mex) { 
mex.printStackTrace(); 
result = "Error: unable to send message...."; 
j 
96» 
«html» 
«head» 
<title>Send Attachement Email using JSP</title> 
«/head» 
«body» 
«center» 
<hi>Send Attachement Email using JSP</h1> 
</center> 
<p align="center"> 


<% 
out.println("Result: " + result + "\n"); 
%> 
</p> 
</body> 
</html> 


用 户 认 证 部 分 
如 果 邮 件 服 务 器 需要 用 户 名 和 密码 来 进行 用 户 认 证 的 话 ， 可 以 像 下 面 这 样 来 设置 : 


props.setProperty("mail.user", "myuser"); 
props.setProperty("mail.password", "mypwd"); 


使 用 表单 发 送 邮 件 
使 用 HTML 表 单 接收 一 封 邮件 ， 并 通过 request 对 象 获取 所 有 邮件 信息 : 


String to = request.getParameter("to"); 

String from = request.getParameter("from"); 

String subject = request.getParameter("subject"); 
String messageText = request.getParameter ("body"); 


获取 以 上 信息 后 ， 您 就 可 以 使 用 前 面 提 到 的 例子 来 发 送 邮 件 了 。 
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JSP 标准 标签 库 (JSTL) 


JSP 标 准 标签 库 (JSTL) 是 一 个 JSP 标 签 集合 ， 它 封装 了 JSP 应 用 的 通用 核心 功 
Ak 


Abo 


JSTL 支 持 通用 的 、 结 构 化 的 任务 ， 比 如 迭代 ， 条 件 判 断 ，XML 文 档 操 作 ， 国 际 化 标 
签 ，SQL 标 签 。 除了 这 些 ， 它 还 提供 了 一 个 框架 来 使 用 集成 JSTL 的 自 定 义 标 签 。 


根据 JSTL 标 签 所 提供 的 功能 ， 可 以 将 其 分 为 5 个 类 别 。 


e 核心 标签 
格式 化 标签 
SQL 标签 
XML 标签 
JSTL HX 


JSTL ERS 


Apache Tomcat 安 装 JSTL 库 步 又 如 下 : 


e 从 Apache 的 标准 标签 库 中 下 载 的 二 进 包 (jakarta-taglibs-standard- 
current.zip)。 下 载 地 
tit : http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/ 

e TF #jakarta-taglibs-standard-1.1.1.zip 包 并 解压 ， 将 jakarta-taglibs-standard- 
1.1.1/lib/ 下 的 两 个 jar 文 件 : standard.jar 和 jstljar 文 件 拷贝 到 WEB-INF/ib/ 下 。 


使 用 任何 库 ， 你 必须 在 每 个 JSP 文 件 中 的 头 部 包含 <taglib> 标 签 。 


核心 标签 是 最 常用 的 JSTL 标 签 。 引 用 核心 标签 库 的 语法 如 下 : 


«9*9 taglib prefix="c" 
uri="http://java.sun.com/jsp/jstl/core" %> 


标签 
<c:out> 
<c:set> 
<c:remove> 
<c:catch> 
<c:if> 
<c:choose> 


<c:when> 
<c:otherwise> 


<c:import> 
<c:forEach> 
<c:forTokens> 
<c:param> 
<c:redirect> 


<c:url> 


描述 
用 于 在 JSP 中 显示 数据 ， 就 像 <%= ... > 
用 于 保存 数据 
用 于 删除 数据 
用 来 处 理 产 生 错 误 的 异常 状况 ， 并 且 将 错误 信息 储存 起 来 
与 我 们 在 一 般 程序 中 用 的 if 一 样 
本 身 只 当做 <c:when> 和 <c:otherwise> 的 父 标 签 
<c:choose> 的 子 标签 ， 用 来 判断 条 件 是 否 成 立 


<c:choose> 的 子 标签 ， 接 在 <c:when> 标 签 后 ， 当 <c:when> 标 


答 判 断 为 false 时 被 执行 
检索 一 个 绝对 或 相对 URL， 然 后 将 其 内 容 暴露 给 页 面 
基础 运 代 标签 ， 接 受 多 种 集合 类 型 


根据 指定 的 分 隅 符 来 分 隔 内 容 并 迭 代 输 出 
用 来 给 包含 或 重 定 向 的 页 面 传递 参数 

重 定向 至 一 个 新 的 URL. 

使 用 可 选 的 查询 参数 来 创造 一 个 URL 


格式 化 标签 


JSTL 格 式 化 标签 用 来 格式 化 并 输出 文本 、 上 日期、 时间、 数字。 引用 格式 化 标签 库 的 
语法 如 下 : 


«99 taglib prefix-"fmt" 
uri="http://java.sun.com/jsp/jstl/fmt" %> 


标签 描述 


<fmt:formatNumber> 使 用 指定 的 格式 或 精度 格式 化 数字 
<fmt:parseNumber> 解析 一 个 代表 着 数字 ， 货 币 或 百分比 的 字符 串 
<fmt:formatDate> 使 用 指定 的 风格 或 模式 格式 化 日 期 和 时 间 
<fmt:parseDate> 解析 一 个 代表 着 日 期 或 时 间 的 字符 串 
<fmt:bundle> BRIE ER 
<fmt:setLocale> 指定 地 区 
<fmt:setBundle> BRE ER 
<fmt:timeZone> 指定 时 区 
<fmt:setTimeZone> 指定 时 区 
<fmt:message> 显示 资源 配置 文件 信息 
<fmt:requestEncoding> 设置 request 的 字符 编码 

SQL 标签 


JSTL SQL 标签 库 提 供 了 和 与 关系 型 数据 库 (Oracle, MySQL, SQL Server 等 等 ) zt 
行 交 互 的 标签 。 引 用 SQL 标签 库 的 语法 如 下 : 


<%@ taglib prefix="sql" 
uri="http://java.sun.com/jsp/jstl/sql" %> 


Ef 


标签 fü 


<sqi:setDataSource> ”指定 数据 源 


<sql:query> 运行 SQL 查 询 语句 
<sql:update> 运行 SQL 更 新 语句 
<sql:param> 将 SQL 语句 中 的 参数 设 为 指定 值 
eld aan aa MEE 对 
值 
在 共享 数据 库 连 接 中 提供 府 套 的 数据 库 行为 元 素 ， 将 所 
ee 有 语句 以 一 个 事务 的 形式 来 运行 


XML 标签 


JSTL XML 标签 库 提 供 了 创建 和 操作 XML 文档 的 标签 。 引 用 XML 标签 库 的 语法 如 
T: 


«9*9 taglib prefix="x" 
uri-"http://java.sun.com/jsp/jstl/xml" 96» 


在 使 用 xml 标 签 前 ， 你 必须 将 XML 和 XPath 的 相关 包 拷 贝 至 你 的 <Tomcat 安装 目录 
>\lib 下 : 


Xerceslmpl.jar: 
下 载 地 址 : http://www.apache.org/dist/xerces/j/ 
xalan.jar: 


下 载 地 址 : http://xml.apache.org/xalan-j/index.html 


<x:out> 与 <%= … >, 类 似 ， 不 过 只 用 于 XPath 表达 式 
<x:parse> 解析 XML 数据 
<x:set> 设置 XPath 表达 式 


E 判断 XPath 表 达 式 ， 若 为 真 ， 则 执行 本 体 中 的 内 容 ， 否 则 跳 过 
本 体 


<x:forEach> 迭代 XML 文 档 中 的 节点 


<x:choose> <x:when> 和 <x:otherwise> 的 父 标签 
<x:when> <x:choose> 的 子 标签 ， 用 来 进行 条 件 判 断 


<x:otherwise> ”<x:choose> 的 子 标签 ， 当 <x:when> 判 断 为 false 时 被 执行 
<x:transform> ， 将 XSL 转 换 应 用 在 XML 文档 中 
<x:param> 与 <x:transform> 共 同 使 用 ， 用 于 设置 XSL 样 式 表 


JSTLESZA 


JSTL& & —JIEEBRZA, AU zGBRBBJSETPEBAISEZC, S|FHJSTLENSZ5UE B^J 
语法 如 下 : 


«99 taglib prefix="fn" 
uri-"http://java.sun.com/jsp/jstl/functions" %> 
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函数 


fn:contains() 
fn:containslgnoreCase() 


fn:endsWith() 
fn:escapeXml() 
fn:indexOf() 
fn:join() 
fn:length() 


fn:replace() 


fn:split() 


fn:startsWith() 
fn:substring() 
fn:substringAfter() 
fn:substringBefore() 
fn:toLowerCase() 
fn:toUpperCase() 
fn:trim() 


描述 
测试 输入 的 字符 串 是 否 包含 指定 的 子 串 
否 包 含 指定 的 子 串 ， 大 小 写 不 


测试 输入 的 字符 串 是 
敏感 


测试 输入 的 字符 串 是 否 以 指定 的 后 
跳 过 可 以 作为 XML 标记 的 字符 

返回 指定 字符 串 在 输入 字符 串 中 出 现 的 位 置 
将 数组 中 的 元 素 合成 一 个 字符 串 然 后 输出 

回 字 符 串 长 度 


将 输入 字符 串 中 指定 的 位 置 蔡 换 为 指定 的 字符 串 然 
后 返回 


将 字符 串 用 指定 的 分 隔 符 分 隔 然 后 
串 数 组 并 返回 


测试 输入 字符 串 是 否 以 指定 的 前 级 开始 
返回 字符 串 的 子 集 

返回 字符 串 在 指定 子 串 之 后 的 子 集 
返回 字符 串 在 指定 子 串 之 前 的 子 集 
将 字符 串 中 的 字符 转 为 小 写 

将 字符 串 中 的 字符 转 为 大 写 

移 除 首位 的 空白 符 


$E 


BRE 


加 


组 成 一 个 子 字符 


JSP 连接 数据 库 


本 章节 假设 您 已 经 对 JDBC 有 一 定 的 了 解 。 在 开始 学 习 JSP 数 据 库 访问 前 ， 请 确保 
JDBC 环 境 已 经 正确 配置 。 


首先 ， 让 我 们 按照 下 面 的 步骤 来 创建 一 个 简单 的 表 并 插 人 几 条 简单 的 记录 : 
创建 表 

在 数据 库 中 创建 一 个 Employees 表 ， 步 又 如 下 : 

步骤 1 : 

打开 CMD， 然 后 进入 数据 库 安装 目录 : 


C:\> 
C:\>cd Program Files\MySQL\bin 
C:\Program Files\MySQL\bin> 


SH 


又 2 : 


C:\Program Files\MySQL\bin>mysql -u root -p 
Enter password: ******** 
mysql> 


步骤 3 : 
在 TEST 数据 库 中 创建 Employee 表 : 


mysql> use TEST; 

mysql> create table Employees 
( 
id int not null, 
age int not null, 
first varchar (255), 
last varchar (255) 


); 
Query OK, © rows affected (0.08 sec) 
mysql» 


插 人 数据 记录 
创建 好 Employee 表 后 ， 往 表 中 插入 几 条 记录 : 


mysql> INSERT INTO Employees VALUES (100, 
Query OK, 1 row affected (0.05 sec) 


mysql> INSERT INTO Employees VALUES (101, 
Query OK, 1 row affected (0.00 sec) 


mysql> INSERT INTO Employees VALUES (102, 
Query OK, 1 row affected (0.00 sec) 


mysql> INSERT INTO Employees VALUES (103, 
Query OK, 1 row affected (0.00 sec) 


mysql> 


18, 


25, 


30, 


28, 


'Zara', 'Ali'); 


'Mahnaz', 'Fatma'); 


'Zaid', 'Khan'); 


'Sumit', 'Mittal'); 


Uee ee t 


SELECT 操作 


接 下 来 的 这 个 例子 告诉 我 们 如 何 使 用 JSTL SQL 标签 来 运行 SQL SELECT 语句 : 


<%@ page import="java.io.*,java.util.*,java.sql.*"%> 

<%@ page import="javax.servlet.http.*, javax.servlet.*" %> 

«99 taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> 
<%@ taglib uri-"http://java.sun.com/jsp/jstl/sql" prefix="sql"%> 


«html» 
«head» 
<title>SELECT Operation</title> 
</head> 
<body> 


<sql:setDataSource var="Snapshot" driver="com.mysql.jdbc.Driver" 
url="jdbc:mysql://localhost/TEST" 
user="root" password="pass123"/> 


<sql:query dataSource="${snapshot}" var="result"> 
SELECT * from Employees; 
</sql:query> 


<table border="1" width="100%"> 
<tr> 
<th>Emp ID</th> 
<th>First Name</th> 
<th>Last Name</th> 
<th>Age</th> 
</tr> 
«c:forEach var="row" items="${result.rows}"> 
<tr> 
<td><c:out value="${row.id}"/></td> 
<td><c:out value="${row.first}"/></td> 
<td><c:out value="${row.last}"/></td> 
<td><c:out value="${row.age}"/></td> 
</tr> 
«/c:forEach» 
</table> 


</body> 
</html> 


访问 这 个 JSP 例 子 ， 运 行 结果 如 下 : 





Emp ID First Name Last Name Age 
100 Zara Ali 18 
101 Mahnaz Fatma 25 
102 Zaid Khan 30 
103 Sumit Mittal 28 








INSERT 操 作 
这 个 例子 告诉 我 们 如 何 使 用 JSTL SQL 标签 来 运行 SQL INSERT 语 句 : 


<%@ page import="java.io.*,java.util.*,java.sql.*"%> 

«99 page import="javax.servlet.http.*, javax.servlet.*" %> 

«99 taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> 
«99 taglib uri-"http://java.sun.com/jsp/jstl/sql" prefix="sql"%> 


«html» 
«head» 
<title>JINSERT Operation</title> 
</head> 
<body> 


<sql:setDataSource var="Snapshot" driver="com.mysql.jdbc.Driver" 
url="jdbc:mysql://localhost/TEST" 
user="root" password="pass1i23"/> 


<sql:update dataSource="${snapshot}" var="result"> 
INSERT INTO Employees VALUES (104, 2, 'Nuha', 'Ali'); 
</sql:update> 


«sql:query dataSource="${snapshot}" var="result"> 
SELECT * from Employees; 
</sql:query> 


«table border="1" width="100%"> 
<tr> 
<th>Emp ID</th> 
<th>First Name</th> 
<th>Last Name</th> 
<th>Age</th> 
</tr> 
«c:forEach var="row" items="${result.rows}"> 
<tr> 
<td><c:out value="${row.id}"/></td> 
<td><c:out value="${row. first}"/></td> 
<td><c:out value="${row.last}"/></td> 
<td><c:out value="${row.age}"/></td> 
</tr> 
</c: forEach> 
</table> 


</body> 
</html> 


访问 这 个 JSP 例 子 ， 运 行 结果 如 下 : 








Emp ID First Name Last Name Age 
100 Zara Ali 18 
101 Mahnaz Fatma 25 
102 Zaid Khan 30 
103 Sumit Mittal 28 
104 Nuha Ali 2 





DELETE 操 作 


这 个 例子 告诉 我 们 如 何 使 用 JSTL SQL 标签 来 运行 SQL DELETE% : 


«99 page import="java.io.*,java.util.*,java.sql.*"%> 

<%@ page import="javax.servlet.http.*, javax.servlet.*" %> 

«99 taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> 
«99 taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> 


<html> 
<head> 
<title>DELETE Operation</title> 
</head> 
<body> 


«sql:setDataSource var="Snapshot" driver="com.mysql.jdbc.Driver" 
url="jdbc:mysql://localhost/TEST" 
user="root" password="pass1i23"/> 


«c:set var="empId" value="103"/> 


<sql:update dataSource="${snapshot}" var="count"> 
DELETE FROM Employees WHERE Id = ? 
<sql:param value="${empId}" /> 

</sql:update> 


«sql:query dataSource="${snapshot}" var="result"> 
SELECT * from Employees; 
</sql:query> 


<table border="1" width="100%"> 
<tr> 
<th>Emp ID</th> 
<th>First Name</th> 
<th>Last Name</th> 
<th>Age</th> 
</tr> 
«c:forEach var="row" items="${result.rows}"> 
<tr> 
<td><c:out value="${row.id}"/></td> 
<td><c:out value="${row.first}"/></td> 
<td><c:out value="${row.last}"/></td> 
<td><c:out value="${row.age}"/></td> 
</tr> 
«/c:forEach» 
</table> 


</body> 
</html> 


访问 这 个 JSP 例 子 ， 运 行 结果 如 下 : 





Emp ID First Name Last Name Age 





100 Zara Ali 18 
101 Mahnaz Fatma 25 
102 Zaid Khan 30 





UPDATE 操 作 


这 个 例子 告诉 我 们 如 何 使 用 JSTL SQL 标签 来 运行 SQL UPDATE 语 句 : 


«99 page import="java.io.*,java.util.*,java.sql.*"%> 

<%@ page import="javax.servlet.http.*, javax.servlet.*" %> 

«99 taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> 
«99 taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> 


<html> 
<head> 
<title>DELETE Operation</title> 
</head> 
<body> 


«sql:setDataSource var="Snapshot" driver="com.mysql.jdbc.Driver" 
url="jdbc:mysql://localhost/TEST" 
user="root" password="pass1i23"/> 


«c:set var="empId" value="102"/> 


<sql:update dataSource="${snapshot}" var="count"> 
UPDATE Employees SET last = 'Ali' 
<sql:param value="${empId}" /> 

</sql:update> 


«sql:query dataSource="${snapshot}" var="result"> 
SELECT * from Employees; 
</sql:query> 


<table border="1" width="100%"> 
<tr> 
<th>Emp ID</th> 
<th>First Name</th> 
<th>Last Name</th> 
<th>Age</th> 
</tr> 
«c:forEach var="row" items="${result.rows}"> 
<tr> 
<td><c:out value="${row.id}"/></td> 
<td><c:out value="${row.first}"/></td> 
<td><c:out value="${row.last}"/></td> 
<td><c:out value="${row.age}"/></td> 
</tr> 
«/c:forEach» 
</table> 


</body> 
</html> 


访问 这 个 JSP 例 子 ， 运 行 结果 如 下 : 
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JSP XML 数据 处 理 


当 通 过 HTTP 发 送 XML 数 据 时 ， 就 有 必要 使 用 JSP 来 处 理 传 人 和 流出 的 XML 文档 
了 ， 比 如 RSS 文 档 。 作 为 一 个 XML 文档 ， 它 公公 只 是 一 堆 文 本 而 已 ， 使 用 JSP 创 建 
XML 文档 并 不 比 创 建 一 个 HTML 文 档 难 。 


使 用 JSP 发 送 XML 


使 用 JSP 发 送 XML 内 容 就 和 发 送 HTML 内 容 一 样 。 唯 一 的 不 同 就 是 您 需要 把 页 面 的 
context 属 性 设置 为 text/xml。 要 设置 context 属 性 ， 使 用 <%@page % > 命令 ， 就 像 
这 样 : 


«XQ page contentType-"text/xml" %> 


接 下 来 这 个 例子 向 浏览 器 发 送 XML 内 容 : 


«XQ page contentType-"text/xml" %> 


«books» 
«book» 
<name>Padam History</name> 
<author>ZARA</author> 
<price>100</price> 
</book> 
</books> 


使 用 不 同 的 浏览 器 来 访问 这 个 例子 ， 看 看 这 个 例子 所 呈现 的 文档 树 。 


在 JSP 中 人 处理 XML 


在 使 用 JSP 父 理 XML 之 前 ， 您 需要 将 与 XML 和 XPath 相关 的 两 个 库 文 件 放 在 
«Tomcat Installation Directory>\lib 目 录 下 : 


e Xerceslmpl.jar : 在 这 下 载 http://www.apache.org/dist/xerces/j/ 
e xalan.jar : 在 这 下 载 http://xml.apache.org/xalan-j/index.html 


books.xml 文 件 : 


<books> 

<book> 
<name>Padam History</name> 
<author>ZARA</author> 
<price>100</price> 

</book> 

<book> 
<name>Great Mistry</name> 
<author>NUHA</author> 
<price>2000</price> 

</book> 

</books> 


main.jsp 文 件 : 


«99 taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> 
«99 taglib prefix="x" uriz"http://java.sun.com/jsp/jstl/xml" %> 


«html» 
«head» 
<title>JSTL x:parse Tags</title> 
</head> 
<body> 
<h3>Books Info:</h3> 
<c:import var="bookInfo" url="http://localhost :8080/books. xmL"/> 


<x:parse xml="${bookInfo}" var="output"/> 
<b>The title of the first book is</b>: 

«x:out select="$output/books/book[1]/name" /> 
<br> 

<b>The price of the second book</b>: 

«x:out select="$output/books/book[2]/price" /> 


</body> 
</html> 


iy ig http://localhost:8080/main.jsp, 47245290 F : 


BOOKS INFO: 
The title of the first book is:Padam History 
The price of the second book: 2000 


使 用 JSP 格 式 化 XML 


这 个 是 XSLT 样 式 表 style.xs| 文 件 : 


<?xml version="1.0"?> 
«xsl:stylesheet xmlns:xsl- 
"http://www.w3.0rg/1999/XSL/Transform" version="1.0"> 


«xsl:output method-z"html" indent="yes"/> 


<xsl:template match="/"> 
<html> 
<body> 
«xsl:apply-templates/» 
</body> 
</html> 

</xsl:template> 


<xsl:template match="books"> 
<table border="1" width="100%"> 
<xsl:for-each select="book"> 
<tr> 
<td> 
<i><xsl:value-of select="name"/></i> 
</td> 
<td> 
<xsl:value-of select="author"/> 
</td> 
<td> 
<xSl:value-of select="price"/> 
</td> 
</tr> 
«/xsl:for-each» 
</table> 
</xsl:template> 
</xsl:stylesheet> 


这 个 是 main.jsp 文 件 : 


«99 taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> 
<%@ taglib prefix="x" uri-z"http://java.sun.com/jsp/jstl/xml" %> 


<html> 
<head> 
<title>JSTL x:transform Tags</title> 
</head> 
<body> 
<h3>Books Info:</h3> 
<c:set var="xmltext"> 
<books> 
<book> 
<name>Padam History</name> 
<author>ZARA</author> 
<price>100</price> 
</book> 
<book> 
<name>Great Mistry</name> 
<author>NUHA</author> 
<price>2000</price> 
</book> 
</books> 
</c:set> 


«c:import url="http://localhost:8080/style.xsl" var="xslt"/> 
<x:transform xml="${xmltext}" xslt="${xslt}"/> 


</body> 
</html> 
运行 结果 如 下 : 


BOOKS INFO: 





Padam History 


Great Mistry 





更 多 关于 使 用 JSTL 人 处 理 XML 的 内 容 请 查阅 JSP 标 准 标签 库 。 


JSP JavaBean 


JavaBean 是 特殊 的 Java 类 ， 使 用 J ava 语 言 书写 ， 并 且 遵 守 JavaBeans API 规 范 。 
接 下 来 给 出 的 是 JavaBean 与 其 它 Java 类 相 比 而 言 独一无二 的 特征 : 


e 提供 一 个 默认 的 无 参 构造 画 数 。 

。 需要 被 序列 化 并 且 实 现 了 Serializable 接 口 。 
e 可 能 有 一 系列 可 读 写 属性 。 

e 可 能 有 一 系列 的 "getter" 或 "setter" 方 法 。 


JavaBeans 属 性 


一 个 JavaBean 对 象 的 属性 应 该 是 可 访问 的 。 这 个 属性 可 以 是 任意 合法 的 Java 数 气 
类 型 ， 包 括 自 定 义 Java 类 。 


一 个 JavaBean 对 象 的 属性 可 以 是 可 读 写 ， 或 只 读 ， 或 只 写 。JavaBean 对 象 的 属性 
通过 JavaBean 实 现 类 中 提供 的 两 个 方法 来 访问 : 


方法 描述 
举例 来 说 ， 如 果 属 性 的 名 称 为 myName， 那 么 3 
getPropertyName() ”的 名 字 就 要 写成 getMyName() 来 读 取 这 个 属性 。 这 个 方 
法 也 称 为 访问 器 。 
举例 来 说 ， 如 果 属 性 的 名 称 为 myName， 那 么 3 ne 
setPropertyName() ”的 名 字 就 要 写成 setMyName() 来 写 入 这 个 属性 。 这 个 方 
OMA SAB. 


一 个 只 读 的 属性 只 提供 getPropertyName() 方 法 ， 一 个 只 写 的 属性 只 提供 
setPropertyName() 方 法 。 


JavaBeans 程 序 示例 


这 是 StudentBean.java 文 件 : 


package com.tutorialspoint; 


public class StudentsBean implements java.io.Serializable 


{ 


private String firstName = null; 
private String lastName = null; 
private int age = 0; 

public StudentsBean() { 


public String getFirstName(){ 
return firstName; 


public String getLastName(){ 
return lastName; 
} 


public int getAge(){ 
return age; 


public void setFirstName(String firstName) { 
this.firstName - firstName; 


public void setLastName(String lastName) { 
this.lastName - lastName; 


j 

public void setAge(Integer age){ 
this.age - age; 

j 


j 


编译 StudentBean.java 文 件 ， 在 本 章 最 后 的 例子 中 将 会 使 用 到 它 。 


访问 JavaBeans 


<jsp:useBean> 标 签 可 以 在 JSP 中 声明 一 个 JavaBean， 然 后 使 用 。 声 明 后 ， 
JavaBean 对 象 就 成 了 脚本 变量 ， 可 以 通过 脚本 元 素 或 其 他 自 定 义 标 签 来 访问 。 
<jsp:useBean> 标 签 的 语法 格式 如 下 : 


<jsp:useBean id="bean's name" scope="bean's scope" typeSpec/> 


其 中 ， 根 据 具 体 情况 ，scope 的 值 可 以 是 page，request，session 或 application。id 
值 可 任意 只 要 不 和 同一 JSP 文 件 中 其 它 <jsp:useBean> 中 id 值 一 样 就 行 了 。 


接 下 来 给 出 的 是 <jsp:useBean> 标 签 的 一 个 简单 的 用 法 : 


<html> 
<head> 
<title>useBean Example</title> 
</head> 
<body> 


<jsp:useBean id="date" class="java.util.Date" /> 
<p>The date/time is <%= date %> 


</body> 
</html> 


它 将 会 产生 如 下 结果 : 


The date/time is Thu Sep 30 11:18:11 GST 2013 


访问 JavaBeans 对 象 的 属性 


在 <jsp:useBean> 标 签 主体 中 使 用 <jsp:getProperty/> 标 签 来 调用 getter 方 法 ， 使 用 
<jsp:setProperty/> 标 签 来 调用 setter 方 法 ， 语 法 格式 如 下 : 


<jsp:useBean id="id" class="bean's class" scope="bean's scope"> 
<jsp:setProperty name="bean's id" property="property name" 
value="value"/> 
<jsp:getProperty name="bean's id" property="property name"/> 


</jsp:useBean> 


name 属 性 指 的 是 Bean 的 id 属性 。property 属 性 指 的 是 想 要 调用 的 getter 或 setter 方 


法 。 


接 下 来 给 出 使 用 以 上 语法 进行 属性 访问 的 一 个 简单 例子 : 


<html> 
<head> 
<title>get and set properties Example</title> 
</head> 
<body> 


<jsp:useBean id="students" 
class="com.tutorialspoint .StudentsBean"> 
<jsp:setProperty name-"students" property="firstName" 
value="Zara"/> 
<jsp:setProperty name-"students" property="lastName" 
value-"Ali"/» 
«jsp:setProperty name-"students" property="age" 
value="10"/> 
</jsp:useBean> 


<p>Student First Name: 

«jsp:getProperty name-"students" property="firstName"/> 
</p> 
<p>Student Last Name: 

<jsp:getProperty name-"students" property="lastName"/> 
</p> 
<p>Student Age: 

«jsp:getProperty name="students" property="age"/> 
</p> 


</body> 
</html> 


将 StudentBean.class 加 入 CLASSPATH 环 境 变 量 中 ， 然 后 访问 以 上 JSP， 运 行 结果 
如 下 : 


Student First Name: Zara 
Student Last Name: Ali 


Student Age: 10 


JSP 目 定 义 标 签 


自 定 义 标签 是 用 户 定义 的 JSP 语 言 元 素 。 当 JSP 页 面包 含 一 个 自 定义 标签 时 将 被 转 
化 为 servlet， 标 签 转 化 为 对 被 称 为 tag handler 的 对 象 的 操作 ， 即 当 servlet 执 行 时 
Web container 调 用 那些 操作 。 


JSP 标 签 扩 展 可 以 让 你 创建 新 的 标签 并 且 可 以 直接 插入 到 一 个 JSP 页 面 。 JSP 2.0 
规范 中 引入 Simple Tag Handlers 来 编写 这 些 自 定 义 标 记 。 


你 可 以 继承 SimpleTagSupport 类 并 重 写 的 doTag() 方 法 来 开发 一 个 最 简单 的 自 定义 


创建 "Hello" 标 签 
接 下 来 ， 我 们 想 创建 一 个 自 定义 标签 叫 作 <ex:Hello>， 标 签 格 式 为 : 


<ex:Hello /> 


要 创建 自 定义 的 JSP 标 签 ， 你 首先 必须 创建 处 理 标签 的 Java 类 。 所 以 ， 让 我 们 创建 
一 个 HelloTag 类 ， 如 下 所 示 : 


package com.tutorialspoint; 


import javax.servlet.jsp.tagext.*; 
import javax.servlet.jsp.*; 
import java.io.*; 


public class HelloTag extends SimpleTagSupport { 


public void doTag() throws JspException, IOException ( 
Jspwriter out = getJspContext().getOut(); 
out.println("Hello Custom Tag!"); 
j 
j 


以 下 代码 重 写 了 doTag() 方 法 ， 方 法 中 使 用 了 getJspContext() 方 法 来 获取 当前 的 
JspContext 对 象 ， 并 将 "Hello Custom Tag!" 传 递 给 JspWriter 对 象 。 


编译 以 上 类 ， 并 将 其 复制 到 环境 变量 CLASSPATH 目 录 中 。 最 后 创建 如 下 标签 库 : 
<Tomcat 安 装 目录 >webapps\ROOT\WEB-INF\custom.tld。 


<taglib> 
<tlib-version>1.0</tlib-version> 
<jsp-version>2.0</jsp-version> 
<short-name>Example TLD</short -name> 
<tag> 
<name>Hello</name> 
<tag-class>com.tutorialspoint.HelloTag</tag-class> 
«body -content>empty</body-content> 
</tag> 
</taglib> 


接 下 来 ， 我 们 就 可 以 在 JSP 文 件 中 使 用 Hello 标 签 : 


<%@ taglib prefix="ex" uri="WEB-INF/custom. tld"%> 
«html» 
«head» 
<title>A sample custom tag</title> 
</head> 
<body> 
«ex:Hello/» 
</body> 
</html> 


Hello Custom Tag! 


访问 标签 体 


你 可 以 像 标 准 标签 库 一 样 在 标签 中 包含 消息 内 容 。 如 我 们 要 在 我 们 自 定 义 的 Hello 中 
包含 内 容 ， 格 式 如 下 : 


«ex:Hello» 
This is message body 
«/ex:Hello» 


我 们 可 以 修改 标签 处 理 类 文件 ， 代 码 如 下 : 


package com.tutorialspoint; 


import javax.servlet.jsp.tagext.*; 
import javax.servlet.jsp.*; 
import java.io.*; 


public class HelloTag extends SimpleTagSupport { 


Stringwriter sw = new Stringwriter(); 
public void doTag() 
throws JspException, IOException 
{ 


getJspBody().invoke(sw); 
getJspContext().getOut().println(sw.toString()); 


接 下 来 我 们 需要 修改 TLD 文 件 ， 如 下 所 示 : 


<taglib> 
<tlib-version>1.0</tlib-version> 
<jsp-version>2.0</jsp-version> 
<short-name>Example TLD with Body</short-name> 
<tag> 
<name>Hello</name> 
<tag-class>com.tutorialspoint .HelloTag</tag-class> 
<body-content>scriptless</body-content> 
</tag> 
</taglib> 


现在 我 们 可 以 在 JSP 使 用 修改 后 的 标签 ， 如 下 所 示 : 


<%@ taglib prefix="ex" uri="WEB-INF/custom. tld"%> 
«html» 
«head» 
<title>A sample custom tag</title> 
</head> 
<body> 
<ex :Hello> 
This is message body 
</ex:Hello> 
</body> 
</html> 


以 上 程序 输出 结果 如 下 所 示 : 


This is message body 


自 定 义 标 签 属性 


你 可 以 在 自 定义 标准 中 设置 各 种 属性 ， 要 接收 属性 ， 值 自 定义 标签 类 必须 实现 


setter 方 法 ， JavaBean 中 的 setter 方 法 如 下 所 示 : 


package com.tutorialspoint; 


import javax.servlet.jsp.tagext.*; 
import javax.servlet.jsp.*; 
import java.io.*; 


public class HelloTag extends SimpleTagSupport { 
private String message; 


public void setMessage(String msg) { 
this.message - msg; 


j 


Stringwriter sw = new Stringwriter(); 


public void doTag() 
throws JspException, IOException 
{ 


if (message != null) { 
/* 从 属性 中 使 用 消息 */ 
JspWriter out = getJspContext().getOut(); 
out.println( message ); 

} 

else { 
/* 从 内 容 体 中 使 用 消息 */ 
get JspBody().invoke(sw); 
getJspContext().getOut().println(sw.toString()); 


属性 的 名 称 是 "message"， 所 以 setter 方 法 ?? 是 的 setMessage()。 现 在 让 我 们 在 TLD 


文件 中 使 用 的 <attribute> 元 素 添加 此 属性 : 


<taglib> 
<tlib-version>1.0</tlib-version> 
<jsp-version>2.0</jsp-version> 
<short-name>Example TLD with Body</short-name> 
<tag> 
<name>Hello</name> 
<tag-class>com.tutorialspoint .HelloTag</tag-class> 
<body-content>scriptless</body-content> 
<attribute> 
<name>message</name> 
</attribute> 
</tag> 
</taglib> 


现在 我 们 就 可 以 在 JSP 文 件 中 使 用 message 属 性 了 ， 如 下 所 示 : 


<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%> 
<html> 
<head> 
<title>A sample custom tag</title> 
</head> 
<body> 
<ex:Hello message="This is custom tag" /> 
</body> 
</html> 


以 上 实例 数据 输出 结果 为 : 


This is custom tag 


你 还 可 以 包含 以 下 属性 : 


属性 描述 
name 定义 属性 的 名 称 。 每 个 标签 的 是 属性 名 称 必 须 是 唯一 的 。 
required 指定 属性 是 否 是 必须 的 或 者 可 选 的 ,如 果 设 置 为 false 为 可 选 


rtexprvalue ”声明 在 运行 表达 式 时 ， 标 签 属性 是 否 有 效 。 
type 定义 该 属性 的 Java 类 类 型 。 默 认 指 定 为 String 
description ”描述 信息 


fragment 如 果 声 明了 该 属性 ,属性 值 将 被 视 为 一 个 JspFragment。 
以 下 是 指定 相关 的 属性 实例 : 


mh 
H 


o 


<attribute> 
<name>attribute_name</name> 
<required>false</required> 
<type>java.util.Date</type> 
<fragment>false</fragment> 
</attribute> 


<attribute> 
<name>attribute_name1</name> 
<required>false</required> 
<type>java.util.Boolean</type> 
<fragment>false</fragment> 

</attribute> 

<attribute> 
<name>attribute_name2</name> 
<required>true</required> 
<type>java.util.Date</type> 

</attribute> 


JSP RANAS 


JSP 表 达 式 语言 (EL) 使 得 访问 存储 在 JavaBean 中 的 数据 变 得 非常 简单 。JSP EL 
既 可 以 用 来 创建 算术 表达 式 也 可 以 用 来 创建 逮 辑 表达 式 。 在 JSP EL 表达 式 内 可 以 使 
用 整 型 数 ， 浮 点 数 ， 字 符 串 ， 常 量 true、false， 还 有 null。 


=A 


间 单 的 语 法 


典型 的 ， 当 您 需要 在 JSP 标 签 中 指定 一 个 属性 值 时 ， 只 需要 简单 地 使 用 字符 串 即 
n: 


«jsp:setProperty name="box" property="perimeter" value="100"/> 


JSP EL 人 允许 您 指定 一 个 表达 式 来 表示 属性 值 。 一 个 简单 的 表达 式 语法 如 下 : 


${expr} 


其 中 ， uiid 的 是 表达 式 。 在 JSP EL 中 通用 的 操作 符 是 "." 和 "[]"。 这 两 个 操作 符 允 
S 通过 内 艇 的 JSP 对 象 访 问 各 种 各 样 的 JavaBean 属 性 。 


举例 来 说 ， 上 面 的 <jsp:setProperty> 标 签 可 以 使 用 表达 式 语言 改写 成 如 下 形式 : 


<jsp:setProperty name="box" property="perimeter" 
value="${2*box.width+2*box.height}"/> 


当 JSP 编 译 器 在 属性 中 见 到 "$ 人 "格式 后 ， 它 会 产生 代码 来 计算 这 个 表达 式 ， 并 且 产 
生 一 个 替代 品 来 代替 表达 式 的 值 。 


您 也 可 以 在 标签 的 模板 文本 中 使 用 表达 式 语言 。 上 比如 <jsp:text> 标 签 简单 地 将 其 主体 
中 的 文本 插入 到 JSP 输 出 中 : 


<jsp:text> 
<hi>Hello JSP!«/hi» 
</jsp:text> 


现在 ， 在 <jsp:text> 标 签 主体 中 使 用 表达 式 ， 就 像 这 样 : 


<jsp:text> 
Box Perimeter is: ${2*box.width + 2*box.height} 
</jsp:text> 


在 EL 表达 式 中 可 以 使 用 圆 括 号 来 组 织 子 表达 式 。 上 比如 ${(1 + 2) 3) 等 于 9， 但 是 8f1 + 
(23) 等 于 7。 


想 要 停 用 对 EL 表达 式 的 评估 的 话 ， 需 要 使 用 page 指 合 将 isELignored 属 性 值 设 为 
true : 


<%@ page isELIgnored ="true|false" %> 
这 样 ，EL 表 达 式 就 会 被 忽略 。 若 设 为 false， 则 容器 将 会 计算 EL 表达 式 。 


EL 中 的 基础 操作 符 


EL 表达 式 文 持 大 部 分 Java 所 提供 的 算术 和 逻辑 操作 符 : 


操作 符 描述 
访问 一 个 Bean 属 性 或 者 一 个 映射 条 目 
[| 访问 一 个 数组 或 者 链表 的 元 素 
() 组 织 一 个 子 表达 式 以 改变 优先 级 
it 加 
à p 
/ or div 除 
% or mod 取 模 
== or eq 则 试 是 否 相等 
I= or ne 测试 是 否 不 等 
« or It 测试 是 否 小 于 
> or gt 则 试 是 否 大 于 
<= orle 测试 是 否 小 于 等 于 
>= or gt 测试 是 否 大 于 等 于 
&& or and 测试 逻辑 与 
|| or or 测试 逻辑 或 
! or not 测试 取 反 
empty 测试 是 否 空 值 








JSP EL 中 的 函数 


JSP EL 人 允许 您 在 表达 式 中 使 用 函数 。 这 些 函 数 必须 被 定义 在 自 定义 标签 库 中 。 阔 数 
的 使 用 语法 如 下 : 


$(ns:func(parami1, param2, ...)} 


ns 指 的 是 命名 空间 (namespace) , funchi ERRIZ, parama 
个 参数 ， param2 指 的 是 第 二 个 参数 ， 以 此 类 推 。 比 如 ， 有 男 数 fn:length， 在 JSTL 
库 中 定义 ， 可 以 像 下 面 这 样 来 获取 一 个 字符 串 的 长 度 : 


${fn:length("Get my length")} 


要 使 用 任何 标签 库 中 的 函数 ， 您 需要 将 这 些 库 
标签 在 JSP 文 件 中 包含 


安装 在 服务 器 中 ， 然 后 使 用 <taglib> 


JSP ELKE x1 2 
JSP EL 支持 下 表 列 出 的 隐 仿 对象 : 


EE 描述 
pageScope page 作用 域 
requestScope request 作用 域 


sessionScope 
applicationScope 
param 
paramValues 
header 
headerValues 
initParam 

cookie 


pageContext 


session 作用 域 

application 作用 域 

Request 对 象 的 参数 ， 字 符 串 
Request 对 象 的 参数 ， 字 符 串 集合 
HTTP 信息 关 ， 字 符 串 

HTTP 信息 头 ， 字 符 串 集合 

上 下 文 初始 化 参数 

Cookie 值 

当前 页 面 的 pageContext 


您 可 以 在 表达 式 中 使 用 这 些 对 象 ， 就 像 使 用 变量 一 样 。 接 下 来 会 给 出 几 个 例子 来 更 


好 的 理解 这 个 念 。 


pageContextxt & 


pageContext 对 象 是 JSP 中 pageContext 对 象 的 引用 。 您 可 
以 访问 request 对 象 。 比 如 ， 访 问 request 对 象 传人 的 查询 字符 串 ， 就 像 这 


${pageContext.request.queryString} 


Scopes] KR 


pageScope, requestScope, sessionScope, applicationScope ¥ BFA ix js] Tz 4i 
TE & T l/E FUE RBS ES. 


举例 来 说 ， 如 果 您 需要 显 式 访问 在 applicationScope 层 的 box 变 量 ， 可 以 这 样 来 访 
i : applicationScope.box。 


param 和 paramValues 对 象 


param 和 paramValues 对 象 用 来 访问 参数 值 ， 通 过 使 用 request.getParameter 方 法 和 
request.getParameterValues Aik. 


举例 来 说 ， 访 问 一 个 名 为 order 的 参数 ， 可 以 这 样 使 用 表达 式 : $(param.order), 3 
4 ${param["order"]}. 


接 下 来 的 例子 表明 了 如 何 访问 request 中 的 username 参 数 : 


<%@ page import="java.io.*,java.util.*" %> 
<% 
String title = "Accessing Request Param"; 
%> 
<html> 
<head> 
<title><% out.print(title); %></title> 
</head> 
<body> 
<center> 
<hi><% out.print(title); %></h1> 
</center> 
<div align="center"> 
<p>${param[ "username" ] }</p> 
</div> 
</body> 
</html> 


param 对 象 返 回 单一 的 字符 串 ， 而 paramValues 对 象 则 返回 一 个 字符 串 数 组 。 


header 和 headerValues 对 象 


header 和 headerValues 对 象 用 来 访问 信息 头 ， 通 过 使 用 request.getHeader 方 法 和 
request.getHeaders 方 法 。 


举例 来 说 ， 要 访问 一 个 名 为 user-agent 的 信息 头 ， 可 以 这 样 使 用 表达 式 : 
${header.user-agent}， 或 者 $f{header["user-agent"]}。 


接 下 来 的 例子 表明 了 如 何 访问 user-agent 信 息 头 : 


<%@ page import="java.io.*,java.util.*" %> 
<% 
String title = "User Agent Example"; 
%> 
«html» 
«head» 
<title><% out.print(title); %></title> 
</head> 
<body> 
<center> 
<hi><% out.print(title); %></h1> 
</center> 
<div align="center"> 
<p>${header ["user-agent" ]}</p> 
</div> 
</body> 
</html> 


User Agent Example 
Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.1; WOW64; Trident/4.0; SLCC2; .NET CLR 


2.0.50727; .NET CLR 3.5.30729; NET CLR 3.0.30729; Media Center PC 6.0; HPNTDF; .NET4.0C; 
InfoPath.2) 


header 对 象 返 回 单 一 值 ， 而 headerValues 则 返回 一 个 字符 串 数组 。 


JSP SRE 


当 编 写 JSP 程 序 的 时 候 ， 程 序 员 可 能 会 遗漏 一 些 BUG， 这 些 BUG 可 能 会 出 现在 程序 
的 任何 地 方 。JSP 代 码 中 通常 有 以 下 几 类 异常 : 


e 检查 型 异常 :检查 型 异常 就 是 一 个 典型 的 用 户 错误 或 者 一 个 程序 员 无 法 预见 的 错 
误 。 举 例 来 说 ， 如 果 一 个 文件 将 要 被 打开 ， 但 是 无 法 找到 这 个 文件 ， 则 一 
常 被 抛 出 。 这 些 异常 不 能 再 编译 期 被 简单 地 忽略 。 

° T E EE 这 种 异常 在 编译 期 将 会 被 

e 错误 :这 里 没有 异常 ， 但 问题 是 它 超 出 了 用 户 或 者 程序 员 的 控制 范围 。 ADR XB 
会 在 代码 中 被 忽略 ， 您 几乎 不 能 拿 它 怎么 样 。 举例 来 或 ， JS 使 出错; 误 。 这 些 错 
误 都 会 在 编译 期 被 忽略 。 


本 节 将 会 给 出 几 个 简单 而 优雅 的 方式 来 处 理 运行 时 异常 和 错误 。 
使 用 Exception 对 象 


exception 对 象 是 Throwable 子 类 的 一 个 实例 ， 只 在 错误 页 面 中 可 用 。 下 表 列 出 了 
Throwable 类 中 一 些 重要 的 方法 : 


方法 描述 
A 。 返回 异常 的 信息 。 ix 言 息 在 Throwable 构 
public String getMessage() x5 B ch dr] f A 


T cun 3E H : 
public ThrowablegetCause() zum ea X BA Throwable xt 


名 


public String toString() 返回 类 
常 栈 轨迹 输出 至 System.err 


[5] 
public void printStackTrace() 将 异 


= 


public StackTraceElement [] JE DTE SE be HOTZ S 
getStackTrace() 以 栈 轨迹 元 素数 组 的 形式 返回 异常 栈 轨迹 


public M^ dn 1 nje A < 
ThrowablefillinStackTrace() 使 用 当前 栈 轨 迹 壤 充 Throwable 对 象 


JSP 提 供 了 可 选项 来 为 每 个 JSP 页 面 指 定 错 误 页 面 论 何 时 页 面 抛 出 了 异常 ， 
JSP 容 器 都 会 自动 地 调用 错误 页 面 。 


接 下 来 的 例子 为 main.jsp 指 定 了 一 个 错误 页 面 。 使 用 <%@page 
errorPage="XXXXX"%> 指 全 指定 一 个 #32 Tl To 


<%@ page errorPage="ShowError.jsp" %> 


<html> 

<head> 
<title>Error Handling Example</title> 

</head> 

<body> 

<% 
// Throw an exception to invoke the error page 
LNG rs 


if (x == 1) 
{ 
throw new RuntimeException("Error condition!!!"); 
} 
%> 
</body> 
</html> 


现在 ， 编 写 ShowErrorjsp 文 件 如 下 : 


<%@ page isErrorPage="true" %> 

<html> 

<head> 

<title>Show Error Page</title> 

</head> 

<body> 

<hi>Opps...</h1> 

<p>Sorry, an error occurred.</p> 

<p>Here is the exception stack trace: </p> 
<pre> 

<% exception.printStackTrace(response.getWriter()); %> 


注意 到 ，ShowError.jsp 文 件 使 用 了 <%@page isErrorPage="true"%> 指 令 ， 这 个 指 
命 告诉 JSP 编 译 器 需要 产生 一 个 异常 实例 变量 。 


现在 试 着 访问 main.jsp 页 面 ， 它 将 会 产生 如 下 结果 : 


java.lang.RuntimeException: Error condition!!! 


Opps... 
Sorry, an error occurred. 


Here is the exception stack trace: 


在 错误 页 面 中 使 用 JSTL 标 签 


可 以 利用 JSTL 标 签 来 编写 错误 页 面 ShowErrorjsp。 这 个 例子 中 的 代码 与 上 例 代 码 
的 逻辑 几乎 一 样 ， 但 是 本 例 的 代码 有 更 好 的 结构 ， 并 且 能 够 提供 更 多 信息 : 


<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> 

<%@page isErrorPage="true" %> 

«html» 

«head» 

<title>Show Error Page</title> 

</head> 

<body> 

<hi>Opps...</h1> 

<table width="100%" border="1"> 

<tr valign="top"> 

<td width="40%"><b>Error:</b></td> 

<td>${pageContext .exception}</td> 

</tr> 

<tr valign="top"> 

<td><b>URI:</b></td> 

<td>${pageContext.errorData. requestURI }</td> 

</tr> 

<tr valign="top"> 

<td><b>Status code:</b></td> 

<td>${pageContext.errorData. statusCode}</td> 

</tr> 

<tr valign="top"> 

<td><b>Stack trace:</b></td> 

<td> 

<c:forEach var="trace" 
items="${pageContext.exception.stackTrace}"> 

<p>${trace}</p> 

</c:forEach> 

</td> 

</tr> 

</table> 

</body> 

</html> 


Opps... 





Error: java.lang.RuntimeException: Error condition!!! 
URI: Imain.jsp 

Status code: 500 

Stack trace: 


org.apache.jsp.main, jsp. jspService(main, jsp.java:65) 
org.apache jasper.runtime.Http.JspBase.service(HttpJspBase.java:68) 
javax.servlet http. HttpServlet service(HttpServlet.java:722) 


org.apache.jasper.servlet.JspServlet.service(JspServlet.java:265) 


javax.servlet.http.HttpServlet. service(HttpServlet.java:722) 





使 用 try...catch 块 


如 果 您 想 要 将 异常 处 理 放 在 一 个 页 面 中 ， 并 且 对 不 同 的 异常 进行 不 同 的 处 理 ， 那 么 
您 就 需要 使 用 try...catch 块 了 。 


接 下 来 的 这 个 例子 显示 了 如 何 使 用 try...catch 块 ， 将 这 些 代 码 放 在 main.jsp 中 : 


«html» 
«head» 
<title>Try...Catch Example</title> 
</head> 
<body> 
<% 
tryt 
int i- 1; 
i=1i/ 909; 
out.println("The answer is " + i); 
} 
catch (Exception e)( 
out.println("An exception occurred: " + e.getMessage()); 
} 
%> 
</body> 
</html> 


试 着 访问 main.jsp， 它 将 会 产生 如 下 结果 : 


An exception occurred: / by zero 


JSP 调试 


要 测试 /调试 一 个 JSP 或 servlet 程 序 总 是 那么 的 难 。JSP 和 Servlets 程 序 赵 向 于 牵涉 
到 大 量 客户 端 /服务 器 之 间 的 交互 ， 这 很 有 可 能 会 产生 错误 ， 并 且 很 难 重 现 出 错 的 环 
境 。 


接 下 来 将 会 给 出 一 些小 技巧 和 小 建议 ， 来 帮助 您 调试 程序 。 


使 用 System.out.println() 


System.out.println() 可 以 很 方便 地 标记 一 段 代 码 是 否 被 执行 。 当 然 ， 我 们 也 可 以 打 
印 出 各 种 各 样 的 值 。 此 外 : 


e 自从 System 对 象 成 为 Java 核 心 对 象 后 ， 它 便 可 以 使 用 在 任何 地 方 而 不 用 引入 
额外 的 类 。 使 用 范围 包括 Servlets，JSP，RMI，EJB's，Beans， 类 和 独立 应 
用 。 

e 与 在 断 点 处 停止 运行 相 比 ， 用 System.out 进 行 输出 不 会 对 应 用 程序 的 运行 流程 
造成 重大 的 影响 ， 这 个 特点 在 定时 机 制 非常 重要 的 应 用 程序 中 就 显得 非常 有 用 
Bes 


接 下 来 给 出 了 使 用 System.out.println() 的 语法 : 


System.out.println("Debugging message"); 


这 是 一 个 使 用 System.out.print() 的 简单 例子 : 


<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> 
<html> 
<head><title>System.out.println</title></head> 
<body> 
«c:forEach var="counter" begin="1" end="10" step="1" > 
«c:out value="${counter -5}"/></br> 
<% System.out.println( "counter- " + 
pageContext.findAttribute("counter") ); %> 
«/c:forEach» 
«/body» 
</html> 


现在 ， 如 果 运 行 上 面 的 例子 的 话 ， 它 将 会 产生 如 下 的 结果 : 


tot 
ENORA 


oOBKRWNHREO: 1 


如 果 使 用 的 是 Tomcat 服 务 器 ， 您 就 能 够 在 logs 目 录 下 的 stdout.log 文 件 中 发 现 多 出 了 
如 下 内 容 : 


counter=1 
counter=2 
counter=3 
counter=4 
counter=5 
counter=6 
counter=7 
counter=8 
counter=9 
counter=10 


使 用 这 种 方法 可 以 将 变量 和 其 它 的 信息 输出 至 系统 日 志 中 ， 用 来 分 析 并 找 出 造成 问 
题 的 深层 次 原因 。 


使 用 JDB Logger 


J2SE 日 志 框 架 可 为 任何 运行 在 JVM 中 的 类 提供 日 志 记 录 服 务 。 因 此 我 们 可 以 利用 这 
个 框架 来 记录 任何 信息 。 


让 我 们 来 重 写 以 上 代码 ， 使 用 JDK 中 的 logger API : 


<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> 
<%@page import="java.util.logging.Logger" %> 


<html> 

<head><title>Logger.info</title></head> 

<body> 

<% Logger logger-Logger.getLogger(this.getClass().getName());96» 


«c:forEach var="counter" begin="1" end="10" step="1" > 
«c:set var="myCount" value="${counter-5}" /> 
«c:out value="${myCount }"/></br> 
<% String message = "counter=" 
+ pageContext.findAttribute("counter") 
+ " myCount=" 
+ pageContext.findAttribute("myCount"); 
logger.info( message ); 
%> 
</c: forEach> 
</body> 
</html> 


它 的 运行 结果 与 先前 的 类 似 ， 但 是 ， 它 可 以 获得 额外 的 信息 输出 至 stdout.log 文 件 
中 。 在 这 我 们 使 用 了 logger 中 的 info 方 法 。 下 面 我 们 给 出 stdout.log 文 件 中 的 一 个 快 


24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=1 myCount=-4 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=2 myCount=-3 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=3 myCount=-2 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=4 myCount=-1 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=5 myCount=0 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=6 myCount=1 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter-7 myCount=2 

24-Sep-2013 23:31:31 org.apache.jsp.main jsp  jspService 
INFO: counter=8 myCount=3 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=9 myCount=4 

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspService 
INFO: counter=10 myCount=5 


消息 可 以 使 用 各 种 优先 级 发 送 ， 通 过 使 用 sever()，warning()，info()，config()， 
fine()，finer()，finest() 方 法 。finest() 方 法 用 来 记录 最 好 的 信息 ， 而 sever() 方 法 用 来 
记录 最 严重 的 信息 。 


使 用 Log4J 框架 来 将 消息 记录 在 不 同 的 文件 中 ， 这 些 消 息 基于 严重 程度 和 重要 性 来 


进行 分 类 Ko 


调试 工具 
NetBeans 是 树 形 结构 ， 是 开源 的 Java 综 合 开发 环境 ， 支 持 开 发 独立 的 Java 应 用 程 
序 和 网 络 应 用 程序 ， 同 时 也 支持 JSP 调 试 。 
NetBeans 支 持 如 下 几 个 基本 的 调试 功能 : 

e HA 


e 单 步 跟 踪 
e 观察 点 


详细 的 信息 可 以 查看 NetBeans 使 用 手册 。 


使 用 JDB Debugger 


可 以 在 JSP 和 servlets 中 使 用 jdb 命 令 来 进行 调试 ， 就 像 调试 普通 的 应 用 程序 一 样 。 


通常 ， 我 们 直接 调试 sun.servlet.http.HttpServer 对 象 来 查看 HttpServer 在 响应 
HTTP 请 求 时 执行 JSP/Servlets 的 情况 。 这 与 调试 applets 非 常 相 似 。 不 同 之 处 在 
F; aeS PE & 亭 实际 调试 的 是 sun.applet.AppletViewer。 


大 部 分 调试 器 在 调试 applets 时 者 和 bE 够 自动 忽略 掉 一 些 细节 ， 因 为 它 知 道 如 何 调试 
applets。 如 果 想 要 将 调试 对 象 转移 到 JSP 身 上 ， 就 需要 做 好 以 下 两 点 : 


e 设置 调试 器 的 classpath， 让 它 能 够 找到 sun.servlet.http.Http-Server 和 相关 的 


。 T 


e SN ASPERIS 让 它 能 够 找到 您 的 JSP 文 件 和 相关 的 类 


设置 好 classpath 后 ， 开 始 调试 sun.servlet.http. Http-Server 。 您 可 以 在 JSP 文 件 的 
任意 地 方 设 受 置 断 点 ， 只 要 你 喜欢 ， 然 后 使 用 浏览 器 发 送 一 个 请 求 给 服务 器 就 应 该 可 
以 看 见 程序 停 在 了 断 点 处 。 


使 用 注释 


程序 中 的 注释 在 很 多 方面 都 对 程序 的 调试 起 到 一 定 的 帮助 作用 。 注 释 可 以 用 在 调试 
程序 的 很 多 方面 中 。 


JSP 使 用 Java 注 释 。 如 果 一 个 BUG 消 失 了 ， 就 请 仔细 查看 您 刚 注释 过 的 代码 ， 通 常 
都 能 找 出 原因 。 


客户 病 和 服务 器 的 头 模块 


有 时 候 ， 当 JSP 没 有 按照 预定 的 方式 运行 时 ， 坦 看 未 加 工 的 HTTP 请 求 和 响应 也 是 
很 有 用 的 。 如 果 对 HTTP 的 结构 很 熟悉 的 话 ， 您 可 以 直接 观察 request 和 response 然 
后 看 看 这 些 头 模块 到 底 怎么 了 。 


重要 调试 技巧 
这 里 我 们 再 透露 两 个 调试 JSP 的 小 技巧 : 


e 使 用 浏览 器 显示 原始 的 页 面 内容 ， 用 来 区 分 是 否 是 格式 问题 。 这 个 选项 通常 在 
View 菜 单 下 。 

e 确保 浏览 器 在 强制 重新 载 入 页 面 时 没有 捕获 先前 的 request 输 出 。 若 使 用 的 是 
Netscape Navigator 浏 览 器 ， 则 用 Shift-Reload ; 若 使 用 的 是 IE 浏览 器 ， 则 用 
Shift-Refresh。 


JSP 国际 化 


在 开始 前 ， 需 要 解释 几 个 重要 的 概念 : 
e 国际 化 (i18n) : 表明 一 个 页 面 根据 访问 者 的 语言 或 国家 来 呈现 不 同 的 翻译 版 
本 。 
e 本 地 化 (I10n) : 向 网 站 添加 资源 ， 以 使 它 适 应 不 同 的 地 区 和 文化 。 比 如 网 站 
的 印度 语 版 本 。 
e 区域 : 这 是 一 个 特定 的 区 域 或 文化 ， 通 常 认为 是 一 个 语言 标志 和 国家 标志 通过 
下 划 线 连接 起 来 。 比 如 "en_US" 代 表 美 国 英语 地 区 。 


如 果 想 要 建立 一 个 全 球 化 的 网 站 ， 就 需要 关心 一 系列 项 目 。 本 章 将 会 详细 告诉 您 如 
何 处 理 国际 化 问题 ， 并 给 出 了 一 些 例子 来 加 深 理解 。 


JSP 容 器 能 够 根据 request 的 locale 属 性 来 提供 正确 地 页 面 版 本 。 接 下 来 给 出 了 如 何 
通过 request 对 象 来 获得 Locale 对 象 的 语法 : 


java.util.Locale request.getLocale() 


仿 测 Locale 


下 表 列 举 出 了 Locale 对 象 中 比较 重要 的 方法 ， 用 于 检测 request 对 象 的 地 区 ， 语 言 ， 
和 区 域 。 所 有 这 些 方法 都 会 在 浏览 器 中 显示 国家 名 称 和 语言 名 称 : 


方法 描述 
String getCountry() vic EE 或 1SO 3166 2-letter 
mee J AWS > 的 国家 小 
getDisplayCountry() 返回 要 显示 给 用 户 的 国家 名 称 
String getLanguage() ，， 返回 语言 码 的 英文 小 宇 ， 或 ISO 639 格式 的 区 域 
String TU mm 
getDisplayLanguage() 返回 要 给 用 户 看 的 语言 名 称 
String M = rz IR EA — i p TA 
getlSO3Country() 返回 国家 名 称 的 3 字母 缩写 
String TR ene 
getlSO3Language() 返回 语言 名 称 的 3 字母 缩写 


实例 演示 


这 个 例子 告诉 我 们 如 何在 JSP 中 显示 语言 和 国家 : 


«99 page import="java.io.*,java.util.Locale" %> 
«99 page import="javax.servlet.*, javax.servlet.http.* "%> 
<% 
// 获 取 客 户 端 本 地 化 信息 
Locale locale = request.getLocale(); 
String language = locale.getLanguage(); 
String country = locale.getCountry(); 
%> 
<html> 
<head> 
<title>Detecting Locale</title> 
</head> 
<body> 
<center> 
<hi>Detecting Locale</h1i> 
</center> 
<p align="center"> 
<% 
out.println("Language : " + language + "<br />"); 
out.println("Country : " + country PaCS oy 
%> 
</p> 
</body> 
</html> 


JSP 可 以 使 用 西欧 语言 来 输出 一 个 页 面 ， 比 如 英语 ， 西 班 牙 语 ， 德 语 ， 法 语 ， 意 大 
利 语 等 等 。 由 此 可 见 ， 设 置 Content-Language 信 息 头 来 正确 显示 所 有 字符 是 很 重要 
的 。 


二 点 就 是 ， 需 要 使 用 HTML 字 符 实体 来 显示 特殊 字符 ， 比 如 "fi" 代表 的 
EU", RESET: 


<%@ page import="java.io.*,java.util.Locale" %> 
<%@ page import="javax.servlet.*, javax.servlet.http.* "%> 
<% 
// Set response content type 
response.setContentType("text/htm1"); 
// Set spanish language code. 
response.setHeader("Content-Language", "es"); 
String title = "En Espa?ol"; 


%> 

<html> 

<head> 

<title><% out.print(title); %></title> 
</head> 

<body> 

<center> 

<hi><% out.print(title); %></h1> 
</center> 

<div align="center"> 

<p>En Espa?ol</p> 

<p>?Hola Mundo! </p> 

</div> 

</body> 

</html> 


区 域 特定 日 期 


可 以 使 用 java.text.DateFormat 类 和 它 的 静态 方法 getDateTimelnstance() 来 格式 化 
日 期 和 时 间 。 接 下 来 的 这 个 例子 显示 了 如 何 根据 指定 的 区 域 来 格式 化 日 期 和 时 间 : 


<%@ page import-"java.io.*,java.util.Locale" %> 
<%@ page import="javax.servlet.*, javax.servlet.http.* "%> 
<%@ page import="java.text.DateFormat, java.util.Date" %> 


<% 
String title = "Locale Specific Dates"; 
//Get the client's Locale 
Locale locale = request.getLocale( ); 
String date = DateFormat.getDateTimeInstance( 
DateFormat.FULL, 
DateFormat .SHORT ， 
locale).format(new Date( )); 
%> 
<html> 
<head> 
<title><% out.print(title); %></title> 
</head> 
<body> 
<center> 
<hi><% out.print(title); %></h1> 
</center> 
<div align="center"> 
<p>Local Date: <% out.print(date); %></p> 
</div> 
</body> 
</html> 


区 域 特定 货 


可 以 使 用 java.text.NumberFormat 类 和 它 的 静态 方法 getCurrencylnstance() 来 格式 
化 数字 。 比 如 在 区 域 特定 货币 中 的 long 型 和 double 型 。 接 下 来 的 例子 显示 了 如 何 根 
据 指定 的 区 域 来 格式 化 货币 : 


<%@ page import="java.io.*,java.util.Locale" %> 
<%@ page import-"javax.servlet.*,javax.servlet.http.* "%> 
<%@ page import="java.text.NumberFormat, java.util.Date" %> 


<% 
String title = "Locale Specific Currency"; 
//Get the client's Locale 
Locale locale = request.getLocale( ); 
NumberFormat nft = NumberFormat.getCurrencyInstance(locale); 
String formattedCurr = nft.format(1000000) ; 
%> 
<html> 
<head> 
<title><% out.print(title); %></title> 
</head> 
<body> 
<center> 
<hi><% out.print(title); %></h1> 
</center> 
<div align="center"> 
<p>Formatted Currency: <% out.print(formattedCurr); %></p> 
</div> 
</body> 
</html> 


区 域 特定 百分比 


可 以 使 用 java.text.NumberFormat 类 和 它 的 静态 方法 getPercentinstance() 来 格式 化 
百分比 。 接 下 来 的 例子 告诉 我 们 如 何 根据 指定 的 区 域 来 格式 化 百分比 : 


<%@ page import="java.io.*,java.util.Locale" %> 
<%@ page import-"javax.servlet.*,javax.servlet.http.* "%> 
<%@ page import="java.text.NumberFormat, java.util.Date" %> 


<% 
String title = "Locale Specific Percentage"; 
//Get the client's Locale 
Locale locale = request.getLocale( ); 


NumberFormat nft = NumberFormat.getPercentInstance(locale); 


String formattedPerc = nft.format(0.51); 
%> 
<html> 
<head> 
<title><% out.print(title); %></title> 
</head> 
<body> 
<center> 
<hi><% out.print(title); %></h1> 
</center> 
<div align="center"> 


<p>Formatted Percentage: <% out.print(formattedPerc); %></p> 


</div> 
</body> 
</html> 


Log4j 教 程 


log4j 是 一 个 用 Java 编 写 的 可 靠 ， 快 速 和 灵活 的 日 志 框 架 (API) ， 它 在 Apache 软 件 
许可 下 发 布 。 Log4j 已 经 被 移植 到 了 C，C++，C#，Perl，Python 和 Ruby 等 语言 
中 。Log4j 是 高 度 可 配置 的 ， 并 可 通过 在 运行 时 的 外 部 文件 配置 。 它 根据 记录 的 优 
先 级 别 ， 并 提供 机 制 ， 以 指示 记录 信息 到 许多 的 目的 地 ， 诸 如 : 数据 库 ， 文 件 ， 控 
制 台 ，UNIX 系 统 日 志 等 。 
Log4j 中 有 三 个 主要 组 成 部 分 : 

e loggers: 负责 捕获 记录 信息 。 

e appenders : 负责 发 布 日 志 信 息 ， 以 不 同 的 首选 目的 地 。 


e layouts: 负责 格式 化 不 同 风 格 的 日 志 信息 。 


log4j 的 历史 


e 始 于 1996 年 初 的 E.U. SEMPER (安全 电子 市 场 为 欧洲 ) 跟踪 API 的 项 目 。 


e 不 计 其 数 的 改进 ， 在 几 个 大 量 的 工作 之 后 ，API 已 经 发 展 成 为 log4j， 一 个 流行 
的 日 志 记 录 包 为 Java。 


e 该 软件 包 是 Apache 软 件 许可 证 ， 由 开源 认证 是 一 个 不 折 不 扣 的 开源 许可 证 下 发 


o 


e 最 新 log4j 的 版 本 ， 包 括 完 整 的 源 代 码 ， 类 文件 和 文档 可 以 在 这 里 找到 
http://logging.apache.org/log4j/. 


log4j 特性 : 


log4j 的 是 线程 安全 的 
log4j 是 经 过 优化 速度 的 
log4j 是 基于 一 个 名 为 记录 器 的 层次 结构 
log4j 的 支持 每 个 记录 器 多 输出 追加 器 (appender) 
log4j 支 持 国 际 化 。 
log4j 并 不 限于 一 组 预定 义 的 设备 
志 行为 可 以 使 用 配置 文件 在 运行 时 设置 
log4j 设 计 从 一 开始 就 是 处 理 Java 异 常 


e log4jf& FH £&^ EZR, BUALL, TRACE, DEBUG, INFO, WARN, ERROR 
FATAL 


e 日 志 输 出 的 格式 可 以 通过 扩展 Layout 类 容易 地 改变 
e 日 志 输 出 的 目标 ， 以 及 在 写 和 人 策略 可 通过 实现 Appender 程 序 接口 改变 


e log4j 会 故障 停止 。 然 而 ， 尽 管 它 肯定 努力 确保 传递 ，log4j 不 保证 每 个 日 志 语 
句 将 被 传递 到 目的 地 。 


日 志 记 录 N 个 缺点 及 优点 . 
日 志 是 软件 开发 的 重要 组 成 部 分 。 一 个 精心 编写 的 日 志 代码 提供 快速 的 调试 ， 维 扩 
方便 ， 以 及 应 用 程序 的 运行 时 信息 La ERE AR. 


日 志 记录 确实 也 有 它 的 缺点 。 它 可 以 减缓 的 应 用 程序 。 如 果 太 详细 ， 它 可 能 会 导致 
滚动 失明 。 为 了 减轻 这 些 影响 ，|log4j 被 设计 为 是 可 靠 ， 快 速 和 可 扩展 。 


由 于 记录 很 少 为 应 用 的 主要 重点 ， 但 log4j API 致 力 于 成 为 易于 理解 和 使 用 。 
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Log4j 的 APl 包 使 用 Apache 软 件 许可 证 ， 由 开源 倡议 认证 一 个 完全 成 熟 的 开源 许可 
证 下 发 布 。 


最 新 log4j 的 版 本 ， 包 括 完整 的 源 代码 ， 类 文件 和 文档 可 以 在 这 里 找到 
http://logging.apache.org/log4j/. 


下 载 apache-log4j-x.x.x.tar.gz 做 到 以 下 几 点 : 


步骤 1: 
将 下 载 的 文件 解压 缩 和 解压 在 /usr/local/ 目录 ， 如 下 所 示 : 


$ gunzip apache-1og4]j-1.2.15.tar.gz 

$ tar -xvf apache-10g4j-1.2.15.tar 
apache-10g4j-1.2.15/tests/input/ 
apache-10g4j-1.2.15/tests/input/xml/ 
apache-10g4j-1.2.15/tests/src/ 
apache-10g4j-1.2.15/tests/src/java/ 
apache-10g4j-1.2.15/tests/src/java/org/ 


当 执 行 解压 缩 ， 这 将 创建 一 个 名 称 apache-log4j-x.x.x 的 目录 层次 结构 如 下 : 


root root 4096 2007-08-25 00:13 site 
root root 4096 2010-02-04 14:08 src 
root root 4096 2010-02-04 14:09 tests 


drwxr-xr-x 
drwxr-xr-x 
drwxr-xr-x 


-rw-r--r-- 1 root root 3565 2007-08-25 00:09 BUILD-INFO.txt 
-rw-r--r-- 1 root root 2607 2007-08-25 00:09 build.properties.sé 
-rw-r--r-- 1 root root 32619 2007-08-25 00:09 build.xml 
drwxr-xr-x 14 root root 4096 2010-02-04 14:09 contribs 
drwxr-xr-x 5 root root 4096 2010-02-04 14:09 examples 
-rw-r--r-- 1 root root 2752 2007-08-25 00:09 INSTALL 
-rw-r--r-- 1 root root 4787 2007-08-25 00:09 KEYS 
-rw-r--r-- 1 root root 11366 2007-08-25 00:09 LICENSE 
-rw-r--r-- 1 root root 391834 2007-08-25 00:29 log4j-1.2.15.jar 
-rw-r--r-- 1 root root 160 2007-08-25 00:09 NOTICE 
-rwxr-xr-x 1 root root 10240 2007-08-25 00:27 NTEventLogAppender 
-rw-r--r-- 1 root root 17780 2007-08-25 00:09 pom.xml 

7 

8 
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步骤 2: 


这 一 步 是 可 选 的 ， 取 决 于 什么 功能 ， 要 使 用 log4j 框架 。 如 果 已 经 有 以 下 安装 在 您 的 
机 器 ， 那 么 可 以 使 用 这 些 软件 包 ， 否 则 将 需要 安装 它们 ， 才 能 正常 使 |og4j 工 作 


e JavaMail API: 电子 邮件 。 基 于 log4j 日 志 记 录 功 能 需要 Java 邮 件 
API (mailjar) 在 计算 机 上 安装 https://glassfish.dev.java.net/javaee5/mail/ 


e JavaBeans 活动 框架 : Java 邮 件 API 还 需要 JavaBeans 激 活 框架 (的 
activation.jar) Mhttp://java.sun.com/products/javabeans/jaf/index.jsp 上 下 载 
安装 在 您 的 计算 机 上 


e Java 信息 服务 : log4j 的 JMS 兼 容 的 功能 将 需要 两 个 JMS 和 JNDI (Java 命 名 和 
Directory 接 口 ) ， 可 以 从 http://java.sun.com/products/jms 下 载 安装 


e XML Parser: 需要 一 个 JAXP 兼 容 的 XML 解析 器 来 使 用 log4j。 请 确保 已 经 在 机 
器 上 安装 xerces.jar ， 可 从 http://xerces.apache.org/xerces-j/install.html 下 载 安 
J+ 
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这 一 步 是 非常 重要 的 ， 需 要 设置 CLASSPATH 和 PATH 变量 正确 。 在 这 里 要 设置 只 是 
log4j.x.x.x.jar 文件 


$ pwd 
/usr/local/apache-10g4j-1.2.15 
$ export CLASSPATH- 
$CLASSPATH: /usr/local/apache -10g4j-1.2.15/log4j-1.2.15.jar 
$ export PATH=$PATH: /usr/local/apache-1log4j-1.2.15/ 


注意 : 如 果 在 Window 上 开发 使 用 Eclipse 的 话 ， 可 以 在 Eclipse 创建 用 户 库 并 加 入 到 
构建 路 径 中 。 


log4j2 44 - Log4j 教 程 


Log4j API 设 计 为 分 层 结构 ， 其 中 每 一 层 提 供 了 不 同 的 对 象 ， 对 象 执 行 不 同 的 任务 。 
这 使 得 设计 灵活， 根据 将 来 需要 来 扩展 。 
有 两 种 类 型 可 用 在 Log4j 的 框架 对 象 。 

。 核心 对 象 : 框架 的 强制 对 象 和 框架 的 使 用 。 

e 支持 对 象 : 框架 和 支持 体 核心 对 象 ， 可 选 的 对 象 执 行 另外 重要 的 任务 。 


核心 对 象 : 


Loggerxt & : 


顶级 层 的 Logger， 它 提供 Logger 对 象 。Logger 对 象 负责 捕获 日 志 信 息 及 它们 存储 在 
一 个 空间 的 层次 结构 。 


布局 对 象 : 


该 层 提供 a i 日 志 信 息 的 对 象 。 布 局 层 提供 支持 Appender 对 象 
到 发 布 日 志 T 息 之 前 。 


布局 对 象 的 发 布 方式 是 人 类 可 读 的 及 可 重复 使 用 的 记录 信息 的 一 个 重要 的 角色 。 


Appender 对 象 : 


下 位 层 提供 Appender 对 象 。Appender 对 象 负 i^ 日 志 信 息 ， 以 不 同 的 首选 目的 
地 ， 如 数据 库 ， 文 件 ， 控 制 台 ， UNIX 系 统 日 志和 


以 下 是 显示 Log4J 框 架 的 不 同 组 件 的 虚拟 图 : 
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支持 对 象 : 
log4j 框 架 的 其 他 重要 的 对 象 起 到 日 志 框 架 的 一 个 重要 作用 : 


Levelxt & : 


级 别 对 象 定 义 的 任何 记录 信息 的 粒度 和 优先 级 。 有 记录 的 七 个 级 别 在 API 中 定义 : 
OFF, DEBUG, INFO, ERROR, WARN, FATAL 和 ALL 


Filters12& : 

过 滤 对 象 用 于 分 析 日 志 信息 及 是 否 应 记录 或 不 用 这 些 信 息 做 出 进一步 的 决定 。 

一 个 appender 对 象 可 以 有 与 之 关联 的 几 个 Filter 对 象 。 如 果 日 志 记 录 信 息 传递 给 特 
定 Appender 对 象 ， 都 和 特定 Appender 相 关 的 Filter 对 象 批准 的 日 志 信 息 ， 然 后 才能 
发 布 到 所 连接 的 目的 地 。 

对 象 泻 染 器 : 


ObjectRenderer 对 象 是 一 个 指定 提供 传递 到 日 志 框架 的 不 同 对 象 的 字符 串 表 示 。 这 
个 对 象 所 使 用 的 布局 对 象 来 准 各 最 后 的 日 志 信息 。 


日 志 管 理 : 
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志 管 理 对 象 管理 的 日 志 框 架 。 它 负责 从 一 个 系统 级 的 配置 文件 或 配置 类 污 取 初始 
配置 参数 。 


log4j 配 置 - Log4j 教 程 
上 一 章 介绍 log4j 的 核心 组 件 。 本 章 介绍 如 何 使 用 配置 文件 来 配置 这 些 核心 组 件 。 配 
置 log4j 涉 及 分 配 级 别 ， 定 义 追 加 程序 ， 并 在 配置 文件 中 指定 布局 的 对 象 


log4j.properties 文 件 是 一 个 键 - 值 对 保存 log4 配置 属性 文件 。 默 认 情 况 下 ， 日 志 管 
理 在 CLASSPATH 查找 一 个 名 为 log4j.properties 的 文件 。 


e. 根 日 志 记 录 器 的 级 别 定义 为 DEBUG 并 连接 附加 器 命名 为 X 到 它 
e 设置 名 为 X 的 附加 目的 地 是 一 个 有 效 的 appender 
e 设置 布局 的 附加 器 X 


log4j.properties 语法 : 
以 下 是 log4j.properties 文件 的 一 个 appender X 的 语法 : 


# Define the root logger with appender X 
log4j.rootLogger = DEBUG, X 


# Set the appender named X to be a File appender 
log4j .appender . X=org. apache. 1og4j .FileAppender 


# Define the layout for X appender 


log4j.appender.X.layout-org.apache.log4j.PatternLayout 
log4j .appender.X.layout.conversionPattern=%m%n 


log4j.properties 示例 : 


使 用 上 面 的 语法 ， 我 们 定义 log4j.properties 文件 如 下 : 
e 根 日 志 记 录 器 (loggenr) 的 级 别 定 义 为 DEBUG 并 连接 附加 器 命名 为 FILE 


e 附加 器 (appendemFile 是 定义 为 org.apache.log4j.FileAppender 并 写 入 到 一 个 名 
为 “log.out" 位 于 日 志 log 目 录 下 


。 定义 的 布局 模式 是 %m%n， 这 意味 着 每 打印 日 志 消 息 之 后 ， 将 加 上 一 个 换行 符 


# Define the root logger with appender file 
log4j.rootLogger = DEBUG, FILE 


# Define the file appender 
log4j.appender.FILE-org.apache.log4j.FileAppender 
log4j .appender.FILE.File=${log}/log.out 

# Define the layout for file appender 


1og4j.appender.FILE.layout-org.apache.log4j.PatternLayout 
log4j .appender.FILE. layout .conversionPattern=%m%n 


需要 注意 的 是 log4j 支 持 UNIX 风 格 的 变量 替换 ， 如 S{variableName}. 


调试 级 别 : 
使 用 DEBUG 两 个 追加 程序 。 所 有 可 能 的 选项 有 : 
e TRACE 
e DEBUG 
e INFO 
e WARN 
e ERROR 
e FATAL 
e ALL 
key BE Log4j 调 试 级 别 这 一 文章 中 解释 


Appenders: 


Apache 的 log4j 提 供 Appender 对 象 主要 负责 打印 日 志 消 息 到 不 同 的 目的 地 ， 如 控制 
台 ， 文 件 ，sockets，NT 事 件 日 志 等 等 。 


每 个 Appender 对 象 具有 和 与 之 相关 联 的 不 同 的 属性 ， 并 且 这 些 属性 表明 对 象 的 行为 


属性 描述 


layout Appender 使 用 布局 Layout 对 象 和 与 之 相关 的 格式 化 的 日 志 记 录 信 


息 转换 模式 
target 目标 可 以 是 一 个 控制 人 台 ， 一 个 文件 ， 或 根据 附加 器 的 另 一 个 项 目 
level 级 别 是 必需 的 ， 以 控制 日 志 消 息 Aa 


er 
Appender 忽 上 略 具 有 级 别 低 于 阔 级 别 的 任何 日 志 消息 


Filter 对 象 可 以 分 析 超 出 级 别 的 匹配 记录 信息 ， 并 决定 是 否 记 录 的 


Migi 请 求 应 该 由 一 个 特定 Appender 或 忽略 处 理 


可 以 通过 包括 以 下 方法 的 配置 文件 中 的 下 面 设置 一 个 Appender 对 象 添加 到 记录 
ae : 


log4j.logger.[logger-name]=level, appenderi,appender..n 


可 以 编写 以 XML 格式 相同 的 结构 如 下 : 


«logger name="com.apress.logging.log4j" additivity="false"> 
<appender-ref ref="appenderi"/> 
<appender-ref ref="appender2"/> 

</logger> 


如 果 想 要 添加 Appender 对 象 到 程序 ， 那 么 可 以 使 用 下 面 的 方法 : 


public void addAppender(Appender appender); 


addAppender() 方 法 添加 一 个 appender 到 Logger 对 象 。 作 为 示例 配置 演示 ， 可 以 添 
加 很 多 Appender 对 象 到 记录 器 在 逗号 分 隔 的 列表 ， 每 个 打印 日 志 信 息 分 离 目 的 地 。 


我 们 仅 使 用 一 个 附加 目的 地 FileAppender 在 我 们 上 面 的 例子 。 所 有 可 能 的 附加 目的 
地 选项 有 : 


e AppenderSkeleton 

e AsyncAppender 

e ConsoleAppender 

e DailyRollingFileAppender 

e ExternallyRolledFileAppender 
e FileAppender 


e JDBCAppender 

e JMSAppender 

e LF5Appender 

e NTEventLogAppender 

e NullAppender 

e RollingFileAppender 

e SMTPAppender 

e SocketAppender 

e SocketHubAppender 

e SyslogAppender 

e TelnetAppender 

e WriterAppender 
我 们 将 涵盖 FileAppender 文 件 和 JDBCAppender 记录 将 被 包 插 记 录 在 数据 库 


Layout: 


我 们 使 用 的 PatternLayout 使 用 appender。 所 有 可 能 的 选项 有 : 


DateLayout 
HTMLLayout 
PatternLayout 
SimpleLayout 
XMLLayout 


使 用 HTMLLayout 和 XMLLayout， 可 以 在 HTML 和 XML 格式 和 生成 日 志 。 


布局 格式 : 


如 何在 章节 格式 的 日 志 信息 : Log 格 式 


log4j 示 例 程 序 - Log4j 教 程 

前 面 我 们 已 经 看 到 了 如 何 创建 一 个 配置 文件 。 本 教程 料 讲 解 如 何 生成 调试 信息 和 日 
志 在 一 个 简单 的 文本 文件 。 

下 面 是 我 们 的 例子 中 创建 了 一 个 简单 的 配置 文件 。 这 里 再 重复 一 次 : 


e 下 载 最 新 的 Log4j 库 : http://logging.apache.org/log4j/2.x/download.html 
e 根 记 录 器 的 级 别 定 义 为 DEBUG 并 连接 appender 命 名 为 FILE。 


e appender FILE 文 件 被 定义 为 org.apache.log4j.FileAppender 并 写 入 到 一 个 名 
为 "log.out" 位 于 log 目录 下 。 


e 定义 的 布局 模式 是 %m%n， 这 意味 着 打印 日 志 消 息 之 后 自动 加 上 一 个 换行 
符 。 


所 以 log4j.properties 文件 的 内 容 如 下 : 


# Define the root logger with appender file 
log = /usr/home/10g4j 
log4j.rootLogger = DEBUG, FILE 


# Define the file appender 
log4j.appender.FILE-org.apache.log4j.FileAppender 
log4j.appender.FILE.File-$(109g)/1l0g.out 


# Define the layout for file appender 


1og4j.appender.FILE.layout-org.apache.log4j.PatternLayout 
log4j .appender.FILE. layout .conversionPattern=%m%n 


在 Java 程 序 中 使 用 log4j : 


下 面 的 Java 类 是 一 个 非常 简单 的 例子 ，Java 应 用 程序 初始 化 ， 然 后 使 用 Log4J 日 志 
库 。 


import org.apache.10g4j.Logger; 
import java.io.* 

import java.sql.SQLException; 
import java.util.*; 


public class log4jExample{ 
/* Get actual class name to be printed on */ 
static Logger log = Logger .getLogger ( 
log4jExample.class.getName()); 


public static void main(String[] args) 
throws IOException, SQLException{ 


log.debug("Hello this is an debug message"); 
log.info("Hello this is an info message"); 


} 
} 


编译 和 运行 
下 面 是 步骤 编译 并 运行 上 述 程序 。 确 保 在 进行 编译 和 执行 之 前 ， 适 当地 设置 PATH 
和 CLASSPATH。 


所 有 的 库 应 该 在 CLASSPATH 和 log4j.properties 文件 应 该 在 PATH 可 用 。 所 以 ， 做 
到 以 下 几 点 : 


e 创建 log4j.properties 如 上 图 所 示 。 
e 创建 log4jExample.java 如 上 图 所 示 ， 并 对 其 进行 编译 。 
e 执行 log4jExample 二 进 制 运行 程序 。 

在 里 面 /usr/home/log4j/log.out 文件 会 得 到 下 面 的 结果 : 


Hello this is an debug message 
Hello this is an info message 


log4j Logger 方 法 - Log4j 教 程 
Logger 类 提供 了 多 种 方法 来 处 理 日 志 活 动 。 Logger 类 不 允许 实例 化 一 个 新 的 记录 
器 实例 ， 但 它 提供 了 两 个 静态 方法 获得 一 个 Logger 对 象 : 

e public static Logger getRootLogger(); 

e public static Logger getLogger(String name); 


此 处 两 种 方法 的 第 一 个 返回 上 应 用 程序 实例 根 记 录 器 并 没有 名 字 。 任 何其 他 命名 的 
Logger 对 象 实例 是 通过 第 二 种 方法 通过 记录 器 的 名 称 获 得 。 记 录 器 名 称 是 可 以 传递 
任何 字符 串 ， 通 常 是 类 或 包 的 名 称 ， 因 为 我 们 已 经 使 用 在 最 后 一 章 。 


static Logger log = Logger.getLogger(log4jExample.class.getName()), 


二 





Logging 方法 : 


我 们 得 到 了 一 个 名 为 记录 器 的 实例 之 后 ， 可 以 使 用 记录 的 几 种 方法 来 记录 消息 。 
Logger 类 有 专门 用 于 打印 日 志 信息 下 面 的 方法 如 下 。 


SN 方法 及 描述 

1 public void debug(Object message) 这 种 方法 打印 使 用 Level.DEBUG 
消息 级 别 

2 public void error(Object message) 这 种 方法 打印 使 用 Level.ERROR 
消息 级 别 

3 public void fatal(Object message); 这 种 方法 打印 使 用 Level.FATAL 消 
息 级 别 

4 public void info(Object message); 这 种 方法 打印 使 用 Level.INFO 消息 
级 别 

5 public void warn(Object message); 这 种 方法 打印 使 用 Level. WARN 
消息 级 别 

6 public void trace(Object message); 这 种 方法 打印 使 用 Level.TRACE 消 
息 级 别 


所 有 的 级 别 定义 在 org.apache.log4j.Level 类 中 ， 并 且 任 何 上 述 方法 都 可 以 调用 如 
F: 


import org.apache.1log4j.Logger; 


public class LogClass { 
private static org.apache.log4j.Logger log = Logger 
.getLogger(LogClass.class); 
public static void main(String[] args) ( 
log.trace("Trace Message!"); 
log.debug("Debug Message!"); 
log.info("Info Message!"); 
log.warn("Warn Message!"); 
log.error("Error Message!"); 
log.fatal("Fatal Message!"); 


当 编 译 并 运行 LogClass 程 序 会 产生 以 下 结果 : 


Debug Message! 
Info Message! 
Warn Message! 
Error Message! 
Fatal Message! 


所 有 的 调试 消息 更 有 意义 ， 当 它们 在 级 别 组 合 使 用 。 级 别 将 在 下 一 章 介 绍 ， 那 么 在 
下 一 节 会 有 一 个 很 好 的 理解 及 如 何 使 用 这 些 方 法 在 不 同 的 级 别 调试 。 


log4j 日 志 记 录 级 别 -Log4j 教 程 


org.apache.log4j.Level 类 提供 以 下 级 别 ， 但 也 可 以 通过 Level 类 的 子 类 自 定义 级 
别 。 


学 


Level T8 
ALL 各 级 包括 自 定 义 级 别 
DEBUG 指定 细 粒 度 信 息 事 件 是 最 有 用 的 应 用 程序 调试 
ERROR ”错误 事件 可 能 仍然 允许 应 用 程序 继续 运行 
FATAL 指定 非常 严重 的 错误 事件 ， 这 可 能 导致 应 用 程序 中 止 
INFO 指定 能 够 突出 在 粗 粒度 级 别 的 应 用 程序 运行 情况 的 信息 的 消息 


OFF 这 是 最 高 等 级 ， 为 了 关闭 日 志 记 录 
TRACE 指定 细 粒 度 比 DEBUG 更 低 的 信息 事件 
WARN 指定 具有 潜在 危害 的 情 ; 

日 志 级 别 是 如 何 工作 ? 


级 别 p 的 级 别 使 用 q， 在 记录 日 志 请 求 时 ， 如 果 p>=q 启 用 。 这 条 规则 是 log4 的 核 
心 。 它 假设 级 别 是 有 序 的 。 对 于 标准 级 别 它们 关系 如 下 : ALL < DEBUG < INFO < 
WARN < ERROR < FATAL < OFF, 


下 面 的 例子 明确 指出 如 何 可 以 过 滤 所 有 的 DEBUG 和 INFO 消 息 。 这 个 程序 使 用 记录 
并 执行 SetLevel (Level.X) 方法 来 设置 所 需 的 日 志 记 录 级 别 : 


这 个 例子 将 打印 ， 除 了 调试 和 信息 的 所 有 消息 : 


import org.apache.1log4j.* 


public class LogClass { 
private static org.apache.log4j.Logger log = Logger 
.getLogger(LogClass.class); 
public static void main(String[] args) ( 
log.setLevel(Level.WARN); 


log.trace("Trace Message!"); 
log.debug("Debug Message!"); 
log.info("Info Message!"); 
log.warn("Warn Message!"); 
log.error("Error Message!"); 
log.fatal("Fatal Message!"); 


当 编 译 并 运行 LogClass 程 序 会 产生 以 下 结果 : 


Warn Message! 
Error Message! 
Fatal Message! 


使 用 配置 文件 设置 级 多 


Log4j 提 供 这 些 可 以 让 程序 员 自 由 更 改 源 人 代码， 改变 调试 级 别 的 配置 级 别 是 基于 文 
件 设 置 。 


以 下 是 上 面 的 例子 使 用 log.setLevel (Level. WARN) 方法 的 配置 文件 与 上 面 的 例子 
例子 功能 一 样 。 


# Define the root logger with appender file 
log = /usr/home/log4j 
log4j.rootLogger = WARN, FILE 


# Define the file appender 
log4j.appender.FILE-org.apache.log4j.FileAppender 
log4j .appender.FILE.File=${log}/log.out 


# Define the layout for file appender 


log4j .appender.FILE.layout=org.apache.1log4j.PatternLayout 
log4j .appender.FILE. layout .conversionPattern=%m%n 


现在 ， 使 用 下 面 的 程序 : 


import org.apache.109g4j.*; 


public class LogClass { 
private static org.apache.log4j.Logger log = Logger 
.getLogger(LogClass.class); 
public static void main(String[] args) ( 
log.trace("Trace Message!"); 
log.debug("Debug Message!"); 
log.info("Info Message!"); 
log.warn("Warn Message!"); 
log.error("Error Message!"); 
log.fatal("Fatal Message!"); 


现在 ， 编 译 和 运行 上 面 的 程序 ， 得 到 以 下 结果 在 /usr/home/log4j/log.out 文件 : 


Warn Message! 
Error Message! 
Fatal Message! 


log4j 日志 格 陈 化 - Log4j 教 程 
Apache log4j 提供 了 各 种 布局 对 象 ， 每 一 个 对 象 都 可 以 根据 各 种 布局 格式 记录 数 
据 。 另 外 ， 也 可 以 创建 一 个 布局 对 象 格式 化 测 井 数据 中 的 特定 应 用 的 方法 。 


所 有 的 布局 对 象 - Appender 对 象 收 到 LoggingEvent 对 象 。 布 局 对 象 检索 来 自 
LoggingEvent 的 消息 参数 ， 并 应 用 适当 的 ObjectRenderer 获得 消息 的 字符 串 表 
7Ivo 


布局 类 型 : 
在 层次 结构 中 的 顶级 类 igual apache.log4j.Layout. ix Æ log4j 的 API 中 
的 所 有 其 他 布局 类 的 基 类 


qut ee eee 不 要 直接 使 用 这 个 类 ; 相反 ， 使 用 它 的 子 类 来 工 
， 如 下 : 


e DateLayout 

e HTMLLayout ( 在 本 教程 解释 ) 
e PatternLayout ( 在 本 教程 解释 ) 
e SimpleLayout 

e XMLLayout 


布局 方法 : 


这 个 类 提供 了 一 个 框架 实现 在 所 有 其 它 布局 对 象 的 所 有 常见 的 操作 ， 并 声明 了 两 个 
HRS 法 。 


S.N. 方法 & 描述 


pu abstract boolean ignoresThrowable() 这 种 方法 表示 日 志 信息 

否 处 理 传递 给 它 的 日 志 记 录 事 件 的 一 部 分 ， 任 何 java.lang. Throwable 
对 象 。 ODER th ia tt 24418 Throwable 对 象 ， 那 么 布局 对 象 不 忽视 它 ， 并 
返回 false。 


public abstract String format(LoggingEvent event) 独特 的 布局 子 类 
将 实施 这 一 方法 的 布局 特定 的 格式 


除了 这 些 抽象 方法 ， 布 局 类 提供 具体 的 实现 下 列 方法 : 


S.N. 方法 & 描述 
public String getContentType() 返回 使 用 的 布局 的 对 象 的 内 容 类 型 。 


| 类 将 返回 text/plain 作为 默认 的 内 容 类 型 
2 public String getFooter() 指定 日 志 消 息 的 页 脚 信 息 
3 public String getHeader() 指定 日 志 消 息 的 标 头 信息 


每 个 子 类 可 以 通过 重 写 的 具体 实现 这 些 方法 返回 类 特定 的 信息 。 


log4j HTMLLayout - Log4j 教 程 
如 果 想 生成 一 个 HTML 格 式 的 文件 ， 日 志 信 息 ， 那 么 可 以 使 用 
org.apache.log4j.HTMLLayout 格式 化 日 志 信 息 。 


HTMLLayout 类 扩展 抽象 org.apache.log4j.Layout 类 ， 并 覆盖 其 基 类 的 format() 方 法 
来 提供 HTML 祥 式 格式 。 


这 提供 了 以 下 信息 显示 : 
e 生成 特定 的 日 志 事件 之 前 ， 从 应 用 程序 的 开始 所 经 过 的 时 间 
。 调用 该 记录 请 求 的 线程 的 名 称 
e. 与 此 记录 请 求 相 关联 的 级 别 
e 日 志 记 录 器 (Logger) 和 记录 消息 的 名 称 

可 选 程序 文件 的 位 置信 息 ， 并 从 其 中 记录 被 调用 的 行 号 
HTMLLayout 是 一 个 非常 简单 的 布局 对 象 ， 它 提供 以 下 方法 : 
S.N. 方法 & 描述 


setContentType(String) 设置 text/html 为 HTML 内 容 的 内 容 类 型 。 默 


: 认为 text/html 


2 setLocationInfo(String) 设置 位 置信 息 记 录 事 件 。 默 认为 false 
3 setTitle(String) 设置 为 HTML 文 件 的 标题 。 黑 认 值 是 Log4j 的 日 志 信息 
HTMLLayout 例子 : 


以 下 是 对 HTMLLayout 一 个 简单 的 配置 文件 : 


# Define the root logger with appender file 
log = /usr/home/10g4j 
log4j.rootLogger = DEBUG, FILE 


# Define the file appender 
log4j.appender.FILE-org.apache.log4j.FileAppender 
1og4j.appender.FILE.File-$(log)/htmlLayout.html 


# Define the layout for file appender 
log4j.appender.FILE.layout-org.apache.log4j.HTMLLayout 
log4j.appender.FILE.layout.Title-HTML Layout Example 
log4j.appender.FILE.layout.LocationInfo-true 


现在 考虑 下 面 的 Java 例 子 用 于 产生 日 志 信息 : 


import org.apache.10g4j.Logger; 


import java.io.*; 
import java.sql.SQLException; 
import java.util.*; 


public class log4jExample{ 
/* Get actual class name to be printed on */ 
static Logger log - Logger.getLogger( 
log4jExample.class.getName()); 


public static void main(String[] args) 
throws IOException, SQLException{ 


log.debug("Hello this is an debug message"); 
log.info("Hello this is an info message"); 


} 
} 


编译 并 运行 上 述 程序 ， 它 会 在 /usr/home/log4j 目录 创建 htmlLayout.html 文件 ， 该 
文件 将 有 如 下 的 日 志 信 息 : 


Log session start time Mon Mar 22 13:30:24 AST 2014 


Time Thread Level Category F 


<font 


0 mee color="#339933">DEBUG </font> 


log4jExample | log4jEx 


6 main INFO log4jExample | log4jEx 


可 以 使 用 一 个 Web 浏 览 器 打开 htmlLayout.html <4, [EAEESEBJEENE, 3H 
HTML> 和 </ body> 标 记 是 完全 缺失 。 


一 个 具有 HTML 格 式 的 日 志文 件 的 一 大 优势 是 ， 它 可 以 被 发 布 为 网 页 可 以 远程 查 


o 


log4j PatternLayout - Log4j 教 程 
如 果 想 生成 基于 模式 的 特定 格式 的 日 志 信息 ， 那 么 可 以 使 用 
org.apache.log4j.PatternLayout 格式 化 日 志 信息 。 


PatternLayout 类 扩展 抽象 org.apache.log4j.Layout 类 并 覆盖 format() 方 法 根据 提供 
的 模式 构建 日 志 信 息 。 


PatternLayout 也 是 一 个 简单 的 布局 对 象 ， 它 提供 下 列 Bean 属 性 ， 可 以 通过 配置 文 
件 进行 设置 : 


S.N. 属性 和 说 明 
1 conversionPattern 设置 转换 模式 。 默 认为 Ver [Yt] Yp 96c %x - 
Amn 
-H- ` ri E 
模式 转换 字符 : 


下 表 说 明了 以 上 模式 使 用 的 字符 和 所 有 其 他 字符 ， 可 以 在 自 定义 模式 中 使 用 : 


3 表示 的 意思 

符 

用 于 输出 的 记录 事件 的 类 别 。 例 如 ， 对 于 类 别名 称 "a.b.c" 模式 %c{2} 会 
输出 "b.c" 

C 用 于 输出 呼叫 者 发 出 日 志 请 求 的 完全 限定 类 名 。 例 如 ， 对 于 类 名 
"org.apache.xyz.SomeClass", 模式 %C{1} 会 输出 "SomeClass". 

4 ”用 于 输出 的 记录 事件 的 日 期 。 例 如 ， %d{HH:mm:ss,SSS} 或 %d{dd 


MMM yyyy HH:mm:ss,SSS). 

F 用 于 输出 被 发 出 日 志 记 录 请 求 ， 其 中 的 文件 名 

| 用 于 将 产生 的 日 志 事件 调用 者 输出 位 置信 息 

L 用 于 输出 从 被 发 出 日 志 记 录 请 求 的 行 号 

m 用 于 输出 使 用 日 志 事 件 相 关联 的 应 用 程序 提供 的 消息 

M 用 于 输出 发 出 日 志 请 求 所 在 的 方法 名 称 

n 输出 平台 相关 的 行 分 隔 符 或 文字 

p 用 于 输出 的 记录 事件 的 优先 级 

r 用 于 输出 毫秒 从 布局 的 结构 经 过 直到 创建 日 志 记 录 事 件 的 数目 
t 用 于 输出 生成 的 日 志 记 录 事 件 的 线程 的 名 称 

x 用 于 和 与 产生 该 日 志 事件 的 线程 相关 联 输出 的 NDC (REEL FR XC) 


在 X 转 换 字 符 后 面 是 键 为 的 MDC。 例 如 X{clientIP} 将 打印 存储 在 MDC 对 
键 clientIP 的 信息 


% 文字 百 分 号 %% 将 打印 % 标 志 


格式 修饰 符 : 


默认 情况 下 ， 相 关 资 料 原 祥 输 出 。 然 而 ， 随 着 格式 修饰 符 的 帮助 下 ， 可 以 改变 最 小 
字段 宽度 ， 最 大 字段 宽度 和 对 章 。 


下 表 池 盖 了 各 种 各 样 的 修饰 符 的 情况 


Format 
modifier 


%20c 


%-20c 


%.30c 


%20.30c 


%-20.30c 


left 
justify 


false 


true 


NA 


false 


true 


minimum 
width 


20 


20 


none 


20 


20 


PatternLayout zn: 


maximum 
width 


none 


none 


30 


30 


30 


以 下 是 针对 PatternLayout 一 个 简单 的 配置 文件 : 


注释 


用 空格 左 热 ， 如 果 类 别名 称 
少 于 20 个 字符 长 


用 空格 右 热 ， 如 果 类 别名 称 
少 于 20 个 字符 长 


从 开始 截断 ， 如 果 类 别名 称 
超过 30 个 字符 长 


用 空格 左 侧 垫 ， 如 果 类 别名 
称 短 于 20 个 字符 。 但 是 ， 如 
果 类 别名 称 长 度 超过 30 个 字 
符 ， 那 么 从 开始 截断 。 


BERANE, WRX AB 
称 短 于 20 个 字符 。 但 是 ， 如 

类 别名 称 长 度 超过 30 个 字 
符 ， 那 么 从 开始 截断 。 


# Define the root logger with appender file 
log = /usr/home/10g4j 
log4j.rootLogger = DEBUG, FILE 


# Define the file appender 
log4j.appender.FILE-org.apache.log4j.FileAppender 


log4j .appender.FILE.File=${log}/log.out 


# Define the layout for file appender 
log4j.appender.FILE.layout-org.apache.log4j.PatternLayout 
10og4j.appender.FILE.layout.ConversionPattern- 

?6d ( yyy y -MM- dd -9?6t -96x -96- 5p -96- 10c :%m%n 


现在 考虑 下 面 产 生日 志 信息 的 Java 例 子 : 


import org.apache.1log4j.Logger; 


import java.io.*; 
import java.sql.SQLException; 
import java.util.*; 


public class log4jExample{ 
/* Get actual class name to be printed on */ 
static Logger log = Logger.getLogger ( 
log4jExample.class.getName()); 


public static void main(String[] args) 
throws IOException, SQLException{ 


log.debug("Hello this is an debug message"); 
log.info("Hello this is an info message"); 


编译 并 运行 上 述 程序 ， 它 会 创建 log.out 文 件 在 /usr/home/log4j 目录 ， 该 文件 将 有 
如 下 的 日 志 信息 : 


2010 -03-23-main- -DEBUG-log4jExample:Hello this is an debug message 
2010-03-23-main--INFO -log4jExample:Hello this is an info message 


eee: 


log4j 日志 记录 到 文件 - Log4j 教 程 


要 写 日 志 信息 到 一 个 文件 中 ， 必 须 使 用 org.apache.log4j.FileAppender。 有 以 下 
FileAppender 的 配置 参数 : 


FileAppender 配 置 


Et 


属性 描述 


. l 标志 的 默认 设置 为 ttue， 这 意味 着 输出 流 的 文件 被 刷新 ， 在 
immediateFlush 每 个 追加 操作 


ri 、 a GF yer oo LU Cd E3 pcc 平台 的 编码 
Encode ERER 默认 情况 下 是 特定 于 平台 的 编码 
threshold 这 个 appender [3] (à 24 3 
Filename 日 志文 件 的 名 称 


fileAppend 这 意味 着 记录 的 信息 被 附加 到 同一 文件 的 


bufferedlO 此 标志 表示 是 否 需要 宇和 人 缓存 和 启用。 默认 设置 为 false 
里 人 > a + 
pufferSize ae bufferedl/O 和 启用 ， 这 表示 缓冲 区 的 大 小 ， 默 认 设 置 为 


下 面 是 一 个 示例 配置 文件 log4j.properties 的 FileAppender。 


# Define the root logger with appender file 
log4j.rootLogger = DEBUG, FILE 


# Define the file appender 
log4j.appender.FILE-org.apache.log4j.FileAppender 
# Set the name of the file 

log4j .appender.FILE.File=${log}/log.out 


# Set the immediate flush to true (default) 
log4j.appender.FILE.ImmediateFlush-true 


# Set the threshold to debug mode 
1og4j.appender.FILE.Threshold-debug 


# Set the append to false, overwrite 
1og4j.appender.FILE.Append-false 


# Define the layout for file appender 
1og4j.appender.FILE.layout-org.apache.log4j.PatternLayout 
log4j .appender.FILE. layout .conversionPattern=%m%n 


WRZ KHF Exhlog4j.propertiessc £FÉJXML Bd ii Sc, E E ze xml i sc 
的 内 容 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd"> 
<log4j:configuration> 


«appender name="FILE" class="org.apache.log4j.FileAppender"> 
<param name="file" value="${log}/log.out"/> 
<param name="immediateFlush" value="true"/> 
<param name="threshold" value="debug"/> 
<param name="append" value="false"/> 
«layout class="org.apache.1log4j.PatternLayout"> 
<param name-"conversionPattern" value="%m%n"/> 
</layout> 
</appender> 


«logger name="1log4j.rootLogger" additivity="false"> 
<level value="DEBUG"/> 
<appender-ref ref="FILE"/> 

</logger> 


«/10g4j:configuration» 
可 以 尝试 在 log4j - 示例 程序 使 用 上 面 的 配置 。 


日 志 记 录 到 多 个 文件 : 


EO TE. BAD, SDSROCÉHEAGINSA E XE BS N 4 


日 志 记 录 信 息 分 成 多 个 文件 ， 必 须 扩 展 FileAppender 类 ， 并 继承 其 所 有 属性 
pers apache.log4j.RollingFileAppender # , 


有 以 下 除了 已 如 上 所 述 为 FileAppender 可 配置 参数 : 


属性 描述 
maxFileSize 上 述 的 文件 的 回 滚 临 界 尺 寸 。 上 默认 值 是 10MB 


maxBackupIndex 此 属性 表示 要 创建 的 备份 文件 的 数量 。 默 认 值 是 1 
下 面 是 一 个 示例 配置 文件 log4j.properties 的 RollingFileAppender 进 行 


# Define the root logger with appender file 
log4j.rootLogger = DEBUG, FILE 


# Define the file appender 
log4j.appender.FILE-org.apache.log4j.RollingFileAppender 
X Set the name of the file 

log4j .appender.FILE.File=${log}/log.out 


# Set the immediate flush to true (default) 
log4j .appender.FILE.ImmediateFlush=true 


# Set the threshold to debug mode 
log4j .appender. FILE. Threshold=debug 


# Set the append to false, should not overwrite 
log4j .appender.FILE.Append=true 


# Set the maximum file size before rollover 
log4j.appender.FILE.MaxFileSize-5KB 


# Set the the backup index 
10g4j.appender.FILE.MaxBackupIndex-2 


# Define the layout for file appender 
log4j.appender.FILE.layout-org.apache.log4j.PatternLayout 
log4j .appender.FILE. layout .conversionPattern=%m%n 


如 果 想 有 一 个 XML 配置 文件 ， 可 以 生成 中 提 到 的 初始 段 ， 并 添加 相关 的 
RollingFileAppender 进行 唯一 额外 的 参数 。 


此 示例 配置 说 明 每 个 日 志文 件 的 最 大 允许 大 小 为 5MB。 2o or 新 的 日 志 
ee a a 当 第 二 个 日 志文 件 达到 最 大 值 ， 
第 一 个 日 志文 件 将 被 删除 ， 之 后 所 有 的 日 志 信 息 将 被 回 站 到 第 一 个 日 志文 件 。 


可 以 尝试 log4j - 示例 程序 使 用 上 面 的 配置 


每 天 生成 日 志文 件 : 


当 想 生成 每 一 天 的 日 志文 件 ， 以 保持 日 志 记 录 信 息 的 良好 记录 。 


日 志 记 录 信 息 纳 和 日 党 的 基础 文件 ， 就 必须 它 扩 展 FileAppender 类 ， 并 继承 其 所 有 
属性 useorg.apache.log4j.DailyRollingFileAppender 类 。 


有 除了 已 如 上 所 述 为 FileAppender 只 有 一 个 重要 的 下 列 配置 参数 : 


Property 描述 
DatePattern ”这 家 示 在 滚动 的 文件 ， 并 按 命 名 惯例 来 执行 。 默 认 情 况 下 ， 在 每 
天 午夜 滚动 


DatePattern 控 制 使 用 下 列 滚动 的 时 间 表 方式 之 一 : 


DatePattern 描述 
'' yyyy-MM 滚动 在 每 个 月 的 结束 和 下 一 个 月 初 
'' yyyy-MM-dd 这 是 默认 值 ， 每 天 午夜 滚动 
'' yyyy-MM-dd-a 滚动 每 一 天 的 午夜 和 中 午 
'' yyyy-MM-dd-HH 滚动 在 每 一 个 小 时 
'' yyyy-MM-dd-HH-mm 滚动 在 每 一 个 分 钟 
"" yyyy-ww 滚动 每 个 星期 取决 于 区 域 设 置 时 的 第 一 天 


下 面 是 一 个 示例 配置 文件 log4j.properties 生 成 日 志文 件 滚动 的 在 每 天 午夜 。 


# Define the root logger with appender file 
log4j.rootLogger = DEBUG, FILE 


# Define the file appender 

log4j .appender .FILE=org.apache.1log4j .DailyRollingFileAppender 
# Set the name of the file 

log4j .appender.FILE.File=${log}/log.out 


# Set the immediate flush to true (default) 
log4j.appender.FILE.ImmediateFlush-true 


# Set the threshold to debug mode 
log4j.appender.FILE.Threshold-debug 


# Set the append to false, should not overwrite 
log4j .appender.FILE.Append=true 


# Set the DatePattern 
log4j.appender.FILE.DatePattern='.' yyyy-MM-dd-a 


# Define the layout for file appender 


log4j .appender.FILE.layout=org.apache.1log4j.PatternLayout 
log4j .appender. FILE. layout .conversionPattern=%m%n 


如 果 想 使 用 XML 配置 文件 ， 可 以 生成 中 提 到 的 初始 段 ， 并 添加 相关 
DailyRollingFileAppender 唯一 的 额外 参数 和 数据 。 


可 以 尝试 在 log4j - 示例 程序 使 用 上 面 的 配置 。 


log4j 日 志 记 录 到 数据 库 - Log4j 教 程 


log4j API 提 供 org.apache.log4j.jdbc.JDBCAppender 对 象 ， 它 能 够 将 日 志 信息 在 指 
定 的 数据 库 。 


JDBCAppender 配置 


Property 描述 
bufferSize ”设置 缓冲 区 的 大 小 。 默 认 大 小 为 1 


设置 驱动 程序 类 为 指定 的 字符 串 。 如 果 没 有 指定 驱动 程序 类 ， 默 
认为 sun.jdbc.odbc.JdbcOdbcDriver 


layout 设置 要 使 用 的 布局 。 上 默认 布局 是 org.apache.log4j.PatternLayout 
password Sets the database password. 
指定 SQL 语句 在 每 次 记录 事件 发 生 的 时 间 执 行 。 这 可 能 是 


driver 


sql INSERT，UPDATE 或 DELETE 
URL 设置 JDBC URL 

user 设置 数据 库 用 户 名 
日 志 表 配置 


开始 使 用 基于 JDBC 日 志 ， 要 创建 在 哪里 保存 日 志 信 息 的 表 。 下 面 是 创建 日 志 表 的 
SQL 语句 : 


CREATE TABLE LOGS 
(USER_ID VARCHAR(20) NOT NULL, 
DATED DATE NOT NULL, 
LOGGER VARCHAR(50) NOT NULL, 
LEVEL VARCHAR(10) NOT NULL, 
MESSAGE VARCHAR(1000) NOT NULL 


): 


置 文件 示例 : 


以 下 是 将 用 于 将 消息 记录 到 一 个 日 志 表 中 的 示例 配置 文件 log4j.properties 的 
JDBCAppender 


# Define the root logger with appender file 
log4j.rootLogger = DEBUG, DB 


# Define the DB appender 
log4j .appender . DB=org. apache. log4j . jdbc. JDBCAppender 


# Set JDBC URL 
log4j .appender .DB.URL=jdbc:mysql://localhost/DBNAME 


# Set Database Driver 
log4j .appender .DB.driver=com.mysql.jdbc.Driver 


# Set database user name and password 
log4j .appender .DB. user=user_name 
log4j .appender .DB. password=password 


# Set the SQL statement to be executed. 
log4j.appender.DB.sql-INSERT INTO LOGS 
VALUES( '9ex ' , '%d', '%C', '96p ' , '%m' ) 


# Define the layout for file appender 
log4j .appender .DB. layout=org.apache.1log4j.PatternLayout 


这 里 使 用 的 是 MySQL 数 据 库 ， 必 须要 使 用 实际 DBNAME， 用 户 ID 和 在 其 中 创建 的 
日 志 表 的 数据 库 密 码 。SQL 语 句 是 使 用 日 志 表 名 和 输入 值 到 表 ， 需 要 执行 INSERT 
语句 。 


JDBCAppender 不 需要 明确 定义 的 布局 。 相 反 ， 使 用 PatternLayout 传递 给 它 SQL 
语句 


如 果 想 拥有 相当 于 上 述 log4j.properties 文 件 的 XML 配置 文件 ， 可 以 参考 在 这 里 的 内 
zm 


<?xml version="1.0" encoding="UTF-8" ?> 


<!DOCTYPE 


log4j: configuration SYSTEM "log4j.dtd"» 


<log4j:configuration> 


<appender 
<param 
<param 
<param 
<param 
<param 


name="DB" class="org.apache.1log4j.jdbc.JDBCAppender'"> 
name-"url" value="jdbc:mysql://localhost/DBNAME"/> 
name-"driver" value="com.mysql.jdbc.Driver"/> 
name-"user" value="user_id"/> 
name="password" value="password"/> 
name="sql" value="INSERT INTO LOGS VALUES('%x', 

'%d', NGC ty. '%p', '%m')"/> 


«layout class="org.apache.log4j.PatternLayout"> 
</layout> 


</appender> 


«logger name="10g4j.rootLogger" additivity="false"> 
<level value="DEBUG"/> 
<appender -ref ref="DB"/> 


</logger> 


«/10g4j:configuration» 


示例 程序 : 


下 面 的 Java 类 
后 使 用 。 


是 一 个 非常 简单 的 Java 应 用 程序 使 用 Log4J 日 志 库 例子 ， 初 始 化 ， 然 


import org.apache.10g4j.Logger; 
import java.sql.*; 

import java.io.*; 

import java.util.*; 


public class log4jExample{ 
/* Get actual class name to be printed on */ 
static Logger log = Logger.getLogger ( 


log4jExample.class.getName()); 


public static void main(String[] args) 


throws IOException, SQLException{ 


log.debug("Debug"); 
log.info("Info"); 


编译 和 运行 


下 面 是 步 又 编译 并 运行 上 述 程序 。 确 保 进 行 编译 和 执行 之 前 ， 适 当地 设置 PATH 和 
CLASSPATH。 


所 有 的 库 应 该 在 CLASSPATH 以 及 log4j.properties 文 件 应 该 在 PATH 可 用 。 所 以 有 以 
下 几 点 : 


e 创建 log4j.properties 如 上 图 所 示 。 
e 创建 log4jExample.java 如 上 图 所 示 ， 并 对 其 进行 编译 。 
e 执行 log4jExample 二 进 制 运行 程序 。 
现在 检查 DBNAME 数 据 库 里 面 日 志 表 ， 发 现下 面 的 条 目 (记录 ) 


mysql > select * from LOGS; 

qe She oe aS ae SPSS ae posse d ae + 
| USER_ID | DATED | LOGGER | LEVEL | MESSAGE | 
Hoos eere lo S ee Sec St c PS GS e + 
| | 2010-05-13 | log4jExample | DEBUG | Debug | 
| | 2010-05-13 | log4jExample | INFO | Info | 
eS SSeS eee eee eos l| SS So Ss p HSS Sao + 
2 rows in set (0.00 sec) 


注 : 此 处 X 被 用 于 产生 该 记录 事件 的 线程 相关 联 输 出 的 NDC (REEL FI) 。 
ENDE 区 分 客户 的 服务 器 端 组 件 处 理 多 个 客户 端 。 检 查 Log4J 的 手册 以 获取 更 
多 信息 。 


Lucene 教 程 


Lucene 是 简单 而 功能 强大 的 基于 Java 的 搜索 库 。 它 可 以 用 于 任何 应 用 程序 来 搜索 功 
能 。 Lucene 是 开源 项 目 。 它 是 可 扩展 的 ， 高 性 能 的 库 用 于 索引 和 搜索 几乎 任何 类 
型 的 文本 。 Lucene 库 提供 了 所 需 的 任何 搜索 应 用 程序 的 核心 业务 。 索 引 和 搜索 。 


搜索 应 用 程序 的 工作 原理 
任何 搜索 应 用 程序 执行 一 些 或 全 部 下 列 操作 。 


步 
$i fü 
m 标题 B 


学 


1 任何 搜索 应 用 程序 的 第 一 个 步骤 是 收集 在 其 上 的 搜索 是 要 进行 
台 内 容 ”的 目标 内 容 。 


2 ， 构 建文 “下 一 步 是 建立 从 原始 内 容 的 搜索 应 用 程序 可 以 理解 和 容易 理解 


档 SCH. 
3 AMX ， 在 索引 过 程 启动 ， 该 文件 是 要 分 析 作 为 其 文本 部 分 是 一 个 候选 
档 索引 。 这 个 过 程 被 称 为 分 析 文 档 。 


4 T uu Mn C ee a 
HOR 
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环境 设置 


本 教程 将 指导 如 何 准备 一 个 开发 环境 ， 开 始 与 Spring 框架 工作 。 本 教程 还 将 教 如 何 
安装 JDK，Tomcat 和 Eclipse 在 机 器 上 在 设置 Spring 框架 之 前 : 


第 1 步 - 安装 Java 开 发 工具 包 (JDK) : 


可 以 从 OracleJava 网 站 上 找到 最 新 版 本 的 SDK : Java SE 下 载 。 发 现 有 说 明 在 下 载 
的 文件 中 说 明 处 理 安装 JDK， 按 照 说 明 安 装 和 配置 设置 的 指示 。 最 后 ， 设 置 PATH 
和 JAVA_HOME 环 境 变 量 指 的 是 分 别 包含 java 和 javac， 通 常 java_install_diwbin 和 
java install dir 目录 。 


如 果 运 行 的 是 Windows， 并 安装 了 JDK 在 C:jdk1.6.0_ 15， 就 必须 执行 以 下 C: 
autoexec.bat. 


set PATH=C:jdk1.6.0_15in;%PATH% 
set JAVA HOME-C: jdk1.6.0 15 


y AOR Windows NT/2000/XP 中 ， 也 可 以 在 “我 的 电脑 ” 选择 “属性 ”， 然 后 “高 
级 ”， 然 后 环境 变量 单 击 鼠 标 右键 。 更 新 PATH 的 值 ， 然 后 按 OK 按 钮 。 


在 Unix (Solaris 和 Linux 等 ) ， 如 果 SDK 安 装 在 /usr/local/jdk1.6.0_15 并 且 使 用 的 是 
C shell， 把 下 列 内 容 放 入 .cshrc 文 件 。 


setenv PATH /usr/local/jdk1.6.0_15/bin:$PATH 
setenv JAVA HOME /usr/local/jdk1.6.0_15 


另外 ， 如 果 使 用 的 集成 开发 环境 (IDE) 像 Borland 公 司 的 JBuilder，Eclipse 或 
IntelliJ IDEA 或 Sun ONE Studio， 那 么 编译 并 运行 一 个 简单 的 程序 ， 以 确认 该 IDE 
知道 安装 Java， 否 则 需要 为 IDE 做 适当 的 设置 。 


第 2 步 - 安装 Eclipse IDE 


在 本 教程 中 的 所 有 示例 使 用 Eclipse IDE。 所 以 建议 你 应 该 在 计算 机 上 安装 最 新 版 本 
的 Eclipse。 


要 安装 Eclipse IDE， 请 从 http://www.eclipse.org/downloads/ 上 下 载 最 新 的 Eclipse 
可 执行 文件 并 安装 ， 解 压缩 二 进 制 分 发 到 一 个 方便 的 位 置 。 例 如 ， 在 C : Eclipse 在 
Windows 上 ， 或 在 Linux/Unix 的 /usrlocal/eclipse， 最 后 设置 PATH 变量 恰当 即 可 。 


TutorialsPoint Java 技术 教程 


Eclipse 可 以 通过 在 Windows 计 算 机 上 执行 以 下 命令 来 启动 ， 或 者 可 以 简单 地 双击 
eclipse.exe 


?6C : eclipseeclipse.exe 


Eclipse 可 以 通过 执行 在 Unix (Solaris 和 Linux 等 ) 机 器 下 面 的 命令 来 启动 : 


$/usr/local/eclipse/eclipse 


成 功 启 动 后 ， 如 果 一 切 正常 那么 就 应 该 显示 如 下 结果 : 


二 二 


File Edit Navigate Search Project Run Window Help 
| |i*-0-Q- BHE- 
: a hd AS Y b 和 eT we 
= (= Outline oe 








An outline is not available. 
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第 3 步 - 安装 Lucene 框 架 库 


现在 ， 如 果 一 切 正常 ， 那 么 就 可 以 继续 设 的 Lucene 框 架 。 以 下 是 简单 的 步骤 下 载 并 
在 机 器 上 安装 Lucene 框 架 。 


e 选择 是 否 要 在 Windows 或 UNIX 上 安装 Lucene， 然 后 进行 下 一 个 步骤 下 载 .zip 
文件 适用 于 Windows， 以 及 .tz 文件 适用 在 Unix 中 。 


e 从 下 载 合 适 版 本 的 Lucene 的 框架 二 进 制 文件 


http://archive.apache.org/dist/lucene/java/. 


e 在 写 这 篇 教程 的 时 候 ， 下 载 Iucene-3.6.2.zip 在 Windows 机 器 上 ， 当 解压 缩 下 载 
的 文件 ， 它 会 给 出 里 面 的 目录 结构 在 C:lucene-3.6.2 如 下 。 


J docs 

|» test-framework 

L | CHANGES 

|. JRE VERSION MIGRATION 

|_| LICENSE 

|_| lucene-core-3.6.2 jar 

|_| lucene-core-3.6.2-javadoc.jar 
|_| lucene-test-framework-3.6.2.jar 
|_| lucene-test-framework-3.6.2-javadoc.jar 
L] NOTICE 

|. README 


会 发 现 所 有 的 Lucene 库 在 C:lucene-3.6.2 目录 。 确 保 在 这 个 目录 上 设置 
CLASSPATH 变 量 正确 ， 否 则 会 在 运行 点 用 程序 时 出 现 问题 。 如 果 使 用 的 是 Eclipse 
则 不 需要 设置 CLASSPATH， 因 为 所 有 的 设置 已 通过 Eclipse 进行 。 


最 后 一 步 完成 后 ， 就 可 以 开始 Lucene 的 第 一 个 例子 ， 在 下 一 章 中 将 看 到 。 
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让 我 们 使 用 Lucene 框 架 做 实际 编程 。 在 开始 使 用 Lucene 框 架 编写 第 一 个 例子 之 


前 ， 必 须 确保 已 经 安装 Lucene 的 环境 正常 。 也 假设 有 一 点 点 的 工作 和 Eclipse IDE 
的 知识 。 


因此 ， 开 始 写 一 个 简单 的 搜索 应 用 程序 将 打印 找到 搜索 结果 数量 。 我 们 也 看 到 在 这 
个 过 程 中 创建 的 索引 列表 。 


第 1 步 - 创建 Java 项 目 : 


第 一 步 是 使 用 Eclipse IDE 创 建 一 个 简单 的 Java 项 目 。 按 照 选 项 File -> New -> 
Project 最 后 选择 Java Project 从 向 导 列表 向 导 。 现 在 ， 项 目 命 名 为 
LuceneFirstApplication 使 用 向 导 窗口 ， 如 下 所 示 : 
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; Ee 


Create a Java project 


Project name: | LuceneFirstApplication 
Contents 
(9) Create new project in workspace 
© Create project from existing source 





Directory: | C:\Users\Acer\workspace\LuceneFirstApplication | | Browse... | 





JRE 
(9) Use default JRE (Currently 'jdk1.6.0 21") 





© Use a project specific JRE: [jdk1.6.0 21 








© Use an execution environment JRE: | JavaSE-1 6 





Project layout 


© Use project folder as root for sources and class files 


(9) Create separate folders for sources and class files 


Working sets 
Add project to working sets 





Working sets: 














—Hom BEES, HAL KARE Project Explorer: 
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Beenesem a 


File Edit Navigate Search Project Run Window Help 


OHS :%-O-Q-: 8#6~ 
a4 Hiri vy eer Do 


I$ Package Exp 23 ^ fg Hierarchy | = |m = O || & Task List 52. EN 
ms 
$3 LuceneFirstApplication 


$8 src 
Bi JRE System Library [jdk1.6.0 21] (£& Uncategorized 


= Referenced Libraries 

















| B Outline 22 





An outline is not available. 











第 2 步 = 添加 必需 的 库 : 


作为 第 二 步 ， 我 们 添加 Lucene 核 心 框 架 库 在 项 目 中 。 要 做 到 这 一 点 ， 右 键 单 击 项 目 
名 称 LuceneFirstApplication 然 后 按照 上 下 文 菜单 中 提供 以 下 选项 : aon Path -> 
Configure Build Path， 显 示 了 Java 构 建 路 径 如 下 窗口 : 
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E 
= Properties for LuceneFirstApplication 


type filter text Java Build Path | 


Resource f | 
Builders (n Source | ed Projects BA Libraries | Sp Order and Export | 


Java Build Path JARs and class folders on the build path: 





Java Code Style | ine) lucene-core-3.6.2.jar - E:\Lucene: Add JARs. | 


Java Compiler BA JRE System Library [jdk1.6.0 21] 
Java Editor Add External JARs... | 


Javadoc Location 








Project References Add Variable... J 


Refactoring History Add Library. | 
Run/Debug Settings 
Task Repository Add Class Folder... 











Task Tags 
Validation 




















现在 ， 使 用 添加 在 库 选 项 卡 中 提供 外 部 JAR 按 钮 ， 添 加 Lucene 安 装 目 录 下 的 核心 
JAR : 


e lucene-core-3.6.2 


98377 - 创建 源 文件 : 


现在 ， 让 我 们 LuceneFirstApplication 项 目下 创建 实际 的 源 文件 。 首 先 ， 我 们 需 
要 创建 一 个 名 为 com.yiibai.lucene 包 。 要 做 到 这 一 点 ， 右 键 单 击 src 在 包 资 源 管 
理 部 分 ， 并 按照 选项 : New -> Package. 


下 一 步 ， 我 们 将 创建 LuceneTester.java 和 其 他 Java 类 在 com.yiibai.lucene & 
下 。 


LuceneConstants.java 
这 个 类 是 用 来 提供 跨 示 例 应 用 程序 中 使 用 的 各 种 常量 。 


package com.yiibai.lucene; 


public class LuceneConstants { 
public static final String CONTENTS="contents"; 
public static final String FILE NAME-"filename"; 
public static final String FILE PATH-"filepath"; 
public static final int MAX SEARCH - 10; 


TextFileFilter.java 


此 类 用 于 为 .txt 文件 过 滤器 


package com.yiibai.lucene; 


import java.io.File; 
import java.io.FileFilter; 


public class TextFileFilter implements FileFilter { 


@Override 
public boolean accept(File pathname) { 
return pathname. getName().toLowerCase().endswith(".txt"); 


} 


Indexer.java 


这 个 类 是 用 于 索引 的 原始 数据 ， 这 样 我 们 就 可 以 使 用 Lucene 库 ， 使 其 可 搜索 。 


package com. 


import 
import 
import 
import 


import 
import 
import 
import 
import 
import 
import 
import 


public 


java. 
java. 
java. 
java. 


org 
org. 
org. 
org. 
org. 
org 
org. 
org. 


.apache. 


apache. 
apache. 
apache. 
apache. 


.apache. 


apache. 
apache. 


io.File; 
io.FileFilter; 
io.FileReader; 
io.IOException; 


lucene. 
lucene. 
lucene. 
lucene. 
lucene. 
lucene. 
lucene. 
lucene. 


class Indexer ( 


yiibai.lucene; 


analysis.standard.StandardAnalyzer; 
document Document ; 

document .Field; 
index.CorruptIndexException; 
index.IndexWriter; 

store.Directory; 

store.FSDirectory; 

util.Version; 


private Indexwriter writer; 


public Indexer(String indexDirectoryPath) throws IOException{ 
//this directory will contain the indexes 
Directory indexDirectory - 
FSDirectory.open(new File(indexDirectoryPath)); 


//create the indexer 

writer - new IndexWriter(indexDirectory, 
new StandardAnalyzer(Version.LUCENE 36),true, 
Indexwriter .MaxFieldLength.UNLIMITED) ; 


public void close() throws CorruptIndexException, 


} 


IOException{ 
writer.close(); 


private Document getDocument(File file) throws IOException{ 


j 


Document document - new Document(); 


//index file contents 

Field contentField - new Field(LuceneConstants.CONTENTS, 
new FileReader(file)); 

//index file name 

Field fileNameField - new Field(LuceneConstants.FILE NAME, 
file.getName(), 
Field.Store.YES,Field.Index.NOT ANALYZED); 

//index file path 

Field filePathField - new Field(LuceneConstants.FILE PATH, 
file.getCanonicalPath(), 
Field.Store.YES,Field.Index.NOT ANALYZED); 


document.add(contentField); 
document.add(fileNameField); 
document.add(filePathField); 


return document; 


private void indexFile(File file) throws IOException( 


j 


System.out.println("Indexing "+file.getCanonicalPath()); 
Document document - getDocument(file); 
writer .addDocument (document); 


public int createIndex(String dataDirPath, FileFilter filter) 


throws IOException{ 
//get all files in the data directory 
File[] files = new File(dataDirPath).listFiles(); 


for (File file : files) ( 
if(!file.isDirectory() 
&& !file.isHidden() 
&& file.exists() 
&& file.canRead() 
&& filter.accept(file) 


){ 
indexFile(file); 
} 
} 


return writer.numDocs(); 








Searcher.java 


这 个 类 是 用 来 搜索 索引 所 创建 的 索引 搜索 请 求 的 内 容 。 


package com. yiibai.lucene; 


import 
import 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


java.io.File; 
java.io. IOException; 


org.apache.lucene.analysis.standard.StandardAnalyzer; 
org.apache.lucene.document.Document ; 
org.apache.lucene.index.CorruptIndexException; 
org.apache.lucene.queryParser.ParseException; 
org.apache.lucene.queryParser.QueryParser; 
org.apache.lucene.search.IndexSearcher; 
org.apache.lucene.search.Query; 
org.apache.lucene.search.ScoreDoc; 
org.apache.lucene.search.TopDocs; 
org.apache.lucene.store.Directory; 
org.apache.lucene.store.FSDirectory; 
org.apache.lucene.util.Version; 


class Searcher ( 


IndexSearcher indexSearcher; 
QueryParser queryParser, 
Query query; 


public Searcher(String indexDirectoryPath) 
throws IOException{ 
Directory indexDirectory = 
FSDirectory.open(new File(indexDirectoryPath) ); 
indexSearcher = new IndexSearcher(indexDirectory) ; 
queryParser = new QueryParser(Version.LUCENE_36, 
LuceneConstants.CONTENTS, 
new StandardAnalyzer(Version.LUCENE 36)); 


j 


public TopDocs search( String searchQuery) 
throws IOException, ParseException{ 
query = queryParser.parse(searchQuery); 
return indexSearcher.search(query, LuceneConstants.MAX SEARCI 


j 


public Document getDocument(ScoreDoc scoreDoc) 
throws CorruptIndexException, IOException{ 
return indexSearcher.doc(scoreDoc.doc); 


j 


public void close() throws IOException{ 
indexSearcher.close(); 
j 











Lucene Tester.java 


这 个 类 是 用 来 测试 Lucene 库 的 索引 和 搜索 功能 。 


package com.yiibai.lucene; 
import java.io.IOException; 


import org.apache.lucene.document.Document; 

import org.apache.lucene.queryParser.ParseException; 
import org.apache.lucene.search.ScoreDoc; 

import org.apache.lucene.search.TopDocs; 


public class LuceneTester { 


String indexDir = "E:\Lucene\Index"; 
String dataDir = "E:\Lucene\Data"; 
Indexer indexer; 

Searcher searcher; 


public static void main(String[] args) ( 

LuceneTester tester; 

try { 
tester = new LuceneTester(); 
tester.createIndex(); 
tester.search("Mohan"); 

) catch (IOException e) { 
e.printStackTrace(); 

) catch (ParseException e) ( 
e.printStackTrace(); 

j 


j 


private void createIndex() throws IOException{ 
indexer - new Indexer(indexDir); 
int numIndexed; 
long startTime - System.currentTimeMillis(); 
numIndexed = indexer.createIndex(dataDir, new TextFileFilteri 
long endTime - System.currentTimeMillis(); 
indexer.close(); 
System.out.println(numIndexed+" File indexed, time taken: 
+(endTime-startTime)+" ms"); 


j 


private void search(String searchQuery) throws IOException, Par: 
searcher = new Searcher(indexDir); 
long startTime = System.currentTimeMillis(); 
TopDocs hits = searcher.search(searchQuery); 
long endTime = System.currentTimeMillis(); 


System.out.println(hits.totalHits + 
" documents found. Time :" + (endTime - startTime)); 


for(ScoreDoc scoreDoc : hits.scoreDocs) { 
Document doc = searcher.getDocument(scoreDoc) ; 

System.out.printin("File: " 
+ doc.get(LuceneConstants.FILE_PATH)); 

} 

searcher.close(); 

} 
} 


«| m 








第 4 步 - 创建 效 据 和 索引 目录 


把 record1.txt 任命 为 record10.txt 包含 简单 的 名 称 以 及 学 生 的 其 他 数据 信息 ， 并 把 
它们 放 在 目录 : E:LuceneData 并 测 斌 数据。 索引 目录 路 径 应 创建 在 
E:Lucenelndex。 运 行 此 程序 后 ， 就 可 以 看 到 该 文件 夹 中 创建 的 索引 文件 的 列表 。 


第 5 步 - 运行 程序 : 


一 旦 完成 创建 源 和 原始 数据 ， 数 据 目录 和 索引 目录 ， 下 一 步 是 编译 和 运行 程序 。 要 
做 到 这 一 点 ， 请 LuceneTester.Java 文 件 的 活动 选项 卡 中 使 用 EclipselDE 可 无 论 是 运 
行 选项 ， 或 使 用 Ctrl+ F11 来 编译 和 运行 应 用 程序 LuceneTester。 如 果 一 切 正 常 您 的 
应 用 程序 ， 这 将 打印 在 Eclipse IDE 控制 台 以 下 消息 : 


Indexing E:LuceneData 
ecordi.txt 

Indexing E:LuceneData 
ecord10. txt 

Indexing E:LuceneData 
ecord2.txt 

Indexing E:LuceneData 
ecord3.txt 

Indexing E:LuceneData 
ecord4. txt 

Indexing E:LuceneData 
ecord5.txt 

Indexing E:LuceneData 
ecord6. txt 

Indexing E:LuceneData 
ecord7.txt 

Indexing E:LuceneData 
ecord8. txt 

Indexing E:LuceneData 
ecord9.txt 

10 File indexed, time taken: 109 ms 
1 documents found. Time :0 
File: E:LuceneData 
ecord4.txt 
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一 旦 已 经 成 功 地 运行 程序 ， 将 有 以 下 的 索引 目录 中 的 内 容 : 


Name 


|_| 0fdt 
[L] 0.fdx 
|_| -0fnm 
|_| _0.frq 
@ 0 
O _0.prx 
L) _0.tii 


|_| Otis 





网 segments.gen 
O segments_1 





Date modified 


5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 


Type 
FDT File 
FDX File 
FNM File 
FRQ File 


Mixed Mode CD C... 


PRX File 
TI File 
TIS File 
GEN File 
File 
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Size 


1 KB 
1 KB 
1 KB 
1 KB 
1 KB 
1 KB 
1 KB 
1 KB 
1 KB 
1 KB 
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索引 过 程 是 由 Lucene 所 提供 的 核心 功能 之 一 。 下 图 说 明了 索引 过 程 和 使 用 的 类 。 
IndexWriter 是 索引 过 程 中 最 重要 的 和 核心 组 件 。 


Document 


Field 





Indexing Process 


我 们 添加 包含 字段 的 IndexWriter 分 析 使 用 Analyzer 文件 ， 然 后 创建 /根据 需要 打 
eee 录 更 新 。IndexWriter 用 于 更 新 或 创建 索引 。 它 不 是 用 来 读 
RRS 


Indexing Z: : 
以 下 是 常用 索引 进程 类 的 列表 。 


NS 类 及 描述 
1 IndexWriter 此 类 充当 创造 /在 索引 过 程 中 更 新 指标 的 核心 组 成 部 分 
2 Directory 此 类 表示 索引 的 存储 位 置 


Analyzer Analyzer 类 负 责 分 析 一 个 文件 ， 并 从 将 被 索引 的 文本 获取 使 牌 / 


? 字 。 不 加 分 析 完 成 后 ，IndexWriter 不 能 创建 索引 。 
4 Document Document 代 表 一 个 虚拟 文档 与 字段 ， 其 中 字段 是 可 包含 在 物 


理 文 档 的 内 容 ， 元 数据 等 对 象 。Analyzer 只 能 理解 文档 。 


Field Field 是 最 低 单 元 或 素 引 过 程 的 起 点 。 它 代表 其 中 一 个 键 被 用 于 识别 

5 要 被 索引 的 值 的 键 值 对 关系 。 用 于 表示 一 个 文件 内 容 的 字段 将 具有 键 
为 “内容 ?”， 值 可 以 包含 文本 或 文档 的 数字 内 容 的 部 分 或 全 部 。 Lucene 能 
索引 公文 本 或 仅 数字 内 容 。 
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在 搜索 过 程 是 由 Lucene 所 提供 的 核心 功能 之 一 。 它 的 流程 是 相似 于 索引 过 程 。 
Lucene 基 本 搜索 可 以 使 用 下 列 类 也 可 称 为 基础 类 的 所 有 搜索 相关 的 操作 进行 。 


Searching #: 
以 下 是 常用 的 类 中 搜索 处 理 的 列表 。 
NS 类 和 说 明 


1 IndexSearcher 这 个 类 充当 读 取 /搜索 索引 的 过 程 后 创建 素 引 的 核心 组 成 
部 分 。 它 需要 目录 实例 指向 包含 素 引 的 位 置 


2 Term 这 个 类 是 搜索 的 最 低 单 位 。 它 是 在 素 引 过 程 中 类 似 字段 Field 

3 Query Query 是 一 个 抽象 类 ， 包 含 各 种 实用 方法 ， 所 有 类 型 查询 的 父 在 
Lucene 的 搜索 过 程 中 使 用 

TermQuery TermQuery 是 最 常用 的 查询 对 象 ， 并 且 是 许多 复杂 的 查询 

lucene 可 利用 的 基础 


5 TopDocs TopDocs 指 向 相 匹 配 的 搜索 条 件 的 前 N 个 搜索 结果 。 它 是 指针 
的 简单 容器 指向 它们 的 搜索 结果 输出 的 文档 。 
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索引 过 程 是 Lucene 提 供 的 核心 功能 之 一 。 下 图 说 明了 索引 过 程 和 使 用 的 类 。 
IndexWriter 是 索引 过 程 中 最 重要 的 和 核心 组 件 。 


Document 


| Field | eld 





Indexing Process 


添加 文档 包含 字段 IndexWriter， 该 分 析 用 分 析 仪 分 析 文 件 ， 然 后 创建 /根据 需要 并 在 
EF RT IA, IndexWriter 用 于 更 新 或 创 as 它 不 是 用 来 读 取 
索引 。 


现在 ， 展 示 一 个 循序 渐进 的 过 程 ， 以 获得 在 索引 过 程 的 理解 ， 使 用 一 个 基本 的 例 
子 。 


创建 一 个 文档 


创建 一 个 方法 来 获取 从 文本 文件 中 获得 Lucene 的 文档 。 
e 创建 各 种 类 型 的 是 含有 键 作为 名 称 和 值 作为 内 容 被 编 人 索引 键 值 对 字段 。 


e 设置 字段 中 进行 分 析 或 不 设置 。 在 我 们 的 实例 中 ， 只 有 内 容 被 分 析 ， 因 为 它 可 
能 包含 数据 ， 诸 如 a, am, are, an， 它 不 要 求 在 搜索 操作 等 等 。 


新 创建 的 字段 添加 到 文档 对 象 并 返回 给 调用 者 的 方法 。 


private Document getDocument(File file) throws IOException{ 
Document document = new Document(); 


//index file contents 

Field contentField = new Field(LuceneConstants.CONTENTS, 
new FileReader(file)); 

//index file name 

Field fileNameField - new Field(LuceneConstants.FILE NAME, 
file.getName(), 
Field.Store.YES,Field.Index.NOT ANALYZED); 

//index file path 

Field filePathField - new Field(LuceneConstants.FILE PATH, 
file.getCanonicalPath(), 
Field.Store.YES,Field.Index.NOT ANALYZED); 


document .add(contentField); 
document .add(fileNameField) ; 
document .add(filePathField) ; 


return document; 


创建 IndexWriter 


e IndexWriter 类 作为 它 创 建 / 在 索引 过 程 中 更 新 指标 的 核心 组 成 部 分 
e 创建 一 个 IndexWriter 对 象 
e 创建 其 应 指向 位 置 ， 其 中 索引 是 存储 一 个 lucene 的 目录 


e 初始 化 索引 目录 ， 有 标准 的 分 析 版 本 信息 和 其 他 所 需 / 可 选 参数 创建 
IndexWriter 对 象 


private IndexWriter writer; 


public Indexer(String indexDirectoryPath) throws IOException( 
//this directory will contain the indexes 
Directory indexDirectory - 
FSDirectory.open(new File(indexDirectoryPath)); 
//create the indexer 
writer - new IndexWriter(indexDirectory, 
new StandardAnalyzer(Version.LUCENE 36),true, 
IndexWwriter.MaxFieldLength.UNLIMITED); 


开始 索引 过 程 


private void indexFile(File file) throws IOException{ 
System.out.println("Indexing "+file.getCanonicalPath()); 
Document document = getDocument(file); 
writer .addDocument (document); 


} 


应 用 程序 示例 
让 我 们 创建 一 个 测试 Lucene 应 用 程序 来 测试 索引 过 程 。 


步 


述 
" 描述 


在 packagecom yiibai.lucene 包 下 创建 一 个 名 称 LuceneFirstApplication 
1 项 目 用 于 解释 Lucene - First Application chapter, 也 可 以 使 用 Lucene 的 
创建 项 目 -在 First Application 章 这 样本 章 理解 索引 过 程 。 


创建 LuceneConstants.java，TextFileFilterjava 和 Indexer.java， 其 它 的 文 
FRETZ. 


3 ”创建 LuceneTester.java 如 下 所 述 
4 清理 和 构建 应 用 程序 ， 以 确保 业务 逻辑 按 要 求 


LuceneConstants.java 
这 个 类 是 用 来 提供 跨 示 例 应 用 程序 中 使 用 的 各 种 常量 


package com.yiibai.lucene; 


public class LuceneConstants { 
public static final String CONTENTS="contents"; 
public static final String FILE NAME-"filename"; 
public static final String FILE PATH-"filepath"; 
public static final int MAX SEARCH - 10; 


TextFileFilter.java 


此 类 用 于 为 .txt 文件 过 滤器 


package com. yiibai.lucene; 


import java.io.File; 
import java.io.FileFilter; 


public class TextFileFilter implements FileFilter { 


@Override 
public boolean accept(File pathname) { 

return pathname. getName().toLowerCase().endswith(".txt"); 
j 


Indexer.java 


这 个 类 是 用 于 索引 的 原始 数据 ， 这 样 就 可 以 使 用 Lucene 库 ， 使 其 可 搜索 。 


package com.yiibai.lucene; 


import java.io.File; 

import java.io.FileFilter; 
import java.io.FileReader; 
import java.io.IOException; 


import org.apache.lucene.analysis.standard.StandardAnalyzer; 
import org.apache.lucene.document.Document; 

import org.apache.lucene.document.Field; 

import org.apache.lucene.index.CorruptIndexException; 

import org.apache.lucene.index.IndexWriter; 

import org.apache.lucene.store.Directory; 

import org.apache.lucene.store.FSDirectory; 

import org.apache.lucene.util.Version; 


public class Indexer { 
private IndexWwriter writer; 


public Indexer(String indexDirectoryPath) throws IOException{ 
//this directory will contain the indexes 
Directory indexDirectory - 
FSDirectory.open(new File(indexDirectoryPath)); 


//create the indexer 

writer - new IndexWriter(indexDirectory, 
new StandardAnalyzer(Version.LUCENE 36),true, 
Indexwriter.MaxFieldLength.UNLIMITED); 


j 


public void close() throws CorruptIndexException, IOException( 
writer.close(); 
j 


private Document getDocument(File file) throws IOException{ 
Document document = new Document(); 


//index file contents 

Field contentField = new Field(LuceneConstants.CONTENTS, 
new FileReader(file) ); 

//index file name 

Field fileNameField = new Field(LuceneConstants.FILE NAME, 
file.getName(), 
Field.Store.YES,Field.Index.NOT ANALYZED); 

//index file path 

Field filePathField - new Field(LuceneConstants.FILE PATH, 
file.getCanonicalPath(), 
Field.Store.YES,Field.Index.NOT ANALYZED); 


document.add(contentField); 
document.add(fileNameField); 
document.add(filePathField); 


return document; 


j 


private void indexFile(File file) throws IOException( 
System.out.println("Indexing "+file.getCanonicalPath()); 
Document document - getDocument(file); 
writer.addDocument (document); 


j 


public int createIndex(String dataDirPath, FileFilter filter) 
throws IOException{ 
//get all files in the data directory 
File[] files - new File(dataDirPath).listFiles(); 


for (File file : files) ( 
if(!file.isDirectory() 
&& !file.isHidden() 
&& file.exists() 
&& file.canRead() 
&& filter.accept(file) 


){ 
indexFile(file); 
j 
j 


return writer.numDocs(); 
LEE oI 


LuceneTester.java 


这 个 类 是 用 来 测试 Lucene JE 8538818873. 


package com. yiibai.lucene; 
import java.io.IOException; 
public class LuceneTester ( 


String indexDir - "E:NLuceneNIndex"; 
String dataDir = "E:\Lucene\Data"; 
Indexer indexer; 


public static void main(String[] args) ( 

LuceneTester tester; 

try { 
tester = new LuceneTester(); 
tester.createIndex(); 

} catch (IOException e) { 
e.printStackTrace(); 

} 


} 


private void createIndex() throws IOException{ 
indexer = new Indexer(indexDir); 
int numIndexed; 
long startTime = System.currentTimeMillis(); 
numIndexed = indexer.createIndex(dataDir, new TextFileFilterı 
long endTime = System.currentTimeMillis(); 
indexer.close(); 
System.out.println(numIndexed+" File indexed, time taken: " 
+(endTime-startTime)+" ms"); 





数据 和 索引 目录 的 创建 


从 record1.txt 命名 文件 record10.txt 包含 简单 的 名 称 以 及 学 生 的 其 他 细节 ， 并 把 它 
们 放 在 目录 E:LuceneData. 索引 目录 路 径 应 创建 为 E:Lucenelndex. 运行 此 程序 
后 ， 就 可 以 看 到 该 文件 夹 中 创建 的 索引 文件 的 列表 。 


运行 程序 : 


一 旦 使 用 创建 源 ， 创 造 了 原始 数据 ， 数 据 目录 和 索引 目录 来 完成 ， 准 各 好 这 一 步 然 
后 编译 和 运行 程序 。 要 做 到 这 一 点 ， 保 存 LuceneTester.Java 文 件 选 项 卡 中 使 用 
Eclipse IDE 运行 Run 选项 ， 或 使 用 Ctrl+ F11 来 编译 和 运行 应 用 程序 


LuceneTester。 如 果 应 用 程序 一 切 正 常 ， 这 将 打印 在 Eclipse IDE 的 控制 台 以 下 消 
自 


AUN or 


Indexing E: 


ecordi.txt 


Indexing E: 
ecord10. txt 
Indexing E: 


ecord2.txt 


Indexing E: 


ecord3.txt 


Indexing E: 


ecord4. txt 


Indexing E: 


ecord5.txt 


Indexing E: 


ecord6.txt 


Indexing E: 


ecord7.txt 


Indexing E: 


ecord8. txt 


Indexing E: 


ecord9.txt 


10 File indexed, 


一 旦 成 功 地 运 
Name 


_0.fdt 

_0.fdx 

_0.fnm 
|_| 0.frq 

B 0 

L.] 0.prx 


Oii 
.D.tis 


EJ 
mJ 


E 


ul 


E 


|. segments.gen 


| | segments 1 


s= 


行程 序 ， 将 有 以 下 的 索引 目录 中 的 内 容 : 


LuceneData 


LuceneData 


LuceneData 


LuceneData 


LuceneData 


LuceneData 


LuceneData 


LuceneData 


LuceneData 


LuceneData 


Es 


time taken: 


Date modified 











5/25/2014 3:15 PM 
5/25/2014 3:15 PN 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PIV 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PM 
5/25/2014 3:15 PN 
5/25/2014 3:15 PN 











109 ms 


Type 


FDT Fi 
FDX Fi 
FNM F 
FRQ Fi 
Mixed 


Mode CD C... 





PRX Fi 
TI File 


e 


TIS File 


GEN Fi 
File 


le 
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在 本 章 中 ， 我 们 将 讨论 索引 的 四 个 主要 操作 。 这 些 操作 是 在 不 同 的 时 间 和 有 用 用 于 
整个 软件 搜索 应 用 程序 。 


索引 操作 : 


以 下 是 常用 的 操作 过 程 中 索引 进程 列表 。 


Sr. 品 ss : 

No. 操作 说 明 : 

1 Add Document 此 操作 在 索引 进程 列表 的 初始 阶段 用 于 在 新 的 可 用 内 容 
创建 索引 

Update Document 此 操作 用 于 更 新 索引 以 反映 变化 的 更 新 的 内 容 。 它 
类 似 于 重新 创建 索引 

3 Delete Document 此 操作 用 于 更 新 的 索引 以 排除 它们 不 需要 被 索引 的 文 
档 / 搜 索 

4 Field Options 字段 选项 指定 的 方式 或 控制 的 方式 ， 一 个 字段 的 内 容 进 


行 搜索 


Lucene 搜 索 操 作 - Lucene 教 程 


搜索 过 程 是 由 Lucene 所 提供 的 核心 功能 之 一 。 下 图 说 明了 搜索 过 程 和 使 用 的 类 。 
IndexSearcher 是 搜索 过 程 中 最 重要 的 和 核心 组 件 。 


Query Object 
Expression C> | QueryParser | ————5 IndexSearcher = TopDocs 
Text | 
fragments 


IndexReader 


Searching Process 


我 们 首先 创建 目录 包含 索引 ， 然 后 将 它 传递 给 IndexSearcher， 它 使 用 IndexReader 
打开 目录 。 然 后 ， 创 建 一 个 期 限 查询 ， 使 搜索 usinglndexSearcher 通 过 将 查询 到 的 
搜索 。 IndexSearcher 返 回 TopDocs 对 象 包含 搜索 信息 连同 它 是 搜索 操作 的 结果 的 
文档 的 文档 ID( 多 个 )。 


am 我 们 将 展示 一 个 循序 渐进 的 过 程 ， 以 获得 在 索引 过 程 的 理解 ， 使 用 一 个 基本 
的 例子 。 


创建 QueryParser 


。 QueryParser 类 解析 用 户 输入 ， 并 输入 到 Lucene 理解 的 格式 的 查询 。 
e 创建 QueryParser 的 对 象 。 


e. 初始 化 一 个 在 此 查询 运行 有 标准 的 分 析 版 本 信息 和 索引 的 名 字 创 建 
QueryParser 对 象 。 


QueryParser queryParser; 
public Searcher(String indexDirectoryPath) throws IOException{ 
queryParser - new QueryParser(Version.LUCENE 36, 


LuceneConstants.CONTENTS, 
new StandardAnalyzer(Version.LUCENE 36)); 


t) IndexSearcher 


e IndexSearcher 类 作为 它 在 索引 过 程 中 创建 搜索 索引 的 核心 组 成 部 分 。 
e 创建 IndexSearcher 对 象 。 

e 创建 其 应 指向 位 置 ， 其 中 索引 是 存储 一 个 lucene 的 目录 。 

e 初始 化 索引 目录 中 创建 IndexSearcher 的 对 象 


IndexSearcher indexSearcher; 


public Searcher(String indexDirectoryPath) throws IOException{ 
Directory indexDirectory = 


FSDirectory.open(new File(indexDirectoryPath) ); 
indexSearcher = new IndexSearcher(indexDirectory); 


搜索 


e 要 开始 搜索 ， 通 过 QueryParser 解析 搜索 表达 式 创建 一 个 查询 对 象 。 
e 通过 调用 IndexSearcher.search() 方 法 搜索 。 


Query query; 


public TopDocs search( String searchQuery) throws IOException, Par: 
query = queryParser.parse(searchQuery); 
return indexSearcher.search(query, LuceneConstants.MAX SEARCH); 


j 


4 


获取 文件 





public Document getDocument(ScoreDoc scoreDoc) 
throws CorruptIndexException, IOException{ 
return indexSearcher.doc(scoreDoc.doc); 


j 


X }4] IndexSearcher 


public void close() throws IOException{ 
indexSearcher.close(); 


j 


应 用 程序 示例 
让 我 们 创建 一 个 测试 Lucene 的 点 用 程序 来 测试 搜索 过 程 。 


步 


述 
" 描述 


创建 下 名 称 为 LuceneFirstApplication 的 一 个 项 目 作为 解释 Lucene 的 应 用 
1 ， 在 包 packagecom.yiibai.Iucene 下 ， 在 第 一 个 应 用 程序 的 篇 章 。 也 可 以 使 
用 Lucene 创 建 的 项 目 理解 搜索 过 程 。 


创建 LuceneConstants.java，TextFileFilterjava 和 Searcherjava 用 于 
Lucene 解 释 - 在 第 一 应 用 章节 。 其 它 文 件 保持 不 变 。 


3 ”创建 LuceneTester.java 如 下 所 述 。 
4 清理 和 构建 应 用 程序 ， 以 确保 业务 逻辑 按 要 求 工作 。 


LuceneConstants.java 
这 个 类 是 用 来 提供 可 应 用 于 示例 应 用 程序 中 使 用 的 各 种 常量 。 


package com.yiibai.lucene; 


public class LuceneConstants { 
public static final String CONTENTS="contents"; 
public static final String FILE NAME-"filename"; 
public static final String FILE PATH-"filepath"; 
public static final int MAX SEARCH - 10; 


} 


TextFileFilter.java 
此 类 用 于 .txt 文 件 过 滤器 


package com.yiibai.lucene; 


import java.io.File; 
import java.io.FileFilter; 


public class TextFileFilter implements FileFilter { 
QOverride 


public boolean accept(File pathname) { 
return pathname.getName( ).toLowerCase().endsWith(".txt"); 
} 


Searcher.java 
这 个 类 用 来 读 取 就 使 用 Lucene 库 的 原始 数据 ， 并 搜索 数据 的 索引 。 


加 


package com.yiibai.lucene; 


import java.io.File; 
import java.io.IOException; 


import org.apache.lucene.analysis.standard.StandardAnalyzer; 
import org.apache.lucene.document.Document; 

import org.apache.lucene.index.CorruptIndexException; 
import org.apache.lucene.queryParser.ParseException; 
import org.apache.lucene.queryParser.QueryParser; 
import org.apache.lucene.search.IndexSearcher; 

import org.apache.lucene.search.Query; 

import org.apache.lucene.search.ScoreDoc; 

import org.apache.lucene.search.TopDocs; 

import org.apache.lucene.store.Directory; 

import org.apache.lucene.store.FSDirectory; 

import org.apache.lucene.util.Version; 


public class Searcher { 


j 


IndexSearcher indexSearcher; 
QueryParser queryParser, 
Query query; 


public Searcher(String indexDirectoryPath) throws IOException{ 
Directory indexDirectory = 
FSDirectory.open(new File(indexDirectoryPath) ); 
indexSearcher = new IndexSearcher(indexDirectory); 
queryParser = new QueryParser(Version.LUCENE_36, 
LuceneConstants.CONTENTS, 
new StandardAnalyzer(Version.LUCENE 36)); 


j 


public TopDocs search( String searchQuery) 
throws IOException, ParseException{ 
query = queryParser.parse(searchQuery); 
return indexSearcher.search(query, LuceneConstants.MAX SEARCI 


j 


public Document getDocument(ScoreDoc scoreDoc) 
throws CorruptIndexException, IOException{ 
return indexSearcher.doc(scoreDoc.doc); 


j 


public void close() throws IOException{ 
indexSearcher.close(); 
} 








Lucene Tester.java 


这 个 类 是 用 来 测试 Lucene 库 的 搜索 能 


package com.yiibai.lucene; 
import java.io.IOException; 


import org.apache.lucene.document.Document; 

import org.apache.lucene.queryParser.ParseException; 
import org.apache.lucene.search.ScoreDoc; 

import org.apache.lucene.search.TopDocs; 


public class LuceneTester ( 


String indexDir = "E:\Lucene\Index"; 
String dataDir = "E:\Lucene\Data"; 
Searcher searcher; 


public static void main(String[] args) ( 

LuceneTester tester; 

try { 
tester = new LuceneTester(); 
tester.search("Mohan"); 

) catch (IOException e) { 
e.printStackTrace(); 

) catch (ParseException e) ( 
e.printStackTrace(); 

} 


} 


private void search(String searchQuery) throws IOException, Par: 
searcher = new Searcher(indexDir); 
long startTime = System.currentTimeMillis(); 
TopDocs hits = searcher.search(searchQuery); 
long endTime = System.currentTimeMillis(); 


System.out.println(hits.totalHits + 
" documents found. Time :" + (endTime - startTime) +" ms": 
for(ScoreDoc scoreDoc : hits.scoreDocs) ( 
Document doc - searcher.getDocument(scoreDoc); 
System.out.println("File: "+ doc.get(LuceneConstants.FILE. 


} 


searcher.close(); 





数据 和 索引 目录 的 创建 


从 record1.txt 到 record10.txt 的 文件 中 包含 简单 的 名 称 以 及 学 生 的 其 他 细节 ， 并 把 它 
们 放 在 目录 E:LuceneData。 这 是 测试 数据 。 索 引 目 录 路 径 应 创建 为 
E:Lucenelndex。 期 间 ， 运 行 Lucene 索 引 程序 后 - 索引 过 程 中 ， 可 以 看 到 该 文件 夹 
中 创建 的 索引 文件 的 列表 。 


运行 程序 : 


一 旦 创建 源 ， 创 造 了 原始 数据 ， 数 据 目录 ， 索 引 目 录 和 索引 完成 后 ， 已 经 准 各 好 这 
一 步 是 编译 和 运行 程序 。 要 做 到 这 一 点 ， 请 LuceneTester.Java 文 件 选项 卡 中 使 用 
Eclipse IDE 可 使 用 Run 选 项 ， 或 使 用 Ctrl+ F11 来 编译 和 运行 应 用 程序 
LuceneTester。 如 果 您 的 应 用 程序 一 切 正常 ， 这 将 在 Eclipse IDE 的 控制 台 打 印 以 下 
消息 : 


1 documents found. Time :29 ms 
File: E:LuceneData 
ecord4.txt 
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正如 我 们 已 经 看 到 在 前 面 的 章节 中 的 Lucene- 搜索 操作 ，Lucene 使 用 
IndexSearcher 进 行 搜索 ， 并 使 用 由 QueryParser 输 入 创建 的 查询 对 象 。 在 本 章 中 ， 
我 们 将 讨论 不 同类 型 的 查询 对 象 和 方法 以 编程 方式 来 创建 它们 。 创 建 不 同类 型 的 查 
询 对 象 的 给 出 了 要 进行 搜索 类 型 的 控制 。 


考虑 高 级 搜索 的 情况 下 ， 许 多 应 用 程序 ， 用 户 给 出 了 多 个 选项 来 限制 搜索 结果 中 提 
供 。 通 过 查询 程序 ， 我 们 一 样 可 以 很 轻松 的 实现 。 


以 下 是 查询 类 型 ， 我 们 将 在 适当 的 时 候 讨 论 的 列表 。 
Sr. 
No. 
1 TermQuery 此 类 充当 创造 /在 索引 人 处理 更 新 指标 的 核心 组 成 部 分 。 


TermRangeQuery TermRangeQuery 是 在 使 用 的 范围 内 的 文本 的 词 条 都 
被 搜索 。 


3 PrefixQuery PrefixQuery 用 于 匹配 其 索引 开始 以 指定 的 字符 串 的 文档 。 


BooleanQuery BooleanQuery 用 于 搜索 的 是 使 用 AND，OR 或 NOT 运 算 
符 多 个 查询 结果 的 文件 。 


5 PhraseQuery 词组 查询 用 于 搜索 包含 词 条 的 特定 序列 的 文档 。 


WildCardQuery WildcardQuery 用 于 搜索 使 用 类 似 “ 的 字符 序列 的 通 配 
符 的 文件 ，"?" 匹配 单个 字符 。 


FuzzyQuery FuzzyQuery 用 于 搜索 使 用 模糊 实现 ， 它 是 一 种 基于 编辑 距 
离 算 法 的 近似 搜索 文件 。 


MatchAllDocsQuery MatchAllDocsQuery 作 为 顾名思义 匹配 的 所 有 文 


o 


类 和 说 明 


2 
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正如 我 们 已 经 看 到 在 前 一 章 的 Lucene 索 引 过 程 ，Lucene 使 用 IndexWriterwhich 分 析 
用 分 析 仪 文件 ， 然 后 根据 需要 创建 /打开 /编辑 索引 。 在 本 章 中 ， 我 们 将 讨论 不 同类 
型 的 分 析 对 象 ， 哪 些 是 在 分 析 过 程 中 使 用 的 相关 对 象 。 了 解 分 析 过 程 中 ， 分 析 仪 如 
何 工作 ， 会 给 Lucene 索 引文 件 很 大 的 和 启示。 


以 下 是 我 们 将 在 适当 的 时 候 讨 论 对 象 的 列表 。 


Sr. 


N 类 和 说 明 

o. 

1 Token 兮 牌 表 示 ( 起 始 偏 移 量 ， 结 束 偏 移 ， 兮 牌 类 型 和 位 置 增 量 位 置 ，) 在 
像 它 的 元 数据 相关 的 详细 信息 的 文档 中 的 文本 或 字 。 

2 TokenStream TokenStream 是 分 析 过 程 中 的 一 个 输出 ， 它 包括 串联 的 兮 


牌 。 它 是 一 个 抽象 类 。 
3 Analyzer 这 是 对 每 个 类 型 分 析 器 的 抽象 基 类 。 
WhitespaceAnalyzer 该 分 析 仪 analyzer 分 割 的 基础 的 空白 文档 中 的 文 


4 

5 SimpleAnalyzer 此 分 析 器 分 割 在 基于 非 字 母 字符 的 文档 的 文本 ， 然 后 小 
写 它 们 。 

6 StopAnalyzer 该 分 析 仪 的 工作 原理 类 似 于 SimpleAnalyzer 并 删除 常用 词 
像 'a','an','the' 等 等 。 

7 StandardAnalyzer 这 是 最 复杂 的 分 析 ， 并 能 处 理 姓名 ， 电 子 邮 件 地 址 


等 ， 它 小 写 每 个 标记 ， 并 删除 常用 词 和 标点 符号 (如 有 )。 
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在 本 章 中 ， 我 们 将 研究 的 排序 顺序 默认 情况 下 ， 在 给 出 的 Lucene 搜 索 结 果 或 可 根据 


需要 进行 操作 。 


按 相 关 性 排序 


这 
来 。 


是 使 用 Lucene 的 默认 排序 方式 。 Lucene 通 过 在 顶部 的 最 相关 的 命中 提供 的 结 


private void sortUsingRelevance(String searchQuery) 


} 


throws IOException, ParseException{ 

searcher = new Searcher(indexDir); 

long startTime = System.currentTimeMillis(); 

//create a term to search file name 

Term term = new Term(LuceneConstants.FILE NAME, searchQuery); 
//create the term query object 

Query query - new FuzzyQuery(term); 
searcher.setDefaultFieldSortScoring(true, false); 
//do the search 

TopDocs hits - searcher.search(query, Sort. RELEVANCE) ; 
long endTime - System.currentTimeMillis(); 


System.out.println(hits.totalHits + 
" documents found. Time :" + (endTime - startTime) + "ms"); 
for(ScoreDoc scoreDoc : hits.scoreDocs) ( 
Document doc - searcher.getDocument(scoreDoc); 
System.out.print("Score: "+ scoreDoc.score + " "); 
System.out.println("File: "+ doc.get(LuceneConstants.FILE PA 
} 


searcher.close(); 


Aoo: ë 


选择 IndexOrder 排 序 方式 
这 被 分 拣 使 用 lucene 模 式 ， 其 中 索引 第 一 文档 示 出 第 一 搜索 结果 中 。 


private void sortUsingIndex(String searchQuery) 


throws IOException, ParseException{ 

searcher = new Searcher(indexDir); 

long startTime = System.currentTimeMillis(); 

//create a term to search file name 

Term term = new Term(LuceneConstants.FILE_NAME, searchQuery); 
//create the term query object 

Query query = new FuzzyQuery(term); 

searcher .setDefaultFieldSortScoring(true, false); 

//do the search 

TopDocs hits = searcher.search(query, Sort. INDEXORDER) ; 
long endTime = System.currentTimeMillis(); 


System.out.println(hits.totalHits + 
" documents found. Time :" + (endTime - startTime) + "ms"); 
for(ScoreDoc scoreDoc : hits.scoreDocs) { 
Document doc = searcher.getDocument(scoreDoc); 
System.out.print("Score: "+ scoreDoc.score + " "); 
System.out.println("File: "+ doc.get(LuceneConstants.FILE PA 


searcher.close(); 





应 用 程序 示例 .… 


让 我 们 创建 一 个 测试 Lucene 的 点 用 程序 来 测试 分 选 过 程 。 


步 -" 
术 
" 描述 
创建 下 名 称 为 LuceneFirstApplication 的 一 个 项 目 作 为 解释 Lucene 的 应 用 
1 ， 在 包 packagecom.yiibai.Iucene 下 ， 在 第 一 个 应 用 程序 的 篇 章 。 也 可 以 使 
用 Lucene 创 建 的 项 目 理 解 搜 索 过 程 。 
2 | 8 建 LuceneConstants.java 和 Searcher.java 作 为 Lucene 的 解释 - 第 一 应 用 
程序 一 章 。 保 持 其 它 文 件 不 变 。 
3 ”创建 LuceneTester.java 如 下 所 述 。 
4 ”清理 和 构建 应 用 程序 ， 以 确保 业务 逻辑 按 要 求 工作 。 
LuceneConstants.java 


这 个 


类 是 用 来 提供 可 应 用 于 示例 应 用 程序 中 使 用 的 各 种 常量 。 


package com.yiibai.lucene; 


public class LuceneConstants { 
public static final String CONTENTS="contents"; 
public static final String FILE NAME-"filename"; 
public static final String FILE PATH-"filepath"; 
public static final int MAX SEARCH - 10; 


Searcher.java 


这 个 类 用 来 读 取 就 使 用 Lucene 库 的 原始 数据 ， 并 搜索 数据 的 索引 。 


package com.yiibai.lucene; 


import java.io.File; 
import java.io.IOException; 


import org.apache.lucene.analysis.standard.StandardAnalyzer; 
import org.apache.lucene.document.Document; 

import org.apache.lucene.index.CorruptIndexException; 
import org.apache.lucene.queryParser.ParseException; 
import org.apache.lucene.queryParser.QueryParser; 
import org.apache.lucene.search.IndexSearcher; 

import org.apache.lucene.search.Query; 

import org.apache.lucene.search.ScoreDoc; 

import org.apache.lucene.search.Sort; 

import org.apache.lucene.search.TopDocs; 

import org.apache.lucene.store.Directory; 

import org.apache.lucene.store.FSDirectory; 

import org.apache.lucene.util.Version; 


public class Searcher ( 


IndexSearcher indexSearcher; 
QueryParser queryParser; 
Query query; 


public Searcher(String indexDirectoryPath) throws IOException( 
Directory indexDirectory 
- FSDirectory.open(new File(indexDirectoryPath)); 
indexSearcher - new IndexSearcher(indexDirectory); 
queryParser - new QueryParser(Version.LUCENE 36, 
LuceneConstants.CONTENTS, 
new StandardAnalyzer(Version.LUCENE 36)); 


j 


public TopDocs search( String searchQuery) 
throws IOException, ParseException{ 
query = queryParser.parse(searchQuery); 
return indexSearcher.search(query, LuceneConstants.MAX SEARCI 


} 


public TopDocs search(Query query) 
throws IOException, ParseException{ 
return indexSearcher.search(query, LuceneConstants.MAX SEARCI 


j 


public TopDocs search(Query query,Sort sort) 
throws IOException, ParseException{ 
return indexSearcher.search(query, 
LuceneConstants.MAX SEARCH, sort); 


j 


public void setDefaultFieldSortScoring(boolean doTrackScores, 
boolean doMaxScores) { 
indexSearcher.setDefaultFieldSortScoring( 
doTrackScores, doMaxScores); 


j 


public Document getDocument(ScoreDoc scoreDoc) 
throws CorruptIndexException, IOException( 
return indexSearcher.doc(scoreDoc.doc); 


j 


public void close() throws IOException{ 
indexSearcher.close(); 





LuceneTester.java 


这 个 类 是 用 来 测试 Lucene 库 的 搜索 能 


package com.yiibai.lucene; 
import java.io.IOException; 


import org.apache.lucene.document.Document; 

import org.apache.lucene.index.Term; 

import org.apache.lucene.queryParser.ParseException; 
import org.apache.lucene.search.FuzzyQuery; 

import org.apache.lucene.search.Query; 

import org.apache.lucene.search.ScoreDoc; 

import org.apache.lucene.search.Sort; 

import org.apache.lucene.search.TopDocs; 


public class LuceneTester ( 
String indexDir = "E:\Lucene\Index"; 


String dataDir = "E:\Lucene\Data"; 
Indexer indexer; 


Searcher searcher; 


public static void main(String[] args) { 

LuceneTester tester; 

try { 
tester = new LuceneTester(); 
tester.sortUsingRelevance("cord3.txt"); 
tester.sortUsingIndex("cord3.txt"); 

) catch (IOException e) { 
e.printStackTrace(); 

) catch (ParseException e) ( 
e.printStackTrace(); 


} 
} 


private void sortUsingRelevance(String searchQuery) 
throws IOException, ParseException{ 
searcher = new Searcher (indexDir); 
long startTime = System.currentTimeMillis(); 
//create a term to search file name 
Term term = new Term(LuceneConstants.FILE_NAME, searchQuery), 
//create the term query object 
Query query = new FuzzyQuery(term); 
searcher.setDefaultFieldSortScoring(true, false); 
//do the search 
TopDocs hits = searcher.search(query, Sort . RELEVANCE) ; 
long endTime - System.currentTimeMillis(); 


System.out.println(hits.totalHits + 
" documents found. Time :" + (endTime - startTime) + "ms": 
for(ScoreDoc scoreDoc : hits.scoreDocs) { 
Document doc - searcher.getDocument (scoreDoc); 
System.out.print("Score: "+ scoreDoc.score + " "); 
System.out.println("File: "+ doc.get(LuceneConstants.FILE. 


j 


searcher.close(); 


j 


private void sortUsingIndex(String searchQuery) 
throws IOException, ParseException{ 
searcher = new Searcher(indexDir); 
long startTime = System.currentTimeMillis(); 
//create a term to search file name 
Term term = new Term(LuceneConstants.FILE NAME, searchQuery) , 
//create the term query object 
Query query = new FuzzyQuery(term); 
searcher.setDefaultFieldSortScoring(true, false); 
//do the search 
TopDocs hits = searcher.search(query, Sort .INDEXORDER) ; 
long endTime = System.currentTimeMillis(); 


System.out.println(hits.totalHits + 
" documents found. Time :" + (endTime - startTime) + "ms"); 


for(ScoreDoc scoreDoc : hits.scoreDocs) { 
Document doc = searcher.getDocument (scoreDoc); 
System.out.print("Score: "+ scoreDoc.score + " "); 
System.out.println("File: "+ doc.get(LuceneConstants.FILE. 


searcher.close(); 


} 
} 


«| a 








数据 和 索引 目录 的 创建 


从 record1.txt 到 record10.txt 的 文件 中 包含 简单 的 名 称 以 及 学 生 的 其 他 细节 ， 并 把 它 
们 放 在 目录 E:LuceneData。 这 是 测试 数据 。 索 引 目 录 路 径 应 创建 为 
E:Lucenelndex。 期 间 ， 运 行 Lucene 索 引 程序 后 - 索引 过 程 中 ， 可 以 看 到 该 文件 夹 
中 创建 的 索引 文件 的 列表 。 


运行 程序 : 


一 旦 创建 源 ， 创 造 了 原始 数据 ， 数 据 目录 ， 索 引 目录 和 索引 完成 后 ， 已 经 准 各 好 这 
一 步 是 编译 和 运行 程序 。 要 做 到 这 一 点 ， 请 LuceneTester.Java 文 件 选项 卡 中 使 用 
Eclipse IDE 可 使 用 Run 选 项 ， 或 使 用 Ctrl+ F11 来 编译 和 运行 应 用 程序 
LuceneTester。 如 果 您 的 应 用 程序 一 切 正 常 ， 这 将 在 Eclipse IDE 的 控制 台 打 印 以 下 
消息 


10 documents found. Time :31ms 
Score: 1.3179655 File: E:LuceneData 
ecord3.txt 

Score: 0.790779 File: E:LuceneData 
ecordi.txt 

Score: 0.790779 File: E:LuceneData 
ecord2.txt 

Score: 0.790779 File: E:LuceneData 
ecord4.txt 

Score: 0.790779 File: E:LuceneData 
ecord5.txt 

Score: 0.790779 File: E:LuceneData 
ecord6.txt 

Score: 0.790779 File: E:LuceneData 
ecord7.txt 

Score: 0.790779 File: E:LuceneData 
ecord8.txt 

Score: 0.790779 File: E:LuceneData 
ecord9.txt 

Score: 0.2635932 File: E:LuceneData 
ecord10 .txt 

10 documents found. Time :QOms 
Score: 0.790779 File: E:LuceneData 
ecord1. txt 

Score: 0.2635932 File: E:LuceneData 
ecord10.txt 

Score: 0.790779 File: E:LuceneData 
ecord2.txt 

Score: 1.3179655 File: E:LuceneData 
ecord3.txt 

Score: 0.790779 File: E:LuceneData 
ecord4. txt 

Score: 0.790779 File: E:LuceneData 
ecord5.txt 

Score: 0.790779 File: E:LuceneData 
ecord6. txt 

Score: 0.790779 File: E:LuceneData 
ecord7.txt 

Score: 0.790779 File: E:LuceneData 
ecord8. txt 

Score: 0.790779 File: E:LuceneData 
ecord9. txt 


Maven 教 程 

Apache Maven 是 一 个 软件 项 目 管理 和 综合 工具 。 基 于 项 目 对 象 模型 (POM) 的 概 
念 ，Maven 可 以 从 一 个 中 心 资 料 片 管理 项 目 构 建 ， 报 告 和 文件 。 

本 教程 将 介绍 如 何 使 用 Maven 在 Java 开 发 ， 或 任何 其 他 的 编程 语言 的 任何 项 目 。 


Maven 是 什么 ? 


Maven 是 一 个 项 目 管理 和 综合 工具 。Maven 提 供 了 开发 人 员 构 建 一 个 完整 的 生命 周 
期 框架 。 开 发 团队 可 以 自动 完成 项 目的 基础 工具 建设 ，Maven 使 用 标准 的 目录 结构 
和 默认 构建 生命 周期 。 


在 多 个 开发 团队 环境 时 ，Maven 可 以 设置 按 标准 在 非常 短 的 时 间 里 完成 配置 工作 。 
由 于 大 部 分 项 目的 设置 都 很 简单 ， 并 且 可 重复 使 用 ，Maven 让 开发 人 员 的 工作 更 轻 
松 ， 同 时 创建 报表 ， 检 查 ， 构 建 和 测试 自动 化 设置 。 


Maven 提 供 了 开发 人 员 的 方式 来 管理 : 
e Builds 
e Documentation 
e Reporting 
e Dependencies 
e SCMs 


Releases 


e Distribution 
e mailing list 


概括 地 说 ，Maven 简 化 和 标准 化 项 目 建设 过 程 。 处 理 编译 ， 分 配 ， 文 档 ， 团 队 协 作 
和 其 他 任务 的 无 颖 连接 。 Maven 增 加 可 重用 性 并 负责 建立 相关 的 任务 。 


Maven 7 Œ 
Maven 最 初 设 计 ， 是 以 简化 Jakarta Turbine 项 目的 建设 。 在 几 个 项 目 ， 每 个 项 目 包 
含 了 不 同 的 Ant 构 建文 件 。 JAR 检 查 到 CVS。 


Apache 组 织 开 发 Maven 可 以 建立 多 个 项 目 ， 发 布 项 目 信息 ， 项 目 部 署 ， 在 几 个 项 目 
中 JAR 文 件 提供 团队 合作 和 帮助 。 


Maven ix 


Maven 主 要 目标 是 提供 给 开发 人 员 : 
e 项 目 是 可 重复 使 用 ， 易 维护 ， 更 容易 理解 的 一 个 综合 模型 。 
e 插件 或 交互 的 工具 ， 这 种 声明 性 的 模式 。 


Maven 项 目的 结构 和 内 容 在 一 个 XML 文件 中 声明 ，pom.xml 项 目 对 象 模型 
(POM) ， 这 是 整个 Maven 系 统 的 基本 单元 。 有 关 详 细 信 息 ， 请 参阅 Maven POM 
的 部 分 。 


Apache Maven 是 一 种 创新 的 软件 项 目 管理 工具 ， 提 供 了 一 个 项 目 对 象 模型 
(POM) 文件 的 新 概念 来 管理 项 目的 构建 ， 相 关 性 和 文档 。 最 强大 的 功能 就 是 能 够 
自动 下 载 项 目 依赖 库 。 


在 本 教程 中 ， 它 提供 了 如 何 使 用 Apache Maven 3.x 的 许多 实例 和 解释 。 


Maven 安 装 和 配置 


在 Windows 和 Ubuntu 的 安装 指南 。 


e 在 Windows 上 安装 Maven 有 关 如 何在 Windows 上 安装 Maven 的 文章 。 
e 启用 Maven 的 代理 访问 要 使 用 代理 服务 器 来 连接 互联 网 ， 必 须 在 Maven 配置 
代理 设置 。 


Maven 资 源 库 


Maven 位 置 ， 中 央 和 远程 存储 库 配置 和 人 解释， 有 些 术 语 可 能 需要 在 Maven 使 用 前 
理解 。 


e Maven 本 地 资源 库 Maven 的 本 地 资源 库 是 用 来 存储 项 目的 依赖 库 ， 默 认 的 文 
件 夹 是 “.m2” 目录 ， 可 能 需要 将 其 更 改 为 另 一 个 文件 夹 。 

° E Ur MPMIY Maven 中 央 存 储 库 是 Maven 用 来 下 载 所 有 项 目的 依赖 库 的 
默认 位 置 。 

e 如 何 从 Maven 远 程 存储 库 下 载 ? ， 如 何 添加 远程 库 ? 并 非 所 有 的 库存 储 在 

Maven 的 中 央 存 储 库 ， 很 多 时 候 需 要 添加 一 些 远 程 仓 库 来 从 其 他 位 置 ， 而 不 是 

默认 的 中 央 存 储 库 下 载 库 。 

Maven 依 赖 机 制 这 里 的 文章 是 关于 传统 方式 和 Maven 方 式 的 依赖 库 的 不 同 ， 并 

说 明 Maven 会 从 那里 搜索 这 些 库 。 

定制 库 到 Maven 本 地 资源 库 很 多 库 仍然 不 支持 Maven 的 pom.xml 的 概念 ， 这 

里 有 一 个 指南 来 说 明 如 何 包 括 “ 非 Maven 支 持 " 库 到 Maven 本 地 资源 库 中 。 


基于 Maven 项 目 和 Eclipse IDE 


实例 是 使 用 Maven 创 建 Java 项 目 和 Web 应 用 程序 ， 以 及 演示 如 何 将 其 导 和 到 Eclipse 
IDE 中 。 


e 使 用 Maven 创 建 Java 项 目 使 用 Maven 来 创建 一 个 Java 项 目 。 

e 转换 基于 Maven 的 Java 项 目 支 持 Eclipse IDE 指导 转换 基于 Maven 的 Java 项 目 
来 支持 在 Eclipse IDE 中 。 

e 使 用 Maven 创 建 Web 应 用 程序 项 目 使 用 Maven 来 创建 Web 应 用 程序 项 目 。 

e 转换 基于 Maven 的 Web 应 用 程序 支持 Eclipse IDE Maven 转 换 基于 Web 应 用 程 
序 来 支持 Eclipse IDE 中 指南 。 

e 使 用 Maven 模 板 创建 项 目 另外 ， 您 也 可 以 从 Maven 的 模板 来 创建 标准 项 目 。 


Maven 基 本 操作 


一 些 基 本 的 操作 ， 编 译 ， 构 建 ， 单 元 测试 ， 安 装 ， 网 站 生成 和 基于 Maven 部 署 项 


o 


使 用 Maven 构 建 项 目 “mvn package" 来 构建 项 目 

使 用 Maven 清 理 项 目 “mvn clean” 来 清理 项 目 

使 用 Maven 运 行 单 元 测试 “mvn test" 来 执行 单元 测试 

将 项 目 安装 到 Maven 本 地 资源 库 “mvn install" 打包 和 部 署 项 目 到 本 地 资源 库 
生成 基于 Maven 的 项 目 文档 站 点 “mvn site" 来 为 您 的 项 目 生 成 信息 文档 站 点 
使 用 “mvn site-deploy" 部 署 站 点 (WebDAV 例 子 ) “mvn site-deploy" 通过 
WebDAV 部 署 自动 生成 的 文档 站 点 到 服务 器 

部 署 基于 Maven 的 war 文 件 到 Tomcat “mvn tomcat:deploy" 以 WAR 文件 部 署 到 
Tomcat 


Maven 参 考 


e Apache Maven 官方 教程 
e Apache Maven (Wiki) 


Maven 安 装配 置 - Maven 教 程 

想 要 安装 Apache Maven 在 Windows 系统 上 , 只 需要 下 载 Maven 的 zip 文件 ， 并 
将 其 解压 到 你 想 安 装 的 目录 ， 并 配置 Windows 环境 变量 。 

所 需 工 具 


1. JDK 1.8 
2. Maven 3.3.3 
3. Windows 7 


注 Maven 3.2 要 求 JDK 1.6 或 以 上 版 本 , 而 Maven 3.0/3.1 需要 JDK 1.5 或 以 上 


1. JDK 和 JAVA_HOME 


确保 已 安装 JDK， 并 “JAVA_HOME” 变量 已 加 入 作为 Windows 环境 变量 。 














Administrator 的 用 户 变量 a 


Re 值 
TEMP SUSERPROFILE® \AppData\Local \Temp 
TMP SUSERPROFILE® \AppData\Local \Temp 
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操作 要 以 按 上 面 数字 顺序 ， 在 这 个 教程 中 ， 安 装 的 JDK 是 JDK1.8， 为 了 方便 学 
习 ， 建 议 你 也 安装 使 用 JDK1.8。 


2. 下 载 Apache Maven 


访问 Maven 官 方 网 站 ， 打 开 后 找到 下 载 链接 ， 如 下 : 


FR Maven 的 zip 文件 ， 例 如 : apache-maven-3.3.3-bin.zip， 将 它 解压 到 你 要 安 
装 Maven 的 文件 夹 。 


假设 你 解压 缩 到 这 个 文件 夹 — D:\software\yiibai.com\apache-maven 
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注意 : 在 这 一 步 ， 只 是 文件 夹 和 文件 ， 安 装 不 是 必需 的 


3. 4870 M2_HOME 21] MAVEN HOME 


添加 M2. HOME 和 MAVEN HOME 环境 变量 在 Windows， 并 将 其 指向 你 的 
Maven 文件 夹 。 
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SUSERPROFILE®S\AppData\Local \Temp 
SUSERPROFILE®\AppData\Local \Temp 
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M2 HOME 或 MAVEN HOME Maven 说 只 是 添加 M2. HOME , 但 一 些 项 目 仍 引用 
Maven 的 文件 夹 MAVEN HOME, 因此 ， 为 了 安全 也 把 它 添加 进去 。 


. 4. 添加 到 环境 变量 - PATH 


更 新 PATH 变量 ， 添 加 Maven bin 文件 夹 到 PATH 的 最 后 — %M2_HOME%\bin, 这 
样 就 可 以 到 处 运行 Maven 命令 了 。 





变量 名 N): Path 
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mm 
"AI el 





iB 


NUMBER DF PR... 4 
Üindows NT 
C:\Windows\system32;C: \Windows;... 
COM: EXE: RAT: CMN: VRS: VRE: RS 








Maven 安 装配 置 - Maven AU 2274 


5. 验证 
完成 ， 以 验证 它 ， 执 行 mvn -version 在 命令 提示 符 下 ， 如 下 图 输出 结果 : 


C:\Users\Administrator>mvn -version 

Apache Maven 3.3.3 (7994120775791599e205a5524ec3e0dfe41d4a06; 2015. 
7+08:00) 

Maven home: D:\software\yiibai.com\apache-maven 

Java version: 1.8.0 40, vendor: Oracle Corporation 

Java home: D:\Program FilesNJavaNjdk1.8.0 40 

Default locale: zh CN, platform encoding: GBK 

OS name: "windows 7", version: "6.1", arch: "amd64", family: "dos" 


“mess >] 


如 果 你 看 到 类 似 消息 ， 表 示 Apache Maven 在 Windows 上 已 安装 成 功 。 
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如 果 你 的 公司 正在 建立 一 个 防火 墙 ， 并 使 用 HTTP 代 理 服 务 器 来 阻止 用 户 直 接连 接 
到 互联 网 。 如 果 您 使 用 代理 ，Maven 将 无 法 下 载 任何 依赖 。 


为 了 使 它 工 作 ， 你 必须 声明 在 Maven 的 配置 文件 中 设置 代理 服务 器 : settings.xml. 


1. Maven 配 置 文件 


找到 文件 {M2_HOME}/conf/settings.xml, 并 把 你 的 代理 服务 器 信息 配置 写 入 。 注 : 
(M2 HOME) => D:\software\yiibai.com\apache-maven 


(M2 HOMEJ/conf/settings.xml 


«!-- proxies 
This is a list of proxies which can be used on this machine t« 
Unless otherwise specified (by system property or command-line 
specification in this list marked as active will be used. 
| - -> 
<proxies> 
<!-- proxy 
| Specification for one proxy, to be used in connecting to the 
| 
<proxy> 
<id>optional</id> 
<active>true</active> 
<protocol>http</protocol> 
<username>proxyuser</</username> 
<password>proxypass</password> 
<host>proxy.host.net</host> 
<port>80</port> 
<nonProxyHosts>local.net|some.host .com</nonProxyHosts> 
</proxy> 
T> 
</proxies> 


JE UM cIcsccecxes n 
取消 注释 代理 选项 ， 填 写 您 的 代理 服务 器 的 详细 信息 。 





<!-- proxies 
| This is a list of proxies which can be used on this machine tc 
| Unless otherwise specified (by system property or command-line 
| specification in this list marked as active will be used. 
| - -> 
<proxies> 
<proxy> 
<id>optional</id> 
<active>true</active> 
<protocol>http</protocol> 
<username>yiibai</username> 
<password>password</password> 
<host>proxy.yiibai.com</host> 
<port>8888</port> 
<nonProxyHosts>local.net|some.host .com</nonProxyHosts> 
</proxy> 
</proxies> 


二 内 


2. 保存 文件 


完成 后 ，Apache Maven 应 该 是 能 够 通过 代理 服务 器 立即 连接 到 Internet。 


注意 : 重新 启动 不 是 必需 的 。Maven 只 是 一 个 命 售 ， 当 你 调用 它 ， 它 会 再 次 读 取 该 
文件。 
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Maven 的 本 地 资源 库 是 用 来 存储 所 有 项 目的 依赖 关系 (插件 jar 和 其 他 文件 ， 这 些 文 
件 被 Maven 下 载 ) 到 本 地 文件 来 。 很 简单 ， 当 你 建立 一 个 Maven 项 目 ， 所 有 相关 文件 
将 被 存储 在 你 的 Maven 本 地 仓库 。 


默认 情况 下 ，Maven 的 本 地 资源 库 默认 为 .m2 目录 文件 夹 : 


1. Unix/Mac OS X - ~/.m2 
2. Windows — C:\Documents and Settings{your-username}.m2 


1. 更 新 Maven 的 本 地 库 


通常 情况 下 ， 可 改变 默认 的 .m2 目录 下 的 默认 本 地 存储 库 文件 夹 到 其 他 更 有 意义 的 
名 称 ， 例 如 ， maven-repo 


找到 (M2. HOME confisetting.xml, 更 新 localRepository 到 其 它 名 称 。 
(M2 HOME}\conf\setting.xml 


<settings><!-- localRepository 
| The path to the local repository maven will use to store artil 


| 
| Default: ~/.m2/repository 


<localRepository>/path/to/local/repo</localRepository> 
--><localRepository>D: \software\yiibai.com\apache-maven\reposito! 


ee es: 


2. 保存 文件 


执行 之 后 ， 新 的 Maven 本 地 存储 库 现在 改 为 DsoftwareViibai.comvapache- 
maven\repository. 





执行 命令 : 


C:\worksp> mvn archetype:generate -DgroupId=com.yiibai -DartifactI( 
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修改 日 期 


2015/10/26 21:59 

2015/10/26 21:59 

J backport-util-concurrent 2015/10/26 21:58 

J classworlds 2015/10/26 21:58 

ü commons-cli 2015/10/26 21:58 

ü commons-collections 2015/10/26 21:58 

J commons-io 2015/10/26 21:58 

ü commons-lang 2015/10/26 21:58 

B beckport-util-cond J domáj 2015/10/26 21:57 
B deseworide J jdom 2015/10/26 21:57 
J junit 2015/10/26 21:58 


J commons-cli B net 
ü commons-collecti: 
J org 


2015/10/26 21:57 

2015/10/26 21:59 

a commons-io J oro 2015/10/26 21:58 夫 

Ù commonsdang [mtaps 7 (1ánsnonezis] yt | 
Ji domáj 

J jdom 

J iunit 


a 15 个 对 象 
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当 你 建立 一 个 Maven HRA, Maven 会 检查 你 的 pom.xml 文件 ， 以 确定 哪些 依赖 
下 载 。 首 先 ，Maven 将 从 本 地 资源 库 获得 Maven 的 本 地 资源 库 依 赖 资源 ， 如 果 没 
有 找到 ， 然 后 把 它 会 从 默认 的 Maven 中 央 存 储 库 一 
http://repo1.maven.org/maven2/ 查找 下 载 。 


Maven 的 中 央 资 源 库 网 站 是 这 样 的 : 


n 











Index of /maven2/ x a 





| 所 CŒ |} repol.maven.org/maven2/ Ww 


Index of /maven2/ 




















HTTPClient/ 01-Nov-2005 05:03 B 
abbot / 23-Sep-2015 10:13 - 
acegisecurity/ 23-Dec-2005 12:20 B 
activation’ 21-Dec-2005 15:37 - 
activecluster/ 29-Jul-2011 13:08 E 
act iveio/ D1-Nov-2005 05:10 B 
act ivemg/ Di-Nov-2005 05:13 B 
act ivemq- jaxb/ D1-Nov-2005 05:11 = 
activesoap/ 01-Nov-2005 05:20 - 
activespace/ 29-Jul-2011 13:08 - 
adarwin/ D1-Nov-2005 05:03 - 
aef 31-Mar-2015 09:06 s 
aelfred/ D1-Nov-2005 05:03 - 
aero/ 19-Feb-2014 19:52 = 
aif 16-Sep-2014 15:43 E 
aislib/ D1-Nov-2005 05:14 - 
altrmi/ D1-Nov-2005 05:14 = 
an 11-Feb-2013 23:07 - 
andromd D1-Nov-2005 05:19 - 
annog ery’ 01-Nov-2005 05:19 E 
ant/ 01-Nov-2005 05:17 - 
ant-contrib/ 08-Aug-2008 22:17 一 
ant-doxygen/ O1-Nov-2005 05:04 E 
ant 4eclinse/ 29-Tu1-2011 13:08 一 d 


Maven 中 心 储 存 库 网 站 已 经 改版 本 ， 目 录 浏 览 可 能 不 再 使 用 。 这 将 直接 被 重 定向 到 
http://search.maven.org/。 这 就 好 多 了 ， 现 在 有 一 个 搜索 功能 : 
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The Central Repository x 


€ > QC |D search.maven.org/#search%7Cga%7C1%7Ca 





= The Central Repository SEARCH | ADVANCED SEARCH | BROWSE 
— 


New: About Central Advanced Search | API Guide | Help 


Search Results <123... 1516 >disple 








Artifactid Latest Version Updated Download 








com.carrotgarden.a carrot-a 1531 19-Nov-2014 pom 
com.aijjpj.a-sysmon a-sysmon-parent 1.0-pre28 all (27) 01-Sep-2015 pom 
com.ajipj.a-foundation a-foundation-parent 1.0-pre16 all (3) 01-Aug-2015 pom 
org jibx. schema .org.opentravel. 2011A opentravel-2011A-reactor 1.14 all (6) 31-Dec-2014 pom 
org jibx.schema.org.opentravel. 2012A opentravel-2012A-reactor 1.14 all (6) 31-Dec-2014 pom 
org jibx.schema.org.opentravel. 2013A opentravel-2013A-reactor 114 all (2) 31-Dec-2014 pom 
org jibx.schema.org.opentravel. 2014A opentravel-2014A-reactor 114 all (2 31-Dec-2014 pom 
netsf a2j 82i beta2 21-Dec-2005 pom jar 
xfire xfire-jaxb 10 07-Dec-2005 pom Méajar M6a.pom 
org.ow2 joram a3 5.10.0 all (6) 28-May-2015 pom 
org.objectweb joram a3 57.0 all (6) 14-Sep-2011 pom 
quilt quilt-0.6-a 5 09-Nov-2005 pom jar 


PS: 目录 浏览 功能 被 禁用 ， 但 是 ， 当 你 建立 Maven 的 项 目 ， 它 仍然 会 从 
"http://repo1.maven.org/maven/" 得 到 依赖 , 您 可 以 从 Maven 验证 输出 。 
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如 何 从 Maven 远 程 存 储 库 下 载 ? - Maven 教 程 


根据 Apache Maven 的 说 明 : 


> Downloading in Maven is triggered by a project declaring a dependency that is 
not present in the local repository (or fora SNAPSHOT, when the remote 
repository contains one that is newer). By default, Maven will download from the 
central repository. 


在 Maven 中 ， 当 你 声明 的 库 不 存在 于 本 地 存储 库 中 ， 也 没有 不 存在 于 Maven 中 心 储 
存 库 ， 该 过 程 业 停止 并 将 错误 消息 输出 到 Maven 控制 台 


1. 示例 


org.jvnet.localizer 只 适用 于 Java.net 资 源 库 


pom.xml 


<dependency> 
<grouplId>org. jvnet .localizer</groupId> 
<artifactId>localizer</artifactId> 
<version>1.8</version> 

</dependency> 


当 你 建立 这 个 Maven 项 目 ， 它 将 依赖 找 不 到 失败 并 输出 错误 消息 。 


2. 声明 Java.net 储 存 库 


告诉 Maven 来 获得 Java.net 的 依赖 ， 你 需要 声明 远程 仓库 在 pom.xml 文件 这 


pom.xml 


<repositories> 
<repository> 
<id>java.net</id> 
<url>https://maven.java.net/content/repositories/public/</t 
</repository> 
</repositories> 


1 Hl 
现在 ，Maven 的 依赖 库 查 询 顺序 更 改 为 : 


1. 在 Maven 本 地 资源 库 中 搜索 ， ee 进入 
2. 在 Maven 中 央 存 储 库 搜索 ， 如 果 没 有 找到 入 第 





第 2 步 , 否则 退出 。 
3 步 ， 否 则 退出 。 


3. 在 java.net Maven 的 远程 存储 库 搜索 ， 如 果 没 有 找到 ， 提 示 错 误 信息 ， 否 则 退 


o 
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默认 情况 下 ，Maven 从 Maven 中 央 合 库 下 载 所 有 依赖 关系 。 但 是 ， 有 些 库 丢失 在 中 
央 存 储 库 ， 只 有 在 Java.net 或 JBoss 的 储存 库 远 程 仓库 中 能 找到 


1. Java.net 资 源 库 


添加 Java.net 远 程 仓库 的 详细 信息 在 "pom.xml" 文 件 。 


pom.xml 


<project ...> 
<repositories> 
<repository> 
<id>java.net</id> 
<url>https://maven. java.net/content/repositories/public/</ur- 
</repository> 
</repositories> 
</project> 





xk IRE “htto:/download.java.net/maven/2” 仍然 可 用 , 但 建议 升级 到 最 新 储存 库 。 


2. JBoss Maven f È 


1. 添加 JBoss 远程 仓库 的 详细 信息 在 “pom.xml” 文件 中 。 


pom.xml 
<project ...> 
<repositories> 


<repository> 
<id>JBoss repository</id> 
<url>http://repository.jboss.org/nexus/content/groups/public/<, 
</repository> 
</repositories> 
</project> 


1 | 
注意 : 旧 的 http;/repository.jboss.com/maven2/ Bit, AREA. 


参考 
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1. http://maven2-repository.java.net/ 
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在 Maven 依赖 机 制 的 帮助 下 自动 下 载 所 有 必需 的 依赖 库 ， 并 保持 版 本 升级 。 


案例 分 析 
让 我 们 看 一 个 案例 研究 ， 以 了 解 它 是 如 何 工作 的 。 假 设 你 想 使 用 Log4j 作为 项 目的 
日 志 。 这 里 你 要 做 什么 ? 


1. 在 传统 方式 


. 访问 http://logging.apache.org/log4j/ 
. 下 载 Log4 j 的 jar 库 

. 复制 jar 到 项 目 类 路 径 
.手动 将 其 包含 到 项 目的 依赖 

. 所 有 的 管理 需要 一 切 由 自己 做 


MRA Log4j 版 本 升级 ， 则 需要 重复 上 述 步骤 一 次 。 


2. 在 Maven 的 方式 


1. 你 需要 知道 log4j 的 Maven 坐标 ， 例 如 : 


oRWND — 


&lt;groupId&gt;log4j&lt;/groupId&gt; 
&lt;artifactId&gt;log4j&lt;/artifactId&gt; 
&lt;version&gt;1.2.14&lt;/version&gt; 


2. € €&B3 FR log4j 81.2.14 版 本 库 。 如 果 “version” 标 签 被 忽略 ， 它 会 自动 升 
级 库 时 当 有 新 的 版 本 时 。 


3. 声明 Maven 的 坐标 转换 成 pom.xml 文件 。 


&lt;dependencies&gt; 
&lt;dependency&gt; 
&lt;groupId&gt;log4j&lt;/groupId&gt; 
&lt;artifactId&gt;log4j&lt;/artifactId&gt; 
&lt;version&gt;1.2.14&1lt;/version&gt; 
&lt;/dependency&gt; 

&lt;/dependencies&gt; 


4. M Maven 编译 或 构建 ，log4j 的 jar 会 自动 下 载 ， 并 把 它 放 到 Maven 本 地 存储 
m 


5. 所 有 由 Maven 管理 


解释 说 明 


看 看 有 什么 不 同 ? 那么 到 底 在 Maven 发 生 了 什么 ? 当 建 立 一 个 Maven 的 项 目 ， 
pom.xml 文 件 将 被 解析 ， 如 果 看 到 log4j 的 Maven 上 坐标， 然后 Maven 按 此 顺序 搜 
R log4j 库 : 


1. 在 Maven 的 本 地 仓库 搜索 log4j 
2. 在 Maven 中 央 存 储 库 搜索 log4j 
3. 在 Maven 远程 仓库 搜索 log4j( 如 果 在 pom.xml HES) 


Maven 依赖 库 管 理 是 一 个 非常 好 的 工具 ， 为 您 节省 了 大 量 的 工作 。 
如 何 找到 Maven 坐标 ? 访问 Maven 中 心 储存 库 ， 搜 索 下 载 您 想 要 的 jar。 
参考 


1. 依赖 机 制 简介 


定制 库 到 Maven 本 地 资源 库 - Maven 教 程 


这 里 有 2 个 案例 ， 需 要 手动 发 出 Maven 命 令 包 括 一 个 jar 到 Maven 的 本 地 资源 库 。 


1. 要 使 用 的 jar 不 存在 于 Maven 的 中 心 储存 库 中 。 
2. 您 创建 了 一 个 自 定义 的 jar ， 而 另 一 个 Maven 项 目 需 要 使 用 。 


PS， 还 是 有 很 多 jar 不 支持 Maven 的 。 


案例 学 习 


例如 ，kaptcha， 它 是 一 个 流行 的 第 三 方 Java 库 ， 它 被 用 来 生成 “验证 码 ” 的 图 片 ， 
以 阻止 垃圾 邮件 ， 但 它 不 在 Maven 的 中 央 仓 库 中 。 


在 本 教程 中 ， 我 们 将 告诉 你 如 何 安装 “kaptcha” jar 到 Maven 的 本 地 资源 库 。 


1. mvn 安装 


下 载 “kaptcha"， 将 其 解压 缩 并 将 kaptcha-version.jar 复制 到 其 他 地 方 ， 比 如 : C 
和 瘟 。 发 出 下 面 的 命令 : 


mvn install:install-file -Dfile=c:\kaptcha-{version}.jar -DgroupId: 
了 — R 5 


示例 : 





D:\>mvn install:install-file -Dfile=c:\kaptcha-2.3.jar -DgroupId-c: 
-DartifactId=kaptcha -Dversion=2.3 -Dpackaging=jar 

[INFO] Scanning for projects... 

[INFO] Searching repository for plugin with prefix: ‘install’. 
[INFO] -----------------------------------------------------------， 
[INFO] Building Maven Default Project 

[ INFO] task-segment: [install:install-file] (aggregator-style) 
[INFO] -----------------------------------------------------------， 
[INFO] [install:install-file] 

[INFO] Installing c:\kaptcha-2.3.jar to 
D:\maven_repo\com\google\code\kaptcha\2.3\kaptcha-2.3.jar 

[INFO] -----------------------------------------------------------: 
[INFO] BUILD SUCCESSFUL 

[INFO] -----------------------------------------------------------， 
[INFO] Total time: < 1 second 

[INFO] Finished at: Tue May 12 13:41:42 SGT 2014 

[INFO] Final Memory: 3M/6M 

[INFO] -----------------------------------------------------------， 





现在 , "kaptcha" jar 被 复制 到 Maven 本 地 存储 库 。 


2. pom.xml 
安装 完毕 后 ， 就 在 pom.xml 中 声明 kaptcha 的 坐标 。 


<dependency> 
<groupId>com.google.code</groupId> 
«artifactId-kaptcha«/artifactId» 
<version>2.3</version> 


</dependency> 
3. 完成 
构建 它 ， 现 在 “kaptcha" jar 能 够 从 你 的 Maven 本 地 存储 库 检 索 了 。 
参考 


1. Maven 安 装 文档 
2. Kaptcha 网 站 


使 用 Maven 创 建 Java 项 目 - Maven 教 程 

在 本 教程 中 ， 我 们 将 向 你 展示 如 何 使 用 Maven 来 创建 一 个 Java 项 目 ， 导 入 其 到 
Eclipse IDE， 并 打包 Java 项 目 到 一 个 JAR 文件 。 

所 需要 的 工具 : 


1. Maven 3.3.3 
2. Eclipse 4.2 
3. JDK8 


注意 : 请 确保 Maven 是 正确 安装 和 配置 (在 Windows，*nix，Mac OSX 系 统 
FH) ， 然 后 再 开始 本 教程 ， 避 人 免 mvn 命令 未 找到 错误 。 


1. 从 Maven 模板 创建 一 个 项 目 


在 终端 (* UNIX 或 Mac) 或 命令 提示 符 (Windows) 中 ， 浏 览 到 要 创建 Java mB 
的 文件 夹 。 键 和 以 下 命令 : 


mvn archetype:generate -DgroupId={project-packaging} -DartifactId=: 
这 告诉 Maven 来 从 maven-archetype-quickstart 模板 创建 Java 项 目 。 如 果 忽 视 
archetypeArtifactld 选项 ， 一 个 巨大 的 Maven 模板 列表 将 列 出 。 


例如 ， 这 里 的 工作 目录 是 : C:\worksp， 执 行 命令 过 程 时 间 可 能 比较 久 ， 看 个 人 的 
网 络 状 况 。 





C:\worksp>mvn archetype:generate -DgroupId=com.yiibai -DartifactId- 
or -DarchetypeArtifactId=maven -archetype-quickstart -Dinteractivel 
[INFO] Scanning for projects... 

[INFO] 
ENEO 


[INFO] --------2- 22-2225 25 525 ees snes cee nee cee eee cess eee cece eens. 
[INFO] 

[INFO] >>> maven-archetype-plugin:2.4:generate (default-cli) > gene 
@ standalone-pom >>> 

[INFO] 

[INFO] <<< maven-archetype-plugin:2.4:generate (default-cli) < gene 
@ standalone-pom <<< 

[INFO] 

[INFO] --- maven-archetype-plugin:2.4:generate (default-cli) @ star 
[INFO] Generating project in Batch mode 

[INFO] SS eee eee ee eee ee ee ee ee ee ee ee eee eee ee eee ee. 
[INFO] Using following parameters for creating project from Old (1 
maven-archetype-quickstart:1.0 

NE OI 
[INFO] Parameter: basedir, Value: C:\worksp 

[INFO] Parameter: package, Value: com.yiibai 

[INFO] Parameter: groupId, Value: com. yiibai 

[INFO] Parameter: artifactId, Value: NumberGenerator 

[INFO] Parameter: packageName, Value: com.yiibai 

[INFO] Parameter: version, Value: 1.0-SNAPSHOT 

[INFO] project created from Old (1.x) Archetype in dir: C:\worksp\t 
n 

[INFO] e e 
[INFO] BUILD SUCCESS 

FINEONE 3 
[INFO] Total time: 23.166 s 

[INFO] Finished at: 2015-10-27T11:03:48+08:00 

[INFO] Final Memory: 17M/114M 

[INFO] ---«-------------------.----2-.--.22-.1--9---.]---2---2-2-2-. 





在 上 述 情况 下 ， 一 个 新 的 Java 项 目 命名 “NumberGenerator, 而 整个 项 目的 目录 结 
构 会 自动 创建 


注意 有 少数 用 户 说 mvn archetype:generate 命令 未 能 生成 项 目 结构 。 如 果 您 有 任 
何 类 似 的 问题 ， 不 用 担心 ， 只 需 跳 过 此 步骤 ， 手 动 创建 文件 夹 ， 请 参阅 步骤 2 的 项 
目 结构 。 


2.MavenE x nis 


使 用 mvn archetype:generate + maven-archetype-quickstart 模板 , 以 下 项 目的 目录 
结构 被 创建 。 


NumberGenerator 
| -Src 
| ---main 


[eee ose yiibai 
|---+------- AppTest.java 


很 简单 的 ， 所 有 的 源 代 码 放 在 文件 夹 /src/main/javal, 所 有 的 单元 测试 代码 放 入 


/src/test/java/. 
注意 ， 请 阅读 Maven 标 准 目录 布局 


附加 的 一 个 标准 的 pom.xml 被 生成 。 这 个 POM 文 件 类 似 于 Ant build.xml 文件 ， 它 
描述 了 整个 项 目的 信息 ， 一 切 从 目录 结构 ， 项 目的 插件 ， 项 目 依 赖 ， 如 何 构 建 这 个 
项 目 等 ， 请 阅读 POM 官 方 指 南 


pom.xml 


3. Eclipse IDE 


为 了 使 它 成 为 一 个 Eclipse 项 目 ， 在 终端 进入 到 “NumberGenerator” 项 目 ， 键 入 以 


下 命令 : 
C:\worksp\NumberGenerator>mvn eclipse:eclipse 


[INFO] Using Eclipse Workspace: null 

[INFO] Adding default classpath container: org.eclipse.jdt.launchir 
ER 

[INFO] Not writing settings - defaults suffice 

[INFO] Wrote Eclipse project for "NumberGenerator" to C:\worksp\Nur 
[INFO] 

[INFO] SS 
[INFO] BUILD SUCCESS 

[INFO] ---=---------6- 2-22-25 525 552525 s esses esses es ee eens eee seen. 
[INFO] Total time: 04:47 min 

[INFO] Finished at: 2015-10-27T15:24:48+08:00 

[INFO] Final Memory: 15M/164M 

[INFO] ST 
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执行 以 上 命令 后 ， 它 自动 下 载 更 新 相关 资源 和 配置 信息 (需要 等 待 一 段 时 间 ) , # 
产生 Eclipse IDE 所 要 求 的 所 有 项 目 文 件 。 要 导 和 项目 到 Eclipse IDE 中 ， 选 择 “File 
-> Import... -> General->Existing Projects into Workspace” 


AA: 项 目 导 入 到 Eclipse IDE, 


Ss Java EE - Eclipse 
| File Edit Navigate Search Project Run Window Help 











4 (® src/test/java 
4 骨 comyiibai 


> [f] AppTestjava 





4 (9 src/main/java 
4 H comyiibai 
> [Jj] Appjava 
> BÓ JRE System Library [jdik1.8.0 40] 
4 (E src 
4 ( main 
4 © java 
4 & com 
4 © yiibai 
回 Appjava 
4 © test 
4 [ java 
4 © com 
4 © yiibai 
AppTestjava 
& target 
[m] pom.xml 





4. 更 新 POM 


默认 的 pom.xml 太 简 单 了 ， 很 多 时 候 ， 你 需要 添加 编译 器 插件 来 千 诉 Maven 使 用 
哪个 JDK 版 本 是 用 来 编译 项 目 。 (默认 JDK1.4， 这 的 确 太 | 旧 了 点 ) 
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<plugin> 
«groupId»org.apache.maven.plugins«/groupId-» 
<artifactId>maven-compiler -plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>1.6</source> 
<target>1.6</target> 
</configuration> 
</plugin> 


从 更 新 JUnit 3.8.1 到 最 新 的 4.11, 


<dependency> 
«groupId»junit«/groupId» 
<artifactId>junit</artifactiId> 
<version>4.11</version> 
<scope>test</scope> 
</dependency> 


Maven 坐标 上 面 的 XML 代码 片段 被 称 为 "Maven 坐 标 ”， 如 果 你 需要 JUnit 的 jar, 
你 需要 找 出 其 相应 的 Maven 坐标 。 它 适用 于 所 有 其 他 的 依赖 ， 如 Spring,， 
Hibernate, Apache 普通 的 等 ， 只 要 到 Maven 中 心 储存 库 ， 并 找 出 哪些 是 依赖 正确 
的 Maven 坐标 。pom.xml — 更 新 版 本 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.mkyong</groupId> 
<artifactId>NumberGenerator</artifactId> 
<packaging>jar</packaging> 
<version>1.0-SNAPSHOT</version> 
<name>NumberGenerator</name> 
<url>http://maven.apache.org</url> 
<dependencies> 

<dependency> 
«groupId»junit«/groupId» 
«artifactId»junit«/artifactId» 
<version>4.11</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 


<build> 
<plugins> 
<plugin> 
<groupiId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler -plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>1.6</source> 
<target>1.6</target> 
</configuration> 
</plugin> 
</plugins> 
</build> 


</project> 


在 终端 ， 再 次 发 出 同样 的 命令 mvn eclipse:eclipse ,Maven 将 从 Maven 中 心 储 存 库 
下 载 插件 项 目 依赖 关系 (JUnit) ， 它 会 自动 保存 到 你 的 本 地 仓库 。 


5. 更 新 业务 逻辑 


测试 驱动 开发 (TOD) ， 先 更 新 单元 测试 ， 以 确保 应 用 程序 (APP) 对 象 有 一 个 方 
法 来 生成 包含 恰好 36 位 字母 表 的 唯一 密 钥 。 


AppTest.java 


package com.yiibai; 


import org.junit.Assert; 
import org.junit.Test; 


public class AppTest { 


QTest 
public void testLengthOfTheUniqueKey() { 


App obj - new App(); 
Assert.assertEquals(36, obj.generateUniqueKey().length()); 


RC I 
完成 业务 逻辑 。 


App.java 


package com.yiibai; 
import java.util.UUID; 


Jf eius 


* Generate a unique number 
* 


iA 
public class App 
{ 


public static void main( String[] args ) 


{ 
App obj = new App(); 
System.out.println("Unique ID : " + obj.generateUniqueKey(: 


} 


public String generateUniquekey( ) { 


String id = UUID.randomUUID().toString(); 
return id; 





6. Maven 打包 


现在 ， 我 们 将 使 用 Maven 这 个 项 目 ， 并 输出 编译 成 一 个 "jar 的 文件 。 请 
pom.xml 文件 ， 包 元 素 定义 应 该 包 应 该 输出 什么 。 


W 
dk 


pom.xml 


<project ...> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com. yiibai</groupId> 
<artifactId>NumberGenerator</artifactId> 
<packaging>jar</packaging> 
<version>1.0-SNAPSHOT</version> 


在 终端 输入 mvn package : 


C:\worksp\NumberGenerator> mvn package 


ha-2/classworlds-1.1-alpha-2.jar (37 KB at 20.2 KB/sec) 

Downloaded: [https://repo.maven.apache.org/maven2/org/codehaus/ple> 
Downloaded: [https://repo.maven.apache.org/maven2/org/codehaus/ple> 
Downloaded: [https://repo.maven.apache.org/maven2/org/codehaus/ple> 
Downloaded: [https://repo.maven.apache.org/maven2/org/codehaus/ple> 
[INFO] Building jar: C:\worksp\NumberGenerator\target\NumberGenerat 


[INFO] Total time: 01:00 min 
[INFO] Finished at: 2015-10-27T20:00:17+08:00 
[INFO] Final Memory: 10M/54M 





它 编 译 ， 运 行 单元 测试 并 打包 项 目 成 一 个 jar 文件 ， 并 把 它 放 在 project/target 文件 
夹 。 如 果 出 错 : ERROR: Unable to locate the Javac Compiler in:, C:\Program 
Files (x86)\Java\jre6..\lib\tools.jar,Please ensure you are using JDK 1.4 or 
above and,not a JRE (the com.sun.tools.javac.Main class is required)... 


参考 : http://my.oschina.net/u/1449336/blog/199802 
最 终 项 目的 目录 结构 , 如 下 图 片 : 


[& Project Explorer 33 m | MEI 
4 (= NumberGenerator 
4 (© src/test/java 
4 骨 comyiibai 
四 AppTestjava 
4 [99 src/main/java 
4 出 com yiibai 
4 |J) App.java 
Q App 
BÀ), JRE System Library UavaSE-1.6] 
(ig junit-4.11jar - M2_REPO\junit\junit\4.11 - C:\Users\Administrator\.m2\repository\junit\jur 
m hamcrest-core-1.3 jar - M2_REPO\org\hamcrest\hamcrest-core\1.3 - C:\Users\Administri 
4 ® src 
4 © main 
4 © Java 
4 |© com 
4 © ylibai 
App java 
4 ® test 
4 [ java 
4 [— com 
4 © yiibai 
AppTest.java 
& target 
[v] pom.xml 


7. zn 


从 项 目的 jar 文件 运行 应 用 程序 示例 


C:\worksp\NumberGenerator>java -cp target/NumberGenerator-1.0-SNAP: 


iibai.App 
Unique ID : 94e5fdia-c038-415f -a8ed-7fc58c397369 
C:\worksp\NumberGenerator> 


C:\worksp\NumberGenerator>java -cp target/NumberGenerator-1.0-SNAP: 


iibai.App 
Unique ID : 48df568a-4b4b-4964-b767-664e206ca4b5 


C:\worksp\NumberGenerator>java -cp target/NumberGenerator-1.0-SNAP: 


iibai.App 
Unique ID : 4ac9156c-2e4a-45f4-8644-0707ae28d5a6 


l= — - SSS 


下 载 代 码 
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下 载 代码 - Maven-NumberGenerator.zip 
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使 用 Maven 创 建 Web 点 用 程序 项 目 - Maven 教 程 


在 本 教程 中 ， 我 们 将 演示 如 何 使 用 Maven 创建 一 个 Java Web 项 目 (Spring 
MVC)。 


用 到 的 技术 /工具 : 


. Maven 3.3.3 

. Eclipse 4.3 

JDK 8 

. Spring 4.1.1.RELEASED 
. Tomcat 7 

. Logback 1.0.13 


Ooo0AoN-A 


1. 从 Maven 模 板 创 建 Web 项 目 


您 可 以 通过 使 用 Maven 的 maven-archetype-webapp 模 板 来 创建 一 个 快速 启动 Java 
Web 上 应 用 程序 的 项 目 。 在 终端 (* UNIX 或 Mac) 或 命 命 提 示 符 (Windows) 中 ， 导 航 至 您 
想 要 创建 项 目的 文件 夹 。 


键 人 以 下 命令 : 

$ mvn archetype:generate -DgroupId=com.yiibai -DartifactId=Counter\ 
网 i) 
具体 示例 : 





C:\worksp>mvn archetype:generate -DgroupId=com.yiibai -DartifactIc 
p -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode-f: 
[INFO] Scanning for projects... 

[INFO] 
ENEO 


[INFO] --------2- 22-2225 25 525 ees snes cee nee cee eee cess eee cece eens. 
[INFO] 

[INFO] >>> maven-archetype-plugin:2.4:generate (default-cli) > gene 
@ standalone-pom >>> 

[INFO] 

[INFO] <<< maven-archetype-plugin:2.4:generate (default-cli) < gene 
@ standalone-pom <<< 

[INFO] 

[INFO] --- maven-archetype-plugin:2.4:generate (default-cli) @ star 
[INFO] Generating project in Batch mode 

Downloading: https://repo.maven.apache.org/maven2/org/apache/maven, 
ven-archetype-webapp/1.0/maven-archetype-webapp-1.0.jar 

Downloaded: https://repo.maven.apache.org/maven2/org/apache/maven/: 
en-archetype-webapp/1.0/maven-archetype-webapp-1.0.jar (4 KB at 0.: 
Downloading: https://repo.maven.apache.org/maven2/org/apache/maven, 
ven-archetype-webapp/1.0/maven-archetype-webapp-1.0.pom 

Downloaded: https://repo.maven.apache.org/maven2/org/apache/maven/: 
en-archetype-webapp/1.0/maven-archetype-webapp-1.0.pom (533 B at O 
[INFO] ---------------u eere c eA rare eee eee ee ERR ARI 
[INFO] Using following parameters for creating project from Old (1 
maven-archetype-webapp:1.0 
TO 
[INFO] Parameter: basedir, Value: C:\worksp 

[INFO] Parameter: package, Value: com.yiibai 

[INFO] Parameter: groupId, Value: com. yiibai 

[INFO] Parameter: artifactId, Value: CounterWebApp 

[INFO] Parameter: packageName, Value: com.yiibai 

[INFO] Parameter: version, Value: 1.0-SNAPSHOT 

[INFO] project created from Old (1.x) Archetype in dir: C:\worksp\( 
(WINE ON 
[INFO] BUILD SUCCESS 

[INFO] ----<----2-2-25225 255s ccc cece ee cee eee cece eee c eee ee esas. 
[INFO] Total time: 10:30 min 

[INFO] Finished at: 2015-10-28T20:31:03+08:00 

[INFO] Final Memory: 16M/174M 

[INFO] 2----2--------.-.-.2..-2..-2.2-.2-.22.2.-22.22.2-2.2-.22.2.2-222-.22-2 





新 的 Web 项 目 命名 为 “CounterWebApp”， 以 及 一 些 标 准 的 web 目录 结构 也 会 自动 
创建 。 


2. 项 目 目录 布局 
查看 生成 的 项 目 结构 布局 : 


pom.xml 


resources 
webapp 

| index.jsp 

| WEB - INF 

| | web.xml 





Maven 产生 了 一 些 文件 夹 ， 一 个 部 署 描述 符 web.xml, pom.xml 和 index.jsp. 
注意 ， 请 查看 官方 Maven 标 准 目 录 布 局 指南 来 了 解 更 多 。 


pom.xml 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupiId>com. yiibai</groupId> 
<artifactId>CounterWebApp</artifactId> 
<packaging>war</packaging> 
<version>1.0-SNAPSHOT</version> 
<name>CounterWebApp Maven Webapp</name> 
<url>http://maven.apache.org</url> 
<dependencies> 
<dependency> 
«groupId»junit«/groupId» 
«artifactId»junit«/artifactlId» 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
<build> 
<finalName>CounterWebApp</finalName> 
</build> 
</project> 


web.xml — Servlet 2.3 已 经 比较 旧 , 建议 升级 到 2.5 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app 2 3.dtd" ><web-app><display - name: 


«| = 








index.jsp — 一 个 简单 的 hello world html 页 面 文件 


«html» 

«body» 

<div><div class-"ads-in-post hide if width less 800"> 

«script async srcz"//pagead2.googlesyndication.com/pagead/js/adsbyt 

«!-- 728x90 - After2ndH4 --» 

«ins class-"adsbygoogle hide if width less 800" 
style-"display:inline-block;width:728px;height:90px" 
data-ad-client-"ca-pub-2836379775501347" 
data-ad-slot="3642936086" 
data-ad-region="mkyongregion"></ins> 

<script> 

(adsbygoogle = window.adsbygoogle || []).push({}); 

</script> 

</div></div><h2>Hello World!</h2> 

</body> 

</html> 





3. Eclipse IDE 支持 


要 导 和 这 个 项 目 到 Eclipse 中 ， 需 要 生成 一 些 Eclipse 项 目的 配置 文件 : 
3.1、 在 终端 ， 进 入 到 “CounterWebApp” 文件 夹 中 ， 键 入 以 下 命令 : 


C:\worksp>cd CounterWebApp 

C:\worksp\CounterWebApp>mvn eclipse:eclipse -Dwtpversion=2.0 
[INFO] Scanning for projects... 

Downloading: [https://repo.maven.apache.org/maven2/org/apache/maver 
Downloaded: [https://repo.maven.apache.org/maven2/org/apache/maven, 
Downloading: [https://repo.maven.apache.org/maven2/org/apache/maver 
Downloaded: [https://repo.maven.apache.org/maven2/org/apache/maven, 
[INFO] 
NFO 


[INFO] ----------------.---.2..-.2.22.-.222..-2221-..2-222-..221.-2-.ll2..2-.. 
[INFO] 
[INFO] >>> maven-eclipse-plugin:2.10:eclipse (default-cli) > gener: 
@ CounterwebApp >>> 
[INFO] 

[INFO] <<< maven-eclipse-plugin:2.10:eclipse (default-cli) < gener: 
@ CounterWebApp <<< 
[INFO] 

[INFO] --- maven-eclipse-plugin:2.10:eclipse (default-cli) @ Counte 
[INFO] Adding support for WTP version 2.0. 
[INFO] Using Eclipse Workspace: null 
[INFO] Adding default classpath container: org.eclipse.jdt.launchir 
[INFO] Not writing settings - defaults suffice 
[INFO] Wrote Eclipse project for "CounterWebApp" to C:\worksp\Count 
[INFO] 
[INFO] == 9-2 e ae ne ne ee ee eee eee, 
[INFO] BUILD SUCCESS 
[INFO] --<<---- 45-22-6066 05s eee see ee ee ee ee ee, 
[INFO] Total time: 7.982 s 

[INFO] Finished at: 2015-10-28T20:24:57+08:00 
[INFO] Final Memory: 15M/146M 
[NE 





注意 ， 此 选项 -Dwtpversion=2.0 告诉 Maven 将 项 目 转换 到 Eclipse 的 Web 项 目 
(WAR)， 而 不 是 默认 的 Java 项 目 (JAR)。 为 方便 起 见 ， 以 后 我 们 会 告诉 你 如 何 配置 
pom.xml 中 的 这 个 WTP 选项 。 


3.2 导 人 到 Eclipse IDE - File -> Import... -> General -> Existing Projects into 
workspace. 


图 像 说 明 ; 在 Eclipse 中 ， 如 果 看 到 项 目 顶部 有 地 球 图 标 ， 意 味 着 这 是 一 个 Web 项 
H. 


4. 更 新 POM 


在 Maven 中 ，Web 项 目的 设置 都 通过 这 个 单一 的 pom.xml 文 件 配置 。 


1. 添加 项 目 依 赖 - Spring, logback 和 JUnit 
2. 添加 插件 来 配置 项 目 


阅读 注释 清楚 明了 。 


pom.xml 


«project xmlns-"[http://maven.apache.org/POM/4.0.0] (http://maven.aj 
xmlns:xsi-"[http://www.w3.0rg/2001/XMLSchema-instance](http://v 
xsi:schemaLocation-"[http://maven.apache.org/POM/4.0.0] (http:/, 
<modelVersion>4.0.0</modelVersion> 
<groupId>com. yiibai</groupId> 
<artifactId>CounterWebApp</artifactid> 
<packaging>war</packaging> 
<version>1.0-SNAPSHOT</version> 
<name>CounterWebApp Maven Webapp</name> 
<url>[http://maven.apache.org</url>](http://maven. apache. org%3( 

<jdk.version>1.7</jdk.version> 

<spring.version>4.1.1.RELEASE</spring.version> 

<jstl.version>1.2</jstl.version> 

<junit.version>4.11</junit.version> 

<logback.version>1.0.13</logback.version> 

<jcl-over-slf4j.version>1.7.5</jcl-over-slf4j.version> 
</properties> 


<dependencies> 
<!-- Unit Test --> 
<dependency> 
«groupId»junit«/groupId» 
«artifactId»junit«/artifactlId» 
<version>${junit.version}</version> 
</dependency> 


<!-- Spring Core --> 
<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-core</artifactId> 
<version>${spring.version}</version> 
<exclusions> 
<exclusion> 
<groupiId>commons- logging</groupId> 
<artifactId>commons-logging</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 


<dependency> 
«groupId»org.slf4j«/groupId» 
<artifactIid>jcl-over-slf4j</artifactId> 
<version>${jcl-over-slf4j.version}</version> 

</dependency> 

<dependency> 


<groupid>ch. qos. logback</groupId> 

<artifactId>logback-classic</artifactId> 

<version>${logback.version}</version> 
</dependency> 


<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-web</artifactid> 
<version>${spring.version}</version> 
</dependency> 


<dependency> 
«groupId»org.springframework«/groupId» 
«artifactId»spring-webmvc«/artifactlId» 
<version>${spring.version}</version> 

</dependency> 

<!-- jstl --> 

<dependency> 
«groupId»jstl«/groupId» 
«artifactId»jstl«/artifactId» 
<version>${jstl.version}</version> 

</dependency> 

</dependencies> 


<build> 
<finalName>CounterWebApp</finalName> 


<plugins> 
<!-- Eclipse project --> 
<plugin> 
<groupiId>org.apache.maven.plugins</groupId> 
<artifactId>maven-eclipse-plugin</artifactId> 
<version>2.9</version> 
<configuration> 
<!-- Always download and attach dependencies s« 
<downloadSources>true</downloadSources> 
<downloadJavadocs>false</downloadJavadocs> 
<!-- Avoid type mvn eclipse:eclipse -Dwtpversion=2 
<wtpversion>2.0</wtpversion> 
</configuration> 
</plugin> 


<!-- Set JDK Compiler Level --> 
<plugin> 
<groupid>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler -plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>${jdk.version}</source> 
<target>${jdk.version}</target> 
</configuration> 
</plugin> 


<!-- For Maven Tomcat Plugin --> 
<plugin> 
<grouplId>org.apache. tomcat .maven</groupId> 
<artifactId>tomcat7-maven-plugin</artifactId> 
<version>2.2</version> 
<configuration> 
<path>/CounterWebApp</path> 
</configuration> 
</plugin> 
</plugins> 
</build> 
</project> 


2 |: 





注意 ， 为 方便 起 见 ， 声 明 maven-eclipse-plugin， 并 配置 wtpversion 来 避免 输入 参 
数 -Dwtpversion=2.0。 现 在 ， 每 次 使 用 mvn eclipse:eclipse, Maven iaz 4 xi H Se 
人 转换 为 Eclipse Web 项目。 


# 之 前 
mvn eclipse:eclipse --> Eclipse Java project (JAR) 
mvn eclipse:eclipse -Dwtpversion=2.0 --> Eclipse Java web project | 


# 之 后 
mvn eclipse:eclipse --> Eclipse Java web project (WAR) 


| 


5. 更 新 源 代 码 


在 这 一 步 中 ， 在 上 一 步 配 置 完 pom.xml 后 ， 重 新 执行 mvn eclipse:eclipse 这 个 命 
令 ， 我 们 将 创建 Spring MVC 的 一 些 文件 和 Ilogback 日 志 框 架 的 文件 夹 ， 最 终 的 项 目 
结构 如 下 所 示 : 





| pom. xml 


com 

| yiibai 

lll controller 

e tena BaseController.java 

resources 

logback. xml 

webapp 

WEB- INF 

mvc-dispatcher-servlet. xml 


| 

局 

| | pages 
x 

dl 








| index.jsp 
web. xml 


注意 ， 如 果 它 不 存在 ， 需 要 手动 创建 文件 夹 。 
5.1 创建 Spring MVC 的 控制 器 类 。 


/src/main/java/com/yiibai/controller/BaseController.java 


package com.yiibai.controller; 


import org.slf4j.LoggerFactory; 

import org.springframework.stereotype.Controller; 

import org.springframework.ui.ModelMap; 

import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 


@Controller 
public class BaseController { 


private static int counter = 0; 

private static final String VIEW_INDEX = "index"; 

private final static org.slf4j.Logger logger = LoggerFactory. ge 
@RequestMapping(value = "/", method = RequestMethod.GET) 
public String welcome(ModelMap model) { 


model.addAttribute("message", "Welcome"); 
model.addAttribute("counter", ++counter); 
logger.debug("[welcome] counter : {}", counter); 


// Spring uses InternalResourceViewResolver and return bacl 
return VIEW INDEX; 


j 


@RequestMapping(value = "/{name}", method = RequestMethod.GET) 
public String welcomeName(@PathVariable String name, ModelMap r 


model.addAttribute("message", "Welcome " + name); 
model.addAttribute("counter", ++counter); 
logger.debug("[welcomeName] counter : {}", counter); 
return VIEW_INDEX; 





5.2 创建 Spring 配置 文件 。 


/src/main/webapp/WEB-INF/mvc-dispatcher-servlet.xml 


«beans xmlns="[http://www.springframework.org/schema/beans ]|(http:/, 
xmlns:context="[http://www.springframework.org/schema/context ] | 
xmlns:xsi-"[http://www.w3.0rg/2001/XMLSchema-instance](http://v 
xsi:schemaLocation-z" 

[http://www.springframework.org/schema/beans] (http://www. sł 
[http://www.springframework.org/schema/beans/spring-beans.» 
[http://www.springframework.org/schema/context/spring-contt: 


«context:component-scan base-package="com.yiibai.controller" /: 
«bean 
class-"org.springframework.web.servlet.view.InternalResour« 
«property name="prefix"> 
<value>/WEB- INF/pages/</value> 
</property> 
«property name="Suffix"> 
<value>.jsp</value> 
</property> 
</bean> 


</beans> 
El 0 EE 


5.3 更 新 让 现 有 的 web.xml 支持 Servlet 2.5( 默 认 的 Servlet2.3 KIAT), 并 且 还 通 
过 Spring 监听 器 ContextLoaderListener 集成 了 Spring 框架 。 





/src/main/webapp/WEB-INF/web.xml 


«web-app xmlns="[http://java.sun.com/xml/ns/javaee](http://java. sur 
xmlns:xsi-"[http://www.w3.0rg/2001/XMLSchema-instance](htt[ 
xsi:schemaLocation-"[http://java.sun.com/xm1/ns/javaee](http:/, 
[http://java.sun.com/xm1/ns/javaee/web-app 2 5.xsd](http 
version="2.5"> 


<display-name>Counter Web Application</display-name> 


<servlet> 
<servlet -name>mvc -dispatcher</servlet -name> 
<servlet-class> 
org.springframework.web.servlet.Dispatcher: 
</servlet-class> 
<load-on-startup>1</load-on-startup> 
</servlet> 


<servlet -mapping> 
<servlet -name>mvc -dispatcher</servlet -name> 
<url-pattern>/</url-pattern> 

</servlet -mapping> 


<context -param> 
<param-name>contextConfigLocation</param-name> 
<param-value>/WEB-INF/mvc-dispatcher-servlet.xml</param-va- 
</context -param> 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderLi: 
</listener-class> 
</listener> 
</web-app> 





5.4 移动 文件 index.jsp 到 WEB-INF/pages 目录 下 ， 为 了 保护 直接 访问 。 并 更 新 内 


shy 


= 
/src/main/webapp/WEB-INF/pages/index.jsp 
5.5 在 资源 文件 夹 (resources) 中 创建 logback.xml 文件 


/src/main/resources/logback.xml 


<?xml version="1.0" encoding="UTF-8"?> 


6. Eclipse + Tomcat 


在 第 5 步 中 创建 所 有 文件 以 后 ， 这 里 有 一 些 方法 可 以 用 来 部 署 和 测试 Web 项 目 ， 我 
们 这 里 推荐 使 用 6.2 中 的 方法 。 


6.1 要 编译 ， 测 试 和 项 目 打包 成 一 个 WAR 文 件 ， 输 入 : 


mvn package 


一 个 新 的 WAR 文件 将 在 project/target/CounterWebApp.war 产 生 ， 只 需 复制 并 部 
署 到 Tomcat 发 布 的 目录 。 


6.2 如 果 想 通过 Eclipse 服务 器 这 个 项 目 插件 (Tomcat 或 其 它 容器 ) 调 试 ， 这 里 再 输 
A 


mvn eclipse:eclipse 


如 果 一 切 顺利 ， 该 项 目的 依赖 将 被 装配 附加 到 Web 部 署 项 目 。 图 片 : 右键 点 击 
project -> Properties -> Deployment Assembly 


6.3 Maven 的 Tomcat 插件 声明 (加 入 到 pom.xml) : 


pom.xml 


<!-- For Maven Tomcat Plugin --> 


BE AER ép (5 8 9I 28 BN hy FS S8 412-92) : 


mvn tomcat:run 
tp://logback.qos.ch/codes.html#layoutInsteadOfEncoder for details 
20:37:32,089 |-INFO in ch.qos.logback.classic.joran.action.LoggerA 
g level of logger [com.yiibai.controller] to DEBUG 

20:37:32,089 |-INFO in ch.qos.logback.classic.joran.action.LoggerA 
g additivity of logger [com.yiibai.controller] to false 
20:37:32,090 |-INFO in ch.qos.logback.core.joran.action.AppenderRe! 
ching appender named [STDOUT] to Logger[com.yiibai.controller] 

20:37:32,090 |-INFO in ch.qos.logback.classic.joran.action.RootLogt 
tting level of ROOT logger to ERROR 

20:37:32,090 |-INFO in ch.qos.logback.core.joran.action.AppenderRe! 

ching appender named [STDOUT] to Logger[ROOT] 

20:37:32,090 |-INFO in ch.qos.logback.classic.joran.action.Configu!: 
End of configuration. 

20:37:32,091 |-INFO in [ch.qos.logback.classic.joran. JoranConfiguré 


+A 28, 2015 20:37:32 FF org.apache.catalina.core.ApplicationCont 


信息 : Initializing Spring root WebApplicationContext 
CH 28, 2015 20:37:33 FF org.apache.catalina.core.ApplicationCont 
信息 : Initializing Spring FrameworkServlet 'mvc-dispatcher' 

+A 28, 2015 20:37:33 FF org.apache.coyote.httpi1.HttpiiProtocol 
信息 : Initializing Coyote HTTP/1.1 on http-8080 

CH 28, 2015 20:37:33 FF org.apache.coyote.httpi1.HttpiiProtocol 
信息 : Starting Coyote HTTP/1.1 on http-8080 





m 
这 将 启动 Tomcat， 部 署 项 目 默认 在 端口 8080。 


出 错 : Maven 项 目下 update maven 后 Eclipse 报错 : 
java.lang.ClassNotFoundException: ContextLoaderL 


解决 方案 : 
1. 右 键 点 击 项 目 -- 选 择 Properties 


选择 Deployment Assembly ,在 右边 点 击 Add 按 妞 ， 在 弹出 的 窗口 中 选择 Java Build 
Path Entries 


2. 点 击 Next， 选 择 Maven Dependencies 


3. 点 击 Finish， 然 后 可 以 看 到 已 经 把 Maven Dependencies 添 加 到 Web 应 用 结构 中 
了 


操作 完 后 ， 重 新 部 署 工程 ， 不 再 报错 了 。 然 后 我 们 再 

到 .metadata.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps\ 目 录 下 ， 发 现 
工程 WEB-INF 目 录 下 自动 生成 了 lib 目 录 ， 并 且 所 有 的 依赖 jar 包 也 都 已 经 部 署 进来 。 
问题 因此 解决 。 


Maven 外 部 依赖 - Maven 教 程 


现在 ， 你 也 知道 Maven 做 依赖 管理 使 用 Maven 仓 库 的 概念 。 但 是 ， 如 果 依 赖 是 不 提 
供 任何 远程 存储 库 和 中 央 存 储 库 发 生 了 什么 ? Maven 提 供 为 使 用 外 部 依赖 的 概念 ， 
应 用 在 这 样 的 场景 。 


举 一 个 例子 ， 让 我 们 做 以 下 修改 项 在 目 Maven 创 建 项 目 这 一 章节 中 创建 。 
e. 添加 lib 文 件 夹 到 src 文 件 夹 

e 复制 任何 的 jar 到 lib 文 件 夹 。 我 们 使 用 ldapjdk.jar， 这 是 LDAP 操 作 的 辅助 库 。 
现在 我 们 的 项 目 结构 看 起 来 应 该 像 下 面 的 : 


4 这 consumerBanking 
(& settings 
4 (z» src 
4 & lib 
i| Idapjdk.jar 
(= main 
& test 
(& target 
X| .classpath 
X)| .project 


M 
Mj pommi Yij Dai, com 


在 这 里 ， 有 自己 的 特定 项 目 ， 这 是 很 平常 案例 库 ， 它 可 以 包含 jar 文 件 可 能 无 法 在 任 
何 Maven 存 储 库 ， 那 么 需要 下 载 。 如 果 代 码 使 用 这 个 Maven 库 ， 那 么 Maven 构 建 将 
失败 ， 因 为 它 无 法 下 载 或 在 编译 阶段 是 指 这 个 库 。 


要 义理 这 种 情况 ， 让 我 们 来 添加 这 个 外 部 依赖 项 中 使 用 下 列 方式 到 Maven 的 


pom.xml。 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupiId>com. companyname. bank</groupId> 
<artifactId>consumerBanking</artifactId> 
<packaging>jar</packaging> 
<version>1.0-SNAPSHOT</version> 
<name>consumer Banking</name> 
<url>http://maven.apache.org</url> 


<dependencies> 
<dependency> 
«groupId»junit«/groupId» 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 


<dependency> 
«groupId»ldapjdk«/groupId» 
<artifactId>ldapjdk</artifactId> 
<scope>system</scope> 
<version>1.0</version> 
<systemPath>${basedir}srclibldapjdk.jar</systemPath> 

</dependency> 

</dependencies> 


</project> 


先 看 下 依赖 性 在 上 面 的 例子 ， 清 除 下 列 有 关外 部 相关 的 关键 概念 第 二 dependency 


元 素 。 


e 外 部 依赖 (jar firi) 可 以 在 pom.xml 中 以 同 祥 的 方式 与 其 他 依赖 关系 进行 配 


置 。 
e 指定 的 groupld 一 样 的 库 名 称 。 
。 指定 artifactld 的 相同 库 的 名 称 。 
。 指定 范围 的 系统 。 
e. 指定 相 系统 项 目的 位 置 
望 现在 你 清楚 了 解 外 部 依赖 ， 能 够 指定 在 Maven 项 目的 外 部 依赖 。 


Maven 项 目 文档 - Maven 教 程 


本 教程 将 教 你 如 何 一 步 到 位 创建 应 用 程序 的 文档 。 因 此 ， 让 我 们 开始 ， 到 C:/MVN 
创建 java 应 用 程序 consumerBanking。 OpenconsumerBanking 文 件 夹 ， 然 后 执行 
以 下 命 全 mvn 命 合 。 


C:MVN>mvn site 
Maven 将 开始 构建 该 项 目 。 


[INFO] Scanning for projects... 


[INFO] -----------------------------------------------------------:' 
[INFO] Building consumerBanking 

[INFO] task-segment: [site] 

[INFO] ------------------------------------------------------------ 


[INFO] [site:site (execution: default-site}] 

[INFO] artifact org.apache.maven.skins:maven-default-skin: 

checking for updates from central 

[INFO] Generating "About" report. 

[INFO] Generating "Issue Tracking" report. 

[INFO] Generating "Project Team" report. 

[INFO] Generating "Dependencies" report. 

[INFO] Generating "Continuous Integration" report. 

[INFO] Generating "Source Repository" report. 

[INFO] Generating "Project License" report. 

[INFO] Generating "Mailing Lists" report. 

[INFO] Generating "Plugin Management" report. 

[INFO] Generating "Project Summary" report. 

[INFO] ---2-----.--.-------2.2.-2..-2.2-2.2-2.222.22.22.2-2.2-..2-2-.2-222-..2-2. 
[INFO] BUILD SUCCESSFUL 

[INFO] ---------- 22-2252 255252 eee sees c ee eee cee see cess ee eee cece eees. 
[INFO] Total time: 16 seconds 

[INFO] Finished at: Wed Jul 11 18:11:18 IST 2012 

[INFO] Final Memory: 23M/148M 

[INFO] ------2 222222525 e os cece cee sce ec eee ee cee cee eee eee cece eens. 





就 是 这 样 。 你 的 项 目 文件 已 准备 就 绪 。 Maven 有 目标 目录 中 创建 一 个 网 站 。 


TutorialsPoint Java 1x AAAS 


4 | Computer 
4 &, Windows (C:) 
4 |: MVN 
4 |. consumerBanking 
4e. settings 
b d src 
4 出 target 
> |) classes 
d maven-archiver 
de 
E css 
> |. images 
4. surefire-reports 
> J) test-classes 


> 


Name 


D css 

> images 

|_| dependencies.html 

| | index.html 

|_| integration.html 

|. | issue-tracking.html 

|. | license.html 

|. mail-lists.html 

|_| plugin-management.html 
|_| project-info.html 

|_| project-summary.html 


|_| source-repository.html 








team-list.htral.., o 
= jilosi COW 


打开 C:MVNconsumerBanking argetsite 文件 夹 。 点 击 index.htmll 看 到 文档 。 


consumerBanking 


Last Published: 2012-07-15 


Project Documentation 


© Project Information 


Project Summary 





Project Information 


pon 
Source Repasite 
UN Dy “Re Name 
maven Descnption 
Homepage 


Project Organization 


This project does not belong to an organization. 


Build Information 


Groupid 
Artifactid 
Version 
Type 


Maven 会 使 用 称 为 Doxia 一 个 文件 处 理 引 擎 ， 


析 编 写 内 容 。 





areurer Bankin 


consumerBanking 


http://maven.apeche.org w% 


com.companyname.bank 
consumerBanking 
1.0-SNAPSHOT 

jar 


它 会 读 取 多 个 源 格式 转换 为 通用 文档 
模型 的 文档 。 要 编写 你 的 项 目 文档 ， 可 以 在 以 下 几 个 常用 的 格式 ， 这 是 由 Doxia 解 


NO 


TutorialsPoint Java 技术 教程 


格式 名 


FML 


XHTML 


A Plain Text 
document format 


A Maven 1.x 
documentation 
format 


Used for FAQ 
documents 


Extensible HTML 


Maven 项 目 文 档 - Maven 教 程 


参考 


http://maven.apache.org/doxia/format.htmll 


http://jakarta.apache.org/site/jakarta- 
site2.htmll 


http://maven.apache.org/doxia/references/fml- 
format.htmll 


http://en.wikipedia.org/wiki/XHTML 
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Maven 项 目 模板 - Maven 教 程 


Maven 提 供用 户 ， 使 用 原型 的 概念 ， 不 同类 型 的 项 目 模板 (以 数字 614) 是 一 个 非 
常 大 的 列表 。 Maven 帮 助 用 户 快 速 开 始 使 用 以 下 命令 创建 新 的 Java 项 目 


mvn archetype:generate 


FLERE ? 


原型 是 一 个 Maven 插 件 ， 其 任务 是 创建 一 个 项 目 结构 按照 其 模板 。 我 们 将 使 用 快速 
启动 原型 插件 在 这 里 创建 一 个 简单 的 Java 应 用 程序 。 


使 用 项 目 模板 
让 我 们 打开 命令 控制 台 ， 进 入 到 C : > MVN 目 录 ， 然 后 执行 以 下 命令 mvn 命 兮 


C:MVN>mvn archetype:generate 


Maven 会 开始 处 理 ， 并 会 要 求 选 择 所 需 的 原型 


INFO] Scanning for projects... 

[INFO] Searching repository for plugin with prefix: 'archetype'. 
[INFO] == 99-2 ane ee ee eee, 
[INFO] Building Maven Default Project 

[INFO] task-segment: [archetype:generate] (aggregator-style) 
[INFO] 3 2-62-22 eee eee ee ee ee ee eee eee, 
[INFO] Preparing archetype:generate 


600: remote -> org.trailsframework:trails-archetype (-) 

601: remote -> org.trailsframework:trails-secure-archetype (-) 

602: remote -» org.tynamo:tynamo-archetype (-) 

603: remote -» org.wicketstuff.scala:wicket-scala-archetype (-) 
604: remote -» org.wicketstuff.scala:wicketstuff-scala-archetype 
Basic setup for a project that combines Scala and Wicket, 

depending on the Wicket-Scala project. 

Includes an example Specs test.) 

605: remote -» org.wikbook:wikbook.archetype (-) 

606: remote -» org.xaloon.archetype:xaloon-archetype-wicket-jpa-gl: 
607: remote -> org.xaloon.archetype:xaloon-archetype-wicket-jpa-sp! 
608: remote -» org.xwiki.commons:xwiki-commons-component-archetype 
(Make it easy to create a maven project for creating XWiki Componer 
609: remote -» org.xwiki.rendering:xwiki-rendering-archetype-macro 
(Make it easy to create a maven project for creating XWiki Renderir 
610: remote -» org.zkoss:zk-archetype-component (The ZK Component : 
611: remote -> org.zkoss:zk-archetype-webapp (The ZK wepapp archet\ 
612: remote -» ru.circumflex:circumflex-archetype (-) 

613: remote -> se.vgregion.javg.maven.archetypes:javg-minimal-arch: 
614: remote -> sk.seges.sesam:sesam-annotation-archetype (-) 
Choose a number or apply filter 

(format: [groupId: JartifactId, case sensitive contains): 203: 


按 Enter 键 选择 默认 选项 (203 : Maven 原 型 - 快速 入 门 ) 
Maven 会 要 求 原型 的 特定 版 本 





Choose org.apache.maven.archetypes:maven-archetype-quickstart vers: 
1: 1.0-alpha-1 

2: 1.0-alpha-2 

3: 1.0-alpha-3 

4: 1.0-alpha-4 
SO 

oie digdl 

Choose a number: 6: 


着 
按 Enter 键 选择 默认 选项 (6 : Maven 原 型 - 快速 入 门 : 1.1) 


Maven 会 要 求 项 目的 细节 。 输 入 项 目 细节 的 要 求 。 按 回 车 ， 如 果 提 供 的 默认 值 。 您 
可 以 通过 输入 自己 的 值 履 盖 它 们 。 





Define value for property 'groupId': : com.companyname. insurance 
Define value for property ‘artifactId': : health 

Define value for property 'version': 1.0-SNAPSHOT: 

Define value for property 'package': com.companyname.insurance: 


Maven 会 要 求 项 目的 细节 确认 。 按 回 车 键 或 按 Y 


Confirm properties configuration: 
groupId: com.companyname. insurance 
artifactId: health 

version: 1.0-SNAPSHOT 

package: com.companyname. insurance 
ME 


现在 ，Maven 将 开始 创建 项 目 结构 ， 并 会 显示 如 下 内 容 : 


[INFO] -----------------------------------------------------------， 
[INFO] Using following parameters for creating project 

from Old (1.x) Archetype: maven-archetype-quickstart:1.1 

[INFO] -----------------------------------------------------------: 
[INFO] Parameter: groupId, Value: com.companyname. insurance 

[INFO] Parameter: packageName, Value: com.companyname. insurance 
[INFO] Parameter: package, Value: com.companyname. insurance 

[INFO] Parameter: artifactId, Value: health 

[INFO] Parameter: basedir, Value: C:MVN 

[INFO] Parameter: version, Value: 1.0-SNAPSHOT 

[INFO] project created from Old (1.x) Archetype in dir: C:MVNhealtt 
[INFO] -----------------------------------------------------------: 
[INFO] BUILD SUCCESSFUL 

[INFO] -----------------------------------------------------------， 
[INFO] Total time: 4 minutes 12 seconds 

[INFO] Finished at: Fri Jul 13 11:10:12 IST 2012 

[INFO] Final Memory: 20M/90M 

[INFO] -----------------------------------------------------------. 





创建 项 目 


现在 转 到 C : > MVN 目 录 。 会 看 到 一 个 java 应 用 程序 项 目 创建 了 这 是 在 创建 项 目 时 
给 出 artifactld 命名 为 : health, Maven 将 创建 一 个 标准 的 目录 布局 如 下 图 所 示 的 
mA: 


= Name 


Js src 


Lj pom.xml 


i Computer 
ü& Windows (C:) 
E MVN 
|) health 
Js src 
|) main 
4 java 
|» com 
J|» companyname 
i insurance 
Jp test 
|) java 
J| com 
J|» companyname 


J|) insurance jilosi eorn 


432M pom.xml 
Maven 生 成 如 下 所 列 项 目 中 的 pom.xml 文件 : 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation-"'http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.companyname. Insurance</groupId> 
<artifactId>health</artifactId> 
<version>1.0-SNAPSHOT</version> 
<packaging>jar</packaging> 
<name>health</name> 
<url>http://maven.apache.org</url> 
<properties> 

<project. build.sourceEncoding>UTF-8</project.build.sourceEnc<¢ 
</properties> 
<dependencies> 
<dependency> 
«groupId»junit«/groupId» 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
</project> 


Er SSS SSS ee 





创建 App.java 


Maven 示例 生成 Java 源 文件 ，App.java 下 面 列 出 项 目 : 


位 置 : C: > MVN > health > src > main > java > com > companyname > 
insurance > App.java 


package com.companyname.insurance; 


ys * 
* Hello world! 
a 
public class App 
{ 
public static void main( String[] args ) 
{ 
System.out.println( "Hello World!" ); 
j 
j 
创建 AppTest.java 


Maven 的 样本 生成 Java 源 测试 文件 ，AppTest.java 下 面 列 出 的 项 目 : 


位 置 : C: > MVN > health > src > test > java > com > companyname > 
insurance > AppTest.java 


package com.companyname. insurance; 


import junit.framework.Test; 
import junit.framework.TestCase; 
import junit.framework.TestSuite; 


Ce 
* Unit test for simple App. 
2 
public class AppTest 
extends TestCase 


{ 
[rare 


* Create the test case 
* 


* (param testName name of the test case 
y 

public AppTest( String testName ) 

{ 


} 


JE 
* @return the suite of tests being tested 
S 

public static Test suite() 


{ 


j 


VERSER 
* Rigourous Test :-) 
A 
public void testApp() 
i 


} 


super( testName ); 


return new TestSuite( AppTest.class ); 


assertTrue( true ); 


就 是 这 样 。 现 在 可 以 看 到 Maven 的 功能 。 您 可 以 创建 任何 类 型 ， 使 用 maven 单一 
命令 的 项 目 并 启动 开发 。 


Maven 快 照 - Maven 教 程 


大 型 应 用 软件 一 般 由 多 个 模块 ， 它 是 多 个 团队 正在 开发 同一 个 应 用 程序 的 不 同 模块 
， 其 中 常见 的 场景 。 例 如 ， 考 虑 一 个 团队 正在 对 应 用 程序 的 应 用 程序 ， 用 户 界 面 项 
El (app-ui.jar:1.0) 的 前 端 和 他 们 正在 使 用 的 数据 服务 计划 (data-service.jar:1.0). 


现在 ， 它 可 能 发 生 ， 团 队 工 作 的 数据 服务 正在 发 生 快速 的 步伐 bug 修 复 或 增强 功能 
和 它们 释放 出 库 到 远程 仓库 几乎 每 隅 一 天 。 


现在 ， 如 果 数 据 服务 团队 上 传 新 版 本 隔日 然后 会 出 现下 面 的 问题 


e 数据 服务 的 团队 应 该 每 次 都 告诉 应 用 程序 UI 的 团队 时 ， 他 们 已 经 发 布 了 更 新 后 
的 代码 。 


e UI 团队 需要 经 常 更 新 自己 的 pom.xml 中 获得 更 新 的 版 本 的 应 用 程序 。 
为 了 处 理 这 类 情况 ， 快 照 的 概念 开始 发 挥 作用 。 


什么 是 快照 ? 


快照 是 一 个 特殊 版 本 ， 指 出 目前 开发 复印 件 。 不 同 于 常规 版 本 ，Maven 的 检查 新 的 
快照 版 本 中 ， 每 生成 一 个 远程 存储 库 。 


现在 ， 数 据 服务 团队 将 公布 更 新 后 的 代码 每 次 的 快照 存储 库 说 ， 数 据 服务 :1.0- 
SNAPSHOT 蔡 换 一 个 旧 的 SNAPSHOT jar. 


快照 与 版 本 


如 遇 版 本 的 ， 如 果 一 旦 Maven 的 下 载 所 提 到 的 版 本 为 ，data-service:1.0， 它 永远 不 
会 党 斌 下载 更 新 1.0 可 在 库 中 。 要 下 载 更 新 的 代码 ， 数 据 服务 版 本 升级 到 1.1。 


Maven 会 自动 获取 最 新 的 快照 (data-service:1.0-SNAPSHOT) 每 次 应 用 程序 UI 团 
队 建 立 自 己 的 项 目 。 


app-ui pom.xml 


app-ui 项 目 使 用 数据 服务 的 1.0-SNAPSHOT 


<project xmlns="http://maven.apache.org/POM/4.0.0" 


xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»app-uic/groupId» 
<artifactId>app-ui</artifactId> 
<version>1.0</version> 
<packaging>jar</packaging> 
<name>health</name> 
<url>http://maven.apache.org</url> 
<properties> 
<project. build.sourceEncoding>UTF-8</project.build.sourceEnc<c 
</properties> 
<dependencies> 
<dependency> 
<groupiId>data-service</groupId> 
<artifactId>data-service</artifactId> 
<version>1.0-SNAPSHOT</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 


</project> 


大 Er 天 





data-service pom.xml 


数据 服务 项 目 释放 1.0 快 照 对 于 每 一 个 微小 的 变化 


‘| 


<project xmlns="http://maven.apache.org/POM/4.0.0" 


xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation-"'http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
<modelVersion>4.0.0</modelVersion> 
«groupId»data-service«c/groupId» 
<artifactId>data-service</artifactId> 
<version>1.0-SNAPSHOT</version> 
<packaging>jar</packaging> 
<name>health</name> 
<url>http://maven.apache.org</url> 
<properties> 

<project. build.sourceEncoding>UTF-8</project.build.sourceEnc¢ 
</properties> 
</project> 











虽然 ， 如 快照 ，Maven 自 动 获 取 上 每 天 最 新 的 快照 。 您 可 以 强制 使 用 -U 切 换 到 任何 
maven 命 令 来 下 载 最 新 的 快照 版 本 。 


mvn clean package -U 


让 我 们 打开 命令 控制 台 ， 进 入 到 C: > MVN > app-ui 目录 ， 然 后 执行 以 下 命令 mvn 


fp. 
C:MVNapp-ui»mvn clean package -U 


Maven 会 下 载 数据 服务 的 最 新 快照 后 开始 构建 该 项 目 。 


[INFO] Scanning for projects... 

INEO 22525 s ccc cece ee cee cee cee ee eee cece eee eens. 
[INFO] Building consumerBanking 

[ INFO] task-segment: [clean, package] 
ENEO 
[INFO] Downloading data-service:1.0-SNAPSHOT 

[INFO] 290K downloaded. 

[INFO] [clean:clean (execution: default-cleanj] 

[INFO] Deleting directory C:MVNapp-ui arget 

[INFO] [resources:resources (execution: default-resources} ] 
[WARNING] Using platform encoding (Cp1252 actually) to copy filter: 
i.e. build is platform dependent! 

[INFO] skip non existing resourceDirectory C:MVNapp-uisrcmain 
resources 

[INFO] [compiler:compile (execution: default-compile)] 

[INFO] Compiling 1 source file to C:MVNapp-ui argetclasses 
[INFO] [resources:testResources (execution: default-testResources}. 
[WARNING] Using platform encoding (Cp1252 actually) to copy filter: 
i.e. build is platform dependent! 

[INFO] skip non existing resourceDirectory C:MVNapp-uisrc est 
resources 

[INFO] [compiler:testCompile (execution: default-testCompile} ] 
[INFO] Compiling 1 source file to C:MVNapp-ui arget est-clas: 
[INFO] [surefire:test (execution: default-test)] 

[INFO] Surefire report directory: C:MVNapp-ui arget 
surefire-reports 


Running com.companyname.bank.AppTest 
Tests run: 1, Failures: 0, Errors: ©, Skipped: ©, Time elapsed: 0.( 


Results 
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


[INFO] [jar:jar {execution: default-jar}] 

[INFO] Building jar: C:MVNapp-ui arget 

app-ui-1.0-SNAPSHOT. jar 

[ENEON Lem. 
[INFO] BUILD SUCCESSFUL 

[INFO] ---------------.--elere elec LA e eer ree ee Ile ere I nme 
[INFO] Total time: 2 seconds 

[INFO] Finished at: Tue Jul 10 16:52:18 IST 2012 

[INFO] Final Memory: 16M/89M 

[INFO] ET 





Maven 构 建 自动 化 -Hudson - Maven 教 程 


建立 自动 化 定义 场景 ， 依 赖 项 目 建 设 过程 中 被 启动 ， 一 旦 项 目 生成 成 功 完成 ， 以 确 
保 相 关 的 项 目 是 稳定 的 。 


实例 


考虑 一 个 团队 正在 开发 一 个 项 目 总 线 核心 API 上 的 其 他 两 个 项 目的 应 用 程序 ， 网 页 
Ul 和 应 用 程序 的 桌面 UI 的 依赖 。 


app-web-ui 项 目 使 用 1.0-SNAPSHOT 总 线 核心 API 项 目 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema- instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupiId>app -web-ui</groupId> 
<artifactId>app-web-ui</artifactId> 
<version>1.0</version> 
<packaging>jar</packaging> 
<dependencies> 

<dependency> 
<groupiId>bus-core-api</groupId> 
<artifactId>bus-core-api</artifactId> 
<version>1.0-SNAPSHOT</version> 
</dependency> 
</dependencies> 
</project> 


app-desktop-ui 项 目 使 用 总 线 核 心 API 项 目的 1.0-SNAPSHOT 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»app-desktop-uic/groupId» 
<artifactId>app-desktop-ui</artifactId> 
<version>1.0</version> 
<packaging>jar</packaging> 
<dependencies> 

<dependency> 
<groupiId>bus-core-api</groupId> 
<artifactId>bus-core-api</artifactId> 
<version>1.0-SNAPSHOT</version> 
</dependency> 
</dependencies> 
</project> 


bus-core-api 项 目 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»bus-core-api«c/groupId» 
<artifactId>bus-core-api</artifactId> 
<version>1.0-SNAPSHOT</version> 
<packaging>jar</packaging> 

</project> 


现在 ，app-web-ui 和 app-desktop-ui 项 目 团队 需要 自己 编译 过 程 应 该 揭 开 序幕 ， 每 
当 bus-core-api 项 目的 变化 。 


使 用 快照 确保 应 使 用 最 新 的 bus-core-api 项 目 ， 但 要 满足 上 面 我 们 需要 做 一 些 额外 
的 要 求 。 


e. 添加 一 个 生成 后 的 目标 bus-core-api POM 的 点 用 程序 app-web-ui 和 app- 
desktop-ui 的 基础 之 上 。 


e 使 用 持续 集成 (Cl) 的 服务 器 像 哈 德 森 自 动 管理 构建 自动 化 。 


使 用 Maven 


更 新 总 线 核心 APIl 项 目 pom.xml 


«project xmlns="http://maven.apache.org/POM/4.0.0" 


xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 


http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»bus-core-api«c/groupId» 
<artifactId>bus-core-api</artifactId> 
<version>1.0-SNAPSHOT</version> 
<packaging>jar</packaging> 
<build> 
<plugins> 
<plugin> 
<artifactId>maven-invoker -plugin</artifactId> 
<version>1.6</version> 
<configuration> 
<debug>t rue</debug> 
<pomIncludes> 


<pomInclude>app-web-ui/pom. xml</pomInclude> 
<pomInclude>app-desktop-ui/pom. xml</pomInclude> 


</pomIncludes> 
</configuration> 
<executions> 
<execution> 
<id>build</id> 
<goals> 
<goal>run</goal> 
</goals> 
</execution> 
</executions> 
</plugin> 
</plugins> 
<build> 
</project> 


让 我 们 打开 命 合 控 制 台 ， 进 入 到 C: > MVN > bus-core-api B i, 


mn S. 


C:MVNus-core-api>mvn clean package -U 


Maven 将 开始 构建 项 目 bus-core-api。 


然后 执行 以 下 命 兮 


[INFO] Scanning for projects... 

ENEONE SS nnn nn nnn nn nnn nnn nn nnn een ene: 
[INFO] Building bus-core-api 

[ INFO] task-segment: [clean, package] 

[INFO] 3 


[INFO] [jar:jar {execution: default-jar}] 

[INFO] Building jar: C:MVNus-core-ui arget 

bus -core-ui-1.0-SNAPSHOT. jar 
NO 
[INFO] BUILD SUCCESSFUL 

[ENEONMWE n-ne nnn nnn nnn nnn nnn ene eee: 





一 旦 bus-core-api 构 建成 功 ，Maven 将 开始 构建 应 用 程序 app-web-ui 


[INFO] ---------- n-ne nnn nnn nn nn nn nnn nnn enn: 
[INFO] Building app-web-ui 

[INFO] task-segment: [package] 

[ENEONWS 


[INFO] [jar:jar {execution: default-jar}] 

[INFO] Building jar: C:MVNapp-web-ui arget 

app -web-ui-1.0-SNAPSHOT. jar 

[ENEONES 
[INFO] BUILD SUCCESSFUL 

[INFO] 3 





— Happ-web-ui 构建 成 功 ，Maven 将 开始 构建 app-desktop-ui 项 目 


[INFO] 2 
[INFO] Building app-desktop-ui 

[INFO] task-segment: [package] 

[INFO] e dme ee 


[INFO] [jar:jar (execution: default-jar}] 

[INFO] Building jar: C:MVNapp-desktop-ui arget 
app-desktop-ui-1.0-SNAPSHOT. jar 

[ENE ON 
[INFO] BUILD SUCCESSFUL 

FINEONE 3 





使 用 Maven 持 续集 成 服务 


使 用 CI 服务 器 更 适合 作为 开发 人 员 不 需要 更 新 的 bus-core-api | 项 目的 POM 每 次 一 
新 的 项 目 ， 例 如 app-mobile-ui 添 加 作为 bus-core-api 项 目 相 关 的 项 目 。 哈 德 森 
Hudson 自动 管理 使 用 Maven 的 依赖 管理 构建 自动 化 。 





E New Job Job name | tus-core-api 


, Manage Hudson D Build a free-style software project 
& copi This is the central feature of Hudson 
Hudson will build your project, You can combine any SCM with any build system 
a” Build History ® Build à maven2 project 
, Project Relationship Build à maven? project. 
Hudson takes advantage of your POM files and drastically reduces the configuration. 


B Check File Fingerprint m 
(©) Build multi-configuration project (alpha) 
Suitable for projects that need a large number of different configurations, 


such às testing on multiple environments, platform-specific builds, etc. 


Build Queue 
No builds in the queue. 


O Monitor an external job 


Build Executor Status 
This type of job allows you to record the execution of a process run outside Hudson, 


No, Status 
Idle even on a remote machine. 


Copy existing job 
Copy from 


OK /iouLcori 


哈 德 森 (Hudson) 认 每 个 项 目 生成 的 工作 。 一 旦 一 个 项 目的 代码 签 入 到 SVN (或 
映射 到 哈 德 森 任何 源 管理 工具 ) ， 哈 德 森 开 始 它 的 构建 工作 ， 一 旦 这 项 工作 得 到 完 
成 ， 它 会 自动 启动 其 他 相关 工作 (其 他 相关 项 目 ) o 


在 上 面 的 例子 中 ， 当 bus-core-ui 源 代码 SVN 更 新 ， 哈 德 森 开始 它 的 构建 。 一 旦 构建 
成 功 。 哈 德 森 自 动 查找 相关 的 项 目 ， 并 开始 构建 app-web-ui 和 app-desktop-ui 项 
目 。 


Maven 依 赖 管理 - Maven 教 程 


其 中 一 个 Maven 的 核心 特征 是 依赖 管理 。 管 理 依赖 关系 变 得 困难 的 任务 一 旦 我 们 处 
理 多 模块 项 目 ( 包 含 数 百 个 模块 / 子 项 目 ) 。 Maven 提 供 了 一 个 高 程度 的 控制 来 管 
理 这 样 的 场景。 


传递 依赖 发 现 
这 是 很 通常 情况 下 ， 当 一 个 库 说 A 就 依赖 于 其 他 库 说 B 的 情况 下 ， 另 一 个 项 目 C 想 用 
A， 则 该 项 目 需要 使 用 库 中 B。 


在 Maven 帮 助 下 以 避免 这 样 的 要 求 来 发 现 所 有 需要 的 库 。 Maven 通 过 读 取 依赖 项 项 
Exft (pom.xml) ， 找 出 它们 的 依赖 等 。 


我 们 只 需要 在 每 个 项 目 POM 定 义 直 接 依赖 关系 。 Maven 自 动 处 理 其 余部 分 。 
传递 依赖 ， 包 括 库 的 图 形 可 能 会 快速 增长 在 很 大 程度 上 。 可 能 出 现 情况 下 ， 当 有 重 
复 的 库 。 Maven 提 供 一 些 功 能 来 控制 传递 依赖 程度 

Feature 描述 


Determines what version of a dependency is to be used 
Dependency when multiple versions of an artifact are encountered. If two 
mediation dependency versions are at the same depth in the 

dependency tree, the first declared dependency will be used. 


Directly specify the versions of artifacts to be used when they 
are encountered in transitive dependencies. For an example 


Shiela project C can include B as a dependency in its 
9 dependencyManagement section and directly control which 
version of B is to be used when it is ever referenced. 
ar Includes dependencies as per the current stage of the build 
对 到 Any transitive dependency can be excluede using "exclusion" 
depende element. As example, A depends upon B and B depends 
p upon C then A can mark C as excluded. 
Any transitive dependency can be marked as optional using 
Optional "optional" element. As example, A depends upon B and B 
dependencies depends upon C. Now B marked C as optional. Then A will 


not use C. 


i HSE E] 


传递 依赖 发 现 可 以 使 用 各 种 依赖 范围 如 下 文 所 述 受 到 限制 


Scope 


compile 


provided 


runtime 


test 


system 


import 


描述 


This scope indicates that dependency is available in classpath of 
project. lt is default scope. 


This scope indicates that dependency is to be provided by JDK or 
web-Server/Container at runtime. 


This scope indicates that dependency is not required for 
compilation, but is required during execution. 


This scope indicates that the dependency is only available for the 
test compilation and execution phases. 


This scope indicates that you have to provide the system path. 


This scope is only used when dependency is of type pom. This 
scopes indicates that the specified POM should be replaced with 
the dependencies in that POM's <dependencyManagement> 
section. 


依赖 关系 管理 


通常 情况 下 ， 我 们 已 经 一 套 项 目 在 一 个 共同 的 项 目下 。 人 在 这 种 情况 下 ， 我 们 可 以 创 


造 让 所 有 的 公共 


依赖 一 个 共同 的 POM， 然 后 进行 分 项 目 POMS 为 这 个 POM 父 。 下 


面 的 例子 将 帮助 你 理解 这 个 概念 









Lib1:1.0 


App-Core-lib:1.0 





App-Data-lib:1.0 
Zio, eor 


以 下 是 上 述 的 依赖 图 的 细节 
e。APP-UI-WAR 依 赖 于 App-Core-lib 和 App-Data-lib, 
e Root 是 App-Core-lib 和 App-Data-lib 的 父 类 。 
e Root 定义 LIB1，LIB2，Lib3 作 为 其 依赖 部 分 依赖 关系 。 


App-UI-WAR 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 

<modelVersion>4.0.0</modelVersion> 
<groupId>com.companyname.groupname</groupId> 
<artifactId>App-UI-WAR</artifactId> 
<version>1.0</version> 
<packaging>war</packaging> 
<dependencies> 
<dependency> 
«groupId»com.companyname.groupname«c/groupId» 
<artifactId>App-Core-lib</artifactId> 
<version>1.0</version> 
</dependency> 
</dependencies> 
<dependencies> 
<dependency> 
«groupId»com.companyname.groupname«c/groupId» 
<artifactId>App-Data-lib</artifactId> 
<version>1.0</version> 
</dependency> 
</dependencies> 
</project> 


App-Core-lib 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 

<parent> 
<artifactId>Root</artifactId> 
<groupId>com. companyname.groupname</groupId> 
<version>1.0</version> 
</parent> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.companyname.groupname</groupId> 
<artifactId>App-Core-lib</artifactId> 
<version>1.0</version> 
<packaging>jar</packaging> 
</project> 


App-Data-lib 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 

<parent> 
<artifactId>Root</artifactId> 
<groupId>com. companyname.groupname</groupId> 
<version>1.0</version> 
</parent> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.companyname.groupname</groupId> 
<artifactId>App-Data-lib</artifactId> 
<version>1.0</version> 
<packaging>jar</packaging> 
</project> 


Root 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 

<modelVersion>4.0.0</modelVersion> 
«groupId»com.companyname.groupname«c/groupId» 
<artifactId>Root</artifactId> 
<version>1.0</version> 
<packaging>pom</packaging> 
<dependencies> 
<dependency> 
«groupId»com.companyname.groupnamei1«/groupId» 
<artifactId>Libi</artifactId> 
<version>1.0</version> 
</dependency> 
</dependencies> 
<dependencies> 
<dependency> 
«groupId»com.companyname.groupname2«/groupId» 
<artifactId>Lib2</artifactId> 
<version>2.1</version> 
</dependency> 
</dependencies> 
<dependencies> 
<dependency> 
«groupId»com.companyname.groupname3«/groupId» 
<artifactId>Lib3</artifactId> 
<version>1.1</version> 
</dependency> 
</dependencies> 
</project> 


现在 ， 当 我 们 建立 App-Ul-WAR 项 目 ，Maven 会 发 现 所 有 的 依赖 通过 通 万 依赖 图 和 
构建 应 用 程序 。 
从 上 面 的 例子 中 ， 我 们 可 以 学 到 以 下 关键 概念 


e 常见 的 依赖 关系 可 以 用 父 POM 的 概念 被 放置 在 一 个 地 方 。 App-Data-lib 和 
App-Core-lib 项 目 列表 在 Root 目录 ( 见 Roots 包 类 型 。 它 是 POM). 

e 不 需要 Lib1, lib2, Lib3 作为 依赖 于 App-UI-WAR. Maven 使 用 传递 性 依赖 机 制 来 
管理 这 些 细节 。 
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在 项 目 开发 中 ， 通 常 是 部 署 过 程 包含 以 下 步 又 

。 检 和 人 代码 在 建 项 目 全 部 进入 SVN 或 源 代码 库 中 ， 并 标记 它 。 
。 从 SVN 下 载 完 整 的 源 代码 。 

e. 构建 应 用 程序 。 

e. 生成 输出 要 么 WAR 或 EAR 文 件 存储 到 一 个 共同 的 网 络 位 置 。 
© 从 网 络 获取 的 文件 和 文件 部 署 到 生产 现场 。 

e 更 新 日 期 和 应 用 程序 的 更 新 版 本 号 的 文件 。 


问题 说 明 
通常 有 多 人 参与 了 上 述 部 署 过 程 。 一 个 团队 可 能 手动 签 入 的 代码 ， 其 他 人 可 以 处 理 


构建 等 。 这 很 可 能 是 任何 一 个 步骤 可 能 会 错过 了 ， 由 于 涉及 和 由 于 多 团队 环境 手动 
工作 。 例 如 ， 较 旧 的 版 本 可 能 不 会 被 更 换 网 络 设 备 和 部 署 团队 再 部 署 旧版 本 。 


dh 
~ 
2H 


F 
过 结合 自动 化 的 部 署 过 程 

e Maven 构 建 和 释放 项 目 ， 

e SubVersion 源 代码 库 ， 管 理 源 代码 ， 

e 和 远程 存储 库 管 理 器 (Jfrog/ Nexus) 来 管理 项 目的 二 进 制 文件 。 


更 新 项 目的 pom.xml 


我 们 将 使 用 Maven 发 布 插件 来 创建 一 个 自动 释放 过 程 。 
例如 : bus-core-api 项 目 POM.xml 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»bus-core-api«/groupId» 
<artifactId>bus-core-api</artifactId> 
<version>1.0-SNAPSHOT</version> 
<packaging>jar</packaging> 
<scm> 

<url>http://www.svn.com</url> 
«connection»scm:svn:http://localhost:8080/svn/jrepo/trunk/ 
Framework</connection> 
<developerConnection>scm:svn:${username}/${password}@locaLho: 
common_core_api:1101:code</developerConnection> 
</scm> 
<distributionManagement> 
<repository> 
<id>Core-API -Java-Release</id> 
<name>Release repository</name> 
<url>http://localhost :8081/nexus/content/repositories/ 
Core-Api-Release</url> 
</repository> 
</distributionManagement> 
<build> 
<plugins> 
<plugin> 
<groupiId>org.apache.maven.plugins</groupId> 
<artifactId>maven-release-plugin</artifactId> 
<version>2.0-beta-9</version> 
<configuration> 
<useReleaseProfile>false</useReleaseProfile> 
<goals>deploy</goals> 
«scmCommentPrefix»[bus-core-api-release-checkin]-« 
/scmCommentPrefix> 
</configuration> 
</plugin> 
</plugins> 
</build> 
</project> 


a] = 
在 pom.xml 中 ， 下 面 是 我 们 使 用 的 重要 元 素 





元 素 描述 


Configures the SVN location from where Maven will check out 


SOM the source code. 

Repositories Location where built WAR/EAR/JAR or any other artifact will 
be stored after code build is successful. 

Plugin maven-release-plugin is configured to automate the 


deployment process. 


Maven 发 布 插件 
Maven 使 用 确实 下 列 有 用 的 任务 maven-release-plugin. 


mvn release:clean 


它 清除 以 防 工作 区 的 最 后 一 个 释放 的 过 程 并 不 顺利 。 


mvn release:rollback 


回 滚 是 为 了 以 防 工作 空间 代码 和 配置 更 改 的 最 后 一 个 释放 的 过 程 并 不 顺利 。 


mvn release:prepare 


。 确保 没有 快照 依赖 

e 更改 应 用 程序 的 版 本 并 删除 快照 从 版 本 ， 以 释放 
。 更 新 文件 到 SVN. 

。 运行 测试 用 例 

e 提交 修改 后 POM 文 件 

e 标签 代码 在 subversion 中 

e. 增加 版 本 号 和 附加 快照 以 各 将 来 发 行 

e 提交 修改 后 的 POM 文 件 到 SVN。 


mvn release:perform 


检查 出 使 用 前 面 定 义 的 标签 代码 并 运行 Maven 的 部 署 目标 来 部 署 战争 或 内 置 工件 档 
AE. 


让 我 们 打开 命令 控制 台 ， 到 C: > MVN >bus-core-api 目录 并 执行 以 下 命令 mvn 命 
ax 


To 


C:MVNus-core-api>mvn release:prepare 
Maven 将 开始 建设 该 项 目 。 一 旦 构建 成 功 运行 以 下 命令 mvn 命 邻 。 
C:MVNus-core-api>mvn release:perform 


一 旦 构建 成 功 ， 您 可 以 在 资料 库 验 证 上 传 的 JAR 文 件 。 
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本 教程 将 教 你 如 何 管理 使 用 Maven 版 本 控制 系统 管理 一 个 基于 Web 项 目 。 在 这 里 ， 
将 学 习 如 何 创建 /构建 /部 署 和 运行 Web 应 用 程序 : 


创建 Web 应 用 程序 


要 创建 一 个 简单 的 java web 应 用 程序 ， 我 们 将 使 用 Maven 的 原型 - web 应 用 插件 。 
因此 ， 让 我 们 打开 命 使 控制 人 台 ， 进 入 到 C : MVN 有 目录 并 执行 以 下 命令 mvn 命 令 。 


C:MVN>mvn archetype:generate 
-DgroupId=com.companyname.automobile 
-DartifactId=trucks 
-DarchetypeArtifactId=maven-archetype-webapp 
-DinteractiveMode=false 


Maven 会 开始 人 处理， 并 建立 完整 的 基于 Web 的 Java 应 用 程序 项 目 结构 。 


[ INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 


Scanning for projects... 
Searching repository for plugin with prefix: 'archetype'. 
Building Maven Default Project 

task-segment: [archetype:generate] (aggregator-style) 
Preparing archetype:generate 
No goals needed for project - skipping 
[archetype:generate {execution: default-cli}] 
Generating project in Batch mode 


Using following parameters for creating project 


from Old (1.x) Archetype: maven-archetype-webapp:1.0 


[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 


Parameter: groupId, Value: com.companyname.automobile 
Parameter: packageName, Value: com.companyname.automobile 
Parameter: package, Value: com.companyname.automobile 
Parameter: artifactId, Value: trucks 

Parameter: basedir, Value: C:MVN 

Parameter: version, Value: 1.0-SNAPSHOT 

project created from Old (1.x) Archetype in dir: C:MVN ri 


Total time: 16 seconds 
Finished at: Tue Jul 17 11:00:00 IST 2012 
Final Memory: 20M/89M 





现在 去 到 C:/ MVN 目 录 。 您 将 看 到 创建 了 一 个 名 为 trucks (如 artifactld 指 定 ) 一 个 
java 应 用 程序 项 目 。 


= Name 


i Computer 


& Windows (C:) 
E MVN 


Ji src 


|. pom.xml 


d trucks 
Js src 
|) main 


d. resources 
4» webapp 
|». WEB-INF 
ilosi eorn 


Maven 使 用 标准 的 目录 结构 。 用 上 面 的 例子 中 ， 我 们 可 以 了 解 到 以 下 关键 概念 


文件 夫 结 构 描述 


trucks contains src folder and pom.xml 

src/main/webapp contains index.jsp and WEB-INF folder. 

src/main/webapp/WEB-INF contains web.xml 

src/main/resources it contains images/properties files . 
POM.xml 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.companyname. automobile</groupId> 
<artifactId>trucks</artifactId> 
<packaging>war</packaging> 
<version>1.0-SNAPSHOT</version> 
<name>trucks Maven Webapp</name> 
<url>http://maven.apache.org</url> 
<dependencies> 

<dependency> 
«groupId»junit«/groupId» 
«artifactId»junit«/artifactlId» 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
<build> 
<finalName>trucks</finalName> 
</build> 
</project> 


Maven 还 创建 了 一 个 示例 JSP 源 文件 
打开 C: > MVN > trucks > src > main > webapp > 文件 夹 ， 你 会 看 到 index.jsp。 


<html> 
<body> 
<h2>Hello World!</h2> 
</body> 
</html> 


构建 Web 应 用 程序 


让 我 们 打开 命令 控制 台 ， 进 入 到 C:MVN rucks 目 录 并 执行 以 下 命令 mvn 命 倒 。 


C:MVN rucks>mvn clean package 


Maven 将 开始 建设 该 项 目 。 


[INFO] Scanning for projects... 

[INFO] > 2-262 eee ee ee ee, 
[INFO] Building trucks Maven Webapp 

[ INFO] task-segment: [clean, package] 

[INFO] ---+------ 22-2266 252252 ses sess ee cee ces eee eee ee eee nese eens. 
[INFO] [clean:clean (execution: default-clean}] 

[INFO] [resources:resources (execution: default-resources} ] 
[WARNING] Using platform encoding (Cp1252 actually) to 

copy filtered resources,i.e. build is platform dependent! 

[INFO] Copying © resource 

[INFO] [compiler:compile (execution: default-compile)] 

[INFO] No sources to compile 

[INFO] [resources:testResources (execution: default-testResources): 
[WARNING] Using platform encoding (Cp1252 actually) to 

copy filtered resources,i.e. build is platform dependent! 

[INFO] skip non existing resourceDirectory 

C:MVN ruckssrc est 

esources 

[INFO] [compiler:testCompile (execution: default-testCompile} ] 
[INFO] No sources to compile 

[INFO] [surefire:test (execution: default-test)] 

[INFO] No tests to run. 

[INFO] [war:war (execution: default-war)] 

[INFO] Packaging webapp 

[INFO] Assembling webapp[trucks] in [C:MVN rucks arget ruc 
[INFO] Processing war project 

[INFO] Copying webapp resources[C:MVN ruckssrcmainwebapp | 

[INFO] Webapp assembled in[77 msecs] 

[INFO] Building war: C:MVN rucks arget rucks.war 

[INFO] ------- 92-66-0262 nse ee ee eee ee ee 
[INFO] BUILD SUCCESSFUL 
ID 
[INFO] Total time: 3 Seconds 

[INFO] Finished at: Tue Jul 17 11:22:45 IST 2012 

[INFO] Final Memory: 11M/85M 

[NE ONE 





部 署 Web 应 用 程序 


现在 复制 创建 的 trucks.war 到 C: > MVN > trucks > target > 文件 夹 到 web 服 务 器 的 
webapp 目 录 下 ， 然 后 重新 启动 Web 服 务 器 。 
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测试 Web 应 用 程序 


使 用 URL 运 行 Web 占 用 程序 http://<server-name>:<port- 
number>/trucks/index.jsp 


验证 输出 。 


| | 
fie. Edit View Favorites Tools Help 


Hello World! 
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Eclipse 提供 了 一 个 很 好 的 插件 m2eclipse 无 缝 季 Maven 和 Eclipse 集成 在 一 起 。 
m2eclipse 一 些 特 点 如 下 

e 您 可 以 从 Eclipse 运行 Maven 目 标 。 

e 可 以 使 用 其 自己 的 控制 台 查 看 Maven 命 邻 的 输出 在 Eclipse 里 面 。 

。 你 可 以 更 新 maven 的 依赖 关系 使 用 IDE。 

e 您 可 以 启动 Maven 在 Eclipse 中 建立 。 
它 的 依赖 管理 基于 Maven 的 pom.xml 在 Eclipse 构建 路 径 。 


它 解决 了 从 Eclipse 工作 区 Maven 的 依赖 关系 ， 而 不 需要 安装 到 本 地 Maven 仓 库 
(需要 依赖 项 目 在 同一 个 工作 区 ) 。 


e 它 自动 下 载 需 要 的 依赖 和 源 从 远程 Maven 仓 库 。 
它 提供 了 向 导 ， 用 于 创建 新 的 Maven 项 目 ，pom.xml 和 现 有 项 目 可 让 Maven 支 
持 


e 它 提供 了 快速 搜索 远程 Maven 仓 库 的 依赖 


安装 m2eclipse 插 件 
请 使 用 以 下 链接 之 一 安装 m2eclipse : 


Eclipse URL 
Eclipse 3.5 (Gallileo) Installing m2eclipse in Eclipse 3.5 (Gallileo) 
Eclipse 3.6 (Helios) Installing m2eclipse in Eclipse 3.6 (Helios) 


下 面 的 例子 将 帮助 您 利用 集成 Eclipse 和 Maven。 


导 人 Eclipse 中 Maven 项 目 
e 打开 Eclipse. 
e 选择 File > Import > 选项 . 


e 选择 Maven 项 目 选项 。 单 击 Next 按 钮 。 
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(3 Import 
Select 
Maven Projects 


Select an import source: 
type filter text 


a & General 
区 Archive File 
E Existing Projects into Workspace 


ines tas : 





EI, Check out Maven Projects from SCM 
D, Install or deploy an artifact to a Maven repository 
Lj Materialize Maven Projects 

b 2% Plua-in loom 











e 选择 项 目的 位 置 ， 使 用 Maven 创 建 一 个 项 目 。 我 们 已 经 创建 一 个 Java 项 目 
consumerBanking。 看 到 Maven 创 建 项 目 ， 看 看 如 何 创 建 使 用 Maven 项 目 。 


e 单 击 Finish 按 钮 。 
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Š Import Maven pr ojects 


| Maven Projects 


Select Maven projects 








Root Directory: C:\MVN\consumerBanking 
Projects: 








Add project(s) to working set 





Working set: | 





> Advanced 








File Edit — Refactor Navigate Search Project He 
T-S fh AAA 5-O- 
[& Project Explorer [5 Navigator oo NE zim 


@| BB v" 














a [2 consumerBanking 
b & settings 
4 (g» src 
b & lib 
4 (& main 
4 & java 
4 (z» com 
4 (& companyname 
4 & bank 
[J] Appjava 
[J] Util.java 
b (g» test 
b & target 
|X| .classpath 
办 .project 
"X; pom.xml Hy, eor 


现在 ， 看 看 consumerBanking 项 目 属性 。 你 可 以 看 到 ， 


赖 关 系 ， 以 Java 构 建 路 径 。 
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Eclipse 已 经 添加 Maven 的 依 


2350 


TutorialsPoint Java 技术 教程 


车 Properties for. 





type filter text 


Resource 
Beaninfo Path 
Builders 

CSS Preview 
FindBugs 

Google 

HTML Code Formatter 
HTML Preview 
Java Build Path 
Java Code Style 
Java Compiler 
Java Editor 
Javadoc Location 
JS Code Formatter 
Maven 

PMD 

Project References 
Run/Debug Settings 
Synchronization 
Task Repository 
Task Tags 





Java Build Path 和 :CD vw | 















4 BA Maven Dependencies 
i Access rules: No rules defined 
a Native library location: (None) 
b junit-3.8.1.jar - C:\Users\GB3824\.m2\rep 
pom Idapjdk,jar - C:\MVN\consumerBanking\ 











© 


现在 ， 它 使 用 Eclipse 的 Maven 来 构建 项 目 。 


e 右键 点 击 consumerBanking 项 目 打 开 上 下 文 菜单 。 
选择 Run 作为 选项 


e 然后 maven 的 封装 选项 


Maven 将 开始 建设 该 项 目 。 你 可 以 看 到 在 Eclipse 控制 台 输 出 
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[INFO] Scanning for projects... 

[INFO] ----=-------- 222225522 s sees cee cee ce see eee eee eee ee eee cease. 
[INFO] Building consumerBanking 

[INFO] 

[INFO] Id: com.companyname.bank:consumerBanking: jar :1.0-SNAPSHOT 
[INFO] task-segment: [package] 

[INFO] ----------------.-2-..-..-2..-2.2-..22..-2.2.2.2-2.2..2-2.-22..-2-. 
[INFO] [resources:resources] 

[INFO] Using default encoding to copy filtered resources. 

[INFO] [compiler :compile ] 

[INFO] Nothing to compile - all classes are up to date 

[INFO] [resources:testResources] 

[INFO] Using default encoding to copy filtered resources. 

[INFO] [compiler:testCompile] 

[INFO] Nothing to compile - all classes are up to date 

[INFO] [surefire:test] 

[INFO] Surefire report directory: 

C:MVNconsumerBanking argetsurefire-reports 


Running com.companyname.bank.AppTest 
Tests run: 1, Failures: 0, Errors: 0, Skipped: ©, Time elapsed: 0.( 


Results 
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


[INFO] [jar:jar] 

[INFO] -----------------------------------------------------------: 
[INFO] BUILD SUCCESSFUL 

[INFO] -----------------------------------------------------------:' 
[INFO] Total time: 1 second 

[INFO] Finished at: Thu Jul 12 18:18:24 IST 2012 

[INFO] Final Memory: 2M/15M 

[INFO] -----------------------------------------------------------: 
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New 
Go Into 
Open in New Window 


Copy 
Paste 


Delete 





Move... 


Rename... 
















Run As E5| 1 Java Applet 

Debug As [3] 2 Java Application 

Profile As Ju 3 JUnit Test 

Team m2 4 Maven assembly:assembly 
Compare With m2 5 Maven build 

Restore from Local History | m2 6 Maven build... 
Synchronize » m2 7 Maven clean 

Web Development Tools » | m2 8 Maven generate-sources 
PDE Tools m2 9 Maven install 

JPA Tools m2 Maven package 

PMD m2 Maven source;jar 

Google m2 Maven test 





des Run Configurations... 







Properties 
Find Bugs 


Remove from Context 


现在 ， 右 键 点 击 App.java。 选 择 Run As 选项 。 选 择 作为 Java 应 用 程序 。 
你 会 看 到 结果 
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NetBeans IDE 集 成 Maven - Maven 教 程 
NetBeans6.7 更 新 版 本 已 经 内 置 对 Maven 支 持 。 如 遇 以 前 的 版 本 ，Maven 插 件 在 插 
件 管 理 器 中 可 用 。 我 们 正在 使 用 NetBeans 在 这 个 例子 中 使 用 6.9。 
在 NetBeans 一 些 特点 如 下 

e 您 可 以 从 NetBeans 运 行 Maven 目 标 。 

e 您 可 以 可 以 查看 Maven 命 令 的 输出 使 用 其 自己 的 控制 台 在 NetBeans 里 面 。 

e 你 可 以 更 新 maven 的 依赖 关系 的 IDE。 

e 您 可 以 启动 Maven 从 内 部 的 NetBeans 版 本 。 
NetBeans 不 依赖 自动 管理 基于 Maven 的 pom.xml。 


NetBeans 解 决 Maven 的 依赖 关系 从 它 的 工作 空间 ， 而 不 需要 安装 到 本 地 Maven 
仓库 (需要 依赖 项 目 在 同一 个 工作 区 ) 。 


NetBeans 自 动 下 载 需 要 的 依赖 和 源 从 远程 Maven 仓 库 。 
NetBeans 提 供 向 导 ， 用 于 创建 新 的 Maven 项 目 及 pom.xml 


NetBeans 提 供 一 个 Maven 资 源 库 浏 览 器 ， 使 您 可 以 查看 您 的 本 地 存储 库 和 注册 
的 外 部 Maven 仓 库 。 


下 面 的 例子 籽 帮 助 您 充分 利用 NetBeans 的 集成 和 Maven 的 好 你 。 


打开 NetBeans Maven 项 目 


e NetBeans. 
e 选择 File Menu > Open Project 选项 . 


e 选择 项 目的 位 置 ， 使 用 Maven 在 那里 创建 了 一 个 项 目 。 我 们 已 经 创建 一 个 Java 
项 目 consumerBanking。 看 到 Maven 创 建 项 目 ， 看 看 如 何 创建 使 用 Maven 项 


o 
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| | 














(i project 


E-i trucks Open as Main Project 


| | Open Required Projects: 


n a 


File name: fe: \MVN \consumerBanking | [ Open Project | 
Files of type: [Project Folder 四 Cancel 
` 4 VEMESS 


On) 

















现在 ， 你 可 以 看 到 Maven 项 目 在 NetBeans。 看 看 consumerBanking 项 目 库 和 测试 
库 。 可 以 看 到 ，NetBeans 的 增加 了 Maven 的 依赖 关系 到 它 的 构建 路 径 。 


OT 







File Edit View Navigate Source Refactor Run Debug Profile Team Tools Window Help 


i Services 












5- [H Source Packages 

: e-B] com.companyname.bank 
: L- En App.java 

E [jj Test Packages 

: 日- 围 com,companyname,bank 
: 1 -图 AppTest.java 

~~ Libraries 

E dg Test Libraries 

| Beg junit-3.8.1jar ftes] 
E [lg Project Files 

[S] pom.xml 

: -图 settings.xml 


iosi eon 


建立 在 NetBeans Mavens El 


现在 ， 它 使 用 NetBeans 的 Maven 来 构建 项 目 。 
e 右键 点 击 consumerBanking 项 目 打开 上 下 文 菜单 。 


NetBeans IDE 集 成 Maven - Maven 教 程 2355 


TutorialsPoint Java 技术 教程 


e 选择 清理 并 生成 可 选项 






fe iis m 7 mm d 
[File Edit View Navigate Source Refactor Run Debug Profile Team Tools Window Help 


Taf We D E eton e TB EN Q 






Build 
Clean and Build 
Build with dependencies 



















Clean 
Generate Javadoc 








Run 
Debug 
Profile 
Test 










Custom 
Set Configuration 







Show Dependency Graph 







Reload Project 
Set as Main Project 

Open Required Projects 
Close 










Rename... 






Move... 


Copy... 
Delete 









Delete 







Find... Ctrl+F 
Share on Team Server... 
Versioning 


Local History 









View Available > 






Properties 


Maven 将 开始 建设 该 项 目 。 你 可 以 看 到 在 NetBeans 控 制 台 输出 


NetBeans IDE 集 成 Maven - Maven 教 程 2356 


NetBeans: Executing 'mvn.bat -Dnetbeans.execution-true clean insta: 
NetBeans: JAVA HOME-C:Program FilesJavajdk1.6.0 21 
Scanning for projects... 
Building consumerBanking 
task-segment: [clean, install] 
[clean:clean] 
[resources: resources ] 
[WARNING] Using platform encoding (Cp1252 actually) 
to copy filtered resources, i.e. build is platform dependent! 
skip non existing resourceDirectory C:MVNconsumerBankingsrcmain 
esources 
[compiler:compile] 
Compiling 2 source files to C:MVNconsumerBanking argetclasses 
[resources:testResources] 
[WARNING] Using platform encoding (Cp1252 actually) 
to copy filtered resources, i.e. build is platform dependent! 


skip non existing resourceDirectory C:MVNconsumerBankingsrc est 
esources 

[compiler:testCompile] 

Compiling 1 source file to C:MVNconsumerBanking arget est-cl: 
[surefire:test] 

Surefire report directory: C:MVNconsumerBanking argetsurefire-rt 
hes hs 


Running com.companyname.bank.AppTest 
Tests run: 1, Failures: 0, Errors: ©, Skipped: ©, Time elapsed: 0.( 


Results 


Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


[jar:jar] 

Building jar: C:MVNconsumerBanking argetconsumerBanking-1.0-SNAI 
[install:install] 

Installing C:MVNconsumerBanking argetconsumerBanking-1.0-SNAPSH( 
to C:UsersGB3824.m2 

epositorycomcompanynameankconsumerBanking 
1.0-SNAPSHOTconsumerBanking-1.0-SNAPSHOT. jar 


Total time: 9 seconds 
Finished at: Thu Jul 19 12:57:28 IST 2012 
Final Memory: 16M/85M 











在 NetBeans 中 运行 的 应 用 程序 
现在 ， 右 键 点 击 App.java。 选 择 Run 档 选项 。 你 会 看 到 在 NetBeans 控 制 台 的 结果 。 


NetBeans: Executing 'mvn.bat -Dexec.classpathScope=runtime 
-Dexec.args=-classpath %classpath com.companyname.bank.App 
-Dexec.executable=C:Program FilesJavajdk1.6.0_21injava.exe 
-Dnetbeans.execution=true process-classes 
org.codehaus.mojo:exec-maven-plugin:1.1.1:exec' 
NetBeans: JAVA_HOME=C:Program FilesJavajdk1.6.0 21 
Scanning for projects... 
Building consumerBanking 
task-segment: [process-classes, 
org.codehaus.mojo:exec-maven-plugin:1.1.1:exec] 
[resources:resources] 
[WARNING] Using platform encoding (Cp1252 actually) 
to copy filtered resources, i.e. build is platform dependent! 
skip non existing resourceDirectory C:MVNconsumerBankingsrcmain 
esources 
[compiler:compile] 
Nothing to compile - all classes are up to date 
[exec:exec] 
**Hello World!** 


Total time: 1 second 
Finished at: Thu Jul 19 14:18:13 IST 2012 
Final Memory: 7M/64M 
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1. 安装 m2eclipse 插 件 要 用 Eclipse 构建 Maven 项 目 ， 我 们 需要 先 安 装 meeclipse 插 
件 点 击 eclipse 菜 单 栏 Help->Eclipse Marketplace 搜 索 到 插件 Maven Integration for 
Eclipse 并 点 击 安装 即 可 ， 如 下 图 : 


Eclipse Marketplace cy 


E] 


Select solutions to install. Press Finish to proceed with installation. 
Press the information button to see a detailed overview and a link to more information. 


Search Recent| Popular | Installed 
Find{jmaven Q 7] [All Markets z) [All:Categories m 


^ 


Maven Integration for Eclipse WTP © m 














! Maven Integration for Eclipse WTP (a.k.a m2e-wtp) aims at providing a tight 
| integration between Maven Integration for Eclipse (a.k.a m2e) and the Eclipse 
| Web... 


by Red Hat, Inc., EPL Update | | Uninstall 


| Maven — for pun © 





| : - - - egratioh for Eclipse. You can use m2e to 
manage both simple and multi- moaie Maven projects, execute Maven builds via | 
the... 


by Eclipse.org, EPL [ Update | [ Uninstall 


CarrotGarden SCR © 


CarrotGarden SCR provides OSGI Service-Component descriptor generator 
according to a proposal described in RFC 0172 Declarative Services Annotations 
(page 187)... 


by CarrotGarden, BSD 


manik-hot-deploy Plugin © 














The "Manik Hot deploy" plugin provides an easy way to activate incremental and 
hot deployment for your maven JEE projects. The Plugin is independend form the 
WTP... 


by Imixs. GPL Learn more 





bd 














Finish Cancel 
IPTENI 7 Ay 





安装 成 成 之 后 我 们 在 Eclipse 菜 单 栏 中 点 击 File->New->Other, 在 弹出 的 对 话 框 中 会 看 
到 如 下 图 所 示 : 
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Select a wizard 


Create a Maven Project 








b > Java Emitter Templates 

> @ JavaScript 

b e JAXB 

> & JPA 

> SF 

E Maven 

eu Checkout Maven Projects from SCM 
M? Maven Module 
M? Maven Project 


> @& PyDev 
b (E Sailfin 





E Back ( Ne» ] Finish 
Zinaj cou 
2. 构建 Maven 项 目 


以 eclipse3.6 为 例 
1) 创建 简单 Maven 项 目 


点 击 Eclipse 菜 单 栏 File-&gt;New-&gt;0hter-&gt;Maven 得 到 如 下 图 所 示 : 


E E 





Eclipse 构建 Maven 项 目 - Maven if 2360 


TutorialsPoint Java 技术 教程 


Select a wizard 


Create a Maven Project 


Wizards: 


type filter text 


> & JPA 

> & JSF 

4 (& Maven 
Lj Checkout Maven Projects from SCM 
zi Maven Module 





> (g PyDev 
> (E Sailfin 
b @ Server 
b & Spring 
> @ SQL Development 


Coe os) MÀ 
Cc — iion eo 


选中 Maven Project 并 点 击 Next， 到 下 一 个 对 话 框 继续 点 击 Next 得 到 如 下 对 话 框 
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New Maven project 
Select an Archetype 


Group Id Artifact Id Version 


org.apache.maven.archetypes maven-archetype-j2ee-simple RELEASE 
org.apache.maven.archetypes maven-archetype-marmalade-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-portlet RELEASE 


ASL asiyo aa Ibr: DeLVDe-DIO 





| org.apache.maven.archetypes maven-archetype-quickstart RELEASE - 


org.apache.maven.archetypes maven-archetype-site RELEASE 





[V] Show the last version of Archetype only Include snapshot archetypes Add Archetype... 


> Advanced 





© ack ome j| c [oem] 


rm " S 
| afi rie 


如 图 示 操 作 ， 选择 maven-archetype-quickstart， 点 击 Next 
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New Maven project 


Specify Archetype parameters 





com.mycompany.app| 





: my-app-simple 








0.0.1-SNAPSHOT v 





com.mycompany.app.my_app_simple 











> Advanced 





© 
按 图 示 填 写 好 groupld, artfactld,version 等 信息 ， 点 击 Finish。 
由 此 我 们 成 功 创建 了 一 个 简单 的 Maven 项 目 ， 项 目 结构 如 图 所 示 





4 i2 my-app-simple 
4 下 src/main/java 
4 册 com.mycompany.app.my. app. simple 
b D) App.java 
4 È src/test/java 
4 册 com.mycompany.app.my. app. simple 
b [J] AppTest.java 
p ik JRE System Library [J2SE-1.5] 
b BRA Maven Dependencies 
> (g» src 
& target 
[mi] pom.xml /lioti, oor 


2) 创建 Maven web E 
操作 跟 创建 简单 Maven 项 目 类 似 ， 点 击 EcLipse 菜 单 File-&gt;New-&gt;Oother-&gt， 
在 选择 maven-archetype 的 界面 进行 如 下 操作 : 
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New Maven project 
Select an Archetype 


Group Id Artifact Id 








A simple Java web application 


[V] Show the last version of Archetype only Include snapshot archetypes Add Archetype... 


P Advanced 





® 一 
点 击 Next, 填 写 好 相应 的 groupld,artifactld,version 等 信息 ， 点 击 Finish 
得 到 的 Maven web 项 目 结构 如 下 图 所 示 : 


a YY my-app-web 
b "Eg Deployment Descriptor: Archetype Created Web App 
(& Referenced Types 
4 2% Java Resources 
(8 src/main/resources 
> BÀ Libraries 
> BA JavaScript Resources 
4 (y Deployed Resources 
4 (& webapp 
EY indexjsp 
> @ WEB-INF 
> @ web-resources 
[m] pom.xml 
> m src 
> (E target /iibui eon 


右 击 项 目 ， 点 击 Properties->Project Facets 
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reete MR 





> JavaScript 


| Project Facets | 


b 


Run/Debug Settings =|] Java Annotation Processing Support ! 
us [v] d=) JavaScript 10 
Gui Polices JG JavaServer Faces 2.0 Y 
Targeted Runtimes 国 B JAX-RS (REST Web Services) 11 X 
. Task Repository 国 5 JCA Module 16 M 
Task Tags WPA 20 n 
» Validation If sr E = a 
Web Content Settings foe) Oracle ADF EAR 1111 
Web Page Editor 回 E Oracle ADF Web 1111 
Web Project Settings (ee) Oracle Coherence 37 M 
WikiText @ Oracle WebLogic EAR Extensions 1035 + 
XDoclet [7] ($ Oracle WebLogic EJB Extensions 1035 “< 
E] ($ Oracle WebLogic EJBGen Support 1035 + 
“| 1 Oracle WebLogic SCA 1035 ~ 
E] $a Oracle WebLogic Scripting Tools (WLST) Support 1035 + m 
um FR Neria Anhi nnie lelh, handla Edancione inde - JL 


|type filter text Project Facets 





Resource 
AppXray Configuration: | «custom» 

















Builders | — —— ^ | 
Deployment Assembly o —————————— 
Java Build Path DW Apache XMLBeans 

Java Code Style |=) Application Client module 6.0 ’ 

, Java Compiler B Axis2 Web Services 

> Java Editor : 





Javadoc Location 




















JSP Fragment ts EJB Module 31 区 
M | B EBDoclet (XDoclet) 123 x a 
aven eR i : : E 
= Deployment ipt 








Project References 






















































































如 上 图 可 以 看 到 项 目 为 web2.3 java1.5 当然 我 们 也 可 以 改 成 我 们 所 需要 的 版 本 ， 打 
开 xml 文 件 my-app-web/.settings/org.eclipse.wst.common.project.facet.core.xml， 
进行 修改 即 可 : 


Xml 代 码 vv 


DUE ULM IS 


<?xml version="1.0" encoding="UTF-8"?> 
<faceted-project> 

«fixed facet="wst.jsdt.web"/> 

<installed facet="java" version="1.5"/> 
<installed facet="jst.web" version="2.3"/> 
<installed facet="wst.jsdt.web" version="1.0"/> 
</faceted-project> 


3) 导入 Maven 项 目 


在 Eclipse project explorer 中 右 击 ， 在 弹出 框 中 选择 ijmport， 得 到 如 下 图 
I | 
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Select 
Import Existing Maven Projects 


Select an import source: 


type filter text 


b @ General 
> @ cs 
> @ BB 
> @ Java EE 





m- Existing Maven Projects 


C] 
metal or 


E, o à Maven repository 
Lj Materialize Maven Projects from SCM 

> > Plug-in Development 

> @ Run/Debug 

> @& SVN 

> (g» Tasks 





| Cancel | 
TAPES 
ne or 


选择 Existing Maven Projects， 并 点 击 Next， 得 到 如 下 图 所 示 对 话 框 : 
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Maven Projects 


Select Maven projects 


Projects: 


| [V] /pom.xml com.mycompany.app:my-app-simple:1.0;jar 

















Add project(s) to working set 





Working set: | 





> Advanced 





@ 


2 Zliuaeo 
选择 一 个 已 经 创建 好 的 Maven 项 目 ， 并 点 击 Finish。 
由 此 ， 导 入 Maven 项 目 成 功 


3. 运行 Maven 命 命 


右 击 项 目 ， 点 击 Run as, MEA: 
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x —————————————————— 





Debug As » | 加 2Java Applet Alt+Shift+X, A 
Profile As >| O 3 Java Application Alt+Shift+X, J 
Team >| Ju 4 JUnit Test Alt+Shift+X, T 
Compare With 上 5 Maven build Alt+Shift+X, M 
Restore from Local History... 6 Maven build... 

PyDev 上 7 Maven clean 


Spring Tools > 8 Maven generate-sources 
Maven > 9 Maven install 
Java EE Tools > Maven test 

el Show AppXray Dependencies Ctrl+Alt+A 


Source b 
即 可 看 到 有 很 多 现 有 的 maven 命 伟 ， 点 击 即 可 运行 ， 并 在 控制 台 可 以 看 到 运行 信息 


如 果 你 想 运行 的 maven 命 令 在 这 里 没有 找到 ， 点 击 Maven build 创 建新 的 命令 ， 操 作 
如 下 图 所 示 : 


Run Configurations... 








Uc cm a ae ee UE S RR rit 














> E 1 Run on Server Alt+Shift+X, R 
Debug As >| E 2 Java Applet Alt+Shift+X, A 
Profile As >| O 3Java Application Alt+Shift+X, J 
Team >| Ju 4JUnit Test Alt+Shift+X, T 
Compare With > | m2 _5 Maven build Alt+Shift+X, M 
Restore from Local History... 
PyDev >| m2 7 Maven clean 
Spring Tools >| m2 8 Maven generate-sources 
Maven >) m2 9 Maven install 
Java EE Tools >| m2 Maven test 

ol Show AppXray Dependencies Ctrl- Alt- A Run Configuiations.. 
Source > 


如 下 图 填 人 Maven 命 令 ， 点 击 Run 即 可 
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Edit configuration and launch. Q 


Name: my-app-web (2) 














Base directory: 
C:/Users/tangyanb/WORK/Maven/my-app-web 


| Er 


Profiles: | 
Offline Update Snapshots 
Debug Output Skip Tests Non-recursive 
Resolve Workspace artifacts 


Parameter Name Value 

















Maven Runtime: [Embedded (3.0.2/1.0.200.20111228-1245) - 








新 增 的 maven 命 令 可 以 通过 如 下 方式 找到 ， 并 再 次 运行 : 
[Runas |] >| 里 1 Run on Server Alt+Shift+X, R 

















Debug As . > 2 Java Applet Alt+Shift+X, A 
Profile As > 团 3Java Application Alt+Shift+X, J 
Team Ju 4JUnit Test Alt+Shift+X, T 

|. Compare With [m2 5 Maven build Alt«Shift-X, M 

Restore from Local History... 6 Maven build 一 一 一 
PyDev m2 7 Maven clean 
Spring Tools m2 8 Maven generate-sources 
Maven m2 9 Maven install 
Java EE Tools m2 Maven test 

me Cm AppXray Dependencies Ctrl- Alt- A E ee VilbaLeon 
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| Select a launch configuration to run: 


m2 my-app-web : clean package 
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转换 基于 Maven 的 Web 应 用 程序 支持 Eclipse IDE - 
Maven 教 程 


在 上 一 节 教 程 中 ， 使 用 Maven 创 建 了 一 个 Web 应 用 程序 。 这 里 有 一 个 指南 ， 告 诉 你 
如 何 转 换 Web 应 用 程序 到 Eclipse IDE 支 持 的 形式 。 


注意 ， 通 过 WTP 工 具 Eclipse IDE 支 持 Web 应 用 程序 ， 所 以 需要 让 基于 Maven 的 项 
目 支持 它 。 


1. mvn eclipse:eclipse -Dwtpversion=2.0 
要 转换 一 个 基于 Maven 的 Java 项 目 支持 IDE， 使 用 此 命令 : 


mvn eclipse:eclipse 


对 于 Web 应 用 程序 ， 需 要 额外 的 参数 ， 使 其 支持 Eclipse WTP， 应 该 使 用 这 个 命 
e. 


TJ 


mvn eclipse:eclipse -Dwtpversion-2.0 


看 看 其 输出 … 


_C:\worksp> mvn archetype:generate -DgroupId=com.yiibai -Dartifact: 
C:\worksp\yiibaiweb-core>mvn eclipse:eclipse -Dwtpversion=2.0 
[INFO] Scanning for projects... 

[ INFO] 

[INFO] -----------------------------------------------------------: 


[INFO] --------------.-.-.2-.2..-2..2.2-.2-22.-2222.2-222..2.2..2-22..--. 
[INFO] 

[INFO] >>> maven-eclipse-plugin:2.10:eclipse (default-cli) > gener: 
@ yiibaiweb-core >>> 

[INFO] 

[INFO] <<< maven-eclipse-plugin:2.10:eclipse (default-cli) < gener: 
@ yiibaiweb-core <<< 

[INFO] 

[INFO] --- maven-eclipse-plugin:2.10:eclipse (default-cli) @ yiiba: 
[INFO] Adding support for WTP version 2.0. 

[INFO] Using Eclipse Workspace: null 

[INFO] Adding default classpath container: org.eclipse.jdt.launchir 
ER 

[INFO] Not writing settings - defaults suffice 

[INFO] Wrote Eclipse project for "yiibaiweb-core" to C:\worksp\yiil 
[INFO] 

[INFO] ----------------.-2--2..-2.2-2-.2-2.21-22.-2222.2-2.2..21.2..-l12..-2-. 
[INFO] BUILD SUCCESS 

[INFO] -----2---2-----.22..2.22-2..-2...-.2.-..2-22..-.222.2-..2..22-2.22.-2..2--. 
[INFO] Total time: 2.038 s 

[INFO] Finished at: 2015-11-02T20:30:36+08:00 

[INFO] Final Memory: 13M/114M 

ENEO 





2. Eclipse WTP 


标准 Eclipse 的 “classpath"” 和 ”“.project" 文 件 被 创建 。 你 会 发 现 创建 一 个 新 的 
"setting" 文件 夹 ， 里 面包 含 两 个 文 

件 “org.eclipse.wst.common.component" 和 "org.eclipse.wst.common.project.facet.c 
ore.xml” 都 是 WTP 或 Faces 文 件 用 来 支持 Eclipse。 


File : org.eclipse.wst.common.project.facet.core.xml 


<faceted-project><fixed facet="jst.java"/><fixed facet="jst.web"/>< 
E) 


注意 使 用 JDK1.4 和 Maven2.X 生 成 的 Web 应 用 程序 ( 见 上 文 )， 这 是 相当 过 时 ， 需 
要 将 其 升级 到 最 新 的 JDK 版 本 。 


File : org.eclipse.wst.common.component 





«project-modules id="moduleCorelId"project-version="2.0"><wb-module 





3. 导 人 到 Eclipse IDE 


现在 ， 我 们 已 经 拥有 了 一 个 Eclipse 的 Web 应 用 程序 需要 配置 和 文件 ， 那 么 ， 就 可 
以 开始 导入 基于 Maven 构 建 Web 应 用 程序 到 Eclipse IDE 中 去 了 。 


步骤 : 在 Eclipse IDE 的 菜单 栏 , File -> Import... -> General -> Existing Projects into 
Workspace -> 选择 根 目 录 ( 选 择 项 目 文件 夹 中 )-> 完成 。 


4 {© yiibaiweb-core 


4  src/test/java 
4 出 com yiibai 
四 AppTestjava 
4 [99 src/main/java 
4 出 com yiibai 
(J) Appjava 
BÀ) JRE System Library [jdk1.8.0 40] 
Gy junit-3.8.1jar - M2_REPO\junit\junit\3.8.1 
(& src 
4 [ main 
© java 
4 [ test 
© java 
& target 
[v] pom.xml 


- C:\Users\Administrator\.m2\repc 


t 


完事 大 吉 ! 


参考 


4. 


1. http://maven.apache.org/plugins/maven-eclipse-plugin/eclipse-mojo.html 
2. 
3. http://wiki.eclipse.org/WTP_FAQ#What_version_of_Eclipse_ does WTP work 


http://maven.apache.org/plugins/maven-eclipse-plugin/wtp.html 


_with.3F 


Unsupported WTP version: 1.5. This plugin currently supports only the 
following versions: 1.0 R7 


使 用 Maven 模 板 创 建 项 目 - Maven 教 程 


在 本 教程 中 ， 我 们 将 向 你 展示 如 何 使 用 mvn archetype:generate 从 现 有 的 Maven 模 
板 列 表 中 生成 项 目 。 在 Maven 3.3.3， 有 超过 1000+ 个 模板 ，Maven 团队 已 经 过 滤 
掉 一 些 无 用 的 模板 。 


通常 情况 下 ， 我 们 只 需要 使 用 下 面 的 两 个 模板 : 


1. maven-archetype-webapp — Java Web Project (WAR) 
2. maven-archetype-quickstart — Java Project (JAR) 


1. Maven 1000+ 模板 


如 果 键 入 命令 mvn archetype:generate, 1000 + 模板 会 被 提示 在 屏幕 上 ， 你 没有 办 
ic 或 者 选择 什么 。 为 了 解决 这 个 问题 ， 输 出 模板 列表 ， 像 这 样 保存 为 文本 


C:\worksp> mvn archetype:generate > templates.txt //waiting few sec 
Press CTRL + C 


C:\worksp> vim templates.txt 





2. Maven archetype:generate 


步骤 来 指导 你 如 何 从 现 有 Spring-Hibernate 模板 来 构建 Web 项 目 : 
2.1 列 出 Maven 的 模板 : 


C:\worksp> mvn archetype:generate 


[INFO] 


[INFO] 


[INFO] 
[INFO] 
[INFO] 


[INFO] 


[INFO] 


[INFO] 


[INFO] 


[INFO] 


[INFO] 
[INFO] 
[INFO] 


Choose 


doo RR 


CONOOBRWNE 


remote 
remote 
remote 
remote 
remote 
remote 
remote 
remote 


es 


archetype: 
am. 
am. 
am. 
am. 
am. 
am. 
am. 
at. 


ik. 


ik 


ik 


ik. 


archetype 


„archetype 
ik. 
ik. 
ik. 


archetype 


archetype: 
archetype: 
„archetype: 
archetype: 


Scanning for projects... 


>>> maven-archetype-plugin:2.4:generate (default-cli) > gene 
<<< maven-archetype-plugin:2.4:generate (default-cli) < gene 


--- maven-archetype-plugin:2.4:generate (default-cli) @ star 
Generating project in Interactive mode 
No archetype defined. Using maven-archetype-quickstart (org 


:maven-reactjs-blank-archetype (Blank F 
:msgpack-rpc-jersey-blank-archetype (B: 
:mvc-1.0-blank-archetype (MVC 1.0 Blanl 


spring-boot-blank-archetype (Blank Pr 
spring-boot-docker-blank-archetype (Dc 
spring-boot-gae-blank-archetype (GAE 上 
spring-boot-jersey-blank-archetype (B: 


chrl.archetypes:chrl-spring-sample (Archetype for : 






E 


2.2 选择 数字 "314" 来 使 用 ml.rugal.archetype:springmvc-spring-hibernate 模板 ， 


并 填写 详细 信息 : 


注意 ， 这 个 数字 314 可 能 在 您 的 环境 有 所 不 同 。 寻 找 正 确 的 数字 应 该 看 看 在 上 面 的 
步骤 1 中 列 出 的 技术 。 


1445: 


remote -> us.fatehi:schemacrawler-archetype-plugin-lint (-) 


Choose a number or apply filter (format: [groupId:]artifactId, cast 
ntains): 674: 477 
Choose ml.rugal.archetype:springmvc-spring-hibernate version: 
abt 


Choose a number: 


O01» WN 


0.1 


OOOO 
OORA WN 


6: 


Downloading: https://repo.maven.apache.org/maven2/ml/rugal/archety| 
pring-hibernate/0.6/springmvc-spring-hibernate-0.6.jar 

Downloaded: https://repo.maven.apache.org/maven2/ml/rugal/archetyp: 
ring-hibernate/0.6/springmvc-spring-hibernate-0.6.jar (30 KB at 6.t 
Downloading: https://repo.maven.apache.org/maven2/ml/rugal/archety| 
pring-hibernate/0.6/springmvc-spring-hibernate-0.6.pom 

Downloaded: https://repo.maven.apache.org/maven2/ml/rugal/archetyp: 
ring-hibernate/0.6/springmvc-spring-hibernate-0.6.pom (4 KB at 5.3 


Define value for property 'groupId': : com.yiibai.web 


Define value for property 'artifactId': : myweb 
Define value for property 'version':  1.0-SNAPSHOT: 
Define value for property 'package':  com.yiibai.web: 


Confirm properties configuration: 
groupId: com.yiibai.web 
artifactId: myweb 

version: 1.0-SNAPSHOT 

package: com.yiibai.web 


[INFO] Using following parameters for creating project from Archet' 
-spring-hibernate:0.6 

[INFO] --------.---..-22..2.22-2..2.2.22-..22-22.-2222.2-..22.2-..22.-2..2-2 
[INFO] Parameter: groupId, Value: com.yiibai.web 

[INFO] Parameter: artifactId, Value: myweb 

[INFO] Parameter: version, Value: 1.0-SNAPSHOT 

[INFO] Parameter: package, Value: com.yiibai.web 

[INFO] Parameter: packageInPathFormat, Value: com/yiibai/web 

[INFO] Parameter: package, Value: com.yiibai.web 

[INFO] Parameter: version, Value: 1.0-SNAPSHOT 

[INFO] Parameter: groupId, Value: com.yiibai.web 

[INFO] Parameter: artifactId, Value: myweb 

[INFO] project created from Archetype in dir: C:\worksp\myweb 
[INFO] 3 2262s esse cess cee cesses seen eee eee cece eee sees. 
[INFO] BUILD SUCCESS 

[INFO] ---+------ 22-2222 255252 eee sce s cee see cesses esse eee sees seen. 
[INFO] Total time: 05:07 min 

[INFO] Finished at: 2015-11-03T07:10:56+08:00 

[INFO] Final Memory: 16M/176M 

[INFO] ST 





它 会 生成 以 下 项 目 文件 夹 和 文件 。 


4 i myweb 
4 Œ src/test/java 
8 rugal 
出 rugal.sample.core.dao.impl 
出 rugal.sample.core.service.impl 
出 rugal.sample.springmvc.controller 
4 四 src/main/java 
BB config 
BB rugal.sample.common 
出 rugal.sample.core.dao 
出 rugal.sample.core.dao.impl 
出 rugal.sample.core.entity 
出 rugal.sample.core.service 
Hi rugal.sample.core.service.impl 
8 rugal.sample.springmvc.controller 
HB rugal.sample.springmvc.interceptor 
4 于 src/main/resources 


zh 


| hibernate.properties 


Il 


N 


| Jdbc.properties 


[my | 


|=) log4j.properties 
Bà JRE System Library [JavaSE-1.8] 
(org dom4j-1.6.1jar - M2_REPO\dom4j\dom4j\1.6.1 - C:\Users\Administrator\.m 
> (£ src 
> (£» target 
[v] pom.xml 


图 片 : 生成 Eclipse IDE 中 的 项 目 结构 。 


注意 ， 要 导 和 项目 到 Eclipse 中 ， 键 入 命令 mvn eclipse:eclipse， 并 导入 它 作为 一 个 
正常 的 项 目 : 


c:\worksp> cd myweb 
c:\worksp>myweb> mvn eclipse:eclipse 


3. 更 多 示例 


如 果 您 知道 哪个 archetypeArtifactld 使 用 ， 只 需 跳 过 交互 模式 命令 : 


3.1 maven-archetype-quickstart (Java Project) 


$ mvn archetype:generate -DgroupId-com.yiibai.core -DartifactId-Pr« 


“I = 














3.2 maven-archetype-webapp (Java Web Project) 


$ mvn archetype:generate -DgroupId-com.yiibai.web -DartifactlId-Pro: 





. Newbie: maven archetype:generate 
. Guide to Creating Archetypes 
. Maven Archetype Plugin — Usage 


personal site for Rugal Bernstein 


使 用 Maven 构 建 项 目 - Maven 教 程 


要 构建 一 个 基于 Maven 的 项 目 ， 打 开 控 制 台 ， 进 入 到 pom.xml 文件 所 放 的 项 目 文件 
夹 ， 并 发 出 以 下 命令 : 


mvn package 


这 将 执行 Maven 的 “package” 阶 段 。 


Maven 构 建生 命 周期 Maven 是 分 阶段 运行 ， 阅 读 默认 的 Maven 构 建生 命 周 期 文 
章 。 因 此 ， 执 行 "package" 阶 段 的 时 候 ， 所 有 阶段 "validate", "compile" 和 "test", 
包括 目前 的 阶段 "package” 将 被 执行 。 


“mvn package” 示 例 

当 你 运行 “mvn package" 命 令 ， 它 会 编译 源 代 码 ， 运 行 单元 测试 和 包装 这 取决 于 在 
pom.xml 文 件 的 “packaging” 标 签 。 例如 ， 

1. If "packaging" = jar, 将 您 的 项 目 打包 成 一 个 “jar” 文件 ， 并 把 它 变 成 你 的 目标 文件 


o 


File : pom.xml 
<project...><modelVersion>4.0.0</modelVersion><groupId>com. yiibai<, 

4 d zs 

2. 如 果 “packaging” = war, 将 您 的 项 目 打 包 成 “war” 文 件 ， 并 把 它 变 成 目标 文件 夹 。 


File : pom.xml 





<project...><modelVersion>4.0.0</modelVersion><groupId>com. yiibai<, 


eae ee ae 





使 用 Maven 清 理 项 目 - Maven 教 程 


在 基于 Maven 的 项 目 中 ， 很 多 缓存 输出 在 “target" 文 件 夹 中 。 如 果 想 建立 项 目 部 署 ， 
必须 确保 清理 所 有 缓存 的 输出 ， 从 面 能 够 随时 获得 最 新 的 部 署 。 


要 清理 项 目 缓存 的 输出 ， 发 出 以 下 命令 : 


mvn clean 


可 以 查看 到 输出 结果 .… 


_C:\worksp\yiibaiweb-core>mvn clean 

[INFO] Scanning for projects... 

[INFO] 

[INFO] -»------------2-22.-2220-222220-2---2x-----]x mer een Tem enema 
[INFO] Building yiibaiweb-core 1.0-SNAPSHOT 

[INFO] ---------.e---2eee ure lee Ll acer ree ere REL eA IL EE IRR: 
[INFO] 

[INFO] --- maven-clean-plugin:2.5:clean (default-clean) Q yiibaiwel 
[INFO] Deleting C:\worksp\yiibaiweb-core\target 

[INFO] REEE 
[INFO] BUILD SUCCESS 

[ENEONS ee, 
[INFO] Total time: 0.538 s 

[INFO] Finished at: 2015-11-03T07:32:48+08:00 

[INFO] Final Memory: 6M/77M 

MINEO eedem ee rm Meme ee 





4“mvn clean”" 执 行 ， 在 “target" 文 件 夹 中 的 一 切 都 将 被 删除 。 


部 署 进行 生产 要 部 署 您 的 项 目 进行 生产 ， 它 总 是 建议 使 用 “mvn clean package", 以 
确保 始终 获得 最 新 的 部 署 。 


使 用 Maven 运 行 单元 测试 - Maven 教 程 
要 通过 Maven 运 行 单元 测试 ， 发 出 此 命令 : 


mvn test 
这 会 在 你 的 项 目 中 运行 整个 单元 测试 。 


案例 学 习 
创建 两 个 单元 测试 ， 并 通过 Maven 的 运行 它 。 参 见 一 个 简单 的 Java 测试 类 : 


package com.yiibai.core; 


public class App { 
public static void main(String[] args) { 


System.out.println(getHelloworld()); 
j 
public static String getHelloWorld() { 
return "Hello World"; 
j 
public static String getHelloworld2() { 


return "Hello World 2"; 


Unit Test 1 


单元 测试 为 getHelloWorld() 方 法 。 


package com.yiibai.core; 


import junit.framework.Assert; 
import org.junit.Test; 


public class TestApp1 { 


@Test 
public void testPrintHelloworld() { 


Assert.assertEquals(App.getHelloWorld(), "Hello World"); 


Unit Test 2 
单元 测试 为 getHelloWorld2() 方 法 。 


package com.yiibai.core; 


import junit.framework.Assert; 
import org.junit.Test; 


public class TestApp2 { 


@Test 
public void testPrintHelloworld2() { 


Assert.assertEquals(App.getHelloworld2(), "Hello World 2"), 


i 
Aoo ë 
运行 单元 测试 
使 用 Maven 和 运行 单元 测试 看 见 下 面 的 例子 。 
示例 1 运行 整个 单元 测试 (TestApp1 和 TestApp2)， 发 出 以 下 命令 : 


mvn test 


示例 2 为 了 运行 单个 测试 (TestApp1)， 发 出 此 命令 : 


mvn -Dtest=TestApp1 test [INFO] --- maven-compiler-plugin:3.1:comp: 
[INFO] Nothing to compile - all classes are up to date 

[INFO] 

[INFO] --- maven-resources-plugin:2.6:testResources (default-testRe 
ibai-core --- 

[INFO] Using 'UTF-8' encoding to copy filtered resources. 

[INFO] skip non existing resourceDirectory C:NworkspNyiibai-coreNs! 
ces 

[INFO] 

[INFO] --- maven-compiler-plugin:3.1:testCompile (default-testComp: 
core --- 

[INFO] Nothing to compile - all classes are up to date 

[INFO] 

[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ yiib: 
[INFO] Surefire report directory: C:\worksp\yiibai-core\target\sure 


Running com.yiibai.core.TestAppi 
Tests run: 1, Failures: 0, Errors: ©, Skipped: ©, Time elapsed: 0.( 


Results 


Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


[INFO] -----------------------------------------------------------: 
[INFO] BUILD SUCCESS 

[INFO] ----------------- 9-2-2 n-ne nn nn nnn nee ee eee eens: 
[INFO] Total time: 2.143 s 

[INFO] Finished at: 2015-11-03T20:29:50+08:00 

[INFO] Final Memory: 11M/114M 

[INFO] -----------------------------------------------------------:' 





示例 3 为 了 运行 单个 测试 (TestApp2)， 发 出 此 命令 : 


mvn -Dtest-TestApp2 test 


注意 欲 了 解 更 多 "mvn test" 的 例子 ， 请 参考 Maven 测 试 插件 文档 。 


将 项 目 安装 到 Maven 本 地 资源 库 - Maven 教 程 


在 Maven 中 ， 可 以 使 用 “mvn instalp" 打 包 项 目 ， 并 自动 部 署 到 本 地 资源 库 ， 让 其 他 开 
发 人 员 使 用 它 。 


mvn install 


注意 ， 当 "“instal" 在 执行 阶段 ， 上 述 所 有 阶段 “validate", “compile", "test", 
"package", "integration-test", "verify" gr Eg, 包括 目前 的 “instalP* 阶 段 将 被 执行 有 序 。 
请 参阅 Maven 的 生命 周期 细节 。 


mvn install 示例 


一 个 Java 项 目 ， 具 有 以 下 pom.xml 文件 


File : pom.xml 


_<project xmlns-"http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»com.yiibai.core«c/groupId» 
<artifactId>yiibai-core</artifactId> 
<packaging>jar</packaging> 
<version>99</version> 
<name>yiibai-core</name> 
<url>http://maven.apache.org</url> 
<dependencies> 

<dependency> 
«groupId»junit«/groupId» 
«artifactId»junit«/artifactlId» 
«version»4.4«/version» 
<scope>test</scope> 

</dependency> 

</dependencies> 
</project>_ 


基于 以 上 pom.xml 文 件 ， 在 “mvn instal" 被 执行 ， 它 会 打包 项 目 为 “yiibai-core- 
99.jar" 文 件 ， 并 复制 到 本 地 存储 库 。 


警告 它 总 是 建议 运行 “clean” 和 “instal" 在 一 
起 ， 让 您 能 始终 部 署 最 新 的 项 目 到 林地 存储 库 。 


TutorialsPoint Java 技术 教程 


mvn clean install 


将 项 目 安装 到 Maven 本 地 资源 库 - Maven 教 程 2385 
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生成 基于 Maven 的 项 目 文档 站 点 - Maven 教 程 
在 Maven 中 ， 可 以 使 用 “mvn site”， 为 您 的 项 目 信 息 生 成 文档 站 点 。 


mvn site 
生成 的 网 站 是 在 项 目的 “target/site” 文 件 夹 中 。 
mvn site 示例 


请 参见 通过 “mvn site” 命 合生 成 的 文件 列表 。 


文档 页 面 的 样本 如 下 。 


r 















Cw | dà « 本 地 磁盘 (C) 》 worksp > yiibai-core » target » site > 
| xem sey IAM WHO) —— 0000 
| Ry 包含 到 库 中 v 共享 刻录 











J| NumberGenerator ^ 
dJ yiibai-core 


2015/11/3 20:47 
di sre 2015/11/3 20:47 


MR 


MiG 


Ji main = 
J java 
J com 
d yiibai 
" test 
出 target 
J classes 
" | maven-status 
J site 


J surefire-reports 





J test-classes 


(|i withaiweh-core 


k 10 WS 


© dependencies.html 

© dependency-convergence.ht... 
© dependency-info.html 

© index.html 

© plugin-management.html 

© plugins.html 

© project-info.html 

© project-summary.html 


2015/11/3 20:47 
2015/11/3 20:47 
2015/11/3 20:47 
2015/11/3 20:47 
2015/11/3 20:47 
2015/11/3 20:47 
2015/11/3 20:47 
2015/11/3 20:47 


Chrome HTML D... 
Chrome HTML D... 
Chrome HTML D... 
Chrome HTML D... 
Chrome HTML D... 
Chrome HTML D... 
Chrome HTML D... 
Chrome HTML D... 








| 10 个 项 目 


FRA RS AVE, 





注意 就 个 人 而 言 ， 我 不 喜欢 这 个 功能 了 ， 因 为 它 





想 知 道 自己 开发 的 项 目的 信息 可 以 试 试 。 











使 用 “mvn site-deploy” 部 署 站 点 (WebDAV 例 
f) - Maven 教 程 


这 里 有 一 po S de LE mvn site:deploy” 来 自动 部 署 生 成 的 文档 站 点 
到 服务 器 ， 过 WebDAV 机 制 说 明 。 


PS 在 这 篇 文章 中 ， 我 们 使 用 的 是 Apache 服 务 器 2.x 的 WebDAV 功 能 。 


1. 启用 WebDAV 


请 参见 本 指南 ， 了 解 如 何 启 用 WebDAV 访 问 Apache 2.x 服 务 器 。 


2. 配置 在 何 处 部 署 
在 pom.xml 中 ， 配 置 在 “distributionManagement” 标签 部 署 你 的 网 站 。 


<distributionManagement> 
<site> 
<id>yiibaiserver</id> 
<url>dav:http://127.0.0.1/sites/</url> 
</site> 
</distributionManagement> 


注 “dav” 前 级 是 HTTP 协 议 之 前 添加 的 ， 这 意味 着 通过 WebDAV 机 制 部 署 您 的 网 站 。 
或 者 ， 可 以 用 “scp” 取 代 它 ， 如 果 您 的 服务 器 支持 “scp” 访 问 。 


告诉 Maven 来 使 用 “wagon-webdav-jackrabbit" 扩 展 部 署 。 


<build> 
<extensions> 
<extension> 
<groupId>org.apache.maven.wagon</groupId> 
<artifactId>wagon-webdav-jackrabbit</artifactId> 
<version>1.0-beta-7</version> 
</extension> 
</extensions> 
</build> 


wagon-webdav 一 些 人 说 可 以 使 用 wagon-webdav"”， 但 这 不 是 我 斌 了 不 能 正常 工 
作 ， 所 以 这 里 用 “wagon-webdav-jackrabbit 代 蔡 。 


<extension> 
«groupId»org.apache.maven.wagon«c/groupId» 
<artifactId>wagon-webdav</artifactId> 
<version>1.0-beta-2</version> 
</extension> 


pom.xml 整个 文件 内 容 : 


«project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xSi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»com.yiibai.core«c/groupId» 
<artifactId>yiibai-core</artifactId> 
<packaging>jar</packaging> 
<version>1</version> 
<name>yiibai-core</name> 
<url>http://maven.apache.org</url> 
<build> 

<extensions> 
<extension> 
«groupId»org.apache.maven.wagon«c/groupId» 
<artifactId>wagon-webdav -jackrabbit</artifactId> 
<version>1.0-beta-7</version> 
</extension> 
</extensions> 
</build> 
<distributionManagement> 
<site> 
<id>yiibaiserver</id> 
<url>dav:http://127.0.0.1/sites/</url> 
</site> 
</distributionManagement> 
</project> 


3. Aci WebDAV Er 435 it 


通常 情况 下 ，WebDAV 是 需要 认证 的 访问 。 所 以 需要 把 相关 的 认证 细节 (用 户 名 和 密 
码 )%MAVEN PATH%/conf/settings.xml. 


File : settings.xml 


<servers> 
<server> 
<id>yiibaiserver</id> 
<username>admin</username> 
<password>123456</password> 
</server> 
</servers> 


“yiibaiserver” 是 什么 ? 在 Maven 的 "的 settings.xml" 文 件 服务 器 ID 将 在 “的 
pom.xml" 文 件 被 网 站 引用 。 


4. mvn site:deploy 


“mvn site:deploy” 命令 执 行 : 


C:\worksp\yiibai-core>mvn site:deploy 


Transfer finished. 11622 bytes copied in 0.021 seconds 

十 一 月 03, 2015 9:00:07 下 午 org.apache.commons.httpclient.auth.Auth 
cessor selectAuthScheme 

信息 : digest authentication scheme selected 

Uploading: .//project-info.html to http://127.0.0.1/sites/ 


## 十 一 月 03, 2015 9:00:07 F4 org.apache.commons.httpclient.auth.Au 
rocessor selectAuthScheme 

信息 : digest authentication scheme selected 
##http://127.0.0.1/sites//./project-info.html - Status code: 201 


Transfer finished. 11170 bytes copied in 0.035 seconds 

十 一 月 03, 2015 9:00:07 FF org.apache.commons.httpclient.auth.Auth 
cessor selectAuthScheme 

信息 : digest authentication scheme selected 

Uploading: .//project-summary.html to http://127.0.0.1/sites/ 


## 十 一 月 03, 2015 9:00:07 F4 org.apache.commons.httpclient.auth.Au 
rocessor selectAuthScheme 

信息 : digest authentication scheme selected 
##http://127.0.0.1/sites//./project-summary.html - Status code: 20: 


Transfer finished. 10190 bytes copied in 0.021 seconds 
http://127.0.0.1/sites/ - Session: Disconnecting 
http://127.0.0.1/sites/ - Session: Disconnected 

[INFO] -----------------------------------------------------------. 
[INFO] BUILD SUCCESS 

[INFO] -----------------------------------------------------------: 
[INFO] Total time: 28.737 s 

[INFO] Finished at: 2015-11-03T21:00:07+08:00 

[INFO] Final Memory: 14M/156M 

[INFO] -----------------------------------------------------------: 





所 有 站 点 文件 夹 和 文件 ， 在 项 目 文件 夹 - “target/site” 会 被 自动 部 署 到 服务 器 。 


5. 输出 


在 本 例 中 ， 可 以 通过 这 个 网 址 访问 该 部 署 的 站 点 : http://127.0.0.1/sites/， 见 下 图 : 
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(5 yiibai-core - About x WEE 


| > QC | 口 127.0.0.1/sites/ 
vilbal- core 





Project Documentation l T 
"ens" | About yiibai-core 


Dependency 
Convergence 

Dependency 
Information 

About 

Plugin Management 

Project Plugins 

Project Summary 


Built by: “me. 
Maven 


There is currently no description associated with this 
project. 


Copyright © 2015. All Rights Reserved. 





1. http://maven.apache.org/plugins/maven-site-plugin/usage.html 

2. http://mojo.codehaus.org/wagon-maven-plugin/usage.html 

3. http://maven.apache.org/plugins/maven-site-plugin/deploy-mojo.html 

4. http://maven.40175.n5.nabble.com/site-deploy-using-DAV-with-digest-auth- 
td125042.html 

5. http://www.sonatype.com/books/maven-book/reference/site-generation-sect- 
deploy-site.html 
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部 署 基 于 Maven 的 war 文 件 到 Tomcat - Maven 教 程 


在 本 教程 中 ， 我 们 将 学 习 如 何 使 用 Maven 的 Tomcat 插 件 打包 并 部 署 一 个 WAR 文 件 
到 Tomcat(Tomcat 的 6 和 7。 


要 用 到 工具 : 


1. Maven 3 
2. Tomcat 6.0.37 
3. Tomcat 7.0.53 


Tomcat 7 发 布 URL = http://ocalhost:8080/manager/text 命令 = mvn 
tomcat7:deploy 


Tomcat 6 发 布 URL = hitp://localhost:8080/manager/ 命令 = mvn tomcat6:deploy 


1. Tomcat 7 示例 


这 个 例子 说 明了 如 何在 Tomcat7 打 包 并 部 署 WAR 文 件 。 
1.1 Tomcat 认证 添加 具有 角色 管理 器 GUI 和 管理 脚本 的 用 户 。 
% TOMCAT7_PATH%/conf/tomcat-users.xml 
<?xml version='1.0' encoding='utf-8'?> 
<tomcat -users> 
«role rolename="manager -gui"/> 
«role rolename-"manager-script"/» 
«user username-"admin" password="password" roles="manager -gui,r 
</tomcat -users> 
ae 


1.2 Maven 认证 添加 在 上 面 Maven 设置 文件 的 Tomcat 用 户 ， 是 之 后 Maven 使 用 此 
用 户 来 登录 Tomcat 服 务 器 。 


%MAVEN_PATH%/conf/settings.xml 





<?xml version="1.0" encoding="UTF-8"?> 
<settings ...> 
<servers> 


<server> 
<id>TomcatServer</id> 
<username>admin</username> 
<password>password</password> 
</server> 


</servers> 
</settings> 


1.3 Tomcat7 Maven 插件 声明 一 个 Maven 的 Tomcat 插 件 。 


pom.xml 


<plugin> 
<groupId>org.apache. tomcat .maven</groupid> 
<artifactIid>tomcat7-maven-plugin</artifactId> 
<version>2.2</version> 
<configuration> 
<url>http://localhost :8080/manager/text</url1> 
<server>TomcatServer</server> 
<path>/yiibaiwebApp</path> 
</configuration> 
</plugin> 


怎么 运行 的 ? 在 部 署 过 程 中 ， 它 告诉 Maven Hit BS WAR 文件 Tomcat 服 务 器 ， 
rhtip:/flocalhost8080/managerliext , 在 路 径 “/yiibaiWebApp“ 上 , 使 用 
“TomcatServer” (settings.xml) 用 户 名 和 密码 来 进行 认证 。 


1.4 发 布 到 Tomcat 以 下 的 命令 是 用 来 操纵 Tomcat WAR 文 件 。 


mvn tomcat7:deploy 
mvn tomcat7:undeploy 
mvn tomcat7:redeploy 


示例 


> mvn tomcat7:deploy 


[INFO] Deploying war to http://localhost:8080/yiibaiWebApp 
Uploading: http://localhost:8080/manager/text/deploy?path=%2Fyiiba: 
Uploaded: http://localhost :8080/manager/text/deploy?path=%2Fyiibail 


[INFO] tomcatManager status code:200, ReasonPhrase:OK 

[INFO] OK - Deployed application at context path /yiibaiWebApp 
[INFO] -----------------------------------------------------------， 
[INFO] BUILD SUCCESS 

[INFO] -----------------------------------------------------------: 
[INFO] Total time: 8.507 s 

[INFO] Finished at: 2015-08-05T11:35:25+08:00 

[INFO] Final Memory: 28M/308M 

[INFO] -----------------------------------------------------------， 





2. Tomcat 6 示例 

这 个 例子 说 明了 如 何在 Tomcat6 打 包 和 部 署 WAR 文 件 。 这 些 步骤 和 Tomcat7 是 一 样 
的 ， 只 是 部 署 URL 和 命令 名 称 不 同 。 

2.1 Tomcat 认证 

%TOMCAT6_PATH%/conf/tomcat-users.xml 


<?xml version='1.0' encoding-'utf-8'?» 
<tomcat -users> 


«role rolename="manager -gui"/> 
<role rolename="manager-script"/> 
«user username="admin" password="password" roles="manager -gui,r 


</tomcat -users> 


EPE 





2.2 Maven 认证 
%MAVEN_PATH%/conf/settings.xml 


<?xml version="1.0" encoding="UTF-8"?> 
<settings ...> 
<servers> 


<server> 
<id>TomcatServer</id> 
<username>admin</username> 
<password>password</password> 
</server> 


</servers> 
</settings> 


2.3 Tomcat6 Maven 插件 


pom.xml 
<plugin> 

<groupId>org.apache. tomcat .maven</groupId> 

<artifactId>tomcat6-maven-plugin</artifactId> 

<version>2.2</version> 

<configuration> 
<url>http://localhost :8080/manager</url1> 
<server>TomcatServer</server> 
<path>/yiibaiwebApp</path> 

</configuration> 

</plugin> 


2.4 发 布 到 Tomcat 


mvn tomcat6:deploy 
mvn tomcat6:undeploy 
mvn tomcat6:redeploy 


示例 


> mvn tomcat6:deploy 


[INFO] Deploying war to http://localhost :8080/yiibaiWebApp 
Uploading: http://localhost:8080/manager/deploy?path-?2FyiibaiWebA[ 
Uploaded: http://localhost :8080/manager/deploy?path=%2FyiibaiwebAp; 


[INFO] -----------------------------------------------------------: 
[INFO] BUILD SUCCESS 

[INFO] -----------------------------------------------------------: 
[INFO] Total time: 22.652 s 

[INFO] Finished at: 2014-08-05T12:18:54+08:00 

[INFO] Final Memory: 30M/308M 

[INFO] -----------------------------------------------------------: 





1. Apache Tomcat 7 Manager App HOW-TO 
2. Apache Tomcat 6 Manager App HOW-TO 
3. Tomcat Maven Plugin 

4. Tomcat Maven Plugin — Context Goals 


MyBatis 教 程 


MyBatis 是 支持 普通 SQL 查询 ,存储 过 程 和 高 级 映射 的 优秀 持久 层 框架 。MyBatis 
消除 了 几乎 所 有 的 JDBC 代码 和 参数 的 手工 设置 以 及 结果 集 的 检索 。MyBatis 使 用 
简单 的 XML 或 注解 用 于 配置 和 原始 映射 ,将 接口 和 Java 的 POJOs(Plain Old Java 
Objects, 普 通 的 Java 对 象 ) 映 射 成 数据 库 中 的 记录 。 


每 个 MyBatis 应 用 程序 主要 都 是 使 用 SqlSessionFactory 实 例 的 ， 一 个 
SqlSessionFactory 实 例 可 以 通过 SqlSessionFactoryBuilder 获 得 。 
SqlSessionFactoryBuilder 可 以 从 一 个 xml 配 置 文件 或 者 一 个 预定 义 的 配置 类 的 实例 
获得 。 用 xml 文 件 构建 SqlSessionFactory 实 例 是 非常 简单 的 事情 。 推 荐 在 这 个 配置 
中 使 用 类 路 径 资 源 (classpath resource)， 但 你 可 以 使 用 任何 Reader 实 例 ， 包 括 用 
文件 路 径 或 fle:W/ 开 头 的 url 创 建 的 实例 。MyBatis 有 一 个 实用 类 ----Resources， 它 有 
很 多 方法 ， 可 以 方便 地 从 类 路 径 及 其 它 位 置 加 载 资 源 。 MyBatis 最 强大 的 特性 之 一 
就 是 它 的 动态 语句 功能 。 如 果 您 以 前 有 使 用 JDBC 或 者 类 似 框 架 的 经 历 ， 您 就 会 明 
白 把 SQL 语句 条 件 连接 在 一 起 是 多 么 的 痛苦 ， 要 确保 不 能 忘记 空格 或 者 不 要 在 
columns 列 后 面 省 略 一 个 逗号 等 。 动 态 语 名 能够 完全 解决 掉 这 些 痛 苦 。 尽 管 与 动态 
SQL 一 起 工作 不 是 在 开 一 个 party， 但 是 MyBatis 确 实 能 通过 在 任何 映射 SQL 语句 中 


使 用 强大 的 动态 SQL 来 改进 这 些 状 况 。 
动态 SQL 元 素 对 于 任何 使 用 过 JSTL 或 者 类 似 于 XML 之 类 的 文本 处 理 器 的 人 来 说 ， 都 是 非常 熟 


MyBatis 环 境 配置 及 人 门 - MyBatis 教 程 


Mybatis 开发 环境 搭建 ， 选 择 : MyEclipse8.5 版 本 ，mysql 5.5, jdk 1.8, 
mybatis3.2.3.jar 包 。 这 些 软件 工具 均 可 以 到 各 自 的 官方 网 站 上 下 载 。 


整个 过 程 在 概 如 下 ， 


1. 在 本 教程 中 ， 建 立 java 工程 ， 但 一 般 都 是 开发 web 项 目 ， 这 个 系列 教程 最 后 是 
web， 但 这 里 为 了 方便 学 习 ， 本 教程 前 面 建 立 的 都 是 java 工程 。 2. 将 mybatis- 
3.2.3.jar, mysql-connector-java-5.1.25-bin.jar 创建 两 个 用 户 自 定 库 (User 
Libary) : mysql-connector 和 mybatis ; 3. 创建 mysql! 测试 数据 库 和 用 户 表 , 注 
意 ， 数 据 库 使 用 的 是 utf-8 编码 。 以 解决 不 必要 的 中 文 乱码 问题 。 


创建 Java 工程 


首先 建立 一 个 名 字 为 Helloword 的 java project。 选 择 "File" -> "New" ->"Java 
Project"， 如 下 图 所 示 : 





n 
New Java Project 

Create a Java Project 一 
Create a Java project in the workspace or in an external location. / 


Project name: mybatis-start 








Contents 


© Create new project in workspace 


Create project from existing source 








D:\workspce\mybatis-start Browse 
JRE 
© Use an execution environment JRE: JavaSE-1.6 z 
Use a project specific JRE: com.sun.java.jdk.win32.x86 1.6.0.013 
Use default JRE (currently ‘com.sun,java.jdk.win32.x86_1.6.0.013') Configure JREs... 


Project layout 





?) < Back Next = Cancel 











TutorialsPoint Java 技术 教程 


这 样 就 创建 了 一 个 Java 工程 了 ， 我 们 继续 下 一 步 。 接 下 来 我 们 在 mybatis-start 项 
目 中 加 入 两 个 所 需 的 程序 库 : D ena 和 mybatis, 4 BERR di "mybatis- 
start" 5j 项 目 ， 从 弹出 的 菜单 中 选 "Build Path" -> "Add Libaries..." ， 如 下 图 所 
ZN: 


Add Library 
Select the library type to add. 





Connectivity Driver Definition (MyEclipse incompatible) 
JRE System Library 

JUnit 

Maven Managed Dependencies 

MyEclipse Libraries 

Plug-in Dependencies 


^ viy p 
WTP Server pinea (MyEcipse Sai ams 


WTP Web App Libraries (MyEclipse incompatible) 








从 中 选择 “User Library"， 点 击 “Next>"， 创 建 两 个 类 库 为 : mysql-connector 和 
mybatis， 如 下 所 示 : 
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User libraries: 








Q EE, e || e | el 





m d “User Libararies.…"， 继 续 下 一 步 ， 创 建 一 个 新 的 类 库 ， 如 下 图 所 示 : 
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TutorialsPoint Java 技术 教程 








type filter text 








Java 
Build Path 
User Libraries 





User Libraries 








Kj New User Library 


User libraries can be added to a Java Build path and bundle a number of 
external archives. System libraries will be added to the boot class path 
when launched. 


Defined user libraries: 


Add JARs... 


Remove 

















到 此 用 户 的 一 个 类 库 创 建 完成 ， 以 相同 的 方式 来 创建 另 一 个 类 库 : 


二 、 创 建 数 据 库 和 User R 
创建 所 需 的 数据 库 和 表 ， 要 创建 的 数据 库 是 : yiibai， 并 在 yiibai 数据 库 创 建 一 个 


表 : user， 如 下 图 所 示 : 


创建 数据 库 : yiibai， 使 用 utf-8 编码 。 
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数据 库 名 : yiibai 





字符 集 ; utf8 -- UTF-8 Unicode v 
排序 规则 : 

















接 下 我 们 创建 一 个 表 : user， 并 插入 一 条 记录 信息 ， 其 结构 如 下 所 示 : 


CREATE TABLE ‘user ( 
"id? int(10) unsigned NOT NULL AUTO INCREMENT, 
“name> varchar(64) NOT NULL DEFAULT '', 
"dept? varchar(254) NOT NULL DEFAULT '', 
"website! varchar(254) DEFAULT '', 
"phone? varchar(16) NOT NULL DEFAULT '', 
PRIMARY KEY ("^ id') 
) ENGINE-InnoDB AUTO INCREMENT-2 DEFAULT CHARSET-latini; 


INSERT INTO "user? VALUES ('1', 'yiibai', 'Tech', 'http://www.yiib: 
1 人 避 
三 、 创 建 Mybatis 配置 文件 


到 此 为 止 ， 前 期 准 各 工作 就 完成 了 。 下 面 开 始 真正 配置 mybatis-start 项 目 。 设 
i& mybatis 配置 文件 : Configure.xml, 在 src/config 目录 下 建立 此 文件 ， 内 容 如 下 : 





<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
«typeAlias alias="User" type-z'com.yiibai.mybatis.models.Us: 
«/typeAliases» 
«environments default="development"> 
«environment id="development"> 
«transactionManager type="JDBC" /> 
<dataSource type="POOLED"> 
«property name="driver" value="com.mys¢ 
«property name-"url" value="jdbc:mysql://127.0.0.1 
«property name="username" value="root" /» 


«property name="password" valuez"" /> 
</dataSource> 
</environment> 
</environments> 


<mappers> 
<!-- // power by http://www.yiibai.com --> 
«mapper resource="com/yiibai/mybatis/models/User.xml" /> 
</mappers> 
</configuration> 


LEX 
四 、 创 建 实体 类 和 了 映射 文件 


首先 创建 一 个 包 : com.yiibai.mybatis.models， 并 在 下 创建 与 数据 库 表 对 应 的 
Userjava 类 及 其 映射 文件 : User.xml， 详 细 如 下 图 所 示 : 






a 


package com.yiibai.mybatis.models; 


public class User { 
private int id; 
private String name; 
private String dept; 
private String phone; 
private String website; 


public String getWebsite() { 
return website; 


public void setWebsite(String website) { 
this.website = website; 
} 


public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public String getDept() { 
return dept; 


public void setDept(String dept) { 
this.dept = dept; 
} 


public String getPhone() { 
return phone; 


public void setPhone(String phone) { 
this.phone = phone; 
} 


同时 建立 这 个 User 类 对 应 的 映射 文件 Userxml， 详 细 如 下 代码 所 示 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


«mapper namespace="com.yiibai.mybatis.models.UserMapper'"> 
«select id="GetUserByID" parameterType="int" resultType="User": 
select * from ‘user where id = #{id} 
</select> 
</mapper> 


«| uni 








下 面 是 对 这 几 个 配置 文件 一 点 解释 说 明 : 1、 配 置 文件 Configure.xml = mybatis 
用 来 建立 sessionFactory， 里 面 主要 包含 了 数据 库 连 接 相 关内 容 ， 还 有 java 类 所 对 
应 的 别名 ， 比 如 : 这 个 别名 非常 重要 ， 在 具体 的 类 的 映射 中 ， 上 比如 : User.xml 中 
resultType 就 是 对 应 这 个 。 要 保持 一 致 ， 这 里 的 resultType 还 有 另外 单独 的 定义 方 
式 ， 后 面 学 习 到 我 们 再 详细 介绍 说 明 。 2. Configure.xml 里 面 的 是 包含 要 映射 的 
类 的 xml 配置 文件 。 3、 在 User.xml 文件 里 面 主要 是 定义 各 种 SQL 语句 ， 以 及 这 
些 语句 的 参数 ， 以 及 要 返回 的 类 型 等 等 。 


五 、 运 行程 序 测试 结 


在 src 源码 目录 下 建立 一 个 类 叫 作 : HelloWord, 来 运行 测试 配置 环境 是 否 成 功 ， 具 
体 代 码 如 下 示 : 


import java.io.Reader; 


import org.apache.ibatis.io.Resources; 

import org.apache.ibatis.session.SqlSession; 

import org.apache.ibatis.session.SqlSessionFactory; 

import org.apache.ibatis.session.SqlSessionFactoryBuilder; 


import com.yiibai.mybatis.models.*; 


VERSES 
* 
* @author yiibai 
* @copyright http://www.yiibai.com 
* @date 2015/09/22 
i 
public class HelloWord { 
private static SqlSessionFactory sqlSessionFactory; 
private static Reader reader; 


static { 
try { 
reader = Resources.getResourceAsReader ("config/Configut 
sqlSessionFactory = new SqlSessionFactoryBuilder().bui- 
} catch (Exception e) { 
e.printStackTrace(); 
j 
j 


public static SqlSessionFactory getSession() { 
return sqlSessionFactory; 
y 


ASIA 
* (param args 
oF 
public static void main(String[] args) { 
// TODO Auto-generated method stub 
SqlSession session = sqlSessionFactory.openSession(); 
try { 
User user = (User) session.selectOne( 
"com. yiibai.mybatis.models.UserMapper .GetUserB\ 
if(user!znull)( 
String userInfo = "4: "+user.getName()+", MÆRI 
System.out.println(userInfo); 


} 
} finally { 
session.close(); 








MyBati 


Zr rr 
ZN 不 = 
FATE 
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这 个 程序 ， 不 是 得 到 查询 结果 了 ?正确 的 输出 结果 应 该 如 下 : 
名 字 : yiibai， 所属 部 门 : Tech， 主 页 : http://ww.yiibai.com 








J 
> E: Problems | @ Javadoc! |, Declaration 





«terminated » HelloWord (1) Java Application] D:\Program Files\MyEclipse 8.5\Common\binary\com.sur 
名 字 : yiibai, PRESB]: Tech， 主 页 nttp://www.yiibai.com 





恭喜 你 ， 环 境 搭建 配置 成 功 ， 在 接 下 来 章节 
删改 查 。 


我 们 将 学 习 Mybatis 的 操作 方式 : 12 
Jar 包 下 载 : http://pan.baidu.com/s/1bnyRJ9H 


narr ipga T a : 
o^ 境 Ace 及 AM] N ly 


/ 
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在 上 一 章 中 ， 我 们 已 经 搭建 了 myeclipse,mybatis,mysql 的 开发 环境 ， 并 且 实 现 了 
mybatis 的 一 个 简单 的 查询 。 要 注意 的 是 ， 这 种 方式 是 用 SqlSession 实例 来 直接 执 
行 已 映射 的 SQL 语句 : 


session.selectOne("com.yiibai.mybatis.models.UserMapper.getUserByID", 1)， 但 
是 还 有 比 这 更 简单 的 方法 ， 而 且 是 更 好 的 方法 ， 使 用 合理 描述 参数 和 SQL 语句 返回 
值 的 接口 (比如 : IUserclass)， 这 样 现 在 就 可 以 至 此 那个 更 简单 ， 更 安全 的 代码 ， 
没有 容易 发 生 的 字符 串 文 字 和 转换 的 错误 ， 下 面 是 详细 过 程 : 


1、 创 建 一 个 接口 : IUser， 并 在 其 中 声明 对 应 的 操作 方法 


在 src 源码 目录 下 创建 一 个 包 : com.yiibai.mybatis.dao， 并 建立 接口 类 IUser 及 一 
个 方法 , 在 方法 上 面 ， 我 们 使 用 了 一 个 SQL 注 释 ， 内 容 如 下 : 


package com.yiibai.mybatis.dao; 
import org.apache.ibatis.annotations.Select; 
import com.yiibai.mybatis.models.User; 
[EES 
* @author yiibai.com 
Pfs 
public interface IUser { 


@Select("select * from user where id= #{id}") 
public User getUserByID(int id); 


请 注意 ， 这 里 面 代 码 有 一 个 方法 名 getUserBylD 必须 与 User.xml 里 面 配 置 的 
select 的 id 对 应 (<select id="getUserBylD")Al4. 


2、 创 建 对 应 映射 接口 SQL 语句 


首先 配置 MyBatis 所 需 的 数据 连接 文件 ， 这 里 创建 一 个 文件 : 
src/config/Configure.xml ， 其 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
«typeAlias alias="User" type-z'com.yiibai.mybatis.models.Us: 
«/typeAliases» 


«environments default="development"> 
«environment id="development"> 
«transactionManager type="JDBC" /> 
<dataSource type="POOLED"> 
«property name-"driver" value="com.mysql.jdbc.Drive 
«property name-"url" value="jdbc:mysql://127.0.0.1 
«property name="username" value="root" /» 
«property name="password" value="" /> 
«/dataSource» 
</environment> 
</environments> 


<mappers> 
<!-- // power by http://www.yiibai.com --> 
«mapper resource-'com/yiibai/mybatis/models/User.xml" /> 
</mappers> 
</configuration> 


E ES E 


T£ 8) : com.yiibai.mybatis.models 下 创建 一 个 Userjava 类 文件 ， 与 上 一 节 中 User 
类 代码 相同 ， 这 里 只 是 拷贝 过 来 ，User.java 具体 的 内 容 如 下 : 





package com.yiibai.mybatis.models; 


public class User { 
private int id; 
private String name; 
private String dept; 
private String phone; 
private String website; 


public String getWebsite() { 
return website; 


public void setWebsite(String website) { 
this.website = website; 
} 


public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 

} 

public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public String getDept() { 
return dept; 


public void setDept(String dept) { 
this.dept = dept; 
} 


public String getPhone() { 
return phone; 


public void setPhone(String phone) { 
this.phone = phone; 
} 


与 Userjava 对 应 的 XML 配置 文件 : User.xml 内 容 如 下 所 示 GE : 在 这 一 小 
小 ， 此 功能 用 不 上 ) : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


«mapper namespace="com.yiibai.mybatis.models.UserMapper'"> 
«select id-"getUserByID" parameterType="int" resultType="User": 
select * from ‘user where id = #{id} 
</select> 
</mapper> 


«| x 











这 里 要 注意 的 是 ，IUserjava 有 一 个 方法 名 getUserByID 必须 与 User.xml PAME 
的 select 的 id 对 应 (<select id="getUserByID") 同 名 。 


3、 测 试 接口 映射 


我 们 在 src 这 个 目录 下 创建 一 个 类 : Main.java， 用 来 测试 整个 配置 和 程序 运行 结 
果 ， 有 关 Main.java 的 代码 详细 内 容 如 下 : 


名 字 : New name, 所 属 部 门 : Tech, 主页 : http://ww.yiibai.com 


后 补充 ， 整 个 工程 mybatis-interface-02 的 结构 如 下 图 所 示 : 


地 


4 ©! mybatis-interface-02 
4 (8 src 
4 iB (default package) 
[JJ Main.java 
4 HB com yiibai.mybatis.dao 
J) lUserjava 
4 HB com yiibai.mybatis.models 
[J] User.java 
IX] User.xml 
4 {B config 
iX; Configure.xml 
= JRE System Library [JavaSE-1.6] 
Ei mybatis 
Ej, mysql-connector 


注意 : 最 后 还 有 一 个 重要 说 明 ， 需要 导入 两 个 jar : mysgl-connector 和 
mybatis3.jar。 在 上 一 小 节 中 ， 有 介绍 怎么 创建 用 户 库 。 
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前 面 的 小 节 我 们 已 经 讲 到 用 接口 的 方式 编程 。 使 用 这 种 方式 ， 需 要 注意 的 一 个 地 方 
就 是 ， 在 Userxml 配置 文件 中 ，mapper 
namespace="com.yiibai.mybatis.interIUser" ， 命 名 空间 对 应 非常 重要 ， 名 称 不 能 
有 错 ， 必 须 与 我 们 定义 的 package 和 接口 一 致 。 如 果 不 一 致 就 会 出 错 ， 这 一 章 主 
要 在 上 一 讲 基于 接口 编程 的 基础 上 完成 如 下 操作 : 1. 使 用 mybatis 查询 用 户 数据 ( 读 
取 用 户 列表 ) 2. 使 用 mybatis 增加 用 户 数 据 3. 使 用 mybatis 更 新 用 户 数 据 4. 使 用 
mybatis 删除 用 户 数据 


查询 数据 ， 前 面 已 经 讲 过 简单 的 查询 单个 用 户 数据 ， 在 这 里 将 查询 出 用 户 列表 ， 


要 查询 出 列表 ， 也 就 是 返回 List, 在 我 们 这 个 例子 中 也 就 是 List«User» , 要 以 这 种 方 
式 返 回 数据 ， 需 要 在 User.xml 里 面 配置 返 回 的 类 型 resultMap, 注意 不 是 
resultType, 而 这 个 resultMap 所 对 应 的 应 该 是 我 们 自己 配置 。 


1、 创 建 工 程 并 配置 所 需 环境 


我 们 首先 来 创建 一 个 工程 : mybatis-curd-03， 与 第 一 节 中 介绍 的 环境 配置 一 样 ， 加 
入 所 需 的 jar & : mysql-connector 和 mybatis3.jar。 配 置 
src/config/Configure.xml， 其 文件 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 


<configuration> 
<typeAliases> 


«typeAlias alias="User" type-z'com.yiibai.mybatis.models.Us: 


«/typeAliases» 


«environments default="development"> 
«environment id="development"> 
«transactionManager type="JDBC" /> 
<dataSource type="POOLED"> 


<property 
<property 
<property 
<property 
</dataSource> 
</environment> 
</environments> 


<mappers> 


name-"driver" value="com.mysql.jdbc.Drive 
name-"url" value="jdbc:mysql://127.0.0.1 
name="username" value="root" /> 
name="password" value="" /> 


<!-- // power by http://www.yiibai.com --> 
«mapper resource="com/yiibai/mybatis/models/User.xml" /> 


</mappers> 
</configuration> 


le LS 


2. 6|£& Java 类 和 接口 





在 这 里 需要 创建 一 个 类 和 一 个 接口 : Userjava X WIlUser.javaf£ O, User.java X f 
于 包 com.yiibai.mybatis.models 下 ，User.java 类 代码 内 容 如 下 : 


package com.yiibai.mybatis.models; 


public class User { 
private int id; 
private String name; 
private String dept; 
private String phone; 
private String website; 


public String getWebsite() { 
return website; 


public void setWebsite(String website) { 
this.website = website; 


} 
public int getId() { 


return id; 


public void setId(int id) { 
this.id = id; 
} 


public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


public String getDept() { 
return dept; 


public void setDept(String dept) { 
this.dept = dept; 
} 


public String getPhone() { 
return phone; 


public void setPhone(String phone) { 
this.phone = phone; 
} 


lUser.java##O z+ com.yiibai.mybatis.dao 下 ，IUserjava 接 口 代码 内 容 如 下 : 


package com.yiibai.mybatis.dao; 
import java.util.List; 
import org.apache.ibatis.annotations.Select; 


import com.yiibai.mybatis.models.User; 
Hf a 


* 


* @author yiibai 
* 
Ev 
public interface IUser ( 
//üSelect("select * from user where id= #{id}") 
//public User getUserByID(int id); 
public List«User» getUserList(); 


public void insertUser(User user); 
public void updateUser(User user); 
public void deleteUser(int userId); 


public User getUser(int id); 


这 里 还 需要 一 个 XML 文件 ， 与 前 一 小 节 中 一 样 ， 使 用 的 是 Userxml， 在 这 其 中 ， 
我 们 分 别 对 应 了 增删 改 查 的 操作 (每 一 个 操作 的 ID 对 应 于 IUser 接 口 的 方法 ) ， 其 
内 容 如 下 : 


import java.io.Reader; 
import java.text.MessageFormat; 
import java.util.List; 


import org.apache.ibatis.io.Resources; 

import org.apache.ibatis.session.SqlSession; 

import org.apache.ibatis.session.SqlSessionFactory; 

import org.apache.ibatis.session.SqlSessionFactoryBuilder ; 


import com.yiibai.mybatis.dao.IUser; 
import com.yiibai.mybatis.models.User; 


public class Main { 
private static SqlSessionFactory sqlSessionFactory; 
private static Reader reader; 


static ( 

try { 
reader = Resources.getResourceAsReader ("config/Configu! 
sqlSessionFactory = new SqlSessionFactoryBuilder().bui- 


} catch (Exception e) 1 
e.printStackTrace(); 
} 


} 


public static SqlSessionFactory getSession() { 
return sqlSessionFactory; 
} 


jee 
* @param args 
24 
public static void main(String[] args) { 
// TODO Auto-generated method stub 
SqlSession session - sqlSessionFactory.openSession(); 


try { 
//User user - (User) session.selectOne( 
// "com.yiibai.mybatis.models.UserMapper.getUsei 


IUser iuser - session.getMapper(IUser.class); 
// 用 户 数据 列表 

//getUserList(); 

// 插入 数据 

//testInsert(); 

//testUpdate(); 


// 删除 数据 
testDelete(); 


) finally ( 
session.close(); 
} 
} 
// 
public static void testInsert() 
{ 
try 
{ 


// 获取 Session 连 接 

SqlSession session = sqlSessionFactory.openSession(); 
// 获取 Mapper 

IUser userMapper = session.getMapper(IUser.class); 
System.out.println("Test insert start..."); 

// 执行 插入 

User user = new User(); 

user.setId(0); 

user.setName("Google"); 

user.setDept(" Tech"); 
user.setWebsite("http://www.google.com"); 
user.setPhone("120"); 

userMapper.insertUser(user); 

// 提交 事务 


session.commit(); 


// 显示 插入 之 后 User 信 息 

System.out.println(" 
After insert"); 

getUserList(); 


System.out.println("Test insert finished..."); 
j 
catch (Exception e) 
{ 
e.printStackTrace(); 
j 


} 


// 获取 用 户 列表 
public static void getUserList(){ 
try 
{ 
SqlSession session = sqlSessionFactory.openSession(); 
IUser iuser = session.getMapper(IUser.class); 
// 显示 User 信 息 
System.out.println("Test Get start..."); 
printUsers(iuser.getUserList()); 
System.out.println("Test Get finished..."); 
jcatch (Exception e) 


{ 
e.printStackTrace(); 

j 
j 
public static void testUpdate() 
{ 

try 

{ 


SqlSession session = sqlSessionFactory.openSession(); 
IUser iuser = session.getMapper(IUser.class); 
System.out.println("Test update start..."); 
printUsers(iuser.getUserList()); 
// 执行 更 新 
User user = iuser.getUser(1); 
user.setName("New name"); 
iuser.updateUser(user); 
// 提交 事务 
session.commit(); 
// 显示 更 新 之 后 User 信 息 
System.out.println(" 
After update"); 

printUsers(iuser.getUserList()); 
System.out.println("Test update finished..."); 

jcatch (Exception e) 


( 


j 


} 
// 删除 用 户 信息 
public static void testDelete() 


e.printStackTrace(); 


try 


SqlSession session = sqlSessionFactory.openSession(); 
IUser iuser = session.getMapper(IUser.class); 
System.out.println("Test delete start..."); 
// 显示 删除 之 前 User 信 息 
System.out.println("Before delete"); 
printUsers(iuser.getUserList()); 
// 执行 删除 
iuser.deleteUser(3); 
// 提交 事务 
session.commit(); 
// 显示 删除 之 后 User 信 息 
System.out.println(" 
After delete"); 

printUsers(iuser.getUserList()); 
System.out.println("Test delete finished..."); 

}catch (Exception e) 


t 
} 


e.printStackTrace(); 


} 
fee 


* 


* 打印 用 户 信息 到 控制 台 


* @param users 
us 
private static void printUsers(final List«User» users) 


( 


int count - 0; 


for (User user : users) 


{ 
System.out.println(MessageFormat. format ("============= 
System.out.println("User Id: " + user.getId()); 
System.out.println("User Name: " + user.getName()); 
System.out.println("User Dept: " + user.getDept()); 
System.out.println("User Website: " + user.getWebsite(;: 
} 





执行 以 上 程序 ， 如 果 没 有 问题 ， 应 该 能 正确 输出 。 那 么 这 里 所 有 增删 改 查 都 完成 
了 ， 需 要 注意 的 是 在 增加 ， 更 改 ， 删 除 的 时 候 需 要 调用 session.commit() 来 提交 事 
务 ， 这 样 才 会 真正 对 数据 库 进 行 操作 提交 保存 ， 否 则 操作 没有 提交 到 数据 中 。 到 此 
为 止 ， 简 单 的 单 表 操 作 已 经 完成 了 ， 接 下 来 在 下 一 节 中 将 会 讲解 多 表 联 合 查询 ， 以 
及 结果 集 的 选取 。 如 遇 到 不 明白 的 问题 ， 请 留言 评论 。 


最 后 ， 附 上 工程 结果 图 ， 如 下 : 
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a $2 mybatis-curd-03 
4 $9 src 

a jB (default package) 
|J) Mainjava 

a [B comyiibai.mybatis.dao 
加 IUserjava 

a B3 comyiibai.mybatis.models 
[J] Userjava 
|X) User.xml 

Æ config 

=) JRE System Library [JavaSE-1.6] 

Ej, mybatis 

BA mysql-connector 
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Mybatis 表 关联 一 对 多 - MyBatis 教 程 


有 了 前 面 几 章 的 基础 ， 对 一 些 简单 的 应 用 是 可 以 处 理 的 ， 但 在 实际 项 目 中 ， 经 常 是 
关联 表 的 查询 ， 比 如 : 最 常见 到 的 多 对 一 ， 一 对 多 等 。 这 些 查询 是 如 何 处 理 的 呢 ， 
这 一 讲 就 讲 这 个 问题 。 前 面 几 篇 教程 中 介绍 的 都 是 单 表 映射 的 一 些 操作 ， 然 而 在 我 
们 的 实际 项 目 中 往往 是 用 到 多 表 了 映射 。 在 Java 实 体 对 象 对 中 ， 一 对 多 可 以 根据 List 
和 Set 来 实现 ， 两 者 在 mybitis 中 都 是 通过 collection 标 签 来 配合 来 加 以 实现 。 这 篇 介 
绍 的 是 多 表 中 的 多 对 一 表 关 联 查 询 。 


应 用 场景 : 首先 根据 用 户 ID 读 取 一 个 用 户 信息 ， 然 后 再 读 取 这 个 用 户 所 发 布 贴 子 
(post). 


1、 先 做 一 些 准 各 工作 


我 们 首先 在 创建 一 个 java 工程， 工程 名 称 为 : mybatis04-one2many( 下 载 )， 还 需 
要 创建 两 张 表 ， 它 们 分 别 是 用 户 表 user， 和 帖子 表 post， 一 个 户 用 户 可 以 有 多 个 帖 
f, USer 表 的 结构 和 数据 : 


-- Table structure for '"user^ 
CREATE TABLE “user” ( 
"id? int(10) unsigned NOT NULL AUTO INCREMENT, 
"username? varchar(64) NOT NULL DEFAULT '', 
"mobile" int(10) unsigned NOT NULL DEFAULT '0', 
"created' datetime NOT NULL DEFAULT '0000-00-00 00:00:00', 
PRIMARY KEY (^id ^) 
) ENGINE-InnoDB AUTO INCREMENT-2 DEFAULT CHARSET=utf8; 


INSERT INTO ^user^ VALUES ('1', 'yiibai', '100', '2015-09-23 20:11 
4 i ae 
帖子 表 post 的 结构 和 数据 : 





CREATE TABLE `post` ( 
"post id^ int(10) unsigned NOT NULL AUTO INCREMENT, 
‘userid int(10) unsigned NOT NULL, 
‘title varchar(254) NOT NULL DEFAULT '', 
“content text, 
“created datetime NOT NULL DEFAULT '0000-00-00 00:00:00', 


PRIMARY KEY ("post id') 
) ENGINE-InnoDB AUTO INCREMENT-4 DEFAULT CHARSET=utf8; 


INSERT INTO ^post' VALUES ('1', '1', 'MyBatis XXe $i, ' 在 实际 项 有 
INSERT INTO ^post' VALUES ('2'，'1',，'MyBatis 开 发 环境 搭建 '，' 为 了 方便 六 
INSERT INTO ^post' VALUES ('3'，'2',，' 这 个 是 别人 发 的 '，'content, AR. 


Aoo ë 


从 上 面 点 该 看 出 ， 这 几 个 帖子 对 上 应 的 userid 都 是 1， 所 以 需要 用 户 表 user 里 面 有 
id=1 的 数据 。 可 以 修改 成 满足 自己 条 件 的 数据 ， 按 照 orm 的 规则 ， 表 肯定 需要 一 个 
对 象 与 之 对 应 ， 所 以 我 们 增加 一 个 Post 类 。 





2、 创 建 表 对 应 的 JavaBean 对 象 


这 个 例子 中 ， 我 们 需要 在 包 com.yiibai.pojo 下 创建 两 个 类 ， 它 们 分 别 是 : 
User.java 和 Post.java， 我 们 一 个 一 个 地 来 看 它们 的 代码 ，User.java 类 的 代码 如 
下 : 


package com.yiibai.pojo; 


import java.io.Serializable; 
import java.util.Date; 
import java.util.List; 


public class User implements Serializable{ 
private int id; 
private String username; 
private String mobile; 
private List«Post» posts; 


public int getId() { 


return id; 
Jr 


public void setId(int id) ( 
this.id - id; 
} 


public String getUsername() { 
return username; 
} 


public void setUsername(String username) { 
this.username = username; 
} 


public String getMobile() { 
return mobile; 
} 


public void setMobile(String mobile) { 
this.mobile = mobile; 
} 


public List<Post> getPosts() { 
return posts; 
public void setPosts(List<Post> posts) { 


this.posts = posts; 
} 


@Override 
public String toString() { 

return "User [id=" + id + ", name=" + username + "]"; 
j 


Post.java 类 的 代码 如 下 : 


package com.yiibai.pojo; 
import java.io.Serializable; 


public class Post implements Serializable{ 
private int id; 
private User user; 
private String title; 
private String content; 


public int getId() { 


return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public User getUser() { 
return user; 
} 


public void setUser(User user) { 
this.user = user; 
} 


public String getTitle() { 
return title; 
} 


public void setTitle(String title) { 
this.title = title; 
} 


public String getContent() { 
return content; 
} 


public void setContent(String content) { 
this.content = content; 
} 


3、 配 置 文件 


在 这 一 章节 中 ， 要 用 到 的 配置 文件 有 两 个 ， 一 个 是 mybatis 的 主 配置 文件 : 
src/config/Configure.xml 和 User.java 对 应 的 配置 文件 Userxml， 我 们 先 来 看 看 
src/config/Configure.xml， 其 详细 配置 信息 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 


<configuration> 
<typeAliases> 


<typeAlias alias="User" type="com.yiibai.pojo.User" /> 
«typeAlias alias="Post" type="com.yiibai.pojo.Post" /> 


</typeAliases> 


«environments default="development"> 
<environment id="development"> 
<transactionManager type="JDBC" /> 
<dataSource type="POOLED"> 


<property 
<property 
<property 
<property 
</dataSource> 
</environment> 
</environments> 


<mappers> 


name-"driver" value="com.mysql.jdbc.Drive 
name-"url" value="jdbc:mysql://127.0.0.1 
name="username" value="root" /> 
name="password" value="" /> 


<!-- // power by http://www.yiibai.com --> 
«mapper resource="com/yiibai/pojo/User.xml" /> 


</mappers> 
</configuration> 


EB 


这 里 需要 注意 的 是 这 个 标签 内 容 ， 





它 就 是 用 于 定义 一 个 JavaBean 类 的 别名 ， 如 将 


com.yiibai.pojo.User 简写 为 User， 可 以 认为 com.yiibai.pojo.User 就 是 User, 


User 就 是 com.yiibai.pojo.User 。 


另外 一 个 配置 文件 Userxml 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


«mapper namespace="com.yiibai.userMaper"> 
<!-- User 级 联 文章 查询 方法 配置 (一 个 用 户 对 多 个 文章 ) --> 


«resultMap type="User" id="resultUserMap"> 
<result property="id" column="user_id" /> 
<result property="username" column="username" /> 
<result property="mobile" column="mobile" /> 
«collection property="posts" ofType="com.yiibai.pojo.Post" 
«id property="id" column-"post id" javaType="int" jdbc" 
«result property="title" column="title" javaType-'strir 
«result property="content" column="content" javaType="s 
</collection> 
</resultMap> 


<select id="getUser" resultMap="resultUserMap" parameterType=": 
SELECT u.*,p.* 
FROM user u, post p 
WHERE u.id=p.userid AND id=#{user_id} 
</select> 


</mapper> 


加 PE 





4、 测 试 程序 运行 


到 这 里 ， 整 个 工作 准备 得 已 经 差不多 了 ， 我 们 创建 一 个 主 类 来 测试 上 面 程 序 ， 在 
src 下 创建 一 个 Main.java， 代 码 如 下 : 


import java.io.Reader; 
import java.text.MessageFormat; 
import java.util.List; 


import org.apache.ibatis.io.Resources; 

import org.apache.ibatis.session.SqlSession; 

import org.apache.ibatis.session.SqlSessionFactory; 

import org.apache.ibatis.session.SqlSessionFactoryBuilder ; 


import com.yiibai.pojo.Post; 
import com.yiibai.pojo.User; 


public class Main { 
private static SqlSessionFactory sqlSessionFactory; 
private static Reader reader; 


static { 
try { 
reader = Resources.getResourceAsReader ("config/Configu! 
sqlSessionFactory = new SqlSessionFactoryBuilder().bui- 
} catch (Exception e) { 
e.printStackTrace(); 
} 


} 


public static SqlSessionFactory getSession() { 
return sqlSessionFactory; 
} 


[fers 
* @param args 
=y 
public static void main(String[] args) { 
// TODO Auto-generated method stub 
SqlSession session = sqlSessionFactory.openSession(); 
try { 
int userid = 1; 
User user = session.selectOne("com.yiibai.userMaper .get 
System.out.println("username: "+user.getUsername()+",' 
List<Post> posts = user.getPosts(); 
for(Post p : posts) { 
System.out.println("Title:" + p.getTitle(: 
System.out.println("Content:" + p.getConte 


} 
} finally { 
session.close(); 
} 








输出 结果 如 下 : 


username: yiibai, 

Title:MyBatis 关 联 数据 查询 

Content :在 实际 项 目 中 ， 经 常 使 用 关联 表 的 查询 ， 比 如 : 多 对 一 ， 一 对 多 等 。 这 些 查询 是 
Title:MyBatis 开 发 环境 搭建 

Content :为 了 方便 学 习 ， 这 里 直接 建立 java 工程 ， 但 一 般 都 是 开发 Web B. 


‘| = 











附 工程 目录 结构 图 如 下 : 


{= mybatis04-one2many E 
$8 src 
OB (default package) 
|J] Mainjava 
[B com yiibai.pojo 
|J] Postjava 
四 Userjava 
(Xj User.xml 
f config 
IX] Configure.xml 
mi JRE System Library [JavaSE-1.6] 
mi mybatis 
Ej, mysql-connector 
i e 


Mybatis 表 关联 多 对 一 - MyBatis 教 程 


在 上 章 的 一 对 多 中 ， 我 们 已 经 学 习 如 何在 Mybatis 中 关联 多 表 ， 但 在 实际 项 目 中 
也 是 经 常 使 用 多 对 一 的 情况 ， 这 些 查 询 是 如 何 处 理 的 呢 ， 在 这 一 节 中 我 们 来 学 习 
它 。 多 表 映 射 的 多 对 一 关系 要 用 到 mybitis 的 association 来 加 以 实现 。 这 篇 介绍 的 
是 多 表 中 的 多 对 一 表 关 联 查 询 。 


应 用 场景 : 首先 根据 帖子 ID 读 取 一 个 帖子 信息 ， 然 后 再 读 取 这 个 帖子 所 属 的 用 户 


信息 。 


1、 先 做 一 些 准 各 工作 


我 们 首先 在 创建 一 个 java 工程 ， 工 程 名 称 为 : mybatis05-many2one( 下 载 )， 还 需 
要 创建 两 张 表 ， 它 们 分 别 是 用 户 表 user， 和 帖子 表 post， 一 个 户 用 户 可 以 有 多 个 帖 
子 。 


user 表 的 结构 和 数据 : 


-- Table structure for '"user^ 
CREATE TABLE “user” ( 
"id? int(10) unsigned NOT NULL AUTO INCREMENT, 
"username" varchar(64) NOT NULL DEFAULT '', 
"mobile" int(10) unsigned NOT NULL DEFAULT 'O', 
“created datetime NOT NULL DEFAULT '0000-00-00 00:00:00', 
PRIMARY KEY ("id ^) 
) ENGINE-InnoDB AUTO INCREMENT-2 DEFAULT CHARSET=utf8; 


INSERT INTO `user` VALUES ('1', 'yiibai', '100', '2015-09-23 20:11 
EOE) 
帖子 表 post 的 结构 和 数据 : 





CREATE TABLE `post` ( 
"post id^ int(10) unsigned NOT NULL AUTO INCREMENT, 
‘userid int(10) unsigned NOT NULL, 
‘title varchar(254) NOT NULL DEFAULT '', 
“content text, 
“created datetime NOT NULL DEFAULT '0000-00-00 00:00:00', 
PRIMARY KEY ("post id') 

) ENGINE-InnoDB AUTO INCREMENT-4 DEFAULT CHARSET=utf8; 


INSERT INTO ^post' VALUES ('1', '1', 'MyBatis XXE $i, 在 实际 项 有 
INSERT INTO ^post' VALUES ('2'，'1',，'MyBatis 开 发 环境 搭建 '，' 为 了 方便 六 
INSERT INTO ^post' VALUES ('3'，'2',，' 这 个 是 别人 发 的 '，'content, AR. 


从 上 面 应 该 看 出 ， 这 几 个 帖子 对 应 的 userid 都 是 1， 所 以 需要 用 户 表 user 里 面 有 
id=1 的 数据 。 可 以 修改 成 满足 自己 条 件 的 数据 ， 按 照 orm 的 规则 ， 表 肯定 需要 
个 对 象 与 之 对 应 ， 所 以 我 们 增加 一 个 Post X, 





2、 创 建 表 对 应 的 JavaBean 对 象 


这 个 例子 中 ， 我 们 需要 在 包 com.yiibai.pojo 下 创建 两 个 类 ， 它 们 分 别 是 : 
User.java 和 Post.java， 我 们 一 个 一 个 地 来 看 它们 的 代码 ，Userjava 类 的 代码 如 
F: 


package com.yiibai.pojo; 


import java.io.Serializable; 
import java.util.Date; 
import java.util.List; 


public class User implements Serializable{ 
private int id; 
private String username; 
private String mobile; 
private List«Post» posts; 


public int getId() { 


return id; 
Jr 


public void setId(int id) ( 
this.id - id; 
} 


public String getUsername() { 
return username; 
} 


public void setUsername(String username) { 
this.username = username; 
} 


public String getMobile() { 
return mobile; 
} 


public void setMobile(String mobile) { 
this.mobile = mobile; 
} 


public List<Post> getPosts() { 
return posts; 
public void setPosts(List<Post> posts) { 


this.posts = posts; 
} 


@Override 
public String toString() { 

return "User [id=" + id + ", name=" + username + "]"; 
j 


Post.java 类 的 代码 如 下 : 


package com.yiibai.pojo; 
import java.io.Serializable; 


public class Post implements Serializable{ 
private int id; 
private User user; 
private String title; 
private String content; 


public int getId() { 


return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public User getUser() { 
return user; 
} 


public void setUser(User user) { 
this.user = user; 
} 


public String getTitle() { 
return title; 
} 


public void setTitle(String title) { 
this.title = title; 
} 


public String getContent() { 
return content; 
} 


public void setContent(String content) { 
this.content = content; 
} 


3、 配 置 文件 


在 这 一 章节 中 ， 要 用 到 的 配置 文件 有 两 个 ， 一 个 是 mybatis 的 主 配置 文件 : 
src/config/Configure.xml 和 User.java 对 应 的 配置 文件 Userxml， 我 们 先 来 看 看 
src/config/Configure.xml， 其 详细 配置 信息 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 


<configuration> 
<typeAliases> 


<typeAlias alias="User" type="com.yiibai.pojo.User" /> 
«typeAlias alias="Post" type="com.yiibai.pojo.Post" /> 


</typeAliases> 


«environments default="development"> 
<environment id="development"> 
<transactionManager type="JDBC" /> 
<dataSource type="POOLED"> 


<property 
<property 
<property 
<property 
</dataSource> 
</environment> 
</environments> 


<mappers> 


name-"driver" value="com.mysql.jdbc.Drive 
name-"url" value="jdbc:mysql://127.0.0.1 
name="username" value="root" /> 
name="password" value="" /> 


<!-- // power by http://www.yiibai.com --> 
«mapper resource="com/yiibai/pojo/User.xml" /> 


</mappers> 
</configuration> 


EB 


这 里 需要 注意 的 是 这 个 标签 内 容 ， 





它 就 是 用 于 定义 一 个 JavaBean 类 的 别名 ， 如 将 


com.yiibai.pojo.User 简写 为 User， 可 以 认为 com.yiibai.pojo.User 就 是 User, 


User 就 是 com.yiibai.pojo.User 。 


另外 一 个 配置 文件 Userxml 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


«mapper namespace="com.yiibai.userMaper"> 
<!-- User 级 联 文章 查询 方法 配置 (多 个 文章 对 一 个 用 户 ) --» 


<resultMap type="Post" id="resultPostsMap"> 
<result property="id" column="post_id" /> 
<result property="title" column="title" /> 
<result property="content" column="content" /> 
<association property="user" javaType="User"> 
<id property="id" column="userid"/> 
«result property="username" column="username"/> 
<result property="mobile" column="mobile"/> 
</association> 
</resultMap> 


<select id="getPosts" resultMap="resultPostsMap" parameterType: 
SELECT u.*,p.* 
FROM user u, post p 
WHERE u.id=p.userid AND p.post_id=#{post_id} 
</select> 


</mapper> 
回填 于 
注 : 在 上 面 的 配置 文件 中 ， 使 用 到 了 一 个 <association> 标 签 ， 关 联 对 应 的 User 


米 
Fo 





4、 测 试 程序 运行 


到 这 里 ， 整 个 工作 准备 得 已 经 差不多 了 ， 我 们 创建 一 个 主 类 来 测试 上 面 程 序 ， 在 
src 下 创建 一 个 Main.java， 代 码 如 下 : 


import java.io.Reader; 
import java.text.MessageFormat; 
import java.util.List; 


import org.apache.ibatis.io.Resources; 

import org.apache.ibatis.session.SqlSession; 

import org.apache.ibatis.session.SqlSessionFactory; 

import org.apache.ibatis.session.SqlSessionFactoryBuilder ; 


import com.yiibai.pojo.Post; 
import com.yiibai.pojo.User; 


public class Main { 
private static SqlSessionFactory sqlSessionFactory; 
private static Reader reader; 


static { 
try { 
reader = Resources.getResourceAsReader ("config/Configu! 
sqlSessionFactory = new SqlSessionFactoryBuilder().bui- 
} catch (Exception e) { 
e.printStackTrace(); 
} 


} 


public static SqlSessionFactory getSession() { 
return sqlSessionFactory; 
} 


[fers 
* @param args 
=y 
public static void main(String[] args) { 
// TODO Auto-generated method stub 
SqlSession session = sqlSessionFactory.openSession(); 
try { 
int postId = 1; 
Post post = session.selectOne("com.yiibai.userMaper.gel 
System.out.println("title: "+post.getTitle()); 
System.out.println("userName: "+post.getUser().getUserr 
} finally { 
session.close(); 





输出 结果 如 下 : 


TutorialsPoint Java 技术 教程 


title: MyBatis 关 联 数据 查询 
userName: yiibai 


附 工 程 目 录 结 构图 如 下 : 


4 43. mybatis05-many2one 
4 器 src 
4 [B (default package) 
> |J] Mainjaval 
4 册 comyiibai.pojo 
b [I] Postjava 
> [J] Userjava 
(Xj User.xml 
4 {B config 
|X) Configure.xml 
b mà JRE System Library [JavaSE-1.6] 
> BA mybatis 
> BA mysql-connector 


Mybatis 表 关联 多 对 一 - MyBatis 教 程 
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Mybatis 多 对 多 - MyBatis 教 程 


在 前 面 的 章节 中 ， 我 们 学 习 了 一 对 多 ， 多 对 一 的 关系 ， 现 在 我 们 来 看 看 Mybatis 中 
的 多 对 多 应 用 。 


mybatis3.0 添加 了 association 和 collection 标 签 专 门 用 于 对 多 个 相关 实体 类 数据 进行 
级 联 查 询 ， 但 仍 不 支持 多 个 相关 实体 类 数据 的 级 联 保存 和 级 联 删 除 操作 。 因 此 在 进 
行 实体 类 多 对 多 映射 表 设 计时 ， 需 要 专门 建立 一 个 关联 对 象 类 对 相关 实体 类 的 天 联 
关系 进行 描述 。 下 文 将 以 'Jser 和 "Group' 丙 个 实体 类 之 间 的 多 对 多 关联 隐身 为 例 寺 
行 CRUD 操 作 


应 用 场景 


假设 项 目 中 存在 用 户 和 用 户 组 ， 从 一 个 用 户 读 取出 它 所 在 的 用 户 组 ， 从 一 个 用 户 组 
也 知道 这 个 组 内 的 所 有 用 户 信息 。 


2、 先 做 一 些 准 各 工作 


我 们 首先 在 创建 一 个 java 工程 ， 工 程 名 称 为 : mybatis06-many2many( 下 载 )， 还 需 
要 创建 三 张 表 ， 它 们 分 别 是 用 户 表 user， 用 户 组 表 group 和 用 户 组 映射 表 


user_group ， 一 个 户 用 户 可 以 在 多 个 用 户 组 中 ， 一 个 用 户 组 中 有 多 个 用 户 。 项 目 工 
程 结构 如 下 : 
4 32) mybatis06-many2many a 
4 (8 src 
4 [8 (default package) 
|J] Mainjava 


4 {8 comyibai.maper 
|J] GroupMaper java 
UserGroupMaper.java 
[JJ UserMaperjava 
X; GroupMaper.xml 


Xj UserGroupMaper.xml 


X) UserMaper.xml E 

4 8B comyiibai.pojo «t 
四 Group,java Gi 
[J] Userjava 


四 UserGroup.java 
4 {B config 
iX; Configure.xml 
Ej JRE System Library [JavaSE-1.6] 
BA JUnit 4 
Ej mybatis 
Ej, mysql-connector 


user 表 的 结构 和 数据 : 


CREATE TABLE ‘user ( 
"id? int(10) unsigned NOT NULL AUTO INCREMENT, 
"username? varchar(64) NOT NULL DEFAULT '', 
"mobile" varchar(16) NOT NULL DEFAULT '', 
PRIMARY KEY (`id`) 
) ENGINE-InnoDB AUTO INCREMENT-3 DEFAULT CHARSET=utf8; 


INSERT INTO ‘user VALUES ('1', 'yiibai', '13838009988'); 
INSERT INTO `user` VALUES ('2', 'User-name-1', '13838009988'); 


用 户 组 group 表 的 结构 和 数据 : 


CREATE TABLE ^group' ( 
"group id^ int(10) unsigned NOT NULL AUTO INCREMENT, 
"group name" varchar(254) NOT NULL DEFAULT '', 
PRIMARY KEY (group id) 

) ENGINE-InnoDB AUTO INCREMENT-3 DEFAULT CHARSET=utf8; 


INSERT INTO ^group^ VALUES ('1', 'Group-1'); 
INSERT INTO ^group^ VALUES ('2', 'Group-2'); 


用 户 组 映射 表 user group 的 结构 和 数据 : 


CREATE TABLE "user group ( 
"user id^ int(10) unsigned NOT NULL DEFAULT 'O', 
"group id' int(10) unsigned NOT NULL 

) ENGINE-InnoDB DEFAULT CHARSET-utf8; 


INSERT INTO "user group VALUES ('1', '1'); 
INSERT INTO "user group VALUES ('2', '1'); 
INSERT INTO "user group VALUES ('1', '2'); 


从 上 面 应 该 看 出 ， 用 户 ID 为 1 同时 在 用 户 组 ID 为 1 和 2 中 ， 而 用 户 ID 为 2 仅 在 一 个 
用 户 组 ID 为 1 中 。 


2、 创 建 表 对 应 的 JavaBean 对 象 


这 个 例子 中 ， 我 们 需要 在 包 comyiibai.pojo 下 创建 三 个 类 ， 它 们 分 别 是 : 
Userjava 、Group.java 和 UserGroup.java， 让 我 们 一 个 一 个 地 来 看 它们 的 代码 ， 
Userjava 类 的 代码 如 下 : 


package com.yiibai.pojo; 
import java.util.List; 


aha 
* @describe: User 
* @author: Yiibai 
* @version: V1.0 
* @copyright http://www.yiibai.com 
BA 
public class User { 
private int id; 
private String username; 
private String mobile; 
private List<Group> groups; 
public List<Group> getGroups() { 
return groups; 


public void setGroups(List<Group> groups) { 
this.groups = groups; 


public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 
} 


public String getUsername() { 
return username; 


public void setUsername(String username) { 
this.username = username; 


public String getMobile() { 
return mobile; 


public void setMobile(String mobile) { 
this.mobile = mobile; 
} 


Group.java 类 的 代码 如 下 : 


package com.yiibai.pojo; 
import java.util.List; 


Jf otia 
* @describe: Group 
* Qauthor: Yiibai 
* Qversion: V1.0 
* (copyright http://www.yiibai.com 
a 
public class Group { 
private int groupId; 
private String groupName; 
private List<User> users; 


public List<User> getUsers() { 
return users; 


public void setUsers(List<User> users) { 
this.users = users; 
} 


public int getGroupId() { 
return groupId; 


public void setGroupId(int groupId) { 
this.groupId - groupId; 
j 


public String getGroupName() { 
return groupName; 


public void setGroupName(String groupName) { 
this.groupName - groupName; 
j 


UserGroup.java 类 (用 户 和 用 户 组 的 关系 映射 ) 的 代码 如 下 : 


package com.yiibai.pojo; 


public class UserGroup { 
private int userId; 
private int groupId; 
public int getUserId() { 
return userId; 


public void setUserId(int userId) { 
this.userId - userId; 


public int getGroupId() { 
return groupId; 


} 

public void setGroupId(int groupId) { 
this.groupId = groupId; 

} 


3、 配 置 文件 


在 这 一 章节 中 ， 要 用 到 的 配置 文件 有 四 个 ， 一 个 是 mybatis 的 主 配置 文件 : 
E 另外 就 是 上 面 三 个 Bean 类 对 应 的 配置 文件 ， 如 ， 
Userjava 对 应 的 配置 文件 Userxml， 等 ， 我 们 先 来 看 看 
src/config/Configure.xml， 其 详细 配置 信息 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
«typeAlias alias-"User" type="com.yiibai.pojo.User" /> 
«typeAlias alias="UserGroup" type="com.yiibai.pojo.UserGrot 
«typeAlias alias="Group" type="com.yiibai.pojo.Group" /> 
</typeAliases> 


«environments default="development"> 
<environment id="development"> 
<transactionManager type="JDBC" /> 
<dataSource type="POOLED"> 
«property name-"driver" value="com.mysql.jdbc.Drive 
«property name-"url" value="jdbc:mysql://127.0.0.1 
«property name="username" value="root" /» 
«property name="password" value="" /> 
«/dataSource» 
</environment> 
</environments> 


<mappers> 
<!-- // power by http://www.yiibai.com --> 
«mapper resource="com/yiibai/maper/UserMaper.xml" /> 
«mapper resource="com/yiibai/maper/GroupMaper.xml" /> 
«mapper resource="com/yiibai/maper/UserGroupMaper.xmLl" /> 
</mappers> 
</configuration> 


Bi EE 
Group.java 对 应 的 配置 文件 src/com/yiibai/maper/Group.xml 的 内 容 如 下 : 





<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 

«mapper namespace-"com.yiibai.maper.GroupMaper"» 


«parameterMap type="Group" id="parameterGroupMap"> 
«parameter property="groupId"/> 
<parameter property="groupName"/> 

</parameterMap> 

<insert id="insertGroup" parameterMap="parameterGroupMap"> 
INSERT INTO ‘group’ (group name) 
VALUES(#{groupName} ) ; 

</insert> 


«resultMap type="Group" id-"resultGroupMap 1"» 
«result property="id" column="id" /» 
«result property="groupName" column-"group name" /> 
«collection property="users" columnz"group id" 
select-"com.yiibai.maper.UserGroupMaper.getUsersByGrou[ 
«/resultMap» 
«select id-"getGroup" resultMap-"resultGroupMap. 1" 
parameterType="int"> 
SELECT ~*~ 
FROM 'group' 
WHERE group_id=#{id} 
</select> 
</mapper> 


a EJ * 
User.java 对 应 的 配置 文件 src/com/yiibai/maper/User.xml 的 内 容 如 下 : 





<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper .dtd"> 
«mapper namespace="com.yiibai.maper .UserMaper"> 
<parameterMap type="User" id="parameterUserMap"> 
<parameter property="id"/> 
<parameter property="username"/> 
<parameter property="mobile"/> 
</parameterMap> 


«insert id-"insertUser" parameterMap="parameterUserMap"> 
INSERT INTO user(username, mobile) 
VALUES(Z(username?, Z(mobile)); 

«/insert» 


«resultMap type="User" id="resultUser"> 

<result property="id" column="group_id"/> 

<result property="name" column="name"/> 

«collection property="groups" column="id" select="com. yiibé 
</resultMap> 


«select id="getUser" resultMap="resultUser" parameterType="int' 
SELECT: 
FROM user 
WHERE id=#{id} 
</select> 
</mapper> 


了] 0 





UserGroup.java 对 应 的 配置 文件 src/com/yiibai/maper/UserGroup.xml 的 内 容 如 
下 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
«mapper namespace="com.yiibai.maper .UserGroupMaper "> 
<parameterMap type="UserGroup" id="parameterUserGroupMap"> 
«parameter property-"userId"/» 
«parameter property-"groupId"/» 
</parameterMap> 


«insert id-"insertUserGroup"  parameterMap-"parameterUserGroup! 
INSERT INTO user group(user id, group id) 
VALUES (#{userId},#{groupId}) 

</insert> 


«1-- 根据 一 个 用 户 组 ID, 查看 这 个 用 户 组 下 的 所 有 用 户 --> 
<resultMap type="User" id="resultUserMap_2"> 
<result property="id" column="id"/> 
<result property="username" column="username"/> 
<result property="mobile" column="mobile"/> 
</resultMap> 


«select id-"getUsersByGroupId" resultMap-"resultUserMap 2" par: 
SELECT u.*, ug.group id 
FROM user u, user group ug 
WHERE u.id-ug.user id AND ug.group_id=#{group_id} 
«/select» 


«1-- 根据 一 个 用 户 ID, 查看 这 个 用 户 所 对 应 的 组 - -> 
<resultMap type="Group" id="resultGroupMap_2"> 
«result property-"groupId" column="group_id"/> 
«result property-"groupName" column-"group name"/» 
«/resultMap» 


«select id-"getGroupsByUserId" resultMap-"resultGroupMap 2" pai 
SELECT g.*, u.user id 
FROM group g, user group u 
WHERE g.group id-u.group id AND u.user id-Z[(user id) 
«/select» 
</mapper> 


rr © 


注 : 在 上 面 的 配置 文件 中 ， 使 用 到 了 <association> 和 <clollection> 标 签 ， 关 联 对 应 
的 User 类 和 Group 类 。 





4、 测 试 程序 运行 


到 这 里 ， 整 个 工作 准备 得 已 经 差不多 了 ， 我 们 创建 一 个 主 类 来 测试 上 面 程 序 ， 在 
src 下 创建 一 个 Main.java， 代 码 如 下 : 


import java.io.Reader; 


import 
import 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 
pri 
pri 


sta 


j 
pub 


j 
VASEN 


java.text.MessageFormat; 
java.util.List; 


org.apache.ibatis.io.Resources; 
org.apache.ibatis.session.SqlSession; 
org.apache.ibatis.session.SqlSessionFactory; 
org.apache.ibatis.session.SqlSessionFactoryBuilder; 


com.yiibai.maper.GroupMaper; 
com.yiibai.maper.UserGroupMaper; 
com.yiibai.maper.UserMaper; 
com.yiibai.pojo.Group; 
com.yiibai.pojo.User; 
com.yiibai.pojo.UserGroup; 


class Main { 


vate static SqlSessionFactory sqlSessionFactory; 
vate static Reader reader; 
wae si 
try { 
reader = Resources.getResourceAsReader ("config/Configut 
sqlSessionFactory = new SqlSessionFactoryBuilder().bui- 
} catch (Exception e) { 
e.printStackTrace(); 
} 
lic static SqlSessionFactory getSession() { 


return sqlSessionFactory; 


* @param args 


j 
pub 


lic static void main(String[] args) { 
// TODO Auto-generated method stub 
// testAddGroup( ); 

// testAddUser(); 

// testAddUserGroup( ); 
testGetGroupAndUsers(); 


lic static void testGetGroupAndUsers() { 

UserGroup userGroup - new UserGroup(); 

SqlSession session - sqlSessionFactory.openSession(); 

try { 

GroupMaper groupMaper = session.getMapper (GroupMaper .c- 
Group group = groupMaper.getGroup(1); 
System.out.println("Group => " + group.getGroupName()), 
List<User> users = group.getUsers(); 
for (User user : users) { 


System.out.println("Nt:" + user.getId() + "Xt" 
+ user.getUsername( )); 


} 
} finally { 
session.close(); 
} 


} 


public static void testAddUserGroup() { 
UserGroup userGroup = new UserGroup(); 
userGroup.setGroupId(1); 
userGroup.setUserId(2); 
SqlSession session - sqlSessionFactory.openSession(); 
try { 
UserGroupMaper userGroupMaper = session 
.getMapper(UserGroupMaper.class); 
userGroupMaper.insertUserGroup(userGroup); 


session.commit(); 
} finally ( 

session.close(); 
} 


} 


public static void testAddUser() { 
// TODO Auto-generated method stub 
SqlSession session = sqlSessionFactory.openSession(); 
try { 
User user = new User(); 
user .setUsername("User-name-1"); 
user .setMobile("13838009988" ) ; 
UserMaper userMaper = session.getMapper(UserMaper.clas: 
userMaper.insertUser (user); 
session.commit(); 
// System.out.println(user.getGroupId()); 
} finally { 
session.close(); 
j 


j 


public static void testAddGroup() { 

// TODO Auto-generated method stub 

SqlSession session - sqlSessionFactory.openSession(); 

try { 
Group group = new Group(); 
group.setGroupName("Ħ è 28-1"); 
GroupMaper groupMapper = session.getMapper (GroupMaper.« 
groupMapper.insertGroup(group); 
session.commit(); 
System.out.println(group.getGroupId()); 

} finally { 
session.close(); 





Group => Group-1 
Pall yiibai 
22 User-name-1 





Mybatis 与 Spring 集成 - MyBatis 教 程 


在 前 面 的 教程 文章 中 ， 前 面 讲 到 有 关 mybatis 连接 数据 库 ， 然 后 进行 进行 数据 增删 
改 查 ， 以 及 多 表 联 合 查询 的 例子 ， 但 很 多 的 项 目 中 ， 通 常会 用 spring 这 个 粘 合 剂 来 
管理 datasource 等 。 充 分 利用 spring 基于 接口 的 编程 ， 以 及 aop ,ioc 带 来 的 方 

便 。 用 spring 来 管理 mybatis 与 管理 hibernate 有 很 多 类 似 的 地 方 。 在 这 一 节 中 ， 
我 们 重点 介绍 数据 源 管理 以 及 bean 的 配置 。 


整个 Mybatis 与 Spring 集成 示例 要 完成 的 步骤 如 下 : 
1、 示 例 功 能 描述 

、 创 建 工程 

、 数 据 库 表 结 构 及 数据 记录 

、 实 例 对 象 

、 配 置 文件 

、 测 试 执行 ， 输 出 结果 


1、 示 例 功能 朱 述 


在 本 示例 中 ， 需 要 完成 这 样 的 一 个 简单 功能 ， 即 ， 指 定 一 个 用 户 (ID=1) ， 查 询 出 
这 个 用 户 的 基本 信息 ， 并 关联 查询 这 个 用 户 的 所 有 订单 。 
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2、 创 建 工 程 
首先 创建 一 个 工程 的 名 称 为 : mybatis07-spring， 在 src 源 代 码 目录 下 建立 文件 夹 
config， 并 将 原来 的 mybatis 配置 文件 Configuration.xml 移动 到 这 个 文件 夹 中 , 并 


在 config 文 家 夹 中 建立 Spring 配置 文件 : applicationContext.xml。 工 程 结构 目录 
如 下 : 


3、 数 据 库 表 结 构 及 数据 记录 
在 本 示例 中 ， 用 到 两 个 表 : 用 户 表 和 订单 表 ， 其 结构 和 数据 记录 如 下 : 


CREATE TABLE ‘user ( 
"id? int(10) unsigned NOT NULL AUTO INCREMENT, 
"username? varchar(64) NOT NULL DEFAULT '', 
"mobile" varchar(16) NOT NULL DEFAULT '', 
PRIMARY KEY (^id) 
) ENGINE-InnoDB AUTO INCREMENT-3 DEFAULT CHARSET=utf8; 


INSERT INTO `user` VALUES ('1', 'yiibai', '13838009988'); 
INSERT INTO `user` VALUES ('2', 'saya', '13838009988'); 


订单 表 结构 和 数据 如 下 : 


CREATE TABLE ‘order’ ( 
"order id^ int(10) unsigned NOT NULL AUTO INCREMENT, 
"user id^ int(10) unsigned NOT NULL DEFAULT 'O', 
"order no^ varchar(16) NOT NULL DEFAULT '', 
"money? float(10,2) unsigned DEFAULT '0.00', 
PRIMARY KEY ("order id ) 

) ENGINE-InnoDB AUTO INCREMENT-17 DEFAULT CHARSET-utf8; 


INSERT INTO ‘order VALUES ('1', '1', '1509289090', '99.90'); 
INSERT INTO “order” VALUES ('2', '1', '1519289091', '290.80'); 
INSERT INTO ‘order VALUES ('3', '1', '1509294321', '919.90'); 
INSERT INTO order VALUES ('4', '1', '1601232190', '329.90'); 
INSERT INTO order VALUES ('5 ^, "1 , "150834573894 , 321.00); 
INSERT INTO “order” VALUES ('6', '1', '1598572382', '342.00 ); 
INSERT INTO ‘order VALUES ('7', '1', '1500845727', '458.00'); 
INSERT INTO "order VALUES ('8', “1%, '1508458923', '1200.00'); 
INSERT INTO "order VALUES ('9 . '1', 715045382937, '2109.00'); 
INSERT INTO ‘order VALUES ('10', '1', '1932428723', '5888.00'); 
INSERT INTO. order VALUES ( 11. , '1', (2390423712. "8219200" ); 
INSERT INTO “order” VALUES ('12', '1', '4587923992', '123.00'); 
INSERT INTO ‘order VALUES ('13', '1', '4095378812', '421.00'); 
INSERT INTO order VALUES ('14', '1', '9423890127', '678.00'); 
INSERT INTO order VALUES ('15', '1', '7859213249', '7689.00'); 
INSERT INTO “order” VALUES ('16', '1', '4598450230', '909.20'); 
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用 户 表 和 订单 表 分 别 对 应 两 个 实例 对 象 ， 分 别 是 : Userjava 和 Order.java， 它 们 都 
在 com.yiibai.pojo 包 中 。 


Userjava 代 码 内 容 如 下 : 


package com.yiibai.pojo; 
import java.util.List; 


RSEN 
* Qdescribe: User 
* Qauthor: Yiibai 
* Qversion: V1.0 
* (copyright http://www.yiibai.com 
7 
public class User { 
private int id; 
private String username; 
private String mobile; 


public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 
} 


public String getUsername() { 
return username; 


public void setUsername(String username) { 
this.username = username; 


public String getMobile() { 
return mobile; 


public void setMobile(String mobile) { 
this.mobile = mobile; 
} 


Orderjava 代 码 内 容 如 下 : 


package com.yiibai.pojo; 


VASE 
* @describe: Order - 订单 
* Qauthor: Yiibai 
* Qversion: V1.0 
* (copyright http://www.yiibai.com 
n 
public class Order ( 
private int orderId; 
private String orderNo; 
private float money; 
private int userId; 
private User user; 


public int getUserId() ( 
return userId; 


public void setUserId(int userId) { 
this.userId - userId; 
} 


public int getOrderId() { 
return orderId; 


public void setOrderId(int orderId) { 
this.orderId - orderId; 
} 


public User getUser() { 
return user; 


public void setUser(User user) { 
this.user = user; 
} 


public String getOrderNo() { 
return orderNo; 


public void setOrderNo(String orderNo) { 
this.orderNo = orderNo; 


} 
public float getMoney() { 
return money; 


public void setMoney(float money) { 
this.money = money; 
} 


5. MEX 


这 个 实例 中 有 三 个 重要 的 配置 文件 ， 它 们 分 别 是 : applicationContext.xml , 
Configuration.xml 以 及 UserMaper.xml. 


applicationContext.xml 配置 文件 里 最 主要 的 配置 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
<typeAlias alias="User" type="com.yiibai.pojo.User" /> 
«typeAlias alias-"Order" type="com.yiibai.pojo.Order" /> 


</typeAliases> 
<!-- Mybatis 和 Spring 集成 之 后 , 这 些 可 以 完全 删除 CEB) ,数据 库 连接 的 管 
E 


«environments default-"development"» «environment id="deve- 

«transactionManager type="JDBC"/> <dataSource type="POOLED' 

name="driver" value="com.mysql.jdbc.Driver"/> <property nar 

value="jdbc:mysql://127.0.0.1:3306/yiibai?characterEncodin¢ 

«property name="username" value="root"/> «property name="pé 

value=""/> </dataSource> </environment> </environments> 
--> 


<mappers> 
«mapper resource="com/yiibai/maper/UserMaper.xml" /> 
</mappers> 
</configuration> 





配置 文件 Configuration.xml 的 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" xmlns:ao[ 
xmlns:tx-"http://www.springframework.org/schema/tx" xmlns:conte 
XSi:schemaLocation=" 
http://www.springframework.org/schema/beans http://www 
http://www.springframework.org/schema/aop http://www. sł 
http://www.springframework.org/schema/context http://w 
http://www.springframework.org/schema/jee http://www. sj 
http://www.springframework.org/schema/tx http://www. sp! 
default-autowire-"byName" default-lazy-init="false"> 


«bean id="dataSource" class-"org.apache.commons.dbcp.BasicData: 
«property name-"driverClassName" value="com.mysql.jdbc.Dri\ 
«property name-"url" 

value-z"jdbc:mysq1://127.0.0.1:3306/yiibai?characterEnc: 
«property name="username" value="root" /» 
«property name="password" value="" /> 
«/bean» 


«bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSess: 
<!--dataSource 属 性 指定 要 用 到 的 连接 池 - -> 
<property name="dataSource" ref="dataSource" /> 
<!--configLocation 属 性 指定 nybatis 的 核心 配置 文件 - -> 
<property name="configLocation" value="config/Configuratior 
</bean> 


«bean id-"userMaper" class="org.mybatis.spring.mapper .MapperFac 
<!--sqlSessionFactory 属 性 指定 要 用 到 的 SqlSessionFactory 实 例 - -> 
«property name="sqlSessionFactory" ref="sqlSessionFactory" 
<!--mapperInterface 属 性 指定 映射 器 接口 ， 用 于 实现 此 接口 并 生成 映射 器 x 
«property name-"mapperInterface" value="com.yiibai.maper .U: 

</bean> 


</beans> 





UserMaper.xml 用 于 定义 查询 和 数据 对 象 映 射 ， 其 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"» 

«mapper namespace="com.yiibai.maper.UserMaper"> 


<!-- 为 了 返回 list 类 型 而 定义 的 returnMap --» 
«resultMap type="User" id="resultUser"> 

<id column="id" property="id" /> 

«result column="username" property="username" /> 

<result column="mobile" property="mobile" /> 
</resultMap> 


«!-- User KG Order 查询 方法 的 配置 (多 对 一 的 方式 ) --> 
«resultMap id="resultUserOrders" type="Order"> 
<id property="orderId" column="order_id" /> 
<result property="orderNo" column="order_no" /> 
<result property="money" column="money" /> 
«result property="userId" column="user_id" /> 


<association property="user" javaType="User"> 
<id property="id" column="id" /> 
<result property="username" column="username" /> 
<result property="mobile" column="mobile" /> 
</association> 
</resultMap> 


«select id-"getUserOrders" parameterType="int" resultMap="resu- 
SELECT u.*,0.* FROM "user' u, ‘order o 
WHERE u.id-o.user id AND u.id=#{id} 
</select> 


«select id-"getUserById" resultMap="resultUser" parameterType=' 
SELECT * 
FROM user 
WHERE id=#{id} 
</select> 
</mapper> 
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6、 测 斌 执行， 输出 结果 


我 们 创建 一 个 测试 类 为 : Main.java , 就 在 src 目录 中 。 其 代码 如 下 : 


import 


import 
import 


import 
import 
import 


VERSUS 


java.util.List; 


org.springframework.context.ApplicationContext; 
org.springframework.context.support.ClassPathXmlApplication( 


com.yiibai.maper.UserMaper; 
com.yiibai.pojo.Order; 
com.yiibai.pojo.User; 


* Description 

* @author yiibai 

* @date 2015-4-12 

* @copyright http://www.yiibai.com 
* @email yiibai.com@gmai.com 

* @version 1.0 


iA 


public class Main { 


private static ApplicationContext ctx; 


static ( 


} 


ctx = new ClassPathXmlApplicationContext( 
"config/applicationContext.xml"); 


public static void main(String[] args) { 


UserMaper userMaper = (UserMaper) ctx.getBean("userMaper") , 
// 测试 id=1 的 用 户 查 询 ， 可 根据 数据 库 中 的 情况 修改 . 

User user = userMaper.getUserById(1); 

System.out .printlLn(" 获 取 用 户 ID=1 WAP? : "+user.getUsername 


// 得 到 文章 列表 测试 

System.out .printLn(" 得 到 用 户 id 为 1 的 所 有 订单 列表 :") ; 

System out. println ( SS I ————————— 
List«Order» orders - userMaper.getUserOrders(1); 


for (Order order : orders) ( 


j 


System.out.printin("i7 #5 : "+torder.getOrderNo() + ", iT. 





10g4j:WARN No appenders could be found for logger (org.springframev 
10g4j:WARN Please initialize the log4j system properly. 

获取 用 户 ID=1 的 用 户 名 : yiibai 

得 到 用 户 id 为 1 的 所 有 订单 列表 : 


订单 号 : 1509289090， 订 单 金额 : 99.9 
订单 号 : 1519289091， 订 单 金额 : 290. 
订单 号 : 1509294321， 订 单 金额 : 919. 
订单 号 : 1601232190， 订 单 金额 : 329. 
订单 号 : 1503457384， 订 单 金额 : 321. 
订单 号 : 1598572382， 订 单 金额 : 342. 
订单 号 : 1500845727， 订 单 金额 : 458. 
订单 号 : 1508458923， 订 单 金额 : 1200.0 
订单 号 : 1504538293， 订 单 金额 : 2109.0 
订单 号 : 1932428723， 订 单 金额 : 5888.0 
订单 号 : 2390423712， 订 单 金额 : 3219.0 
订单 号 : 4587923992, iT BBM: 123.0 

订单 号 : 4095378812, iT €4& E: 421.0 

订单 号 : 9423890127, i *HM : 678.0 

订单 号 : 7859213249, ip *HM : 7689.0 
订单 号 : 4598450230, iT *#M: 909.2 





代码 下 载 : Mybatis 与 Spring 集成 


MyBatis# Spring MVC - MyBatis 教 程 


前 面 几 篇 文章 已 经 讲 到 了 mybatis 与 spring 的 集成 。 目 前 主流 的 Web MVC 框 架 ， 除 
了 Struts 这 个 主力 外 ， 还 有 Spring MVC， 主 要 是 由 于 Spring MVC 配置 比较 简单 ， 
使 用 起 来 也 十 分 明了 ， 非 常 灵活 ， 与 Spring 集成 较 好 ， 对 RESTful API 的 支持 也 比 
struts 要 好 。 所 以 Spring MVC 在 一 定 程 度 上 有 一 定 的 优势 。 MyBatis 是 ibatis 的 升级 
版 ， 作 为 hibernate 的 老 对 手 ， 它 是 一 个 可 以 自 定义 SQL、 存 储 过 程 和 高 级 映射 的 持 
久 层 框架 。 Hibernate 的 主要 区 别 就 是 Mybatis 是 半自动 化 的 ， 而 Hibernate 是 
全 自动 的 ， 所 以 当 应 用 需求 越 来 越 复杂 的 时 候 ， 自 动 化 的 SQL 显得 比较 笨拙 。 经 
常 搭 框架 的 人 应 该 都 清楚 ， 框 架 搭建 的 核心 就 是 配置 文件 。 


在 这 里 我 们 需要 创建 web 工程 。 今 天 将 直接 用 mybatis 与 Spring mvc 的 方式 集成 起 
来 ， 源 码 在 本 文 结尾 处 下 载 .主要 有 以 下 几 个 方面 的 配置 。 


整个 Mybatis 与 Spring MVC 示例 要 完成 的 步骤 如 下 : 
1、 示 例 功 能 描述 

、 创 建 工程 

、 数 据 库 表 结构 及 数据 记录 

、 实 例 对 象 

、 配 置 文件 

、 测 试 执行 ， 输 出 结果 


1、 示 例 功 能 摘 述 


在 本 示例 中 ， 需 要 使 用 MyBatis 和 Spring MVC 整 合 完成 这 样 的 一 个 简单 功能 ， 即 指 
定 一 个 用 户 (ID=1) ， 查 询 出 这 个 用 户 关联 的 所 有 订单 。 
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2. GRIS 
首先 创建 一 个 工程 的 名 称 为 : mybatis07-spring-mvc， 在 src 源 代码 目录 下 建立 文 
件 夹 config， 并 将 原来 的 mybatis 配置 文件 Configuration.xml 移动 到 这 个 文件 夹 


中 , 并 在 config 文 家 夹 中 建立 Spring 配置 文件 : applicationContext.xml。 工 程 结 构 
目录 如 下 : 


3、 数 据 库 表 结 构 及 数据 记录 
在 本 示例 中 ， 用 到 两 个 表 : 用 户 表 和 订单 表 ， 其 结构 和 数据 记录 如 下 : 


CREATE TABLE ‘user ( 
"id? int(10) unsigned NOT NULL AUTO INCREMENT, 
"username? varchar(64) NOT NULL DEFAULT '', 
"mobile" varchar(16) NOT NULL DEFAULT '', 
PRIMARY KEY (^id) 
) ENGINE-InnoDB AUTO INCREMENT-3 DEFAULT CHARSET=utf8; 


INSERT INTO `user` VALUES ('1', 'yiibai', '13838009988'); 
INSERT INTO `user` VALUES ('2', 'saya', '13838009988'); 


订单 表 结构 和 数据 如 下 : 


CREATE TABLE ‘order’ ( 
"order id^ int(10) unsigned NOT NULL AUTO INCREMENT, 
"user id^ int(10) unsigned NOT NULL DEFAULT 'O', 
"order no^ varchar(16) NOT NULL DEFAULT '', 
"money? float(10,2) unsigned DEFAULT '0.00', 
PRIMARY KEY ("order id ) 

) ENGINE-InnoDB AUTO INCREMENT-17 DEFAULT CHARSET-utf8; 


INSERT INTO ‘order VALUES ('1', '1', '1509289090', '99.90'); 
INSERT INTO “order” VALUES ('2', '1', '1519289091', '290.80'); 
INSERT INTO ‘order VALUES ('3', '1', '1509294321', '919.90'); 
INSERT INTO order VALUES ('4', '1', '1601232190', '329.90'); 
INSERT INTO order VALUES ('5 ^, "1 , "150834573894 , 321.00); 
INSERT INTO “order” VALUES ('6', '1', '1598572382', '342.00 ); 
INSERT INTO ‘order VALUES ('7', '1', '1500845727', '458.00'); 
INSERT INTO "order VALUES ('8', “1%, '1508458923', '1200.00'); 
INSERT INTO "order VALUES ('9 . '1', 715045382937, '2109.00'); 
INSERT INTO ‘order VALUES ('10', '1', '1932428723', '5888.00'); 
INSERT INTO. order VALUES ( 11. , '1', (2390423712. "8219200" ); 
INSERT INTO “order” VALUES ('12', '1', '4587923992', '123.00'); 
INSERT INTO ‘order VALUES ('13', '1', '4095378812', '421.00'); 
INSERT INTO order VALUES ('14', '1', '9423890127', '678.00'); 
INSERT INTO order VALUES ('15', '1', '7859213249', '7689.00'); 
INSERT INTO “order” VALUES ('16', '1', '4598450230', '909.20'); 


4, RBI Rt R 


用 户 表 和 订单 表 分 别 对 应 两 个 实例 对 象 ， 分 别 是 : Userjava 和 Order.java， 它 们 都 
在 com.yiibai.pojo 包 中 。 


Userjava 代 码 内 容 如 下 : 


package com.yiibai.pojo; 
import java.util.List; 


RSEN 
* Qdescribe: User 
* Qauthor: Yiibai 
* Qversion: V1.0 
* (copyright http://www.yiibai.com 
7 
public class User { 
private int id; 
private String username; 
private String mobile; 


public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 
} 


public String getUsername() { 
return username; 


public void setUsername(String username) { 
this.username = username; 


public String getMobile() { 
return mobile; 


public void setMobile(String mobile) { 
this.mobile = mobile; 
} 


Orderjava 代 码 内 容 如 下 : 


package com.yiibai.pojo; 


VASE 
* Qdescribe: User - 订单 
* @author: Yiibai 
* Qversion: V1.0 
* (copyright http://www.yiibai.com 
n 
public class Order ( 
private int orderId; 
private String orderNo; 
private float money; 
private int userId; 
private User user; 


public int getUserId() ( 
return userId; 


public void setUserId(int userId) { 
this.userId - userId; 
} 


public int getOrderId() { 
return orderId; 


public void setOrderId(int orderId) { 
this.orderId - orderId; 
} 


public User getUser() { 
return user; 


public void setUser(User user) { 
this.user = user; 
} 


public String getOrderNo() { 
return orderNo; 


public void setOrderNo(String orderNo) { 
this.orderNo = orderNo; 


} 
public float getMoney() { 
return money; 


public void setMoney(float money) { 
this.money = money; 
} 


5. MEX 


这 个 实例 中 有 三 个 重要 的 配置 文件 ， 它 们 分 别 是 : applicationContext.xml , 
Configuration.xml 以 及 UserMaper.xml. 


applicationContext.xml 配置 文件 里 最 主要 的 配置 : 


<?xml version="1.0" encoding="utf-8"?> 
«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" xmlns:ao[ 
xmlns:tx-"http://www.springframework.org/schema/tx" xmlns:cont: 
xmins:p="http://www.springframework.org/schema/p" 
xsi:schemaLocationz" 
http://www.springframework.org/schema/beans http://www 
http://www.springframework.org/schema/aop http://www. sj 
http://www.springframework.org/schema/context http://w 
http://www.springframework.org/schema/jee http://www. sj 
http://www.springframework.org/schema/tx http://www. spi 
default -autowire="byName" default-lazy-init="false"> 


«1- -本 示例 采用 DBCP 连 接 池 ， 应 预先 把 DBCP 的 jar 包 复制 到 工程 的 Lib 目 录 下 。 -- 
«context:property-placeholder location="classpath:/config/datal 


«bean id="dataSource" class="org.apache.commons.dbcp.BasicData: 
destroy-method-"close" p:driverClassName="com.mysql.jdbc.Dt 
p:url="jdbc:mysql://127.0.0.1:3306/yiibai?characterEncodin¢ 
p:username="root" p:password="" p:maxActive="10" p:maxIdle: 

</bean> 


<bean id="transactionManager" 
class="org.springframework.jdbc.datasource.DataSourceTransé 
<property name="dataSource" ref="dataSource" /> 

</bean> 


<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSess: 
<!--dataSource 属 性 指定 要 用 到 的 连接 池 - -> 
<property name="dataSource" ref="dataSource" /> 
<!--configLocation 属 性 指定 nybatis 的 核心 配置 文件 - -> 
«property name="configLocation" value="classpath:config/Cor 
<!-- 所 有 配置 的 mapper 文 件 --> 
«property name-"mapperLocations" value="classpath*:com/yiit 
«/bean» 


«bean class-"org.mybatis.spring.mapper.MapperScannerConfigurer' 
«property name="basePackage" value-"com.yiibai.maper" /> 
</bean> 
</beans> 





配置 文件 Configuration.xml 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
<typeAlias alias="User" type="com.yiibai.pojo.User"/> 
«typeAlias alias-"Order" type="com.yiibai.pojo.Order"/> 


«/typeAliases» 
<!-- Sspring 集成 之 后 , 这 些 可 以 完全 删除 , 数据 库 连 接 的 管理 交 给 spring X 
us 


«environments default="development"> 
«environment id="development"> 
«transactionManager type="JDBC"/> 
«dataSource type="POOLED"> 
«property name="driver" value-"com.mysql.jdbc.Driver"/: 
«property name-"url" value="jdbc:mysql://127.0.0.1:330¢ 
«property name="username" value="root"/> 
<property name="password" value="password"/> 
</dataSource> 
</environment> 
</environments> 
T 


<!-- 这 里 交 给 sqLlSessionFactory 的 mapperLocations 属 性 去 得 到 所 有 配置 
ler 


<mappers> 

«mapper resource="com/yihaomen/mapper/User.xm1l"/> 
</mappers> 
==> 


</configuration> 
4 = m 
UserMaper.xml 用 于 定义 查询 和 数据 对 象 映射 ， 其 内 容 如 下 : 





<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"» 

«mapper namespace="com.yiibai.maper.UserMaper"> 


<!-- 为 了 返回 list 类 型 而 定义 的 returnMap --» 
«resultMap type="User" id="resultUser"> 

<id column="id" property="id" /> 

«result column="username" property="username" /> 

<result column="mobile" property="mobile" /> 
</resultMap> 


«!-- User KG Order 查询 方法 的 配置 (多 对 一 的 方式 ) --> 
«resultMap id="resultUserOrders" type="Order"> 
<id property="orderId" column="order_id" /> 
<result property="orderNo" column="order_no" /> 
<result property="money" column="money" /> 
«result property="userId" column="user_id" /> 


<association property="user" javaType="User"> 
<id property="id" column="id" /> 
<result property="username" column="username" /> 
<result property="mobile" column="mobile" /> 
</association> 
</resultMap> 


«select id-"getUserOrders" parameterType="int" resultMap="resu- 
SELECT u.*,0.* FROM "user' u, ‘order o 
WHERE u.id-o.user id AND u.id=#{id} 
</select> 


«select id-"getUserById" resultMap="resultUser" parameterType=' 
SELECT * 
FROM user 
WHERE id=#{id} 
</select> 
</mapper> 


S LLL O f 





6、 测 斌 执行， 输出 结果 


我 们 创建 一 个 控制 器 类 在 包 com.yiibai.controller 下 ， 类 的 名 称 为 : 
UserControllerjava， 其 代码 如 下 : 


package com.yiibai.controller; 
import java.util.List; 


import javax.servlet.http.HttpServletRequest; 

import javax.servlet.http.HttpServletResponse; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.servlet.ModelAndView; 


import com.yiibai.maper.UserMaper; 
import com.yiibai.pojo.Order; 


fS 
* Qdescribe: 读 取 一 个 用 户 下 的 所 有 订单 
* @author: Yiibai 
* @version: V1.0 
* @copyright http://www.yiibai.com 
WA 


// http://localhost:8080/mybatis07-spring-mvc/user/orders 
@Controller 
QRequestMapping("/user") 
public class UserController ( 
@Autowired 
UserMaper userMaper; 


@RequestMapping("/orders" ) 

public ModelAndView listall(HttpServletRequest request, HttpSer\ 
List<Order> orders-userMaper.getUserOrders(1); 
System.out.println("orders"); 
ModelAndView mav-new ModelAndView("user orders"); 
mav.addObject("orders",orders); 
return mav; 





接 下 来 还 需要 创建 一 个 web 页 面 作为 结果 输出 ， 在 目录 WebRoot/WEB-INF/pages 
下 创建 一 个 名 为 user orders.jsp 文件 ， 其 代码 如 下 : 


«90 page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF -8"%> 
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "hti 
«html» 
«head» 
«meta http-equiv="Content-Type" content="text/html; charset 
<title> 用 户 订单 列表 </title> 
</head> 
<body> 
<c:forEach items="${orders}" var="order"> 
订单 写 : ${order.orderNo }, 订单 总 额 : ${order.money }<br /> 
</c:forEach> 


</body> 
</html> 


sd 
然后 启动 MyEclipse 中 的 tomcat, BAUR AAT : 





XE: web.xml 还 需要 配置 一 下 ， 详 细 见 下 载 代码 。 


在 浏览 器 中 打开 网 址 : http://localhost:8080/mybatis07-spring-mvc/user/orders， 输 
出 结果 如 下 图 所 示 : 


a+ a" ro €"* + € wiles 
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MyBatis 5; - MyBatis 教 程 


搞 清楚 什么 是 分 页 (pagination) 


例如 ， 在 数据 库 的 某 个 表 里 有 1000 条 数据 ， 我 们 每 次 只 显示 100 条 数据 ， 在 第 1 页 
显示 第 0 到 第 99 条 ， 在 第 2 页 显示 第 100 到 199 条 ， 依 次 类 推 ， 这 就 是 分 页 。 


分 页 可 以 分 为 逻辑 分 页 和 物理 分 页 。 逻 辑 分 页 是 我 们 的 程序 在 显示 每 页 的 数据 时 ， 
首先 查询 得 到 表 中 的 1000 条 数据 ， 然 后 成 熟 根 据 当前 页 的 "页码" 选 出 其 中 的 100 条 
数据 来 显示 。 


物理 分 页 是 程序 先 判 断 出 该 选 出 这 1000 条 的 第 几 条 到 第 几 条 ， 然 后 数据 库 根 据 程序 
给 出 的 信息 查询 出 程序 需要 的 100 条 返回 给 我 们 的 程序 。 


MyBatis 物理 分 页 
MyBatis 使 用 RowBounds 实 现 的 分 页 是 逻辑 分 页 ,也 就 是 先 把 数据 记录 全 部 查询 出 
来 , 然 在 再 根据 offset 和 limit 截断 记录 返回 。 


为 了 在 数据 库 层 面 上 实现 物理 分 页 ， 又 不 改变 原来 MyBatis 的 函数 逻辑 ,可 以 编写 
plugin 截获 MyBatis Executor 的 statementhandler， 重 写 SQL 来 执行 查询 。 


经 常 搭 框架 的 人 应 该 都 清楚 ， 框 架 搭建 的 核心 就 是 配置 文件 。 


在 这 里 我 们 需要 创建 web 工程 。 也 需要 用 mybatis 与 Spring mvc 集成 起 来 ， 源 码 在 
本 文 结尾 处 下 载 ， 主 要 有 以 下 几 个 方面 的 配置 。 


整个 Mybatis 分 页 示例 要 完成 的 步骤 如 下 : 
1、 示 例 功 能 描述 

、 创 建 工 程 

、 数 据 库 表 结构 及 数据 记录 

、 实 例 对 象 

、 配 置 文件 

、 测 试 执行 ， 输 出 结果 


1、 示 例 功 能 摘 述 


在 本 示例 中 ， 需 要 使 用 MyBatis 和 Spring MVC 整 合 完成 分 页 ， 完 成 这 样 的 一 个 简单 
功能 ， 即 指定 一 个 用 户 (ID=1) ， 查 询 出 这 个 用 户 关 联 的 所 有 订单 分 页 显示 出 来 
(使 用 的 数据 库 是 : MySQL) 。 


O oc 上 上 W N 


2、 创 建 工程 


首先 创建 一 个 工程 的 名 称 为 : mybatis08-paging， 在 src 源 代 码 目录 下 建立 文件 夹 
config， 并 将 原来 的 mybatis 配置 文件 Configuration.xml 移动 到 这 个 文件 夹 中 , 并 
在 config 文 家 夹 中 建立 Spring 配置 文件 : applicationContext.xml。 工 程 结构 目录 
如 下 : 


3、 数 据 库 表 结 构 及 数据 记录 
在 本 示例 中 ， 用 到 两 个 表 : 用 户 表 和 订单 表 ， 其 结构 和 数据 记录 如 下 : 


CREATE TABLE ‘user ( 
"id? int(10) unsigned NOT NULL AUTO INCREMENT, 
"username? varchar(64) NOT NULL DEFAULT '', 
"mobile" varchar(16) NOT NULL DEFAULT '', 
PRIMARY KEY ("id ^) 
) ENGINE-InnoDB AUTO INCREMENT-3 DEFAULT CHARSET=utf8; 


INSERT INTO ‘user VALUES ('1', 'yiibai', '13838009988'); 
INSERT INTO `user` VALUES ('2', 'saya', '13838009988'); 


订单 表 结构 和 数据 如 下 : 


CREATE TABLE order 


( 


"order id' int(10) unsigned NOT NULL AUTO INCREMENT, 

"user id? int(10) unsigned NOT NULL DEFAULT 'O', 

"order no^ varchar(16) NOT NULL DEFAULT '', 

"money? float(10,2) unsigned DEFAULT '0.00', 

PRIMARY KEY ("order id') 
) ENGINE-InnoDB AUTO INCREMENT-17 DEFAULT CHARSET=utf8; 


INSERT INTO 'order'^ 
INSERT INTO 'order'^ 
INSERT INTO `order` 
INSERT INTO 'order^ 
INSERT INTO 'order'^ 
INSERT INTO 'order^ 
INSERT INTO `order` 
INSERT INTO 'order^ 
INSERT INTO 'order'^ 
INSERT INTO 'order'^ 
INSERT INTO `order` 
INSERT INTO 'order'^ 
INSERT INTO ‘order. 
INSERT INTO 'order'^ 
INSERT INTO 'order'^ 
INSERT INTO 'order^ 


4、 实 例 对 象 


VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
VALUES 
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us 
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'1509289090', '99.90'); 
'1519289091', '290.80'); 
'1509294321', '919.90'); 
'1601232190', '329.90'); 
'1503457384', '321.00'); 
'1598572382', '342.00'); 
'1500845727', '458.00'); 
'1508458923', '1200.00'); 
'1504538293', '2109.00'); 
'1932428723', '5888.00'); 
'2390423712', '3219.00'); 
'4587923992', '123.00'); 
'4095378812', '421.00'); 
'0423890127', '678.00'); 
'7859213249', '7689.00'); 
'4598450230', '999.20'); 


用 户 表 和 订单 表 分 别 对 应 两 个 实例 对 象 ， 分 别 是 : Userjava 和 Orderjava， 它 们 都 


在 com.yiibai.pojo 包 中 。 
User.java 代 码 内 容 如 下 : 


package com.yiibai.pojo; 
import java.util.List; 


Jf otto 
* (describe: User 
* @author: Yiibai 
* Qversion: V1.0 
* (copyright http://www.yiibai.com 
a 
public class User { 
private int id; 
private String username; 
private String mobile; 


public int getId() { 
return id; 


public void setId(int id) { 
this.id = id; 
} 


public String getUsername() { 
return username; 


public void setUsername(String username) { 
this.username = username; 
} 


public String getMobile() { 
return mobile; 


public void setMobile(String mobile) { 
this.mobile = mobile; 
} 


Orderjava 代 码 内 容 如 下 : 


package com.yiibai.pojo; 


VASE 
* Qdescribe: User - 订单 
* @author: Yiibai 
* Qversion: V1.0 
* (copyright http://www.yiibai.com 
n 
public class Order ( 
private int orderId; 
private String orderNo; 
private float money; 
private int userId; 
private User user; 


public int getUserId() ( 
return userId; 


public void setUserId(int userId) { 
this.userId - userId; 
} 


public int getOrderId() { 
return orderId; 


public void setOrderId(int orderId) { 
this.orderId - orderId; 
} 


public User getUser() { 
return user; 


public void setUser(User user) { 
this.user = user; 
} 


public String getOrderNo() { 
return orderNo; 


public void setOrderNo(String orderNo) { 
this.orderNo = orderNo; 


} 
public float getMoney() { 
return money; 


public void setMoney(float money) { 
this.money = money; 
} 


5. MEX 


这 个 实例 中 有 三 个 重要 的 配置 文件 ， 它 们 分 别 是 : applicationContext.xml , 
Configuration.xml 以 及 UserMaper.xml. 


applicationContext.xml 配置 文件 里 最 主要 的 配置 : 


<?xml version="1.0" encoding="utf-8"?> 
«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" xmlns:ao[ 
xmlns:tx-"http://www.springframework.org/schema/tx" xmlns:cont: 
xmins:p="http://www.springframework.org/schema/p" 
xsi:schemaLocationz" 
http://www.springframework.org/schema/beans http://www 
http://www.springframework.org/schema/aop http://www. sj 
http://www.springframework.org/schema/context http://w 
http://www.springframework.org/schema/jee http://www. sj 
http://www.springframework.org/schema/tx http://www. spi 
default -autowire="byName" default-lazy-init="false"> 


«1- -本 示例 采用 DBCP 连 接 池 ， 应 预先 把 DBCP 的 jar 包 复制 到 工程 的 Lib 目 录 下 。 -- 
«context:property-placeholder location="classpath:/config/datal 


«bean id="dataSource" class="org.apache.commons.dbcp.BasicData: 
destroy-method-"close" p:driverClassName="com.mysql.jdbc.Dt 
p:url="jdbc:mysql://127.0.0.1:3306/yiibai?characterEncodin¢ 
p:username="root" p:password="" p:maxActive="10" p:maxIdle: 

</bean> 


<bean id="transactionManager" 
class="org.springframework.jdbc.datasource.DataSourceTransé 
<property name="dataSource" ref="dataSource" /> 

</bean> 


<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSess: 
<!--dataSource 属 性 指定 要 用 到 的 连接 池 - -> 
<property name="dataSource" ref="dataSource" /> 
<!--configLocation 属 性 指定 nybatis 的 核心 配置 文件 - -> 
«property name="configLocation" value="classpath:config/Cor 
<!-- 所 有 配置 的 mapper 文 件 --> 
«property name-"mapperLocations" value="classpath*:com/yiit 
«/bean» 


«bean class-"org.mybatis.spring.mapper.MapperScannerConfigurer' 
«property name="basePackage" value-"com.yiibai.maper" /> 
</bean> 
</beans> 





配置 文件 Configuration.xml 的 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN' 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
<typeAlias alias="User" type="com.yiibai.pojo.User"/> 
«typeAlias alias-"Order" type="com.yiibai.pojo.Order"/> 


«/typeAliases» 
<!-- Sspring 集成 之 后 , 这 些 可 以 完全 删除 , 数据 库 连 接 的 管理 交 给 spring X 
cuu 


«environments default="development"> 
«environment id="development"> 
«transactionManager type="JDBC"/> 
«dataSource type="POOLED"> 
«property name="driver" value-"com.mysql.jdbc.Driver"/: 
«property name-"url" value="jdbc:mysql://127.0.0.1:330¢ 
«property name="username" value="root"/> 
<property name="password" value="password"/> 
</dataSource> 
</environment> 
</environments> 
T 


<!-- 这 里 交 给 sqLlSessionFactory 的 mapperLocations 属 性 去 得 到 所 有 配置 
lee 


<mappers> 

«mapper resource="com/yihaomen/mapper/User .xm1l"/> 
</mappers> 
sa 


</configuration> 
4 = m 
UserMaper.xml 用 于 定义 查询 和 数据 对 象 映射 ， 其 内 容 如 下 : 





<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"» 

«mapper namespace="com.yiibai.maper.UserMaper"> 


<!-- 为 了 返回 list 类 型 而 定义 的 returnMap --» 
«resultMap type="User" id="resultUser"> 

<id column="id" property="id" /> 

«result column="username" property="username" /> 

<result column="mobile" property="mobile" /> 
</resultMap> 


«!-- User KG Order 查询 方法 的 配置 (多 对 一 的 方式 ) --> 
«resultMap id="resultUserOrders" type="Order"> 
<id property="orderId" column="order_id" /> 
<result property="orderNo" column="order_no" /> 
<result property="money" column="money" /> 
«result property="userId" column-"user id" /> 


«association property="user" javaType="User"> 
<id property="id" column="id" /> 
«result property="username" column="username" /> 
<result property="mobile" column="mobile" /> 
</association> 
</resultMap> 


<select id="getUserOrders" parameterType="int" resultMap="resu- 
SELECT u.*,0.* FROM "user' u, ‘order o 
WHERE u.id-o.user id AND u.id=#{id} 
</select> 


«select id-"getUserById" resultMap="resultUser" parameterType=' 
SELECT * 
FROM user 
WHERE id=#{id} 
</select> 
</mapper> 


S LLL O f 





6、 测 试 执行 ， 输 出 结果 
我 们 创建 一 个 控制 器 类 在 包 com.yiibai.controller 下 ， 类 的 名 称 为 : 


UserControllerjava， 这 里 新 增 了 一 个 方法 : pageList， 对 应 请 求 URL 是 
/orderpages， 其 代码 如 下 : 


package com.yiibai.controller; 


import java.util.List; 


import javax.servlet.http.HttpServletRequest; 

import javax.servlet.http.HttpServletResponse; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.servlet .ModelAndView; 


import com.yiibai.maper.UserMaper; 
import com.yiibai.pojo.Order; 
import com.yiibai.util.Page; 


// http://localhost:8080/mybatis08-paging/user/orders 
@Controller 
QRequestMapping("/user") 
public class UserController ( 
@Autowired 
UserMaper userMaper; 


/ * 
某 一 个 用 户 下 的 所 有 订单 


@param request 
@param response 
@return 


*ox ok FF ob o 


e 
@RequestMapping("/orders") 
public ModelAndView listall(HttpServletRequest request, 
HttpServletResponse response) { 

List<Order> orders = userMaper.getUserOrders(1); 
System.out.println("orders"); 
ModelAndView mav - new ModelAndView("user orders"); 
mav.addObject("orders", orders); 
return mav; 


c 


* 


订单 分 页 


SS 


~*~ FF FF FF F A 


@param request 

@param response 

@return 

“y 

@RequestMapping("/orderpages") 

public ModelAndView pageList(HttpServletRequest request, 
HttpServletResponse response) { 

int currentPage = request.getParameter ("page") == null ? 1 

.parseInt(request.getParameter("page")); 

int pageSize = 3; 

if (currentPage <= 0) { 
currentPage = 1; 

} 


int currentResult = (currentPage - 1) * pageSize; 


System.out.println(request.getRequestURI( )); 
System.out.println(request.getQueryString()); 


Page page - new Page(); 

page.setShowCount ( pageSize); 
page.setCurrentResult(currentResult); 

List«Order» orders - userMaper.getOrderListPage(page, 1); 


System.out.println("Current page =>" + page); 


int totalCount - page.getTotalResult(); 

int lastPage - 0; 

if (totalCount % pageSize == 0) { 
lastPage - totalCount ?6 pageSize; 

) else { 
lastPage = 1 + totalCount / pageSize; 

} 

if (currentPage >= lastPage) { 
currentPage = lastPage; 

} 

String pageStr = ""; 


pageStr = String.format( 


"<a href=\"%s\">E— </a> «a href=\"%s\"> 下 一 页 < 
.getRequestURI() 
+ "?page-" + (currentPage - 1), request.gel 
+ "?page=" + (currentPage + 1)); 


// 制定 视图 ， 也 就 是 list .jsp 
ModelAndView mav = new ModelAndView("pagelist"); 


mav 
mav 


.addObject("orders", orders); 
.addObject("pagelist", pageStr); 


return mav; 





注意 ， 在 这 个 分 页 工程 中 ， 在 comyiibai.utl 包 下 新 增 了 几 个 类 ， 它 们 分 别 是 : 
PagePlugin.java, Page.java, PageHelperjava， 其 中 PagePlugin 是 针对 MyBatis 
分 页 的 插件 。 由 于 代码 太 多 ， 这 里 列 出 PagePlugin.java 的 代码 ， 其 它 两 个 类 的 代 
码 有 闪 趣 的 读者 可 以 在 下 载 代码 后 阅读 取 研 究 。 PagePlugin.java 的 代码 如 下 所 


小 : 


package com 


import java 
import java 
import java 


.yiibai.util; 


.lang.reflect.Field; 
.sgl.Connection; 
.sql.PreparedStatement; 


import 
import 
import 
import 
import 


import 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


java. 
java. 
java. 
java. 
java. 


java 


org. 
org. 
org. 
org. 
org 
org. 
org. 
org. 
org. 
org 
org. 
org. 
org. 
org. 
org 
org. 
org. 
org 
org. 
org. 
org. 
org. 
org 


sql.ResultSet; 
sql.SQLException; 
util.List; 
util.Map; 
util.Properties; 


x.xml.bind.PropertyException; 


apache.ibatis.executor.ErrorContext; 
apache.ibatis.executor.Executor; 
apache.ibatis.executor.ExecutorException; 
apache.ibatis.executor.statement.BaseStatementHandler; 


.apache.ibatis.executor.statement.RoutingStatementHandle!: 


apache.ibatis.executor.statement.StatementHandler; 
apache.ibatis.mapping.BoundSql; 
apache.ibatis.mapping.MappedStatement; 
apache.ibatis.mapping.ParameterMapping; 


.apache.ibatis.mapping.ParameterMode; 


apache.ibatis.plugin.Interceptor; 
apache.ibatis.plugin.Intercepts; 
apache.ibatis.plugin.Invocation; 
apache.ibatis.plugin.Plugin; 


.apache.ibatis.plugin.Signature; 


apache.ibatis.reflection.MetaObject; 
apache.ibatis.reflection.property.PropertyTokenizer; 


.apache.ibatis.scripting.xmltags.ForEachSqlNode; 


apache.ibatis.session.Configuration; 
apache.ibatis.session.ResultHandler; 
apache.ibatis.session.RowBounds; 
apache.ibatis.type.TypeHandler; 


.apache.ibatis.type.TypeHandlerRegistry; 


QIntercepts( { @Signature(type = StatementHandler.class, method = ' 
public class PagePlugin implements Interceptor { 


private static String dialect = ""; 
private static String pageSqlId = ""; 


@SuppressWarnings("unchecked" ) 
public Object intercept(Invocation ivk) throws Throwable { 


if 


(ivk.getTarget() instanceof RoutingStatementHandler) { 

RoutingStatementHandler statementHandler = (RoutingStal 
.getTarget(); 

BaseStatementHandler delegate = (BaseStatementHandler) 
.getValueByFieldName(statementHandler, "delega! 

MappedStatement mappedStatement - (MappedStatement) Re! 
.getValueByFieldName(delegate, "mappedStatement 


if (mappedStatement.getId().matches(pageSqlId)) { 
BoundSql boundSql = delegate.getBoundSql(); 
Object parameterObject = boundSql.getParameterObjec 
if (parameterObject == null) { 


throw new NullYiibaierException("parameterObjec 
) else { 

Connection connection = (Connection) ivk.getArt( 

String sql = boundSql.getSql(); 

String countSql = "select count(0) from (" + s¢ 
+ ") myCount"; 

System.out.println("iZXsql 语句 :" + countSql); 

PreparedStatement countStmt = connection 
.prepareStatement(countSql); 

BoundSql countBS = new BoundSql(mappedStatement 
.getConfiguration(), countSql, boundSq- 
.getParameterMappings(), parameterObjec 

setParameters(countStmt, mappedStatement, count 
parameterObject); 

ResultSet rs - countStmt.executeQuery(); 

int count - 0; 

if (rs.next()) 1 

count - rs.getInt(1); 
j 


rs.close(); 
countStmt.close(); 


Page page - null; 

if (parameterObject instanceof Page) { 
page = (Page) parameterObject; 
page.setTotalResult(count); 

) else if (parameterObject instanceof Map) { 
Map<String, Object» map = (Map<String, Obje 
page = (Page) map.get("page"); 
if (page == null) 

page = new Page(); 
page.setTotalResult(count); 

} else { 

Field pageField = ReflectHelper.getFieldByt 
parameterObject, "page"); 
if (pageField != null) ( 
page = (Page) ReflectHelper.getValueByt 
parameterObject, "page"); 
if (page -- null) 
page - new Page(); 
page.setTotalResult(count); 
ReflectHelper.setValueByFieldName(parar 
"page", page); 
) else { 
throw new NoSuchFieldException(paramete 
.getClass().getName()); 
} 

} 

String pageSql = generatePageSql(sql, page); 

System.out.println("page sql:" + pageSql); 

ReflectHelper.setValueByFieldName(boundSql, "st 


} 


return ivk.proceed(); 


} 


private void setParameters(PreparedStatement ps, 
MappedStatement mappedStatement, BoundSql boundSql, 
Object parameterObject) throws SQLException { 
ErrorContext.instance().activity("setting parameters") .obje 
mappedStatement.getParameterMap().getId()); 
List«ParameterMapping» parameterMappings = boundSql 
.getParameterMappings(); 
if (parameterMappings !- null) ( 
Configuration configuration = mappedStatement.getConfit 
TypeHandlerRegistry typeHandlerRegistry - configuratior 
.getTypeHandlerRegistry(); 
MetaObject metaObject = parameterObject == null ? null 
configuration.newMetaObject(parameterObject), 
for (int i = 0; i < parameterMappings.size(); i++) ( 
ParameterMapping parameterMapping - parameterMappir 
if (parameterMapping.getMode() !- ParameterMode.OU' 
Object value; 
String propertyName = parameterMapping.getPropt 
PropertyTokenizer prop = new PropertyTokenizer | 
if (parameterObject == null) { 
value - null; 
) else if (typeHandlerRegistry 
.hasTypeHandler(parameterObject.getCla: 
value - parameterObject; 
) else if (boundSql.hasAdditionalParameter (pro 
value = boundSql.getAdditionalParameter (prt: 
) else if (propertyName 
.Startswith(ForEachSqlNode.ITEM PREFIX: 
&& boundSql.hasAdditionalParameter(pro[ 
value = boundSql.getAdditionalParameter(prt« 
if (value != null) { 
value = configuration.newMetaObject(va- 
.getValue( 
propertyName.substringi 
.getName( ). lent 


} 
} else { 
value = metaObject == null ? null : metaOb: 
.getValue(propertyName); 
} 
TypeHandler typeHandler = parameterMapping.get™ 
if (typeHandler == null) { 
throw new ExecutorException( 
"There was no TypeHandler found fot 
+ propertyName + " of state 
+ mappedStatement.getId()), 
j 
typeHandler.setParameter(ps, i+ 1, value, par: 
.getJdbcType( )); 


} 


private String generatePageSql(String sql, Page page) { 
if (page != null && (dialect != null || !dialect.equals("" 
StringBuffer pageSql = new StringBuffer(); 
if ("mysql".equals(dialect)) { 
pageSql.append(sql); 
pageSql.append(" limit " + page.getCurrentResult() 
+ page.getShowCount( )); 
) else if ("oracle".equals(dialect)) { 
pageSql 
.append("select * from (select tmp tb.*,ROV 
pageSql.append(sql); 
pageSql.append(") tmp tb where ROWNUM<=") ; 
pageSql.append(page.getCurrentResult() + page.getSt 
pageSql.append(") where row_id>"); 
pageSql.append(page.getCurrentResult()); 
} 
return pageSql.toString(); 
} else { 
return sql; 
} 


} 


public Object plugin(Object arg0) { 
// TODO Auto-generated method stub 
return Plugin.wrap(arg0, this); 


j 


public void setProperties(Properties p) ( 
dialect - p.getProperty("dialect"); 
if (dialect -- null || dialect.equals("")) ( 
try { 
throw new PropertyException("dialect property is nN 
) catch (PropertyException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


} 


} 
pageSqlId = p.getProperty("pageSqlId"); 
if (dialect == null || dialect.equals("")) { 
try { 
throw new PropertyException("pageSqlId property is 
) catch (PropertyException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 





接 下 来 部 署 mybatis08-paging 这 个 工程 ， 和 启动 tomcat ， 打 开 浏 览 器 输入 网 
tit : http://localhost:8080/mybatis08-paging/user/orderpages ， 显 示 结 果 如 下 : 


工程 mybatis08-paging 的 代码 下 载 : http://pan.baidu.com/s/1pJxhvNt 
Jar 包 下 载 : http://pan.baidu.com/s/1bnyRJ9H 


MyBatis# SQL: - MyBatis 教 程 


MyBatis 的 强大 特性 之 一 便 是 它 的 动态 SQL。 如 果 你 有 使 用 JDBC 或 其 他 类 似 框架 
的 经 验 ， 你 就 能 体会 到 根据 不 同 条 件 拼接 SQL 语句 有 多 么 痛苦 。 拼 接 的 时 候 要 确 
保 不 能 志 了 必要 的 空格 ， 还 要 注意 省 掉 列 名 列表 最 后 的 逗号 。 利 用 动态 SQL 这 一 
特性 可 以 彻底 摆脱 这 种 痛苦 。 


通常 使 用 动态 SQL 不 可 能 是 独立 的 一 部 分 ,MyBatis 当然 使 用 一 种 强大 的 动态 SQL 
语言 来 改进 这 种 情形 ,这 种 语言 可 以 被 用 在 任意 的 SQL 映射 语句 中 。 


动态 SQL 元 素 和 使 用 JSTL 或 其 他 类 似 基 于 XML 的 文本 处 理 器 相似 。 在 MyBatis 
之 前 的 版 本 中 ,有 很 多 的 元 素 需 要 来 了 解 。MyBatis 3 大 大 提升 了 它们 ,现在 用 不 到 原 
先 一 半 的 元 素 就 可 以 了 。MyBatis 采用 功能 强大 的 基于 OGNL 的 表达 式 来 消除 其 他 
元 素 。 


mybatis 的 动态 sql 语句 是 基于 OGNL 表 达 式 的 。 可 以 方便 的 在 sql 语句 中 实现 某 些 
逻辑 . 总 体 说 来 mybatis 动态 SQL 语句 主要 有 以 下 几 类 : 1. if i (简单 的 条 件 判 断 ) 
2. choose (when,otherwize) ,相当 于 java 语言 中 的 switch ,与 jstl 中 的 choose 很 类 
似 . 3. trim (对 包含 的 内 容 加 上 prefix, 或 者 suffix 等 ， 前 级 ， 后 级 ) 4. where (主要 是 
用 来 简化 sql 语 句 中 where 条 件 判 断 的 ， 能 智能 的 处 理 and or ,不 必 担 心 多 余 导 致 语 
法 错误 ) 5. set (主要 用 于 更 新 时 ) 6. foreach (在 实现 mybatis in 语句 查询 时 特别 有 

用 ) 


if 
动态 SQL 通常 要 做 的 事情 是 有 条 件 地 包含 where 子 句 的 一 部 分 。 比 如 : 


«select id="findActiveBlogwithTitleLike" 
resultType="Blog"> 
SELECT * FROM BLOG 
WHERE state = ‘ACTIVE’ 
<if test="title != null"> 
AND title like #{title} 
</if> 
</select> 


这 条 语句 提供 了 一 个 可 选 的 文本 查找 类 型 的 功能 。 如 果 没 有 传 入 “title”， 那 么 所 有 处 
于 “ACTIVE” 状 态 的 BLOG 都 会 返回 ; 反之 若 传 入 了 “title”， 那 么 就 会 把 模糊 查 

找 “title” 内 容 的 BLOG 结 果 返 回 (就 这 个 例子 而 言 ， 细 心 的 读者 会 发 现 其 中 的 参数 值 是 
可 以 包含 一 些 掩 码 或 通配符 的 )。 


如 果 想 可 选 地 通过 “title" 和 “author 两 个 条 件 搜 索 该 怎么 办 呢 ? 首先 ， 改 变 语句 的 名 
称 让 它 更 具 实 际 意义 ; 然后 只 要 加 入 另 一 个 条 件 即 可 。 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG WHERE state = ‘ACTIVE’ 
<if test="title != null"> 
AND title like #{title} 


</if> 
<if test="author != null and author.name != null"> 
AND author_name like #{author.name} 
</if> 
</select> 


choose, when, otherwise 


有 些 时 候 ， 我 们 不 想 用 到 所 有 的 条 件 语句 ， 而 只 想 从 中 择 其 一 二 。 针 对 这 种 情况 ， 
MyBatis 提供 了 choose 元 素 ， 它 有 点 像 Java 中 的 switch 语句 。 


还 是 上 面 的 例子 ， 但 是 这 次 变 为 提供 了 “title" 就 按 'title" 查 找 ， 提 供 了 "author 就 
按 "author" 查 找 ， 若 两 者 都 没有 提供 ， 就 返回 所 有 符合 条 件 的 BLOG( 实 际 情况 可 能 
是 由 管理 员 按 一 定 策略 选 出 BLOG 列表 ， 而 不 是 返回 大 量 无 意义 的 随机 结果 )。 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG WHERE state = ‘ACTIVE’ 
<choose> 
<when test="title != null"> 
AND title like #{title} 
</when> 
«when test-"author != null and author.name != null"> 
AND author name like #{author.name} 
</when> 
<otherwise> 
AND featured = 1 
</otherwise> 
</choose> 
</select> 


trim, where, set 


前 面 几 个 例子 已 经 合宜 地 解决 了 一 个 臭名 昭著 的 动态 SQL 问题 。 现 在 考虑 回 
到 "证 示 例 ， 这 次 我 们 将 "ACTIVE = 人 也 设置 成 动态 的 条 件 ， 看 看 会 发 生 什么 。 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG 


WHERE 

«if test="state !- null"> 
state = #{state} 

</if> 


«if test="title != null"> 
AND title like #{title} 


</if> 
<if test="author != null and author.name != null"> 
AND author_name like #{author.name} 
</if> 
</select> 


如 果 这 些 条 件 没有 一 个 能 匹配 上 将 会 怎样 ?最 终 这 条 SQL 会 变 成 这 样 : 


SELECT * FROM BLOG 
WHERE 


这 会 导致 查询 失败 。 如 果 仅 仅 第 二 个 条 件 匹 配 又 会 怎样 ?3 这 
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SELECT * FROM BLOG 
WHERE 
AND title like 'yiibai.com' 


这 个 查询 也 会 失败 。 这 个 问题 不 能 简单 的 用 条 件 句 式 来 解决 ， 如 果 你 也 便 经 被 迫 这 
样 写 过， 那么 你 很 可 能 从 此 以 后 都 不 想 再 这 样 去 写 了 。 


MyBatis 有 一 个 简单 的 处 理 ， 这 在 90% 的 情况 下 都 会 有 用 。 而 在 不 能 使 用 的 地 方 ， 
你 可 以 自 定义 处 理 方 式 来 合 其 正常 工作 。 一 处 简单 的 修改 就 能 得 到 想 要 的 效果 : 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG 


<where> 
<if test="state != null"> 
state = #{state} 
</if> 


<if test="title != null"> 
AND title like #{title} 
</if> 
<if test="author != null and author.name != null"> 
AND author_name like #{author.name} 
</if> 
</where> 
</select> 


where 元 素 知 道 只 有 在 一 个 以 上 的 if 条 件 有 值 的 情况 下 才 去 插入 * WHERE” 子 句 。 而 
且 ， 若 最 后 的 内 容 是 “AND” 或 “OR” 开 头 的 ，where 元 素 也 知道 如 何 将 他 们 去 除 。 


如 果 where 元 素 没有 按 正常 套路 出 牌 ， 我 们 还 是 可 以 通过 自 定义 trim 元 素来 定制 
我 们 想 要 的 功能 。 上 比如 ， 和 where 元 素 等 价 的 自 定义 trim 元 素 为 : 


«trim prefix="WHERE" prefixOverrides="AND |OR "> ... </trim> 


ee 属性 会 忽略 通过 管道 分 隔 的 文本 序列 (注意 此 例 中 的 空格 也 是 必要 
的 )。 它 带 来 的 结果 就 是 所 有 在 prefixOverrides 属性 中 指定 的 内 容 将 被 移 除 ， 并 且 
插入 prefix 属性 中 指定 的 内 容 。 


类 似 的 用 于 动态 更 新 语句 的 解决 方案 叫做 set, set 元 素 可 以 被 用 于 动态 包含 需要 更 
新 的 列 ， 而 舍 去 其 他 的 。 上 比如 : 


«update id="updateAuthorIfNecessary"> 
update Author 


<set> 
«if test="username !- null">username=#{username}, </if> 
«if test-"password !- null">password=#{password},</if> 
«if test-"email !- null">email=#{email},</if> 
«if test="bio !- null">bio=#{bio}</if> 

</set> 

where id=#{id} 
</update> 


EH, set 元 素 会 动态 前 置 SET KS, [e t aBERZSXBgES, AAA T R 
语句 之 后 很 可 能 就 会 在 生成 的 赋值 语句 的 后 面 留 下 这 些 逗 号。 


若 你 对 等 价 的 自 定义 trim 元 素 的 样子 感 兴趣 ， 那 这 就 应 该 是 它 的 真面目 : 


«trim prefix="SET" suffixOverrides=","> ... </trim> 


注意 这 里 我 们 忽略 的 是 后 缀 中 的 值 ， 而 又 一 次 附加 了 前 级 中 的 值 。 


foreach 


动态 SQL 的 另外 一 个 常用 的 必要 操作 是 需要 对 一 个 集合 进行 通 历 ， 通 常 是 在 构建 
IN 条 件 语句 的 时 候 。 上 比如 : 


«select id-"selectPostIn" resultType="domain.blog.Post"> 
SELECT * 
FROM POST P 
WHERE ID in 
«foreach item="item" index="index" collection="list" 
open="(" separator="," close=")"> 
#{item} 
</foreach> 
</select> 


foreach 元 素 的 功能 是 非常 强大 的 ， 它 允许 你 指定 一 个 集合 ， 声 明 可 以 用 在 元 素 体 
内 的 集合 项 和 索引 变量 。 它 也 允许 你 指定 开 闭 匹配 的 字符 串 以 及 在 迭代 中 间 放 置 分 
隅 符 。 这 个 元 素 是 很 智能 的 ， 因 此 它 不 会 偶然 地 附加 多 余 的 分 隔 符 。 


注意 你 可 以 将 一 个 List 实例 或 者 数组 作为 参数 对 象 传 给 MyBatis， 当 你 这 么 做 的 时 
候 ，MyBatis 会 自动 将 它 包装 在 一 个 Map 中 并 以 名 称 为 键 。List 实例 将 会 以 “list” 作 
为 键 ， 而 数组 实例 的 键 将 是 “array”。 


到 此 我 们 已 经 完成 了 涉及 XML 配置 文件 和 XML 映射 文件 的 讨论 。 下 一 部 分 将 详细 
探讨 Java API， 这 样 才能 从 已 创建 的 映射 中 获取 最 大 利益 。 


bind 
bind 元 素 可 以 从 OGNL 表达 式 中 创建 一 个 变量 并 将 其 绑 定 到 上 下 文 。 上 比如 : 


<select id="selectBlogsLike" resultType="Blog"> 
«bind name="pattern" value="'%' + _parameter.getTitle() + '%'" /: 
SELECT * FROM BLOG 
WHERE title LIKE #{pattern} 

</select> 


4 — 





Multi-db vendor support 


一 个 配置 了 “″ databaseld" 变 量 的 databaseldProvider 对 于 动态 代码 来 说 是 可 用 的 ， 
这 样 就 可 以 根据 不 同 的 数据 库 厂 商 构 建 特定 的 语句 。 比 如 下 面 的 例子 : 


<insert id="insert"> 
<selectKey keyProperty="id" resultType="int" order="BEFORE"> 


«if test="_databaseId == 'oracle'"> 
select seq_users.nextval from dual 
</if> 
«if test="_databaseId == 'db2'"> 
select nextval for seq users from sysibm.sysdummy1" 
</if> 
</selectKey> 
insert into users values (#{id}, #{name}) 
</insert> 


动态 SQL 中 可 插 拔 的 脚本 语言 


tL a Ee A EA E ae 
(language driven) 之 后 来 写 基 于 这 种 语言 的 动态 SQL 查询 。 


可 以 通过 实现 下 面 接口 的 方式 来 插入 一 种 语言 : 
public interface LanguageDriver { 
ParameterHandler createParameterHandler(MappedStatement mappedSté 


SqlSource createSqlSource(Configuration configuration, XNode scr: 
SqlSource createSqlSource(Configuration configuration, String sci! 


is] — —H 
一 旦 有 了 自 定 义 的 语言 驱动 ， 你 就 可 以 在 mybatis-config.xml 文件 中 将 它 设置 为 默 


Kies : 





<typeAliases> 

<typeAlias type="org.sample.MyLanguageDriver" alias="myLanguage", 
</typeAliases> 
<settings> 

<setting name="defaultScriptingLanguage" value="myLanguage"/> 
</settings> 


SS ee 


除了 设置 默认 语言 ， 你 也 可 以 针对 特殊 的 语句 指定 特定 语言 ， 这 可 以 通过 如 下 的 
lang 属性 来 完成 : 





«select id-"selectBlog" lang="myLanguage"> SELECT * FROM BLOG </se- 
和 
或 者 在 你 正在 使 用 的 映射 中 加 上 注解 @Lang 来 完成 : 





public interface Mapper { 
@Lang(MyLanguageDriver.class) 
@Select("SELECT * FROM BLOG") 
List<Blog> selectBlog(); 


} 


MyBatis SqiSessionDaoSupport fJ - MyBatis 
教程 

在 前 面 的 章节 中 ， 我 们 已 经 讲 到 了 基本 的 mybatis 操作 ， 但 都 是 基于 mapper eH 
操作 的 ， 在 mybatis3 中 这 个 mapper 接口 貌似 充当 了 以 前 在 ibatis 2 中 的 DAO 层 的 
作用 。 但 事实 上 ， 如 果 有 这 个 mapper 接 口 不 能 完成 的 工作 ， 或 者 需要 更 复杂 的 扩展 
的 时 候 ， 我 们 就 需要 自己 写 DAO 层 。 mybatis 3 也 是 支持 DAO 层 设计 的 ， 类 似 于 
ibatis2。 下面 我 们 结合 一 个 实例 来 介绍 。 


首页 我 们 创建 一 个 工程 为 : mybatis11， 再 创建 一 个 com.yihaomen.dao 包 ， 然 后 
在 里 面 分 别 创 建 接口 UserDAO， 并 实现 该 接口 UserDAOImpl 。 整 个 工程 的 目录 结 
构 如 下 : 


UserDao 接 口 的 代码 如 下 : 


package com.yiibai.dao; 
import java.util.List; 
import com.yiibai.pojo.Order; 


public interface UserDAO { 
public List<Order> getUserOrders(int userId); 
} 


UserDaolmpl 实现 UserDao 接 口 的 代码 如 下 : 


package com.yiibai.dao; 
import java.util.List; 


import org.mybatis.spring.support.SqlSessionDaoSupport; 
import org.springframework.stereotype.Repository; 


import com.yiibai.pojo.Order; 


@Repository 
public class UserDAOImpl extends SqlSessionDaoSupport implements U: 
public List«Order» getUserOrders(int userId) { 
// TODO Auto-generated method stub 
return this.getSqlSession().selectList("com.yiibai.inter. Il 


‘ — 78 








控制 类 UserControllerjava 的 代码 如 下 : 


package com.yiibai.controller; 


import 


import 
import 
import 
import 
import 
import 


import 
import 
import 


java.util.List; 


javax.servlet.http.HttpServletRequest; 
javax.servlet.http.HttpServletResponse; 
org.springframework.beans.factory.annotation.Autowired; 
org.springframework.stereotype.Controller; 
org.springframework.web.bind.annotation.RequestMapping; 
org.springframework.web.servlet.ModelAndView; 


com.yiibai.dao.UserDAO; 
com.yiibai.pojo.Order; 
com.yiibai.util.Page; 


// http://localhost:8080/mybatis08-paging/user/orders 
@Controller 
QRequestMapping("/user") 


public 


class UserController ( 


//UserMaper userMaper; 


@Autowired 
UserDAO userDao; 


Pre 


* 


* 


* 


* 


* 


* 


“7 


某 一 个 用 户 下 的 所 有 订单 (Dao 方式 ) 
URL => http://localhost :8080/mybatisi1/user/lists 


@param request 
@param response 
@return 


QRequestMapping("/lists") 
public ModelAndView listalldao(HttpServletRequest request, 


下 一 步 ， 我 们 运行 检验 结果 (根据 用 户 ID， 读 取 这 个 用 户 的 所 有 订单 ) ， 打 开 浏 


HttpServletResponse response) { 
List«Order» orders = this.userDao.getUserOrders(1); 
// 制定 视图 =>list.jsp 
ModelAndView mav = new ModelAndView("lists"); 
mav.addObject("orders", orders); 
return mav; 


器 ， 输 入 网 址 : http://localhost:8080/mybatis11/user/lists ， 结 果 如 下 图 所 示 : 


We 
p 
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1509289090 999 
1519289091 290. 8 
1509294321 919. 9 
1601232190 329. 9 
1503457384 321.0 
1598572382 342. 0 
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1504538293 2109. 0 
1932428723 5888. 0 
2390423712 3219. 0 
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4598450230 909. 2 
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工程 mybatis11 的 代码 下 载 : http://pan.baidu.com/s/1sjrEL9V 
Jar 包 下 载 http://pan.baidu.com/s/1bnyRJ9H 
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MyBatis 打 印 输出 SQL 语句 - MyBatis 教 程 


Hibernate 是 可 以 配置 show_sql 显示 自动 生成 的 SQL 语句 ， 用 format_sql 可 以 格 
式 化 SQL 语句 ， 但 如 果 用 mybatis 怎么 实现 这 个 功能 呢 ? 如 果 你 搜索 看 一 下 ， 基 本 
都 是 通过 配置 日 志 来 实现 的 ， 比 如 配置 我 们 最 常用 的 log4j.properties 来 实现 。 


首页 我 们 创建 一 个 java 工程 叫 作 : mybatis12， 内 容 与 之 前 Mybatis+Spring 差 不 
多 ， 实 现 一 个 通过 指定 用 户 ID 并 读 取 其 订单 列表 ， 来 观察 SQL 的 执行 情况 。 其 工程 
目录 结构 如 下 : 


[$ Package Explorer :: fe Hierarchy | [E (S) LI 
EI mybatis10 
$$ mybatis11 
4 3:2 mybatis12 
4 $8 src 
4 [B (default package) 
|J] Mainjava 
4 IB com yiibai.dao 
四 IUser;java 
4 HB com yiibai.pojo 
四 Userjava 
IX] User.xml 
4 {B config 
iX; Configure.xml 
log4j.properties 
mi JRE System Library [JavaSE-1.6] 
Ei mybatis spring 


log4j.properties 内 容 如 下 : 


# by yiibai.com 

log4j .rootLogger=debug, stdout, logfile 
10g4j.appender.stdout-org.apache.109g4j.ConsoleAppender 
4Zlog4j.appender.stdout.Target-System.err 

log4j .appender.stdout.layout=org.apache.1log4j .SimpleLayout 
log4j.appender.logfile-org.apache.log4j.FileAppender 
1og4j.appender.logfile.File-C:/mybatis show sql.log 
1og4j.appender.logfile.layout-org.apache.log4j.PatternLayout 

log4j .appender.logfile.layout.ConversionPattern=%d{yyyy-MM-dd HH:mr 


log4j . logger .com. ibatis=DEBUG 
10g4j.logger.com.ibatis.common.jdbc.SimpleDataSource-DEBUG 

log4j . logger .com.ibatis.common.jdbc.ScriptRunner=DEBUG 
1og4j.logger.com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate-DEE 
10g4j.logger.java.sql.Connection-DEBUG 
1og4j.logger.java.sql.Statement-DEBUG 
1og4j.logger.java.sql.PreparedStatement-DEBUG 


LLL RE 
主 类 测试 代码 如 下 : 





import java.io.Reader; 
import java.text.MessageFormat; 
import java.util.List; 


import org.apache.ibatis.io.Resources; 

import org.apache.ibatis.session.SqlSession; 

import org.apache.ibatis.session.SqlSessionFactory; 

import org.apache.ibatis.session.SqlSessionFactoryBuilder; 


import com.yiibai.dao.IUser; 
import com.yiibai.pojo.User; 


public class Main { 
private static SqlSessionFactory sqlSessionFactory; 
private static Reader reader; 


static { 
try { 
reader = Resources.getResourceAsReader ("config/Configut 
sqlSessionFactory = new SqlSessionFactoryBuilder().bui- 
} catch (Exception e) { 
e.printStackTrace(); 
} 


} 


public static SqlSessionFactory getSession() { 
return sqlSessionFactory; 
} 


jf sks 


* @param args 


ye 


public static void main(String[] args) { 
// TODO Auto-generated method stub 
SqlSession session = sqlSessionFactory.openSession(); 


try { 
//User user = (User) session.selectOne( 
// "com.yiibai.mybatis.models.UserMapper.getUsei 
IUser iuser - session.getMapper(IUser.class); 
getUserList(); 
//testInsert(); 
testUpdate(); 
//testDelete(); 
} finally { 
session.close(); 
} 
} 
// 
public static void testInsert() 
{ 
try 
{ 
SqlSession session = sqlSessionFactory.openSession(); 
IUser userMapper = session.getMapper(IUser.class); 
System.out.println("Test insert start..."); 
User user - new User(); 
user.setId(0); 
user.setName("Google"); 
user.setDept("Tech"); 
user.setWebsite("http://www.google.com"); 
user.setPhone("120"); 
userMapper.insertUser(user); 
session.commit(); 
System.out.println("NrNnAfter insert"); 
getUserList(); 
System.out.println("Test insert finished..."); 
} 
catch (Exception e) 
{ 
e.printStackTrace(); 
} 
} 
// 用 户 列表 
public static void getUserList()( 
try 
{ 


SqlSession session = sqlSessionFactory.openSession(); 
IUser iuser = session.getMapper(IUser.class); 
System.out.println("Test Get start..."); 
printUsers(iuser.getUserList()); 


System.out.println("Test Get finished..."); 
jcatch (Exception e) 


{ 
e.printStackTrace(); 
} 
} 
public static void testUpdate() 
{ 
try 
{ 
SqlSession session = sqlSessionFactory.openSession(); 
IUser iuser = session.getMapper(IUser.class); 
System.out.println("Test update start..."); 
printUsers(iuser.getUserList()); 
User user - iuser.getUser(1); 
user.setName("New name"); 
iuser.updateUser(user); 
session.commit(); 
System.out.println("NrNnAfter update"); 
printUsers(iuser.getUserList()); 
System.out.println("Test update finished..."); 
}catch (Exception e) 
{ 
e.printStackTrace(); 
} 
} 
public static void testDelete() 
{ 
try 
{ 
SqlSession session = sqlSessionFactory.openSession(); 
IUser iuser = session.getMapper(IUser.class); 
System.out.println("Test delete start..."); 
System.out.println("Before delete"); 
printUsers(iuser.getUserList()); 
iuser.deleteUser(3); 
session.commit(); 
System.out.println("NrNnAfter delete"); 
printUsers(iuser.getUserList()); 
System.out.println("Test delete finished..."); 
jcatch (Exception e) 
{ 
e.printStackTrace(); 
} 
} 
EXER 


* 


* 
* (param users 
Eu 
private static void printUsers(final List«User» users) 


{ 


int count = 0; 


for (User user : users) 


{ 
System.out.println(MessageFormat. format ("============= 
System.out.println("User Id: " + user.getId()); 
System.out.println("User Name: " + user.getName()); 
System.out.println("User Dept: " + user.getDept()); 
System.out.println("User Website: " + user.getWebsite(: 
} 





执行 后 ， 在 MyEclise 终 端 输出 结果 如 下 : 


DEBUG - Logging initialized using 'class org.apache.ibatis.logging 
DEBUG - PooledDataSource forcefully closed/removed all connections 
DEBUG - PooledDataSource forcefully closed/removed all connections 
DEBUG - PooledDataSource forcefully closed/removed all connections 
DEBUG - PooledDataSource forcefully closed/removed all connections 
Test Get start... 

DEBUG - Opening JDBC Connection 

DEBUG - Created connection 22927632. 

DEBUG - Setting autocommit to false on JDBC Connection [com.mysql.: 
DEBUG - ooo Using Connection [com.mysql. jdbc. JDBC4Connection@15dd9-: 


DEBUG - ==> Preparing: select * from user 
DEBUG - ==> Parameters: 

DEBUG - <== Total: 2 

———— User [1 ]================= 
User Id: 1 


User Name: New name 

User Dept: Tech 

User Website: http://www. yiibai.com 

==- =- User [2] =e 

User Id: 2 

User Name: Hevi 

User Dept: Tech 

User Website: http://www.baidu.com 

Test Get finished... 

Test update start... 

DEBUG - Opening JDBC Connection 

DEBUG - Created connection 33189144. 

DEBUG - Setting autocommit to false on JDBC Connection [com.mysql.: 
DEBUG - ooo Using Connection [com.mysql.jdbc.JDBC4Connection@1faéd: 


DEBUG - ==> Preparing: select * from user 
DEBUG - ==> Parameters: 

DEBUG - <== Total: 2 

——— User [1 ]================= 
User Id: 1 


User Name: New name 


User Dept: Tech 

User Website: http://www. yiibai.com 

——————— User [2] =m 

User Id: 2 

User Name: Hevi 

User Dept: Tech 

User Website: http://www.baidu.com 

DEBUG - ooo Using Connection [com.mysql.jdbc.JDBC4Connection@1fa6d: 


DEBUG - ==> Preparing: select * from user where id=? 

DEBUG - ==> Parameters: 1(Integer) 

DEBUG - <== Total: 1 

DEBUG - ooo Using Connection [com.mysql. jdbc. JDBC4Connection@1faéd: 
DEBUG - ==> Preparing: UPDATE user SET name = ?, dept = ?, website 
DEBUG - ==> Parameters: New name(String), Tech(String), http://www 
DEBUG - <== Updates: 1 


DEBUG - Committing JDBC Connection [com.mysql. jdbc. JDBC4Connection( 


After update 
DEBUG - ooo Using Connection [com.mysql. jdbc. JDBC4Connection@1faéd: 


DEBUG - ==> Preparing: select * from user 
DEBUG - ==> Parameters: 

DEBUG - <== Total: 2 

=e em User [1]================= 
User Id: 1 


User Name: New name 

User Dept: Tech 

User Website: http://www.yiibai.com 
=N User [2] == 
User Id: 2 

User Name: Hevi 

User Dept: Tech 

User Website: http://www.baidu.com 
Test update finished... 





代码 下 载 : http://pan.baidu.com/s/1jGk1650 
Jar 包 下 载 http://pan.baidu.com/s/1bnyRJ9H 


Quartz 教 程 


cc 可 以 让 计划 的 程序 任务 一 个 预定 义 的 日 期 和 时 
eee 简单 或 复 条 的 日 程 安排 执行 几 十 ， 几 百 ， 甚 至 是 十 万 
的 作业 


Quartz 是 什么 ? 


作业 调度 库 


Quartz 是 一 种 功能 丰富 的 ， 开 放 源 码 的 作业 调度 库 ， 可 以 在 几乎 任何 Java 应 用 程序 
集成 - 从 最 小 的 独立 的 应 用 程序 到 规模 最 大 电子 商务 系统 。Quartz 可 以 用 来 创建 简 
单 或 复杂 的 日 程 安排 执行 几 十 ， 几 百 ， 甚 至 是 十 万 的 作业 数 - 作业 被 定义 为 标准 的 
Java 组 件 ， 可 以 执行 几乎 任何 东西 ， 可 以 编程 让 它们 执行 。 Quartz 调 度 包括 许多 企 
业 级 功能 ， 如 JTA 事 务 和 集群 支持 。 


Quartz 是 可 自由 使 用 ， 使 用 Apache 2.0 license 授 权 方 式 。 


Quartz 可 以 用 来 做 什么 ? 


如 果 应 用 程序 需要 在 给 定时 间 执 行 任务 ， 或 者 如 果 系 统 有 连续 维护 作业 ， 那 么 
Quartz 是 理想 的 解决 方案 。 


使 用 Quartz 作 业 调 度 应 用 的 示例 : 


e 了 驱动 处 理工 作 流 程 : 作为 一 个 新 的 订单 被 初始 化 放置 ， lies 到 在 正好 两 个 
小 时 内 ， 它 将 检查 订单 的 状态 ， 如 果 订 单 确 认 消 息 尚未 收 到 命令 触发 警告 通 
知 ， 以 及 改变 订单 的 状态 为 “等 待 的 干预 ”。 

e 系统 维护 : 调度 工作 给 数据 库 的 内 容 ， 每 个 工作 日 (节假日 除外 平日 ) 在 
11:30 PM 转 储 到 一 个 XML 文 件 中 。 

。 在 应 用 程序 内 提供 提醒 服务 。 


Quartz 特 点 - Quartz 教 程 


运行 环境 


e Quartz 可 以 运行 敌人 在 另 一 个 独立 式 应 用 程序 

e Quartz 可 以 在 应 用 程序 服务 器 (或 servlet 容 器 ) 内 被 实例 化 ， 并 且 参 与 XA 事 务 

e Quartz 可 以 作为 一 个 独立 的 程序 运行 (其 自己 的 Java 虚 拟 机 内 )， 可 以 通过 RMI 
使 用 

e Quartz 可 以 被 实例 化 ， 作 为 独立 的 项 目 集群 (负载 平衡 和 故障 转移 功能 )， 用 于 
作业 的 执行 


作业 调度 


人 
创建 : 


e 在 一 天 中 的 某 个 时 间 (FY) 

。 在 一 周 的 某 几 天 

。 在 每 月 的 某 一 天 

。 在 一 年 中 的 某 些 日 期 

e 不 在 注册 的 日 历 中 列 出 的 特定 日 期 (如 商业 节假日 除外 ) 
。 重复 特定 次 数 

。 重复 进行 ， 直 到 一 个 特定 的 时 间 / 日 期 

e 无 限 重 复 

e 重复 的 延迟 时 间 间 隔 


作业 是 由 其 创建 者 赋予 的 名 字 ， 也 可 以 组 织 成 命名 组 。 鲁 发 器 也 可 以 给 予 名 称 和 放 
置 在 组 中 ， 以 方便 地 将 它们 调度 内 组 织 。 作 业 可 以 被 添加 到 所 述 调度 器 一 次 ， 而 是 
具有 多 个 触发 器 注册 。 在 企业 Java 环 境 中 ， 作 业 可 以 执行 自己 的 工作 作为 分 布 式 
(XA) 事务 的 一 部 分 。 


作业 执行 


。 作业 可 以 实现 简单 的 作业 接口 ， 为 作业 执行 工作 的 任何 Java 类 。 

Job 类 的 实例 可 以 通过 Quartz 被 实例 化 ， 或 者 通过 应 用 程序 框架 。 

e 当 触 发 时 ， 调 度 通知 实现 JobListener 和 TriggerListener 接 口 雳 个 或 多 个 Java 对 
R (监听 器 可 以 是 简单 的 Java 对 象 ， 或 EJB，JMS 或 发 布 者 等 ) 。 这 些 监 听 器 
在 作业 已 经 执行 之 后 通知 。 

。 由 于 作业 完成 后 返回 JobCompletionCode， 它 通知 的 成 功 或 失败 的 调度 。 
JobCompletionCode 还 可 以 指示 的 基础 上 ， 成 功 的 话 就 采取 行动 调度 /失败 的 代 
码 - 如 立即 重新 执行 作业 。 


作业 持久 性 


e Quartz 的 设计 包括 可 被 实现 以 提供 的 作业 存储 各 种 机 制 一 个 作业 存储 接口 

e 通过 使 用 包含 的 JDBCJobStore， 所 有 的 作业 和 触发 器 配置 为 “ 非 挥 发 性 "都 存储 
在 通过 JDBC 关 系数 据 库 。 

e 通过 使 用 包含 的 RAMJobStore， 所 有 的 作业 和 人 触发 器 存储 在 RAM， 因 此 不 计 
划 执 行 仍然 存在 - 但 这 是 无 需 使 用 外 部 数据 库 的 优势 。 


事务 


e 可 以 参与 JTA 事 务 ， 通 过 使 用 JobStoreCMT (JDBCJobStore 的 子 类 ) 。 
e Quartz 可 以 管理 JTA 事 务 (开始 并 提交 它们 ) 周围 作业 的 执行 ， 从 而 使 作业 执 
行 的 工作 自动 将 JTA 事 务 中 发 生 。 


SERE 


e 故障 切换 

e 负载 均衡 

。 Quartz 的 内 置 的 群集 功能 ， 通 过 JDBCJobStore (如 上 所 述 ) 依靠 数据 库 持 久 
e Terracotta 扩 展 Quartz 提 供 集 群 功能 ， 而 不 需要 一 个 支持 数据 库 


监听 器 和 插件 


e 应 用 程序 可 以 捕捉 事件 的 调度 监控 或 通过 实现 一 个 或 多 个 监听 器 接口 控制 工作 / 

e 插件 机 制 ， 可 以 用 来 添加 功能 ，Quartz 让 作业 执行 过 程 中 或 工作 负载 和 触发 定 
义 的 历史 不 受 限 在 一 个 文件 中 。 

e 附带 了 一 些 “ 工 厂 建 有 ”插件 和 监听 器 。 


Quartz2 第 一 个 程序 - Quartz 教 程 


Quartz, 是 一 个 企业 级 调度 工作 的 框架 ， 帮 助 Java 应 用 程序 到 调度 工作 /任务 在 指定 
的 日 期 和 时 间 运 行 。 

本 教程 教 作为 一 个 入 门 介绍 如 何 开 发 使 用 调度 工作 (在 写本 教程 时 使 用 的 最 新 
Quartz 2.2.1 ) 


1. 下 载 Quartz 
可 以 从 官方 网 站 或 Maven 中 央 存 储 库 下 载 Quartz 库 文件 ; 


File: quartz.properties 


org.quartz.scheduler.instanceName - MyScheduler 
org.quartz.threadPool.threadCount - 3 
org.quartz.jobStore.class -org.quartz.simpl.RAMJobStore 


2. Quartz fF J} 
Quartz 作 业 定 义 要 运行 什么 ? 
File : HelloJob 


package com.yiibai.common; 

import org.quartz.Job; 

import org.quartz.JobExecutionContext; 
import org.quartz.JobExecutionException; 


public class HelloJob implements Job 


public void execute(JobExecutionContext context) 
throws JobExecutionException { 


System.out.println("Hello Quartz!"); 


3. Quartzfit 4 25 


定义 Quartz 触 发 器 ， 当 Quartz 运 行 在 上 面 的 Quartz 作 业 。 
像 老 版 本 的 Quartz， 仍 然 有 两 种 类 型 的 触发 器 在 Quartz2， 但 API 有 些 变化 : 


e SimpleTrigger — 允许 设置 开始 时 间 ， 结 束 时 间 ， 重 复 间 隔 。 
e CronTrigger — 人 允许 UNIX cron 表 达 式 来 指定 日 期 和 时 间 来 运行 作业 。 


SimpleTrigger — 每 5 秒 运行 。 


Trigger trigger = TriggerBuilder 

.hewTrigger() 

.WithIdentity("dummyTriggerName", "group1") 

.WithSchedule( 
SimpleScheduleBuilder.simpleSchedule() 
.withIntervalInSeconds(5).repeatForever () ) 

.build(); 


CronTrigger — 每 5 秒 运行 。 


Trigger trigger = TriggerBuilder 
.hewTrigger() 
.WithIdentity("dummyTriggerName", "groupi") 
.withSchedule( 

CronScheduleBuilder.cronSchedule("0/5 * * * * ?")) 
.build(); 


注意 请 阅读 官方 文档 更 多 的 Quartz2 触 发 器 的 例子 。 
4. Scheduler 
调度 类 链接 “工作 "和 “触发 器 "到 一 起 ， 并 执行 它 。 


Scheduler scheduler = new StdSchedulerFactory().getSchedule 
scheduler.start(); 
scheduler.scheduleJob(job, trigger); 


n p — M —— ee a eee 
5. 完整 的 例子 


Quartz2 两 个 SimpleTrigger 和 CronTrigger 完整 的 例子 。 





SimpleTrigger 的 例子 - 每 间隔 5 秒 运行 。 


package com. yiibai.quartz; 


import org.quartz.JobBuilder; 

import org.quartz.JobDetail; 

import org.quartz.Scheduler; 

import org.quartz.SimpleScheduleBuilder; 
import org.quartz.Trigger; 

import org.quartz.TriggerBuilder; 

import org.quartz.impl.StdSchedulerFactory; 


public class SimpleTriggerExample { 
public static void main(String[] args) throws Exception { 


// Quartz 1.6.3 

// JobDetail job = new JobDetail(); 
// job.setName("dummyJobName" ) ; 

// job.setJobClass(HelloJob.class); 


JobDetail job - JobBuilder.newJob(HelloJob.class) 
.WithlIdentity("dummyJobName", "groupi").build(); 


//Quartz 1.6.3 
// SimpleTrigger trigger - new SimpleTrigger(); 
// trigger.setStartTime(new Date(System.currentTimeMillis(: 
// trigger.setRepeatCount(SimpleTrigger.REPEAT INDEFINITEL" 
// trigger.setRepeatInterval(30000); 


// Trigger the job to run on the next round minute 
Trigger trigger - TriggerBuilder 
.hewTrigger() 
.WithIdentity("dummyTriggerName", "groupi") 
.withSchedule( 
SimpleScheduleBuilder .simpleSchedule( ) 
.WithIntervallnSeconds(5).repeatForever()) 
.build(); 


// schedule it 

Scheduler scheduler = new StdSchedulerFactory().getSchedule 
scheduler.start(); 

scheduler.scheduleJob( job, trigger); 





CronTrigger 例 子 - 同样 ， 在 每 5 秒 运行 作业 。 


package com. yiibai.quartz; 


import org.quartz.CronScheduleBuilder ; 
import org.quartz.JobBuilder; 

import org.quartz.JobDetail; 

import org.quartz.Scheduler; 

import org.quartz.Trigger; 

import org.quartz.TriggerBuilder; 

import org.quartz.impl.StdSchedulerFactory; 


public class CronTriggerExample 
{ 
public static void main( String[] args ) throws Exception 
{ 
//Quartz 1.6.3 
//JobDetail job = new JobDetail(); 
//job.setName("dummyJobName" ) ; 
//job.setJobClass(HelloJob.class); 
JobDetail job - JobBuilder.newJob(HelloJob.class) 
.WithIdentity("dummyJobName", "groupi").build(); 


//Quartz 1.6.3 
//CronTrigger trigger - new CronTrigger(); 
//trigger.setName("dummyTriggerName"); 
//trigger.setCronExpression("0/5 * * * * 2"); 


Trigger trigger - TriggerBuilder 
.newTrigger() 
.WithIdentity("dummyTriggerName", "groupi") 
.withSchedule( 

CronScheduleBuilder.cronSchedule("0/5 * * * * ?")) 
.build(); 


//schedule it 

Scheduler scheduler = new StdSchedulerFactory().getSchedule 
scheduler.start(); 

scheduler.scheduleJob(job, trigger); 





代码 下 载 : http;//pan.baidu.com/s/1c0s6xoO 


Quartz2 作 业 监 听 - Quartz 教 程 


在 本 教程 中 ， 我 们 将 展示 /介绍 如 何 创建 一 个 JobListener， 跟 踪 运 行 工作 状态 在 作 
业 完 成 等 。 


P.S 这 个 例子 是 Quartz 2.1.5 


1. Quartz 作业 
作业 - 用 于 打印 一 个 简单 的 信息 ， 并 抛 出 一 个 JobExecutionException 进 行 测试 。 
File : HelloJob.java 


package com.yiibai; 

import org.quartz.Job; 

import org.quartz.JobExecutionContext; 
import org.quartz.JobExecutionException; 


public class HelloJob implements Job 


public void execute(JobExecutionContext context) 
throws JobExecutionException { 


System.out.println("Hello Quartz! - by yiibai.com"); 


//Throw exception for testing 
throw new JobExecutionException("Testing Exception"); 


2. JobListener 


创建 一 个 JobListener， 只 是 实现 了 JobListener 接 口 ， 并 覆盖 所 有 的 接口 的 方法 。 


File : HelloJobListener.java 


package com.yiibai.quartz.listener; 


import org.quartz.JobExecutionContext; 
import org.quartz.JobExecutionException; 
import org.quartz.JobListener; 


public class HelloJobListener implements JobListener { 


public static final String LISTENER_NAME = "dummyJobListenerNar 


@Override 
public String getName() { 

return LISTENER_NAME; //must return a name 
} 


// Run this if job is about to be executed. 
@Override 
public void jobToBeExecuted(JobExecutionContext context) { 


String jobName = context.getJobDetail().getKey().toString(: 
System.out.println("jobToBeExecuted"); 


System.out.println("Job : " + jobName + " is going to star! 
} 
// No idea when will run this? 
@Override 


public void jobExecutionVetoed(JobExecutionContext context) { 
System.out.println("jobExecutionVetoed"); 
} 


//Run this after job has been executed 
@Override 
public void jobWasExecuted(JobExecutionContext context, 
JobExecutionException jobException) { 
System.out.println("jobwasExecuted"); 


String jobName = context.getJobDetail().getKey().toString(: 
System.out.println("Job : " + jobName + " is finished..."), 


if (!jobException.getMessage().equals("")) { 
System.out.println("Exception thrown by: " + jobName 
+ " Exception: " + jobException.getMessage()); 


WwW 








3. CronTrigger 
例如 上 面 HelloJobListener 连 接 到 调度 和 监控 作业 的 状态 。 


File : CronTriggerExample.java 


package com. yiibai.quartz; 


import org.quartz.CronScheduleBuilder ; 
import org.quartz.JobBuilder; 

import org.quartz.JobDetail; 

import org.quartz.JobKey; 

import org.quartz.Scheduler; 

import org.quartz.Trigger; 

import org.quartz.TriggerBuilder; 

import org.quartz.impl.StdSchedulerFactory; 
import org.quartz.impl.matchers.KeyMatcher; 


import com.yiibai.quartz.listener.HelloJobListener; 


public class CronTriggerExample { 
public static void main( String[] args ) throws Exception 


( 


JobKey jobKey = new JobKey("dummyJobName", "groupi"); 
JobDetail job - JobBuilder.newJob(HelloJob.class) 
.WithIdentity(jobKey).build(); 


Trigger trigger - TriggerBuilder 
.newTrigger() 
.WithIdentity("dummyTriggerName", "groupi") 
.withSchedule( 

CronScheduleBuilder.cronSchedule("90/5 * * * * ?")) 
.build( ); 


Scheduler scheduler = new StdSchedulerFactory().getSchedule 


//Listener attached to jobKey 
scheduler .getListenerManager().addJobListener ( 

new HelloJobListener(), KeyMatcher.keyEquals(jobKey) 
); 


//Listener attached to group named "group 1" only. 
//scheduler.getListenerManager().addJobListener( 

// new HelloJobListener(), GroupMatcher.jobGroupEquals(' 
//); 


scheduler.start(); 
scheduler.scheduleJob( job, trigger); 





i 47 CronTriggerExample.java, 这 里 是 输出 结果 : 


jobToBeExecuted 

Job : group1.dummyJobName is going to start... 

Hello Quartz! - by yiibai.com 

jobWasExecuted 

Job : groupi.dummyJobName is started and finished... 

Exception thrown by: groupi.dummyJobName Exception: Testing Except: 


jobToBeExecuted 

Job : groupi.dummyJobName is going to start... 

Hello Quartz! - by yiibai.com 

jobWasExecuted 

Job : groupi.dummyJobName is started and finished... 

Exception thrown by: groupi.dummyJobName Exception: Testing Except: 





以 下 代码 下 载 地 址 : http://pan.baidu.com/s/1pJ6xiwb 


Quartz 执 行 多 作业 - Quartz 教 程 

在 这 个 例子 中 ， 我 们 将 介绍 如 何 通过 Quartz API 多 个 作业 。 在 Quartz 调 度 框 架 中 ， 
每 个 作业 将 被 连接 到 一 个 唯一 的 触发 ， 并 且 由 调度 器 运行 它 。 

PS : f£ Quartz 中 ， 一 个 触发 器 触发 多 个 作业 是 不 可 以 的 。 


1. Quartz APIs 


创建 3 个 作业 ，JobA，JobB 和 JobC。 


package com.yiibai.quartz; 


import org.quartz.Job; 
import org.quartz.JobExecutionContext; 
import org.quartz.JobExecutionException; 


public class JobA implements Job { 


@Override 
public void execute(JobExecutionContext context) 
throws JobExecutionException { 
System.out.println("Job A is runing //every 5 seconds "); 


} 
[E 


package com.yiibai.quartz; 


import org.quartz.Job; 
import org.quartz.JobExecutionContext; 
import org.quartz.JobExecutionException; 


public class JobB implements Job { 


@Override 

public void execute(JobExecutionContext context) 
throws JobExecutionException ( 
System.out.println("Job B is runing"); 


package com. yiibai.quartz; 


import 
import 
import 


public 


org.quartz 
org.quartz 
org.quartz 


class JobC 


@Override 
public void execute(JobExecutionContext context) 
throws JobExecutionException { 
System.out.println("Job C is runing"); 


. Job; 
. JobExecutionContext; 
. JobExecutionException; 


implements Job { 


使 用 QuartzAPI 声 明 上 述 3 个 作业 ， 分 配 它们 到 特定 触发 器 并 调度 它 。 


package com.yiibai.quartz; 


import 
import 
import 
import 
import 
import 
import 
import 


public 
{ 


org.quartz. 


org.quartz 


org.quartz. 
org.quartz. 


org.quartz 
org.quartz 
org.quartz 


org.quartz. 


CronScheduleBuilder; 

. JobBuilder; 

JobDetail; 

JobKey; 

.Scheduler; 

. Trigger; 

.TriggerBuilder; 
impl.StdSchedulerFactory; 


class CronTriggerExample { 
public static void main( String[] args ) throws Exception 


JobKey jobKeyA = new JobKey("jobA", "group1"); 


JobDetail 


jobA = JobBuilder.newJob(JobA.class) 


.withIdentity(jobKeyA).build(); 


JobKey jobKeyB - new JobKey("jobB", "group1"); 
JobDetail jobB - JobBuilder.newJob(JobB.class) 
.withIdentity(jobKeyB) .build(); 


JobKey jobKeyC = new JobKey("jobC", "group1"); 
JobDetail jobC - JobBuilder.newJob(JobC.class) 
.WithIdentity(jobKeyC).build(); 


Trigger triggeri = TriggerBuilder 
.newTrigger() 
.withIdentity("dummyTriggerNamei", "groupi") 
.WithSchedule( 
CronScheduleBuilder.cronSchedule("0/5 * * * * ?")) 


-build(); 


Trigger trigger2 = TriggerBuilder 
.newTrigger() 
.WithIdentity("dummyTriggerName2", "groupi") 
.withSchedule( 

CronScheduleBuilder.cronSchedule("90/5 * * * * ?")) 
.build(); 


Trigger trigger3 = TriggerBuilder 
.newTrigger() 
.WithIdentity("dummyTriggerName3", "group1") 
.withSchedule( 

CronScheduleBuilder.cronSchedule("90/5 * * * * ?")) 
.build( ); 


Scheduler scheduler = new StdSchedulerFactory().getSchedule 


scheduler.start(); 

scheduler.scheduleJob(jobA, triggeri); 
scheduler.scheduleJob(jobB, trigger2); 
scheduler.scheduleJob(jobC, trigger3); 





} 
} 
输出 结果 如 上 : 

Job A is runing //every 5 seconds 
Job B is runing 

Job C is runing 

Job A is runing //every 5 seconds 
Job B is runing 

Job C is runing 


代码 下 载 : http://pan.baidu.com/s/1qW4tkAw 


Quartz 列 出 调 大 器 所 有 作业 - Quartz 教 程 


下 面 是 两 个 代码 片段 展示 如 何 列 出 所 有 Quartz 的 作业 。Quartz2 API 都 发 生 了 很 大 
变化 ， 所 以 语法 和 Quartz1.x 是 不 同 的 


1. Quartz 2.2.1 示例 


Scheduler scheduler = new StdSchedulerFactory().getScheduler(); 
for (String groupName : scheduler.getJobGroupNames()) { 
for (JobKey jobKey : scheduler.getJobKeys(GroupMatcher .jobGrot 


String jobName - jobKey.getName(); 
String jobGroup - jobKey.getGroup(); 


//get job's trigger 
List«Trigger» triggers = (List<Trigger>) scheduler.getTrigge! 
Date nextFireTime - triggers.get(0).getNextFireTime(); 


System.out.println("[jobName] : " + jobName + " [groupName: 
+ jobGroup + " - " + nextFireTime); 





2. Quartz 1.8.6 示例 


Scheduler scheduler = new StdSchedulerFactory().getScheduler(), 


//loop all group 
for (String groupName : scheduler.getJobGroupNames()) { 


//loop all jobs by groupname 
for (String jobName : scheduler.getJobNames(groupName)) { 


//get job's trigger 
Trigger[] triggers = scheduler.getTriggersOfJob(jobName, grout 
Date nextFireTime - triggers[0].getNextFireTime(); 


System.out.println("[jobName] : " + jobName + " [groupName] 
+ groupName + " - " + nextFireTime); 





Servlet 教程 


Servlet 简介 


Serviet 是 什么 ? 


Java Servlet 是 运行 在 Web 服务 器 或 应 用 服务 器 上 的 程序 ， 它 是 作为 来 自 Web 浏 
览 器 或 其 他 HTTP 客户 端的 请 求 和 HTTP 服务 器 上 的 数据 库 或 应 用 程序 之 间 的 中 间 
层 


使 用 Servlet， 您 可 以 收集 来 自 网 页 表单 的 用 户 输入 ， 呈 现 来 自 数 据 库 或 者 其 他 源 的 
记录 ， 还 可 以 动态 创建 网 页 。 


Java Servlet 通常 情况 下 与 使 用 CGI (Common Gateway Interface， 公 共 网 关 接 
O) 实现 的 程序 可 以 达到 异曲同工 的 效果 。 但 是 相 比 于 CGI, Servet 有 以 下 几 点 
优势 : 


e 性 能 明显 更 好 。 

e Servlet 在 Web 服务 器 的 地 址 空间 内 执行 。 这 样 它 就 没有 必要 再 创建 一 个 单独 
的 进程 来 处 理 每 个 客户 端 请 求 。 

e Servlet 是 独立 于 平台 的 ， 因 为 它们 是 用 Java 编写 的 。 

e 服务 器 上 的 Java 安全 管理 器 执行 了 一 系列 限制 ， 以 保护 服务 器 计算 机 上 的 资 
源 。 因 此 ，Servlet 是 可 信 的 。 

e Java 类 库 的 全 部 功能 对 Servlet 来 说 都 是 可 用 的 。 它 可 以 通过 sockets 和 RMI 
机 制 与 applets、 数 据 库 或 其 他 软件 进行 交互 。 


Servlet 2837 


下 图 显示 了 Servlet 在 Web 应 用 程序 中 的 位 置 。 
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Servlet 任务 


Servlet 执行 以 下 主要 任务 : 
。 读 取 客户 端 (浏览 器 ) 发 送 的 显 式 的 数据 。 这 包括 网 页 上 的 HTML 表单 ， 或 者 


也 可 以 是 来 自 applet 或 自 定义 的 HTTP. 客户 端 程序 的 表单 。 
e 读 取 客户 端 (浏览 器 ) 发 送 的 隐 式 的 HTTP 请 求 数据 。 这 包括 cookies. IE 
类 型 和 浏览 器 能 理解 的 压缩 格式 等 等 。 
处 理 数据 并 生成 结果 。 这 个 过 程 可 能 需要 访问 数据 库 ， 执 行 RMI 或 CORBA 
调用 ， 调 用 Web 服务 ， 或 者 直接 计算 得 出 对 应 的 响应 。 
发 送 显 式 的 数据 ( 即 文档 ) 到 客户 端 (浏览 器 ) 。 该 文档 的 格式 可 以 是 多 种 多 
~ 包括 文本 文件 (HTML z& XML) 、 二 进 制 文件 (GIF 图 像 ) . Excel 
发 送 隐 式 的 HTTP 响应 到 客户 端 (浏览 器 ) 。 这 包括 告诉 浏览 器 或 其 他 客户 端 
被 返回 的 文档 类 型 (例如 HTML) ， 设 置 cookies 和 缓存 参数 ， 以 及 其 他 类 似 
的 任务 。 


Servlet 包 


Java Servlet 是 运行 在 带 有 支持 Java Servlet 规范 的 解释 器 的 web 服务 器 上 的 
Java 类 。 


Servlet 可 以 使 用 javax.servlet 和 javax.servlet.http 包 创 建 ， 它 是 Java 企业 版 的 
标准 组 成 部 分 ，Java 企业 版 是 支持 大 型 开发 项 目的 Java 类 库 的 扩展 版 本 。 


这 些 类 实现 Java Servlet 和 JSP 规范 。 在 写本 教程 的 时 候 ， 二 者 相应 的 版 本 分 别 
是 Java Servlet 2.5 和 JSP 2.1。 


Java Servlet 就 像 任 何其 他 的 Java 类 一 样 已 经 被 创建 和 编译 。 在 您 安装 Servlet 包 
并 把 它们 添加 到 您 的 计算 机 上 的 Classpath 类 路 径 中 之 后 ， 您 就 可 以 通过 JDK 的 
Java 编译 器 或 任何 其 他 编译 器 来 编译 Servlet。 


下 一 步 呢 ? 


接 下 来 ， 本 教程 会 带 你 一 步 一 步 地 设置 您 的 Servlet 环境 ， 以 便 开始 后 续 的 Servlet 
人 使用。 因此， 请 系 紧 您 的 安全 带 ， 随 我 们 一 起 开始 Servlet 的 学 习 之 旅 吧 ! 相信 您 


会 很 喜欢 这 个 教程 的 。 


Servlet 环境 设置 


开发 环境 是 您 可 以 开发 、 测 试 、 运 行 Servlet 的 地 方 。 


就 像 任 何其 他 的 Java 程序 ， 您 需要 通过 使 用 Java 编译 器 javac 编译 Servlet， 在 
编译 Servlet 应 用 程序 后 ， 将 它 部 署 在 配置 的 环境 中 以 便 测 试 和 运行 。 


这 个 开发 环境 设置 包括 以 下 步骤 : 


fie Java 开发 工具 包 (Java Development Kit) 
一 步 涉及 到 下 载 Java 软件 开发 工具 包 (SDK, BI Software Development 

Kit) ， 并 适当 地 设置 PATH 环境 变量 。 

您 可 以 从 Oracle 的 Java 网 站 下 载 SDK : Java SE Downloads。 


一 旦 您 下 载 了 SDK， 请 按照 给 定 的 指令 来 安装 和 配置 设置 。 最 后 ， 设 置 PATH 和 
JAVA HOME 环境 变量 指向 包含 java 和 javac 的 目录 ， 通 常 分 别 为 
java install dir/bin 和 java install dir, 


如 果 您 运行 的 是 Windows， 并 把 SDK 安装 在 C: \jdk1. 5, 0 | 20 中 ， 则 需要 在 您 的 
C:\autoexec.bat 文件 中 放 入 下 列 的 行 : 


set PATH=C:\jdk1.5.0_20\bin;%PATH% 
set JAVA_HOME=C:\jdk1.5.0_20 


或 者 ， 在 Windows NT/2000/XP 中 ， 您 也 可 以 用 鼠标 右键 单 击 " 我 的 电脑 "， 选 择 " 属 
性 "， 再 选择 "高 级 "，" 环 境 变量 "。 然 后 ， 更 新 PATH 的 值 ， 按 下 "确定 "按钮 。 


在 Unix (Solaris, Linux 等 ) 上 ， 如 果 SDK 安装 在 /usr/local/jdk1.5.0_20 中 ， 并 
且 您 使 用 的 是 C shell， 则 需要 在 您 的 .cshrc 文件 中 放 入 下 列 的 行 : 


setenv PATH /usr/local/jdk1.5.0 20/bin:$PATH 
setenv JAVA HOME /usr/1local/jdk1.5.0 20 


另外 ， 如 果 您 使 用 集成 开发 环境 (IDE, Bl Integrated Development 
E ncs 比如 Borland JBuilder, Eclipse, IntelliJ IDEA 或 Sun ONE 
Studio, 编译 并 运行 一 个 简 简单 的 程序 ， 以 确认 该 IDE 知道 您 安装 的 Java BE. 


x j& Web 服务 十 : Tomcat 


在 市 场 上 有 许多 Web 服务 器 支持 Servlet, BLY Web 服务 器 是 免费 下 载 的 ， 
Tomcat 就 是 其 中 的 一 个 。 
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Apache Tomcat 是 一 款 Java Servlet 和 JavaServer Pages 技术 的 开源 软件 实现 ， 
可 以 作为 测试 Servlet 的 独立 服务 器 ， 而 且 可 以 集成 到 Apache Web 服务 器 。 下 面 
是 在 电脑 上 安装 Tomcat 的 步骤 : 


e 从 hitp://tomcat.apache.org/ 上 下 载 最 新 版 本 的 Tomcat. 

e 一 旦 您 下 载 了 Tomcat， 解 压缩 到 一 个 方便 的 位 置 。 例 如 ， 如 果 您 使 用 的 是 
Windows， 则 解压 缩 到 C:\apache-tomcat-5.5.29 中 ， 如 果 您 使 用 的 是 
Linux/Unix， 则 解压 缩 到 /usr/local/apache-tomcat-5.5.29 中 ， 并 创建 
CATALINA_HOME 环境 变量 指向 这 些 位 置 。 


在 Windows 上 ， 可 以 通过 执行 下 面 的 命令 来 启动 Tomcat : 


%CATALINA_HOME%\bin\startup.bat 
or 


C:\apache-tomcat-5.5.29\bin\startup.bat 


在 Unix (Solaris, Linux &) 上 ， 可 以 通过 执行 下 面 的 命令 来 启动 Tomcat : 


$CATALINA_HOME/bin/startup.sh 
or 


/usr/local/apache-tomcat-5.5.29/bin/startup.sh 


Tomcat 启动 后 ， 可 以 通过 在 浏览 器 地 址 栏 输 入 http: Illocalhost:8080/ 访问 
Tomcat 中 的 默认 应 用 程序 。 如 果 一 切 顺 利 ， 那 么 会 显示 以 下 结果 : 


Th Apache Software Foundation 
http://www.apache.org/ 
If you're seeing this page via a web browser, It means you've setup Tomcat successfully, Congratulations! 
As you may have guessed by now, this is the defaut Tomeal home page. E can be found en the lacs! filesystem at 
SCATALINA_HONE/webapps/ROOT/ index.html 

whee “SCATAUINA_MOME™ is the rect of the Tamcat installation directory. HE you're seeing tis page, and you dont think you should 
ba, then youre amer a user who has arrived at new instalation at Tomcat, or youre an administrator who hasnt got shar setup quite 
right. Providing the later is the case, please refer to the Tomcat Documn=ctation tor more detailed setup and admeistration information 
than is found in the INSTALL file 


NOTE: For security reasons, t ihe manager webapp is restricted to users with role "manager". Users are defined in 
SCATALIIA_MOMD (eof /toroet-u0e 


Induded wih vs release are à host of sample Servels and JSPs (wilh associated source code], extensive documentalion, and an 
introductory guide to developing web appiicabanz 


Tomcat mæling lists are avatable at the Tomcat proynct web ste 


» usersfttomcatapachae.org far general quastions related to configuring and using Tomcat 
» dov@itomcatapache.org for developers waking on Temeal 


Thanks for using Tomcat! 
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有 关 配 置 和 运行 Tomcat 的 进一步 信息 可 以 查阅 应 用 程序 安装 的 文档 ， 或 者 可 以 访 
问 Tomcat 网 站 : http://tomcat.apache.org。 


在 Windows 上 ， 可 以 通过 执行 下 面 的 命令 来 停止 Tomcat : 


C:\apache-tomcat-5.5.29\bin\shutdown 


在 Unix (Solaris, Linux) 上 ， 可 以 通过 执行 下 面 的 命令 来 停止 Tomcat : 


/usr/local/apache-tomcat-5.5.29/bin/shutdown.sh 


X = CLASSPATH 


FHF Servlet # Java 平台 标准 版 的 组 成 部 分 ， 所 以 您 必须 为 编译 器 指定 Servlet 
类 的 路 径 。 


如 果 您 运行 的 是 Windows， 则 需要 在 您 的 Cautoexec.bat 文件 中 放 和 人 下列 的 行 


set CATALINA=C: \apache-tomcat-5.5.29 
set CLASSPATH=%CATALINA%\common\lib\servlet-api. jar ;%CLASSPATH% 


或 者 ， 在 Windows NT/2000/XP 中 ， 您 也 可 以 用 鼠标 右键 单 击 "我 的 电脑 "， 选 择 " 属 
性 "， 再 选择 "高 级 "，" 环 境 变 量 "。 然 后 ， 更 新 CLASSPATH 的 值 ， 按 下 "确定 " 按 
钮 。 


在 Unix (Solaris, Linux &) 上 ， 如 果 您 使 用 的 是 C shell， 则 需要 在 您 的 .cshrc 
文件 中 放 入 下 列 的 行 : 


setenv CATALINA=/usr/local/apache-tomcat-5.5.29 
setenv CLASSPATH $CATALINA/common/1ib/servlet -api. jar :$CLASSPATH 


注意 : 假设 您 的 开发 目录 是 C:\ServietDevel E Windows E) 或 
: ru (Œ UNIX +) ， 那 么 您 还 需要 在 CLASSPATH 中 添加 这 些 目 
录 , 添加 方式 与 上 面 的 添加 方式 类 类 似 。 


Servlet 生命 周期 


Servlet 生命 周期 可 被 定义 为 从 创建 直到 毁灭 的 整个 过 程 。 以 下 是 Servlet 遵循 的 过 


程 : 


Servlet 通过 调用 init () 方法 进行 初始 化 。 

Servlet 调用 service() 方法 来 处 理 客 户 端的 请 求 。 
Servlet 通过 调用 destroy() 方法 终止 (结束 ) 。 

最 后 ，Servlet 是 由 JVM 的 垃圾 回收 器 进行 垃圾 回收 的 。 


现在 让 我 们 详细 讨论 生命 周期 的 方法 。 


init() 方法 
init 方法 被 设计 成 只 调用 一 次 。 它 在 第 一 次 创建 Servlet 时 被 调用 ， 在 后 续 每 次 用 户 
请 求 时 不 再 调用 。 因 此 ， 它 是 用 于 一 次 性 初始 化 ， 就 像 Applet 的 init 方法 一 样 。 


Servlet 创建 于 用 户 第 一 次 调用 对 应 于 该 Servlet 的 URL 时 ， 但 是 您 也 可 以 指定 
Servlet 在 服务 器 第 一 次 启动 时 被 加 载 。 


当 用 户 调用 一 个 Servlet 时 ， 就 会 创建 一 个 Servlet 实例 ， 每 一 个 用 户 请 求 都 会 产生 
一 个 新 的 线程 ， 适 当 的 时 候 移交 给 doGet 或 doPost 方法 。init() 方法 简单 地 创建 或 
加 载 一 些 数据 ， 这 些 数据 将 被 用 于 Servlet 的 整个 生命 周期 。 


init 方法 的 定义 如 下 : 


public void init() throws ServletException { 
// 初始 化 代码 . . . 
j 


service() 方法 


service() 方法 是 执行 实际 任务 的 主要 方法 。Servlet 容器 (BI Web 服务 器 ) 调用 
service() 方法 来 处 理 来 自 客户 端 (浏览 器 ) 的 请 求 ， 并 把 格式 化 的 响应 宇 回 给 客户 
Ufo 

每 次 服务 器 接收 到 一 个 Servlet 请 求 时 ， 服 务 器 会 产生 一 个 新 的 线程 并 调用 服务 。 
service() 方法 检查 HTTP 请 求 类 型 (GET. POST, PUT. DELETE 等 ) ， 并 在 适 
当 的 时 候 调 用 doGet、doPost、doPut，doDelete 等 方法 。 


下 面 是 该 方法 的 特征 : 


public void service(ServletRequest request, 
ServletResponse response) 
throws ServletException, IOException{ 


service() 方法 由 容器 调用 ，service 方法 在 适当 的 时 候 调 用 doGet, doPost. 
doPut、doDelete 等 方法 。 所 以 ， 您 不 用 对 service() 方法 做 任何 动作 ， 您 只 需要 根 
据 来 自 客户 端的 请 求 类 型 来 重 载 doGet() 或 doPost() 即 可 。 


doGet() 和 doPost() 方法 是 每 次 服务 请 求 中 最 常用 的 方法 。 下 面 是 这 两 种 方法 的 特 
征 。 


doGet() 方法 


GET 请 求 来 自 于 一 个 URL 的 正常 请 求 ， 或 者 来 自 于 一 个 未 指定 METHOD 的 
HTML 表单 ， 它 由 doGet() 方法 处 理 。 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 
// Servlet 代码 


doPost() 方法 


POST 请 求 来 自 于 一 个 特别 指定 了 METHOD 为 POST 的 HTML 表单 ， 它 由 
doPost() 方法 处 理 。 


public void doPost(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 
// Servlet 代码 


destroy() 方法 


destroy() 方法 只 会 被 调用 一 次 ， 在 Servlet 生命 周期 结束 时 被 调用 。destroy() 方法 
可 以 让 您 的 Servlet 关闭 数据 库 连 接 、 停 止 后 台 线 程 、 把 Cookie 列表 或 点 击 计数 器 
写 入 到 磁盘 ， 并 执行 其 他 类 似 的 清理 活动 。 


在 调用 destroy() 方法 之 后 ，servlet 对 象 被 标记 为 垃圾 回收 。destroy 方法 定义 如 下 
所 示 : 


public void destroy() { 
// 终止 化 代码 ,,， 
} 


2844 
下 图 显示 了 一 个 典型 的 Servlet 生命 周期 方案 。 


e 第 一 个 到 达 服 务 器 的 HTTP 请 求 被 委派 到 Servlet 容器 。 

e Servlet 容器 在 调用 service() 方法 之 前 加 载 Servlet。 

e 然后 Servlet 容器 处 理由 多 个 线程 产生 的 多 个 请 求 ， 每 个 线程 执行 一 个 单一 的 
Servlet 实例 的 service() 方法 。 


Java virtual machine Servlet 


Servlet 
Container 





Web Server 


Servlet 实例 


Servlet 是 服务 HTTP 请 求 并 实现 javax.servlet.Servlet 接口 的 Java . Web JS 
用 程序 开发 人 员 通 常 编写 Servlet 来 扩展 javax.servlet.http.HttpServlet， 并 实现 
Servlet 接口 的 抽象 类 专门 用 来 处 理 HTTP 请 求 。 


Hello World 示例 代码 
下 面 是 Servlet 输出 Hello World 的 示例 源 代 码 : 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 


// 扩展 HttpServlet X 
public class HelloWorld extends HttpServlet { 


private String message; 
public void init() throws ServletException 


// 执行 必需 的 初始 化 
message = "Hello World"; 


} 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


{ 
// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
// 实际 的 逻辑 是 在 这 里 
Printwriter out = response.getWriter(); 
out.println("«hi»" + message + "</h1>"); 
} 


public void destroy() 


// 什么 也 不 做 


编译 Servlet 


让 我 们 把 上 面 的 代码 写 在 HelloWorld.java 文件 中 ， 把 这 个 文件 放 在 
CAServletDevel (在 Windows 上 ) 或 /usr/ServletDevel (在 UNIX 上 ) 中 ， 您 还 需 
要 把 这 些 目 录 添 加 到 CLASSPATH 中 。 


假设 您 的 环境 已 经 正确 地 设置 ， 进 入 ServletDevel 目录 ， 并 编译 
HelloWorld.java， 如 下 所 示 : 


$ javac HelloWorld.java 


如 果 Servlet 依赖 于 任何 其 他 库 ， 您 必须 在 CLASSPATH 中 包含 那些 JAR 文件 。 
在 这 里 ， 我 只 包含 了 servlet-api.jar JAR 文件 ， 因 为 我 没有 在 Hello World 程序 中 
使 用 任何 其 他 库 。 


该 命令 行使 用 Sun Java 软件 开发 工具 包 (JDK) AEH javac 编译 
器 。 为 使 该 命令 正常 工作 ， 您 必须 PATH 环境 变量 中 使 用 的 Java SDK 的 位 置 。 


如 果 一 切 顺利 ， 上 面 编译 会 在 同一 目录 下 生成 HelloWorld.class 文件 。 下 一 节 将 讲 
解 已 编译 的 Servlet 如 何 部 署 在 生产 中 。 


Servlet 部 署 


默认 情况 下 ，Servlet 应 用 程序 位 于 路 径 <Tomcat-installation- 
directory>/webapps/ROOT 下 ， 且 类 文件 放 在 <Tomcat-installation- 
directory»/webapps/ROOT/WEB-INF/classes 中 。 


如 果 您 有 一 个 完全 合格 的 类 名 称 com.myorg.MyServlet， 那 么 这 个 Servlet 类 必须 
位 于 WEB- NGG ue a ee 中 。 


现在 ， 让 我 们 把 HelloWorld.class 复制 到 <Tomcat-installation- 
directory>/webapps/ROOT/WEB-INF/classes 中 ， 并 在 位 于 <Tomcat-installation- 
directory>/webapps/ROOT/WEB-INF/ 的 web.xml 文件 中 创建 以 下 条 目 : 


<servlet> 
<servlet -name>Helloworld</servlet -name> 
<servlet-class>Helloworld</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>HelloWorld</servlet -name> 
<url-pattern>/HelloWorld</url-pattern> 
</servlet -mapping> 


上 面 的 条 目 要 被 创建 在 web.xml 文件 中 的 <web-app>...</web-app> 标签 内 。 在 该 
文件 中 可 能 已 经 有 各 种 可 用 的 条 目 ， 但 不 要 在 意 。 
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到 这 里 ， 您 基本 上 已 经 完成 了 ， 现 在 让 我 们 使 用 <Tomcat-installation- 
directory>\bin\startup.bat (在 Windows 上 ) 或 <Tomcat-installation- 
directory>/bin/startup.sh (在 Linux/Solaris 等 上 ) 启动 tomcat 服务 器 ， 最 后 在 浏 
览 器 的 地 址 栏 中 输入 http://localhost:8080/HelloWorld。 如 果 一 切 顺 利 ， 您 会 
到 下 面 的 结果 : 


Č http://localhost: BOBO/HelloWorld - Windows Internet Explorer 











GO- ® 


File Edit View Favorites Tools Help 


ttp: Hilocalhost:8080/HelloWorld 





[EE] http: /flocalhost:8080/HelloWorld 





Hello World 





Servlet 表单 数据 


很 多 情 m F, 需要 传递 一 些 信息 AS eu 在 器 到 Web Hk 4-25, 最 终 到 后 台 程 序 。 浏 | 
览 器 使 用 两 种 方法 可 将 这 些 信息 传递 到 Web 服务 器 ， 分 别 为 GET 方法 和 POST 


法 。 


GET 方法 


GET 方法 向 页 面 请 求 发 送 已 编码 的 用 户 信息 。 页 面 和 已 编码 的 信息 中 间 用 ? 字符 
分 隔 ， 如 下 所 示 : 


http://www.test.com/hello?keyi-valuei&key2-value2 


GET 方法 是 默认 的 从 浏览 器 向 Web 服务 器 传递 信息 的 方法 ， 它 会 产生 一 个 很 长 的 
FRR, Bic 器 的 地 址 栏 中 。 AD ARAS 入 要 向 服务 器 传递 的 是 密码 或 其 他 的 敏感 
信息 ， 请 不 要 使 用 GET 方法 。GET 方法 有 大 小 限制 : 请 求 字符 串 中 最 多 只 能 有 
1024 个 字符 。 


这 些 信 息 使 用 QUERY_STRING 头 传递 ， 并 可 以 通过 QUERY_STRING 环境 变量 
iij, Servlet 使 用 doGet() 方法 处 理 这 种 类 型 的 请 求 。 


POST 方法 


另 一 个 向 后 台 程 序 传递 信息 的 比较 可 靠 的 方法 是 POST 方法 。POST 方法 打包 信息 
ona GET 方法 基本 相同 ， 但 是 POST 方法 不 是 把 信息 作为 URL 中 ? 字符 后 
的 文本 字符 串 进 行 发 送 ， 而 是 把 这 些 信 息 作 为 一 个 单独 的 消息 。 消 息 以 标准 输出 的 
形式 传 到 后 台 程 序 ， 您 可 以 解析 和 使 用 这 些 标准 输出 。Servlet 使 用 doPost() 方法 
处 理 这 种 类 型 的 请 求 。 


使 用 Servlet 读 取 表单 数据 


Servlet 处 理 表 单数 据 ， 这 些 数 据 会 根据 不 同 的 情况 使 用 不 同 的 方法 自动 解析 : 


e getParameter() : 您 可 以 调用 request.getParameter() 方法 来 获取 表单 参数 的 
{Bo 

e getParameterValues() : 如 果 参 数 出 现 一 次 以 上 ， 则 调用 该 方法 ， 并 返回 多 个 
值 ， 例 如 复 选 框 。 

e getParameterNames() : 如 果 您 想 要 得 到 当前 请 求 中 的 所 有 参数 的 完整 列表 ， 
则 调用 该 方法 。 


使 用 URL 的 GET 方法 实例 


下 面 是 一 个 简单 的 URL， 将 使 用 GET 方法 向 HelloForm 程序 传递 两 个 值 。 
http://localhost:8080/HelloForm?first name-ZARA&last name-ALI 


下 面 是 人 处理 Web 浏览 器 输入 的 HelloForm.java Servlet 程序 。 我 们 将 使 用 
getParameter() 方法 ， 可 以 很 容易 地 访问 传递 的 信息 : 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 


// 扩展 HttpServlet X 
public class HelloForm extends HttpServlet { 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


PrintWriter out = response.getWriter(); 
String title = "使 用 GET 方法 读 取 表 单数 据 " ， 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<h1 align=\"center\">" + title + "</hi>\n" + 
Neyl>\n" + 
" <li><b>4F</b>:" 
+ request.getParameter("first_name") + "\n" + 
" <1i><b> 姓 氏 </b> :" 
+ request.getParameter("last_name") + "\n" + 
"</ul>\n" + 
"</body></htm1>"); 


假设 您 的 环境 已 经 正确 地 设置 ， 编 译 HelloForm.java, M0 RATA : 


$ javac HelloForm.java 


如 果 一 切 顺 利 ， 上 述 编译 会 产生 HelloForm.class 文件 。 接 下 来 ， 您 就 必须 把 该 类 
文件 复制 到 <Tomcat-installation-directory>/webapps/ROOT/WEB-INF/classes 
中 ， 并 在 位 于 <Tomcat-installation-directory>/webapps/ROOT/WEB-INF/ 的 


web.xml 文件 中 创建 以 下 条 目 : 


<servlet> 
<servlet -name>HelloForm</servlet -name> 
<servlet-class>HelloForm</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>HelloForm</servlet -name> 
<url-pattern>/HelloForm</url-pattern> 
</servlet -mapping> 


现在 在 浏览 器 的 地 址 栏 中 输入 htto://ocalhost:8080/HelloForm? 
first name-ZARA&last name-ALI ， 并 在 触发 上 述 命 合 之 前 确保 已 经 启动 Tomcat 
服务 器 。 如 果 一 切 顺 利 ， 您 会 得 到 下 面 的 结果 : 


<h1> 使 用 GET 方法 读 取 表单 数据 </h1> 


<ul> 

<li><b>4 <b> : ZARA</1li> 
<]i><b> 姓 氏 <b> : ALI</1i> 
</ul> 


使 用 表单 的 GET 方法 实例 


下 面 是 一 个 简单 的 实例 ， 使 用 HTML 表单 和 提交 按钮 传递 两 个 值 。 我 们 将 使 用 相同 
的 Servlet HelloForm 来 处 理 输 入 。 


<html> 

<body> 

<form action="HelloForm" method="GET"> 
名 字 : <input type="text" name="first_name"> 
<br /> 

姓氏 : <input type="text" name="last_name" /> 
«input type="submit" value=" 提 交 " /> 
</form> 

</body> 

</html> 


保存 这 个 HTML 到 hello.htm 文件 中 ， 并 把 它 放 在 <Tomcat-installation- 
directory»/webapps/ROOT 目录 下 。 当 您 访问 http/localhost:8080/Hello.htm 时 ， 
下 面 是 上 面 表单 的 实际 输出 。 


«form action="javascript:void();" method="get" target="_blank">% £ 
姓氏 : <input type="text" name="last_name"> <input type="button" valı 


一 








尝试 输入 名 字 和 姓氏 ， 然 后 点 击 " 提 交 "按钮 ， 在 您 本 机 上 查看 输出 结果 。 基 于 所 提 
供 的 输入 ， 它 会 产生 与 上 一 个 实例 类 似 的 结果 。 


使 用 表单 的 POST 方法 实例 


让 我 们 对 上 面 的 Servlet 做 小 小 的 修改 ， 以 便 它 可 以 处 理 GET 和 POST 方法 。 下 
面 的 HelloForm.java Servlet 程序 使 用 GET 和 POST 方法 处 理由 Web 浏览 器 给 


出 的 输入 。 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 


// 扩展 HttpServlet X 
public class HelloForm extends HttpServlet { 


// 处 理 GET 方法 请 求 的 方法 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


Printwriter out - response.getWriter(); 
String title - "Using GET Method to Read Form Data"; 
String docType - 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOTFO\">\n" + 
"<hi align=\"center\">" + title + "</h1i>\n" + 
Neyl>\n" + 
M Seas bea see DS "i 
+ request.getParameter("first_name") + "\n" + 
"  <li><b>#ER </b>: " 
+ request.getParameter("last_name") + "\n" + 
"</ul>\n" + 
"«/body»«/htm1»"); 


} 
// 义理 POST 方法 请 求 的 方法 
public void doPost(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 
doGet(request, response); 


现在 ， 编 译 部 署 上 述 的 Servlet， 并 使 用 带 有 POST 方法 的 Hello.htm 进行 测试 ， 
如 下 所 示 : 


<html> 

<body> 

<form action="HelloForm" method="POST"> 
名 字 : <input type="text" name="first_name"> 
<br /> 

姓氏 : <input type="text" name="last_name" /> 
<input type="submit" value=" 提 交 " /> 
</form> 

</body> 

«/html» 


下 面 是 上 面 表单 的 实际 输出 ， 尝 试 输入 名 字 和 姓氏 ， 然 后 点 击 "提交 "按钮 ， 在 您 本 
机 上 查看 输出 结果 。 


«form action="javascript:void();" method="get" target="_blank"> 名 字 
姓氏 : <input type="text" name="last_name"> <input type="button" vall 


aj — 
基于 所 提供 的 输入 ， 它 会 产生 与 上 一 个 实例 类 似 的 结果 。 


将 复 选 框 数据 传递 到 Servlet 程序 


当 需 要 选择 一 个 以 上 的 选项 时 ， 则 使 用 复 选 框 。 
下 面 是 一 个 HTML 代码 实例 CheckBox.htm， 一 个 带 有 两 个 复 选 框 的 表单 。 





«html» 

«body» 

«form action="CheckBox" method="POST" target="_blank"> 
<input type="checkbox" name="maths" checked="checked" /> 数学 
<input type="checkbox" name="physics" /> 物理 

<input type="checkbox" name-"chemistry" checked="checked" /> 


化 学 
«input type="submit" value=" 选 择 学 科 " /> 
</form> 
</body> 
</html> 


这 段 代 码 的 结果 是 下 面 的 表单 : 


«form action="javascript:void();" method="get" target-" blank'»«in[ 


«| — qmm 











‘Fifi CheckBox.java Servlet 2, 4418 Web 浏览 器 给 出 的 复 选 框 输入 。 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 


// 扩展 HttpServlet X 
public class CheckBox extends HttpServlet { 


// 处 理 GET 方法 请 求 的 方法 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


Printwriter out - response.getWriter(); 
String title = " 读 取 复 选 框 数据 " ; 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<hi align=\"center\">" + title + "</h1>\n" + 
"<ul>\n" + 
" <1i><b> 数 学 标识 : </b>: " 
+ request.getParameter("maths") + "\n" + 
" <li><b> iB tein : </b>: " 
+ request.getParameter("physics") + "\n" + 
" <1i><b> 化 学 标识 : </b>: " 
+ request.getParameter("chemistry") + "\n" + 
"</ul>\n" + 
"</body></htm1>"); 


} 
// 义理 POST 方法 请 求 的 方法 
public void doPost(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 
doGet(request, response); 


上 面 的 实例 将 显示 下 面 的 结果 : 


<h1> 读 取 复 选 框 数据 </h1> 


<ul> 

<]1i><b> 数 学 标识 : </b>on</1li> 
<1i><b> 物 理 标识 : </b>null</1li> 
<1i><b> 化 学 标识 : </b>on</li> 
</ul> 


读 取 所 有 的 表单 参数 


以 下 是 通用 的 实例 ， 使 用 HttpServletRequest 的 getParameterNames() 方法 读 取 
所 有 可 用 的 表单 参数 。 该 方法 返回 一 个 枚 举 ， 其 中 包含 未 指定 顺序 的 参数 名 。 


一 旦 我 们 有 一 个 枚 举 ， 我 们 可 以 以 标准 方式 循环 枚 举 ， 使 用 hasMoreElements() 75 
法 来 确定 何 时 停止 ， 使 用 nextElement() 方法 来 获取 每 个 参数 的 名 称 。 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 
import java.util.*; 


// 扩展 HttpServlet X 
public class ReadParams extends HttpServlet { 


// 处 理 GET 方法 请 求 的 方法 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/html"); 


Printwriter out = response.getWriter(); 
String title = " 读 取 所 有 的 表单 数据 " ; 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<h1 align=\"center\">" + title + "</h1i>\n" + 
"<table width=\"100%\" border=\"1\" align=\"center\">\n" + 
"<tr bgcolor=\"#949494\">\n" + 
"<th> 参 数 名 称 </th><th> 参 数值 </th>\n"+ 
"</tr>\n"); 


Enumeration paramNames = request.getParameterNames(); 


while(paramNames.hasMoreElements()) { 
String paramName = (String)paramNames.nextElement(); 
out.print("<tr><td>" + paramName + "</td>\n<td>"); 
String[] paramValues = 
request.getParameterValues(paramName); 
// 读 取 单个 值 的 数据 
if (paramValues.length == 1) { 
String paramValue = paramValues[0]; 
if (paramValue.length() == 0) 
out.println("«i»No Value</i>"); 
else 
out.println(paramValue); 
) else { 
// 读 取 多 个 值 的 数据 
out.println("«ul»"); 
for(int i-0; i « paramValues.length; i++) { 
out.println("«li»" + paramValues[i]); 
} 


out.println("«/ul»"); 
} 

} 

out.println("</tr>\n</table>\n</body></html>"); 
} 
// 义理 POST 方法 请 求 的 方法 
public void doPost(HttpServletRequest request, 

HttpServletResponse response) 


throws ServletException, IOException { 
doGet(request, response); 


EB 
现在 ， 通 过 下 面 的 表单 党 试 上 面 的 Servlet : 


«html» 

«body» 

«form action-"ReadParams" method="POST" target="_blank"> 

<input type="checkbox" name="maths" checked="checked" /> 数学 
<input type="checkbox" name="physics" /> 物理 

<input type="checkbox" name="chemistry" checked="checked" /> 化 学 
«input type="submit" Value=" 选 择 学 科 "” /> 

</form> 

</body> 

</html> 


现在 使 用 上 面 的 表单 调用 Servlet， 将 产生 以 下 结果 : 


读 取 所 有 的 表单 数据 


参数 名 称 参数 值 
maths on 


chemistry on 


您 可 以 尝试 使 用 上 面 的 Servlet 来 读 取 其 他 的 表单 数据 ， 比 如 文本 框 、 单 选 按钮 或 
下 拉 框 等 。 


Servlet 客户 端 HTTP 请 求 


当 浏览 A ae 请 求 网 页 pi AY, 它 会 向 Web 服务 器 发 送 特定 信息 IN 这 些 信 息 AA 能 被 站 接 读 
ee m 青 求 的 头 的 一 部 分 进行 传 栓 的 。 您 可 以 查看 HTTP 
协议 了 解 更 多 相关 信息 。 


以 下 是 来 自 于 浏览 器 端的 重要 头 信息 ， 您 可 以 在 Web 编程 中 频繁 使 用 : 


头 信息 描述 
Deci 这 个 头 信息 指定 浏览 器 或 其 他 客户 端 可 以 处 理 的 MME 类 型 。 
P 44 image/png 3 image/jpeg 是 最 常见 的 两 种 可 能 值 。 
Accept- 这 个 头 信 息 指定 浏览 器 可 以 用 来 显示 信息 的 字符 集 。 例 如 ISO- 
Charset 8859-1。 
Accept- 这 个 头 信息 指定 浏览 器 知道 如 何 你 理 的 编码 类 型 。 值 gzip 或 
Encoding compress 是 最 常见 的 两 种 可 能 值 。 
Accept- 这 个 头 信息 指定 客户 端的 首选 语言 ， 在 这 种 情况 下 ，Servlet 会 
Language 产生 多 种 语言 的 结果 。 例 如 ，en、en-us、ru 等 。 
Authorization 这 个 头 信 息 用 于 客户 端 在 访问 受 密码 保护 的 网 页 时 识别 自己 的 
身份 。 
这 个 头 信息 指示 客户 端 是 否 可 以 义理 持久 HTTP 连接 。 持 久 连 
Connection 接 允 许 客 户 端 或 其 他 浏览 器 通过 单个 请 求 来 检索 多 个 文件 。 值 
Keep-Alive 意味 着 使 用 了 持续 连接 。 
Content- 这 个 头 信息 只 适用 于 POST 请 求 ， 并 给 出 POST 数据 的 大 小 
Length (以 字 节 为 单位 ) 。 
Cookie 这 个 头 信息 把 之 前 发 送 到 浏览 器 的 cookies 返回 到 服务 器 。 
Host 这 个 头 信息 指定 原始 的 URL 中 的 主机 和 端口 。 
eine B RR FEINER TEUER 服务 器 会 发 送 一 个 
304 代码 ， 表 示 Not Modified 头 信息 。 
la ye ik 4*3 a If-Modified-Since 的 对 立 面 ， 它 指定 只 有 当 文 档 
Unmodified- 
Si 早 于 指定 日 期 时 ， 操 作 才 会 成 功 。 
ince 
这 个 头 信 息 指示 所 指向 的 Web 页 的 URL. 例如 ， 如 果 您 在 网 
Referer 页 1， 点 击 一 个 链接 到 网 页 2， 当 浏览 器 请 求 网 页 2 时 ， 网 页 
1 的 URL 就 会 包含 在 Referer 
User-Agent 这 个 头 信息 识别 发 出 请 求 的 浏览 器 或 其 他 客户 端 ， 并 可 以 向 不 


同类 型 的 浏览 5 器 返回 不 同 的 内 容 。 


读 取 HTTP 头 的 方法 


下 面 的 方法 可 用 在 Servlet 程序 中 读 取 HTTP 头 。 这 些 方法 通过 
HttpServletRequest 对 象 可 用 。 


方法 
Cookie[] getCookies() 


Enumeration 
getAttributeNames() 


Enumeration 
getHeaderNames() 


Enumeration 
getParameterNames() 


HttpSession getSession() 
HttpSession 
getSession(boolean 
create) 


Locale getLocale() 


Object getAttribute(String 
name) 


ServietinputStream 
getinputStream() 


String getAuthType() 


String 
getCharacterEncoding() 


String getContentType() 


String getContextPath() 


String getHeader(String 
name) 


String getMethod() 


描述 


返回 一 个 数组 ， 包 含 客 户 端 发 送 该 请 求 的 所 有 
的 Cookie 对 象 。 


包含 提供 给 该 请 求 可 用 的 属性 
称 。 


uc ME 包含 在 该 请 求 中 包含 的 所 有 的 
头 o 


返回 一 个 String 对 象 的 枚 举 ， 包 含 在 该 请 求 中 
包含 的 参数 的 名 称 。 


返回 与 该 请 求 关 联 的 当前 session 会 话 ， 或 者 
如 果 请 求 没有 session 会 话 ， 则 创建 一 个 。 


返回 与 该 请 求 关 联 的 当前 HttpSession， 或 者 
如 果 没 有 当前 会 话 ， 且 创建 是 真 的 ， 则 返回 一 
个 新 的 session 会 话 。 


基于 Accept-Language 头 ， 返 回 客 户 端 接受 内 
容 的 首选 的 区 域 设 置 。 


以 对 象形 式 返 回 已 命名 属性 的 值 ， 如 果 没 有 给 
定名 称 的 属性 存在 ， 则 返回 null。 


使 用 ServletlnputStream， 以 二 进 制 数据 形式 
检索 请 求 的 主体 。 


返回 用 于 保护 Servlet 的 身份 验证 方案 的 名 
称 ， 例 如 ，"BASIC" 或 "SSL"， 如 果 JSP 没 有 
受到 保护 则 返回 null, 


返回 请 求 主体 中 使 用 的 字符 编码 的 名 称 。 


返回 请 求 主 体 的 MIME 类 型 ， 如 果 不 知道 类 型 
则 返回 null. 


返回 指示 请 求 上 下 文 的 请 求 URI 部 分 。 
以 字符 串 形式 返回 指定 的 请 求 头 的 值 。 


返回 请 求 的 HTTP 方法 的 名 称 ， 例 如 ，GET、 
POST 或 PUT。 


String getParameter(String 
name) 


String getPathInfo() 
String getProtocol() 


String getQueryString() 


String getRemoteAddr() 


String getRemoteHost() 


String getRemoteUser() 


String getRequestURI() 
String 
getRequestedSessionld() 
String getServletPath() 


String[] 
getParameterValues(String 
name) 


boolean isSecure() 


int getContentLength() 


int getintHeader(String 
name) 


int getServerPort() 


以 字符 串 形 式 返 回 请 求 参 数 的 值 ， 或 者 如 果 参 
数 不 存 在 则 返回 null。 


当 请 求 发 出 时 ， 返 回 和 与 客户 端 发 送 的 URL 相关 
的 任何 额外 的 路 径 信息 。 


返回 请 求 协议 的 名 称 和 版 本 。 
返回 包含 在 路 径 后 的 请 求 URL 中 的 查询 字符 


o 


返回 发 送 请 求 的 客户 端的 互联 网 协议 CP) 地 
"ss 


返回 发 送 请 求 的 客户 端的 完全 限定 名 称 。 
如 果 用 户 已 通过 身份 验证 ， 则 返回 发 出 请 求 的 
登录 用 户 ， 或 者 如 果 用 户 未 通过 身份 验证 ， 则 
返回 null。 
从 协议 名 称 直 到 HTTP 请 求 的 第 一 行 的 查询 字 
符 串 中 ， 返 回 该 请 求 的 URL 的 一 部 分 。 
返回 由 客户 端 指定 的 session 会 话 1D。 

回调 用 JSP 的 请 求 的 URL 的 一 部 分 。 


返 
返回 一 个 字符 串 对 象 的 数组 ， 包 含 所 有 给 定 的 
请 求 参数 的 值 ， 如 果 参 数 不 存 在 则 返回 null。 


M 


返回 一 个 布尔 值 ， 指 示 请 求 是 否 使 用 安全 通 
道 ， 如 HTTPS。 


以 字 节 为 单位 返回 请 求 主体 的 长 度 ， 并 提供 输 
入 流 ， 或 者 如 果 长 度 未 知 则 返回 -1。 


返回 指定 的 请 求 头 的 值 为 一 个 int 值 。 


返回 接收 到 这 个 请 求 的 端口 号 。 


HTTP Header 请 求实 例 
下 面 的 实例 使 用 HttpServletRequest 的 getHeaderNames() 方法 读 取 HTTP 头 信 
息 。 该 方法 返回 一 个 枚 举 ， 包 含 与 当前 的 HTTP 请 求 相 关 的 头 信息 。 


一 旦 我 们 有 一 个 枚 举 ， 我 们 可 以 以 标准 方式 循环 枚 举 ， 使 用 hasMoreElements() 75 
法 来 确定 何 时 停止 ， 使 用 nextElement() 方法 来 获取 每 个 参数 的 名 称 。 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 
import java.util.*; 


// 扩展 HttpServlet X 
public class DisplayHeader extends HttpServlet ( 


// 处 理 GET 方法 请 求 的 方法 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/html"); 


Printwriter out = response.getWriter(); 
String title = "HTTP Header 请 求实 例 "， 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n"+ 
"<body bgcolor=\"#fOfFOTFO\">\n" + 
"<hi align=\"center\">" + title + "</hi>\n" + 


"<table width=\"100%\" border=\"1\" align=\"center\">\n" + 


"<tr bgcolor=\"#949494\">\n" + 
"<th>Header 名 称 </th><th>Header {&</th>\n"+ 
e b > NM OY 


Enumeration headerNames = request.getHeaderNames( ); 


while(headerNames.hasMoreElements()) { 
String paramName = (String)headerNames.nextElement(); 
out.print("<tr><td>" + paramName + "</td>\n"); 
String paramValue = request.getHeader (paramName) ; 
out.println("«td» " + paramValue + "</td></tr>\n"); 


out.println("</table>\n</body></html1>") ; 


} 
// 处 理 POST 方法 请 求 的 方法 
public void doPost(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 
doGet(request, response); 








现在 ， 调 用 上 面 的 Servlet 会 产生 以 下 结果 : 


<h1>HTTP Header 请 求实 例 </h1> 

<table> 

<tbody> 

«tr bgcolor="#949494"><th>Header 4#h</th><th>Header {&</th></tr> 
<tr><td>accept</td><td>*/*</td></tr> 
<tr><td>accept - language</td><td>en-us</td></tr> 

<tr><td>user -agent</td><td>Mozilla/4.0 (compatible; MSIE 7.0; Wind 
<tr><td>accept -encoding</td><td>gzip, deflate</td></tr> 
<tr><td>host</td><td>localhost :8080</td></tr> 
<tr><td>connection</td><td>Keep-Alive</td></tr> 
<tr><td>cache-control</td><td>no-cache</td></tr> 

</tbody> 


</table> 
JE 
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正如 前 面 的 章节 中 讨论 的 那样 ， 当 一 个 Web 服务 器 响应 一 个 HTTP 请 求 时 ， 响 应 
通常 包括 一 个 状态 行 、 一 些 响 应 报头 、 一 个 空 行 和 文档 。 一 个 典型 的 响应 如 下 所 
人 小: 


HTTP/1.1 200 OK 
Content-Type: text/html 
Header2: ... 


HeaderN: ... 
(Blank Line) 

<!doctype ...> 

«html» 

<head>. . .</head> 

<body> 

</body> 

</html> 


状态 行 包括 HTTP 版 本 〈 在 本 例 中 为 HTTP/1.1) 、 一 个 状态 码 (在 本 例 中 为 
200) 和 一 个 对 应 于 状态 码 的 短 消息 (在 本 例 中 为 OK) 。 


BREA SM Web 服务 器 端 返回 到 浏览 器 的 最 有 用 的 HTTP 1.1 响应 报头 ， 您 会 
在 Web 编程 中 频繁 地 使 用 它们 : 


头 信 息 


Allow 


Cache- 
Control 


Connection 


Content- 
Disposition 


Content- 
Encoding 


Content- 
Language 


Content- 
Length 


Content- 
Type 


Expires 


Last- 
Modified 


Location 


Refresh 


Retry-After 


Set-Cookie 


描述 
这 个 头 信息 指定 服务 器 支持 的 请 求 方法 (GET、POST 等 ) 。 


这 个 头 信息 指定 响应 文档 在 何 种 情况 下 可 以 安全 地 缓存 。 可 能 的 
{44 : public, private 或 no-cache 等 。Public 意味 着 文档 是 
WA, Private 意味 着 文档 是 单个 用 户 私 用 文档 ， 且 只 能 存储 
在 私有 ( 非 共 享 ) 缓存 中 ，no-cache 意味 着 文档 不 应 被 缓存 。 


这 个 头 信息 指示 浏览 器 是 否 使 用 持久 HTTP 连接 。 值 close 指示 
m P d 使 用 持久 HTTP p 44 keep-alive 意味 着 使 用 持久 
连接 。 


这 个 头 信 息 可 以 让 您 请 求 浏览 器 要 求 用 户 以 给 定名 称 的 文件 把 响 
应 保存 到 磁盘 。 
tit, 


在 传输 过 这 个 头 信 息 指定 页 面 的 编码 方式 。 


这 个 头 信 息 表 示 文 档 编写 所 使 用 的 语言 。 


STO 


这 个 头 信息 指示 响应 中 的 字 节 数 。 只 有 当 浏 览 器 使 用 持久 
(keep-alive) HTTP 连接 时 村 需 要 这 些 信 息 。 


这 个 头 信息 提供 了 响应 文档 的 MIME (Multipurpose Internet 
Mail Extension) 类 型 。 


这 个 头 信息 指定 内 容 过 期 的 时 间 ， 在 这 之 后 内 容 不 再 被 缓存 。 


个 头 信 息 指示 文档 的 最 后 修改 时 间 。 然 后， 客户 端 可 以 缓存 文 
fy 并 在 以 后 的 请 求 中 通过 If-Modified-Since 请 求 头 信息 提供 


个 头 信 息 点 被 包含 在 所 有 的 带 有 状态 码 的 响应 中 。 在 300s — 
内 ， 这 会 通知 浏览 器 文档 的 地 址 。 浏 览 器 会 自动 重新 连接 到 这 
位 置 ， 并 获 x Ri ci 


个 关 信 息 指定 浏览 器 应 该 如 何 尽快 请 求 更 新 的 页 面 
定 ER 面 刷新 的 秒 数 。 


这 个 头 信息 可 以 与 503 (Service Unavailable 服务 不 可 用 ) 响应 
配合 使 用 ， 这 会 告诉 客户 端 多 久 就 可 以 重复 它 的 请 求 。 


个 头 信 息 指定 一 个 与 页 面 关 联 的 cookie, 


例如 ，en、en-us、ru 


o 您 可 以 指 


jk HTTP 响应 报头 头 的 方法 


下 面 的 方法 可 用 于 在 Servlet 程序 中 设置 


HTTP 响应 报头 。 这 些 方 法 通过 


HttpServletResponse 对 象 可 用 。 


方法 


String 
encodeRedirectURL(String 
url) 


String encodeURL(String url) 


boolean 
containsHeader(String 
name) 


boolean isCommitted() 


void addCookie(Cookie 
cookie) 


void addDateHeader(String 
name, long date) 


void addHeader(String name, 
String value) 


void addintHeader(String 
name, int value) 


void flushBuffer() 


void reset() 


void resetBuffer() 


void sendError(int sc) 
void sendError(int sc, String 
msg) 


void sendRedirect(String 
location) 


void setBufferSize(int size) 
void 


setCharacterEncoding(String 
charset) 


void setContentLength(int 
len) 


描述 


为 sendRedirect 方法 中 使 用 的 指定 的 URL 

进行 编码 ， 或 者 如 果 编 码 不 是 必需 的 ， 则 返 
回 URL 未 改变 。 

对 包含 session 会 话 ID 的 指定 URL 进行 编 
码 ， 或 者 如 果 编 码 不 是 必需 的 ， 则 返回 URL 
未 改变 。 


I 
(LI 
iS 
Ni 
[ufi 
(LI 
=p 
m 


返回 一 个 布尔 值 ， 指 示 是 
的 响应 报头 。 


返回 一 个 布尔 值 ， 指 示 响 应 是 否 已 经 提交 。 
把 指定 的 cookie 添加 到 响应 。 


添加 一 个 带 有 给 定 的 名 称 和 日 期 值 的 响应 报 


添加 一 个 带 有 给 定 的 名 称 和 值 的 响应 报头 。 
添加 一 个 带 有 给 定 的 名 称 和 整数 值 的 响应 报 
头 。 


强制 任何 在 缓冲 区 中 的 内 容 被 宇 入 到 客户 


LLL: 
师 。 


清除 缓冲 区 中 存在 的 任何 数据 ， 包 括 状 态 码 
和 头 。 


清除 响应 中 基础 缓冲 区 的 内 容 ， 不 清除 状态 
码 和 头 。 


使 用 指定 的 状态 码 发 送 错误 响应 到 客户 端 ， 
并 清除 缓冲 区 。 

使 用 指定 的 状态 发 送 错误 响应 到 客户 端 。 
使 用 指定 的 重 定向 位 置 URL 发 送 临 时 重 定 
向 响应 到 客户 端 。 

为 响应 主体 设置 首选 的 缓冲 区 大 小 。 


设置 被 发 送 到 客户 端的 响应 的 字符 编码 
(MIME 字符 集 ) 例如 ，UTF-8。 


设置 在 HTTP Servlet 响应 中 的 内 容 主体 的 
长 度 ， 该 方法 设置 HTTP Content-Length 


len) Ko 


void setContentType(String 如 果 响 应 还 未 被 提交 ， 设 置 被 发 送 到 客户 端 
type) 的 响应 的 内 容 类 型 。 


void setDateHeader(String 设置 一 个 带 有 给 定 的 名 称 和 日 期 值 的 响应 报 
name, long date) 头 。 


void setHeader(String name, 设置 一 个 带 有 给 定 的 名 称 和 值 的 响应 报头 。 


void setlntHeader(String 设置 一 个 带 有 给 定 的 名 称 和 整数 值 的 响应 报 
name, int value) 头 。 

void setLocale(Locale loc) 如 果 响 应 还 未 被 提交 ， 设 置 响应 的 区 域 。 
void setStatus(int sc) 为 该 响应 设置 状态 码 。 


HTTP Header 响应 实例 


您 已 经 在 前 面 的 实例 中 看 到 setContentType() 方法 ， 下 面 的 实例 也 使 用 了 同样 的 方 
ik, 此 外 ， 我 们 会 用 setlntHeader() 方法 来 设置 Refresh 头 。 


// 导入 必需 的 java E 

import java.io.* 

import javax.servlet.*; 
import javax.servlet.http.* 
import java.util.*; 


// 扩展 HttpServlet X 
public class Refresh extends HttpServlet ( 


// 义理 GET 方法 请 求 的 方法 
public void dcer HE pee yl eed request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 刷新 自动 加 载 时 间 为 5 秒 
response.setIntHeader("Refresh", 5); 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


// Get current time 

Calendar calendar - new GregorianCalendar(); 
String am pm; 

int hour - calendar.get(Calendar.HOUR); 

int minute - calendar.get(Calendar.MINUTE); 
int second - calendar.get(Calendar.SECOND); 
if(calendar.get(Calendar.AM PM) -- 0) 


else 
am_pm = "PM"; 


String CT = hour+":"+ minute +":"+ second +" "+ am pm; 


PrintWriter out = response.getwWriter(); 
String title = "自动 刷新 Header 设置 " ; 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n"+ 
"<body bgcolor=\"#fOfFOTFO\">\n" + 
"<hi align=\"center\">" + title + "</hi>\n" + 
"<p> 当 前 时 间 是 :" + CT + "</p>\n"); 


} 
// 义理 POST 方法 请 求 的 方法 
public void doPost(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 
doGet(request, response); 


现在 ， 调 用 上 面 的 Servlet， 每 隔 5 秒 会 显示 当前 系统 时 间 。 只 要 运行 Servlet 并 稍 
等 片刻 ， 即 可 看 到 如 下 的 结果 : 


<h1> 自 动 刷 新 Header 设置 </h1> 


当前 时 间 是 : 9:44:50 PM 


Servlet HTTP 状态 码 


HTTP 请 求 和 HTTP 响应 消息 的 格式 是 类 似 的 ， 结 构 如 下 : 
初始 状态 行 + 回 车 换行 符 〈 回 车 + 换行 

雳 个 或 多 个 标题 行 + 回 车 换行 符 

一 个 空白 行 ， 即 回 车 换行 符 

一 个 可 选 的 消息 主体 ， 上 比如 文件 、 查 询 数据 或 查询 输出 


例如 ， 服 务 器 的 响应 头 如 下 所 示 : 


HTTP/1.1 200 OK 
Content-Type: text/html 
Header2: ... 


HeaderN: ... 
(Blank Line) 

<!doctype ...> 

<html> 

<head>. ..</head> 

<body> 

</body> 

</html> 


状态 行 包括 HTTP 版 本 (在 本 例 中 为 HTTP/1.1) 、 一 个 状态 码 〈 在 本 例 中 为 


200) 和 一 个 对 应 于 状态 码 的 短 消息 〈 在 本 例 中 为 OK) 。 
以 下 是 可 能 从 Web 服务 器 返回 的 HTTP 状态 码 和 相关 的 信息 列表 : 


被 拒绝 ， 客 户 端 应 继续 该 请 求 。 


d Se ea 服务 器 切换 协议 。 

200 OK 请 求 成 功 。 

201 Created 该 请 求 是 完整 的 ， 并 创建 一 个 新 的 资源 。 

202 Accepted 该 请 求 被 接受 处 理 ， 但 是 该 处 理 是 不 完整 的 。 
Non- 


203 authoritative 
Information 


只 有 请 求 的 一 部 分 已 经 被 服务 器 接收 ， 但 只 要 它 没有 


204 


205 


206 


300 


301 


302 
303 
304 
305 


306 


307 


400 
401 


402 


403 
404 


405 


406 


407 


408 


409 
410 


No Content 


Reset 
Content 


Partial 
Content 


Multiple 
Choices 


Moved 
Permanently 


Found 

See Other 
Not Modified 
Use Proxy 
Unused 
Temporary 
Redirect 

Bad Request 
Unauthorized 


Payment 
Required 


Forbidden 
Not Found 


Method Not 
Allowed 


Not 
Acceptable 


Proxy 
Authentication 
Required 


Request 
Timeout 


Conflict 


Gone 


链接 列表 。 用 户 可 以 选择 一 个 链接 ， 进 入 到 该 位 置 。 
最 多 五 个 地 址 。 


所 请 求 的 页 面 已 经 转移 到 一 个 新 的 URL。 


所 请 求 的 页 面 已 经 临时 转移 到 一 个 新 的 URL。 
所 请 求 的 页 面 可 以 在 另 一 个 不 同 的 URL 下 被 找到 。 


在 以 前 的 版 本 中 使 用 该 代码 。 现 在 已 不 再 使 用 它 ， 但 
代码 仍 被 保留 。 


所 请 求 的 页 面 已 经 临时 转移 到 一 个 新 的 URL。 


服务 器 不 理解 请 求 。 
所 请 求 的 页 面 需要 用 户 名 和 密码 。 


您 还 不 能 使 用 该 代码 。 


禁止 访问 所 请 求 的 页 面 。 
服务 器 无 法 找到 所 请 求 的 页 面 。. 


在 请 求 中 指定 的 方法 是 不 允许 的 。 


服务 器 只 生成 一 个 不 被 客户 端 接受 的 响应 。 


在 请 求 送 达 之 前 ， 您 必须 使 用 代理 服务 器 的 验证 。 


请 求 需要 的 时 间 比 服务 器 能 够 等 待 的 时 间 长 ， 超 时 。 


请 求 因为 冲突 无 法 完成 。 
所 请 求 的 页 面 不 再 可 用 。 


411 


412 


413 


414 


415 


417 


500 


501 


502 


503 


504 


505 


Length 
Required 


Precondition 
Failed 


Request 
Entity Too 
Large 


Request-url 
Too Long 


Unsupported 
Media Type 


Expectation 
Failed 


Internal 
Server Error 


Not 
Implemented 


Bad Gateway 


Service 
Unavailable 


Gateway 
Timeout 


HTTP Version 
Not 
Supported 


"Content-Length" 未 定义 。 服 务 器 无 法 义理 客户 端 发 
送 的 不 带 Content-Length 的 请 求 信 息 。 


请 求 中 给 出 的 先决 条 件 被 服务 器 评估 为 false。 


服务 器 不 接受 该 请 求 ， 因 为 请 求实 体 过 大 。 


服务 器 不 接受 该 请 求 ， 因 为 URL 太 长 。 当 您 转换 一 个 
"post" 请 求 为 一 个 带 有 长 的 查询 信息 的 "get" 请 求 时 发 


o 


服务 器 不 接受 该 请 求 ， 因 为 媒体 类 型 不 被 支持 。 


未 完成 的 请 求 。 


未 完成 的 请 求 。 
未 完成 的 请 求 。 
未 完成 的 请 求 。 


网 关 超时 。 


服务 器 遇 到 了 一 个 意外 的 情况 。 


服务 器 不 支持 所 需 的 功能 。 
服务 器 从 上 游 服 务 器 收 到 无 效 响应 。 
服务 器 暂时 超载 或 死机 。 


服务 器 不 支持 "HTTP 协 议 " 版 本 。 


设置 HTTP 状态 代码 的 方法 


下 面 的 方法 可 用 于 在 Servlet 程序 中 设置 HTTP 状态 码 。 这 些 方法 通 


HttpServletResponse 对 象 可 用 。 


E: 


方法 描述 
该 方法 设置 一 个 任意 的 状态 码 。setStatus 方法 接受 一 


Peste (int 个 int (状态 码 ) 作为 参数 。 如 果 您 的 反应 包含 了 一 个 
特殊 的 状态 码 和 文档 ， 请 确保 在 使 用 PrintWriter 实际 


statis code) 返回 任何 内 容 之 前 调用 setStatus, 


public void E ek Mm T 
: 该 方法 生成 一 个 302 响应 ， 连 同一 个 带 有 新 文档 URL 
sendRedirect(String ENIM OE 
url) 
public void 该 方法 发 送 一 个 状态 码 GRR 404) ， 连 同一 个 在 


sendError(int code, HTML 文档 内 部 自动 格式 化 并 发 送 到 客户 端的 短 消 
String message) 息 。 


HTTP 状态 码 实 例 


下 面 的 例子 把 407 错误 代码 发 送 到 客户 端 浏 览 器 ， 浏 览 器 会 显示 "Need 
authentication!!!" 消息 。 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 
import java.util.*; 


// 扩展 HttpServlet X 
public class showError extends HttpServlet { 


// 处 理 GET 方法 请 求 的 方法 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 错误 代码 和 原因 
response.sendError(407, "Need authentication!!!" ); 


b 

// 人 处理 POST 方法 请 求 的 方法 

public void doPost(HttpServletRequest request, 

HttpServletResponse response) 
throws ServletException, IOException { 
doGet(request, response); 
J 
} 


现在 ， 调 用 上 面 的 Servet 将 显示 以 下 结果 : 


<h2>HTTP Status 407 - Need authentication! ! !</h2> 

<b>type</b> Status report 

<b>message</b> <u>Need authentication! !!</u> 

<b>description</b> <u>The client must first authenticate itself wi! 
<h3>Apache Tomcat/5.5.29</h3> 


| 
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Servlet 过 滤器 是 可 用 于 Servlet 编程 的 Java 类 ， 有 以 下 目的 : 


e 在 客户 端的 请 求 访问 后 端 资源 之 前 ， 拦 截 这 些 请 求 。 
。 在 服务 器 的 响应 发 送 回 客户 端 之 前 ， 处 理 这 些 响应 。 


根据 规范 建议 的 各 种 类 型 的 过 滤器 : 


身份 验证 过 滤器 (Authentication Filters) 。 

数据 压缩 过 滤器 (Data compression Filters) 。 
加 密 过 滤器 (Encryption Filters) 。 

触发 资源 访问 事件 过 滤器 。 

图 像 转换 过 滤器 (Image Conversion Filters) 。 

日 志 记 录 和 审核 过 滤器 (Logging and Auditing Filters) 。 
MIME-TYPE 链 过 滤器 (MIME-TYPE Chain Filters) 。 
标记 化 过 滤器 (Tokenizing Filters) 。 

XSL/T 过 滤器 (XSL/T Filters) ， 转 换 XML 内 容 。 


过 滤器 被 部 署 在 部 署 描述 符 文 件 web.xml 中 ， 然 后 映射 到 您 的 应 用 程序 的 部 署 描 
述 符 中 的 Servlet 名 称 或 URL 模式 。 


当 Web 容器 启动 Web 应 用 程序 时 ， 它 会 为 您 在 部 署 描述 符 中 声明 的 每 一 个 过 滤器 
创建 一 个 实例 。 该 过 滤器 执行 的 顺序 是 按 它们 在 部 署 描述 符 中 声明 的 顺序 。 


Servlet 过 滤器 方法 


过 滤器 是 一 个 实现 了 javax.servlet.Filter 接口 的 Java 类 。javax.servlet.Filter 接口 
定义 了 三 个 方法 : 


方法 描述 

public void doFilter 该 方法 在 每 次 一 个 请 求 /响应 对 因 客 户 端 在 
(ServletRequest, 链 的 末端 请 求 资 源 而 通过 链 传递 时 由 容器 
ServietResponse, FilterChain) 调用 。 
public void init(FilterConfig 该 方法 由 Web 容器 调用 ， 指 示 一 个 过 滤 
filterConfig) 器 被 放 入 服务 。 

. 该 方法 由 Web 容器 调用 ， 指 示 一 个 过 滤 
public void destroy() 器 被 取出 服务 。 


Servlet 过 滤器 实例 


以 下 是 Servlet 过 滤器 的 实例 ， 将 输出 客户 端的 IP 地 址 和 当前 的 日 期 时 间 。 本 实例 
让 您 对 Servlet 过 滤器 有 基本 的 了 解 ， 您 可 以 使 用 相同 的 概念 编写 更 复杂 的 过 滤器 
应 用 程序 : 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 
import java.util.*; 


// 实现 Filter X 
public class LogFilter implements Filter { 
public void init(FilterConfig config) 
throws ServletException{ 
// 获取 初始 化 参数 
String testParam = config.getInitParameter("test-param"); 


// 输出 初始 化 参数 
System.out.println("Test Param: " + testParam); 


public void doFilter(ServletRequest request, 
ServletResponse response, 
FilterChain chain) 
throws java.io.IOException, ServletException { 


// 获取 客户 机 的 IP 地 址 
String ipAddress = request.getRemoteAddr(); 


// 记录 IP 地 址 和 当前 时 间 稚 
System.out.println("IP "+ ipAddress + ", Time 
+ new Date().toString()); 


// 把 请 求 传 回 过 滤 链 
chain.doFilter(request, response) ; 


} 
public void destroy( ){ 

/* 在 Filter 实例 被 Web 容器 从 服务 移 除 之 前 调用 */ 
} 


以 通常 的 方式 编译 LogFilterjava， 把 您 的 类 文件 放 入 <Tomcat-installation- 
directory»/webapps/ROOT/WEB-INF/classes 中 。 


Web.xml 中 的 Servlet 过 滤器 映射 (Servlet Filter 
Mapping) 


定义 过 滤器 ， 然 后 映射 到 一 个 URL 或 Servlet， 这 和 与 定义 Servlet， 然 后 映射 到 一 个 
URL 模式 方式 大 致 相同 。 在 部 署 描述 符 文 件 web.xml 中 为 filter 标签 创建 下 面 的 条 
H: 


<filter> 
<filter-name>LogFilter</filter -name> 
<filter-class>LogFilter</filter-class> 
<init -param> 
<param-name>test -param</param-name> 
<param-value>Initialization Paramter</param-value> 
«/init-param» 
</filter> 
<filter -mapping> 
<filter-name>LogFilter</filter -name> 
<url-pattern>/*</url-pattern> 
</filter -mapping> 


上 述 过 滤器 适用 于 所 有 的 Servlet， 因 为 我 们 在 配置 中 指定 # 。 如 果 您 只 想 在 少数 
的 Servlet 上 应 用 过 滤器 ， 您 可 以 指定 一 个 特定 的 Servlet 路 径 。 


现在 试 着 以 常用 的 方式 调用 任何 Servlet， 您 将 会 看 到 在 Web 服务 器 中 生成 的 日 
志 。 您 也 可 以 使 用 Log4J 记录 器 来 把 上 面 的 日 志 记 录 到 一 个 单独 的 文件 中 。 


使 用 多 个 过 滤器 


Web 应用 程序 可 以 根据 特定 的 目的 定义 若干 个 不 同 的 过 滤器 。 假 设 您 定义 了 两 个 过 
滤器 AuthenFilter 和 LogFilter。 您 需要 创建 一 个 如 下 所 述 的 不 同 的 上 映射， 其 余 的 处 
理 与 上 述 所 讲解 的 大 致 相同 : 


«filter» 
«filter-name»LogFilter«/filter-name» 
<filter-class>LogFilter</filter-class> 
<init -param> 
<param-name>test -param</param-name> 
<param-value>Initialization Paramter</param-value> 
</init-param> 
</filter> 


<filter> 
<filter-name>AuthenFilter</filter -name> 
<filter-class>AuthenFilter</filter-class> 
<init -param> 
<param-name>test -param</param-name> 
<param-value>Initialization Paramter</param-value> 
«/init-param» 
</filter> 


<filter -mapping> 
<filter-name>LogFilter</filter -name> 
<url-pattern>/*</url-pattern> 
</filter -mapping> 


<filter -mapping> 
<filter -name>AuthenFilter</filter -name> 
<url-pattern>/*</url-pattern> 

</filter -mapping> 


过 滤器 的 应 用 顺序 


web.xml 中 的 filter-mapping 元 素 的 顺序 决定 了 Web 容器 应 用 过 滤器 到 Servlet 的 
顺序 。 若 要 反 转 过 滤器 的 顺序 ， 您 只 需要 在 web.xml 文件 中 反 转 filter-mapping 元 
素 即 可 。 


例如 ， 上 面 的 实例 将 先 应 用 LogFilter， 然 后 再 应 用 AuthenFilter， 但 是 下 面 的 实例 
将 颠倒 这 个 顺序 : 


<filter -mapping> 
<filter -name>AuthenFilter</filter -name> 
<url-pattern>/*</url-pattern> 

</filter -mapping> 


<filter -mapping> 
<filter-name>LogFilter</filter -name> 
<url-pattern>/*</url-pattern> 
</filter -mapping> 


Servlet 寞 常 处 理 


当 一 个 Servlet 抛 出 一 个 异常 时 ，Web 容器 在 使 用 了 exception-type TRAY 
web.xml 中 搜索 与 抛 出 异常 类 型 相 匹配 的 配置 。 


您 必须 在 web.xml 中 使 用 error-page 元 素来 指定 对 特定 异常 或 HTTP 状态 码 作 
出 相应 的 Servlet 调用 。 


web.xml 配置 


假设 ， 有 一 个 ErrorHandler 的 Servelt 在 任何 已 定义 的 异常 或 错误 出 现时 被 调用 。 
以 下 将 是 在 web.xml 中 创建 的 项 。 


<!-- servlet 定义 --> 
<servlet> 
<servlet -name>ErrorHandler</servlet -name> 
<servlet-class>ErrorHandler</servlet-class> 
</servlet> 
<!-- servlet BRAY --> 
<servlet -mapping> 
<servlet -name>ErrorHandler</servlet -name> 
<url-pattern>/ErrorHandler</url-pattern> 
</servlet -mapping> 


<!-- error-code 相关 的 错误 页 面 --> 

<error-page> 
<error-code>404</error-code> 
<location>/ErrorHandler</location> 

«/error-page» 

«error-page» 
«error-code»403«/error -code» 
<location>/ErrorHandler</location> 

</error -page> 


<!-- exception-type 相关 的 错误 页 面 --> 
<error-page> 
<exception-type> 
javax.servlet.ServletException 
</exception-type > 
<location>/ErrorHandler</location> 
«/error-page» 


«error-page» 
«exception-type»java.io.IOExceptionc/exception-type > 
<location>/ErrorHandler</location> 

</error -page> 


如 果 您 想 对 所 有 的 异常 有 一 个 通用 的 错误 处 理 程序 ， 那 么 应 该 定义 下 面 的 error- 
page， 而 不 是 为 每 个 异常 定义 单独 的 error-page 7538 : 


<error-page> 
<exception-type>java.lang.Throwable</exception-type > 
<location>/ErrorHandler</location> 

</error -page> 


以 下 是 关于 上 面 的 web.xml 异常 处 理 要 注意 的 点 : 


e Servelt ErrorHandler 与 其 他 的 Servelt 的 定义 方式 一 样 ， 且 在 web.xml 中 进行 
配置 。 

e 如 果 有 错误 状态 代码 出 现 ， 不 管 为 404 (Not Found 未 找到 ) 或 
403 (Forbidden 禁止 ) ， 则 会 调用 ErrorHandler 的 Servlet, 

e 如果 Web 应 用 程序 抛 出 ServletException 或 IOException, #82 Web 容器 会 
调用 ErrorHandler 的 Servlet. 

e 4& BT LA RE SL AR [B] FR AS EB AS FE o 2 EE [ad E IB RS 异常。 上 面 的 实例 是 
非常 通用 的 ， 希 望 您 能 通过 实例 理解 基本 的 概念 。 


请 求 属 性 - 错误 / 异常 


以 下 是 错误 处 理 的 Servlet 可 以 访问 的 请 求 属性 列表 ， 用 来 分 析 错 误 / 异 常 的 性 质 。 


属性 描述 
属性 给 出 状态 码 ， 状 态 码 可 被 存储 ， 
javax.servlet.error.status_code 并 在 存储 为 java.lang.Integer 数据 类 型 
后 可 被 分 析 。 


属性 给 出 异常 类 型 的 信息 ， 异 常 类 型 
javax.servlet.error.exception type ”可 被 存储 ， 并 在 存储 为 java.lang.Class 


数据 类 型 后 可 被 分 析 。 
交 属 性 给 出 确切 错 误 消 息 的 信息 ， 信息 
javax.servlet.error.message 可 被 存储 ， 并 在 存储 为 java.lang.String 
数据 类 型 后 可 被 分 析 。 
属性 给 出 有 关 URL 调用 Servlet 的 信 
javax.servlet.error.request_uri A, Same 储 ， 并 在 存储 为 


java.lang.String 数据 类 型 后 可 被 分 析 。 
属性 给 出 异常 产 生 的 信息 ， 言 息 可 被 


javax.servlet.error.exception 存储 ， 并 在 存储 为 java.lang.Throwable 
数据 类 型 后 可 被 分 析 。 
该 属性 给 出 Servlet 的 名 称 ， 名 称 可 被 
javax.servlet.error.servlet name Fit, FER GEA java.lang.String 数 


据 类 型 后 可 被 分 析 。 


Servlet 错误 义理 程序 实例 


以 下 是 Servlet 实例 ， 将 应 对 任何 您 所 定义 的 错误 或 异常 发 生 时 的 错误 处 理 程序 。 


本 实例 让 您 对 Servlet 中 的 异常 处 理 有 基本 的 了 解 ， 您 可 以 使 用 相同 的 概念 编写 更 
复杂 的 异常 处 理应 用 程序 : 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 
import java.util.*; 


// 扩展 HttpServlet X 
public class ErrorHandler extends HttpServlet { 


// 处 理 GET 方法 请 求 的 方法 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 分 析 Servlet 异常 
Throwable throwable = (Throwable) 
request.getAttribute("javax.servlet.error.exception"); 
Integer statusCode - (Integer) 
request.getAttribute("javax.servlet.error.status code"); 
String servletName - (String) 
request.getAttribute("javax.servlet.error.servlet name"); 
if (servletName == null){ 

servletName = "Unknown"; 
} 


String requestUri = (String) 
request.getAttribute("javax.servlet.error.request_uri"); 
if (requestUri == null){ 

requestUri = "Unknown"; 
} 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


Printwriter out - response.getWriter(); 
String title - "Error/Exception Information"; 
String docType - 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n"); 


if (throwable == null && statusCode == null){ 


out. 
out. 


printin("<h2>Error information is missing</h2>"); 
println("Please return to the <a href=\"" + 


response.encodeURL("http://localhost:8080/") + 
"\"SHome Page</a>."); 
jelse if (statusCode != null){ 


out. 


jelse( 


out. 
out. 


out. 


out. 


out. 


j 


println("The status code : " + statusCode); 


println("«h2 class="tutheader">Error information</h2>' 


println("Servlet Name : " + servletName + 
"</br></br>"); 

println("Exception Type : " + 
throwable.getClass( ).getName( ) + 
"«/br»«/br»"); 

println("The request URI: " + requestUri + 
"<br><br>") ; 

println("The exception message: " + 


throwable.getMessage( )); 


out.println("«/body»"); 
out.println("«/html»"); 


j 


// 3832 POST 方法 请 求 的 方法 
public void doPost(HttpServletRequest request, 


HttpServletResponse response) 


throws ServletException, IOException { 
doGet(request, response); 





以 通常 的 方式 编译 ErrorHandlerjava， 把 您 的 类 文件 放 人 <Tomcat-installation- 
directory»/webapps/ROOT/WEB-INF/classes 中 。 


让 我 们 在 web.xml 文件 中 添加 如 下 配置 来 处 理 异常 : 


<servlet> 
<servlet -name>ErrorHandler</servlet -name> 
<servlet-class>ErrorHandler</servlet-class> 
</servlet> 
<!-- servlet mappings --> 
<servlet -mapping> 
<servlet -name>ErrorHandler</servlet -name> 
<url-pattern>/ErrorHandler</url-pattern> 
</servlet -mapping> 
<error-page> 
<error-code>404</error -code» 
<location>/ErrorHandler</location> 
</error -page> 
<error-page> 
<exception-type>java.lang.Throwable</exception-type > 
<location>/ErrorHandler</location> 
</error -page> 


现在 ， 尝 试 使 用 一 个 会 产生 异常 的 Servlet， 或 者 输入 一 个 错误 的 URL， 这 将 触发 
Web 容器 调用 ErrorHandler 的 Servlet， 并 显示 适当 的 消息 。 例 如 ， 如 果 您 输入 
了 一 个 错误 的 URL， 那 么 它 将 显示 下 面 的 结果 : 


The status code : 404 


上 面 的 代码 在 某 些 Web 浏览 器 中 可 能 无 法 正常 工作 。 因 此 ， 请 尽量 党 试 使 用 
Mozilla 和 Safari 浏览 器 ， 在 这 两 种 浏览 器 中 它们 应 该 能 够 正常 工作 。 


Servlet Cookies 义理 


Cookies 是 存储 在 客户 端 计算 机 上 的 文本 文件 ， 并 保留 了 各 种 跟踪 信息 。Java 
Servlet 显然 支持 HTTP Cookies。 


识别 返回 用 户 包括 三 个 步 又 : 


e 服务 器 脚本 向 浏览 器 发 送 一 组 Cookies, HHI: 姓名 、 年 龄 或 识别 号 码 等 。 

e 浏览 器 将 这 些 信息 存储 在 本 地 计算 机 上 ， 以 各 将 来 使 用 。 

e 当下 一 次 浏览 器 向 Web 服务 器 发 送 任何 请 求 时 ， 浏 览 器 会 把 这 些 Cookies 信 
息 发 送 到 服务 器 ， 服务 器 将 使 用 这 些 信息 来 识 另 JH Èo 


本 章 将 向 您 讲解 如 何 设置 或 重 置 Cookies， 如 何 访 问 它 们 ， 以 及 如 何 将 它们 删除 。 


Cookie 剖析 


Cookies 通常 设置 在 HTTP 头 信 息 中 (虽然 JavaScript 也 可 以 直接 在 浏览 器 上 设置 
一 个 Cookie) > i&i& Cookie 的 Servlet 会 发 送 如 下 的 头 信息 : 


HTTP/1.1 200 OK 

Date: Fri, 04 Feb 2000 21:03:38 GMT 

Server: Apache/1.3.9 (UNIX) PHP/4.0b3 

Set-Cookie: name-xyz; expires-Friday, 04-Feb-07 22:03:38 GMT; 
path-/; domain=w3cschool.cc 

Connection: close 

Content-Type: text/html 


正如 您 所 看 到 的 ，Set-Cookie 头 包 含 了 一 个 名 称 值 对 、 一 个 GMT 日 期 、 一 个 路 径 
和 一 个 域 。 名 称 和 值 会 被 URL 编码 。expires 字段 是 一 个 指令 ， 告 诉 浏 览 器 在 给 定 
的 时 间 和 日 期 之 后 "忘记 "该 Cookie。 


如 果 浏 览 器 被 配置 为 存储 Cookies， 它 将 会 保留 此 信息 直到 到 期 日 期 。 如 果 用 户 的 
a] 5 | 览 器 指 Rest Cookie 的 路 径 和 域 的 页 面 ， 它 会 重新 发 送 Cookie 到 服务 
Zro 3| 览 器 的 头 信息 Aa 能 如 下 所 示 : 


GET / HTTP/1.0 

Connection: Keep-Alive 

User-Agent: Mozilla/4.6 (X11; I; Linux 2.2.6-15apmac ppc) 
Host: zink.demon.co.uk:1126 

Accept: image/gif, */* 

Accept-Encoding: gzip 

Accept-Language: en 

Accept-Charset: iso-8859-1,*,utf-8 

Cookie: name-xyz 


Servlet 就 能 够 通过 请 求 方 法 request.getCookies() 访问 Cookie， 该 方法 将 返回 一 
个 Cookie 对 象 的 数组 。 


Servlet Cookies 方法 
以 下 是 在 Servlet 中 操作 Cookies 时 可 使 用 的 有 用 的 方法 列表 。 


方法 


public void 
setDomain(String 
pattern) 


public String 
getDomain() 


public void 
setMaxAge(int 


expiry) 


public int 
getMaxAge() 


public String 
getName() 


public void 
setValue(String 
newValue) 


public String 
getValue() 


public void 
setPath(String uri) 


public String 
getPath() 


public void 
setSecure(boolean 


flag) 
public void 


setComment(String 
purpose) 


public String 
getComment() 


描述 


该 方法 设置 cookie 适用 的 域 ， 例 如 w3cschool.cc。 


该 方法 获取 cookie 适用 的 域 ， 例 如 w3cschool.cc。 


该 方法 设置 cookie 过 期 的 时 间 (以 秒 为 单位 ) 。 如 果 
不 这 样 设置 ，cookie 只 会 在 当前 session 会 话 中 持续 
有 效 。 


该 方法 返回 cookie 的 最 大 生存 周期 ae 秒 为 单位 ) ， 


默认 情况 下 ，-1 表示 cookie 将 持续 ， 直 到 浏 览 器 
关闭 。 
该 方法 返回 cookie 的 名 称 。 名 称 在 创建 后 不 能 改变 。 


该 方法 设置 与 cookie 关联 的 值 。 


该 方法 获取 与 cookie 关联 的 值 。 

该 方法 设置 cookie 适用 的 路 径 。 如 果 您 不 指定 路 径 ， 
与 当前 页 面相 同 目录 下 的 (包括 子 目 录 下 的 ) 所 有 
URL 都 会 返回 cookie。 


该 方法 获取 cookie 适用 的 路 径 。 


该 方法 设置 布尔 值 ， 表 示 cookie 是 否 应 该 只 在 加 密 的 
( 即 SSL) 连接 上 发 送 。 


该 方法 规定 了 描述 cookie 目的 的 注释 。 该 注释 在 浏览 
器 向 用 户 呈 现 cookie 时 非常 有 用 。 


该 方法 返回 了 描述 cookie 目的 的 注释 ， 如 果 cookie 没 
有 注释 则 返回 null。 


* 


通过 Servlet 设置 Cookies 


通过 Servlet 设置 Cookies 包括 三 个 步骤 : 


(1) 创建 一 个 Cookie 对 象 : 您 可 以 调用 带 有 cookie 名 称 和 cookie 值 的 Cookie 4 
ERA, cookie 名 称 和 cookie 值 都 是 字符 串 。 


Cookie cookie = new Cookie("key", "value"); 
请 记 住 ， 无 论 是 名 字 还 是 值 ， 都 不 应 该 包含 空格 或 以 下 任何 字符 : 
[E eee oO Sey 


(2) 设置 最 大 生存 周期 : 您 可 以 使 用 setMaxAge 方法 来 指定 cookie 能 够 保持 有 效 
的 时 间 〈 以 秒 为 单位 ) 。 下 面料 设置 一 个 最 基 有 效 期 为 24 小 时 的 cookie. 


cookie.setMaxAge(60*60*24); 


(3) 43€ Cookie 到 HTTP 响应 头 : 您 可 以 使 用 response.addCookie 来 添加 
HTTP "4 kA Cookies, 7I RAR : 


response.addCookie(cookie); 


实例 


让 我 们 修改 我 们 的 表单 数据 实例 ， 为 名 字 和 姓氏 设置 Cookies. 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 


// 扩展 HttpServlet X 
public class HelloForm extends HttpServlet { 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 为 名 字 和 姓氏 创建 Cookies 

Cookie firstName = new Cookie("first_name", 
request.getParameter("first_name")); 

Cookie lastName = new Cookie("last_name", 
request.getParameter("last_name")); 


// 为 两 个 Cookies 设置 过 期 日 期 为 24 小 时 后 
firstName.setMaxAge(60*60*24); 
lastName.setMaxAge(60*60*24); 


// 在 响应 头 中 添加 两 个 Cookies 
response.addCookie( firstName ); 
response.addCookie( lastName ); 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


Printwriter out - response.getWriter(); 
String title = "设置 Cookies 实例 "， 
String docType - 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 


"<head><title>" + title + "</title></head>\n" + 


"<body bgcolor-N"zfOfOfON"»2Nn" + 


"<hi align=\"center\">" + title + "</hi>\n" + 


Neyl>\n" + 
" <1i><b> 名 字 </b> :" 


+ request.getParameter("first_name") + "\n" + 


" <1i><b> 姓 氏 </b> :" 


+ request.getParameter("last_name") + "\n" + 


"</ul>\n" + 
"«/body»«/htm1»"); 


编译 上 面 的 Servlet HelloForm, #7 web.xml 文件 中 创建 适当 的 条 目 ， 
下 面 的 HTML 页 面 来 调用 Servlet, 


最 后 尝试 


<html> 

<body> 

<form action="HelloForm" method="GET"> 

名 字 : «input type="text" name="first_name"> 
<br /> 

姓氏 : <input type="text" name="last_name" /> 
<input type="submit" value=" 提 交 " /> 
</form> 

</body> 

</html> 


保存 上 面 的 HTML 内 容 到 文件 hello.htm 中 ， 并 把 它 放 在 <Tomcat-installation- 
directory>/webapps/ROOT 目录 中 。 当 您 访问 http://localhost:8080/Hello.htm 时 ， 
上 面 表单 的 实际 输出 如 下 所 示 : 


r: Cnn 
尝试 输 入 名 字 和 姓氏 ， 然 后 点 击 "提交 "按钮 ， 名 字 和 姓氏 将 显示 在 屏幕 上 ， 同 时 会 
设置 firstName 和 lastName 这 两 个 Cookies， 当 下 次 您 按 下 提交 按钮 时 ， 会 被 这 
两 个 Cookies 传 回 到 服务 器 。 


下 一 节 会 讲解 如 何在 Web 应 用 程序 中 访问 这 些 Cookies. 





通过 Servlet 读 取 Cookies 
要 读 取 Cookies， 您 需要 通过 调用 HttpServletRequest 的 getCookies( ) 方法 创建 


一 个 javax.servlet.http.Cookie 对 象 的 数组 。 然 后 循环 通 历 数组 ， 并 使 用 
getName() 和 getValue() 方法 来 访问 每 个 cookie 和 关联 的 值 。 


实例 


让 我 们 读 取 上 面 的 实例 中 设置 的 Cookies 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 


// 扩展 HttpServlet X 
public class ReadCookies extends HttpServlet { 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


{ 
Cookie cookie = null; 
Cookie[] cookies = null; 
// 获取 与 该 域 相关 的 Cookies 的 数组 
cookies = request.getCookies(); 
// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
PrintWriter out = response.getWriter(); 
String title - "Reading Cookies Example"; 
String docType - 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" ); 
if( cookies != null ){ 
out.printin("<h2>4#% Cookies 名 称 和 值 </h2>" ) ; 
for (int i = 0; i < cookies.length; i++){ 
cookie = cookies[i]; 
out .print(" 名 称 :" + cookie.getName( ) + ", "); 
out.print("4& :" + cookie.getValue( )+" <br/>"); 
jelse( 
out.println( 
"<h2 class="tutheader"> 未 找到 Cookies</h2>"); 
out.println("</body>"); 
out.println("«/html»"); 
} 


编译 上 面 的 Servlet ReadCookies, #7 web.xml 文件 中 创建 适当 的 条 目 。 如 果 您 
已 经 设置 了 firstname cookie 为 "John", last name cookie 7; "Player", zt jXi 11 
_http://localhost:8080/ReadCookies, #$ X zs3U FR : 


<tr><td> 

<h2> 查 找 Cookies 名 称 和 值 </h2> 

名 称 : first_name， 值 :John 

名 称 : last_name， 值 : Player</td></tr> 


通过 Servlet 删除 Cookies 


删除 Cookies 是 非常 简单 的 。 如 果 您 想 删 除 一 个 cookie， 那 么 您 只 需要 按照 以 下 三 
个 步骤 进行 : 

e 读 取 一 个 现 有 的 cookie， 并 把 它 存 储 在 Cookie 对 象 中 。 

e 使 用 setMaxAge() 方法 设置 cookie HEH AS, 3k mlER SU B^ cookie, 

e 把 这 个 cookie 添加 到 响应 头 。 


实例 


下 面 的 例子 将 删除 现 有 的 名 为 "first name" 的 cookie， 当 您 下 次 运行 ReadCookies 
的 Servlet 时 ， 它 会 返回 first name 为 空 值 。 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 


// 扩展 HttpServlet X 
public class DeleteCookies extends HttpServlet { 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


Cookie cookie - null; 

Cookie[] cookies - null; 

// 获取 与 该 域 相关 的 Cookies 的 数组 
cookies = request.getCookies(); 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


PrintWriter out = response.getWriter(); 
String title - "Delete Cookies Example"; 
String docType - 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOfFOFO\">\n" ); 
if( cookies != null )( 
out.println("«h2»Cookies 名 称 和 值 </h2>" ) ; 
for (int i = 0; i < cookies.length; i++){ 
cookie = cookies[i]; 
if((cookie.getName( )).compareTo("first_name") == 0 ){ 
cookie.setMaxAge(0); 
response.addCookie(cookie); 
out ,print(" 已 删除 的 cookie: " + 
cookie.getName( ) + "<br/>"); 
} 
out .print(" 名 称 :" + cookie.getName( ) + ", "); 
out.print(" 值 :" + cookie.getValue( )+" <br/>"); 


} 
}else{ 
out.println( 
"<h2 class="tutheader">No cookies founds</h2>") ; 
j 
out.println("«/body»"); 
out.println("«/html»"); 





编译 上 面 的 Servlet DeleteCookies, ##7£ web.xml 文件 中 创建 适当 的 条 目 。 现 在 
i& ÍT http:;//localhost:8080/DeleteCookies, "fX zm 255 : 


<h2>Cookies 名 称 和 值 </h2> 
已 删除 的 cookie : first_name 
名 称 : first_name， 值 :John 
名 称 : last_name， 值 : Player 


现在 尝试 运行 http:/localhost:8080/ReadCookies， 它 将 只 显示 一 个 cookie, MF 
所 示 : 


<h2>4# Cookies 名 称 和 值 </h2> 
名 称 : last_name， 值 : Player 


您 可 以 手动 在 Internet Explorer 中 出 KR Cookies。 在 "工具 "菜单 ， 选 择 "Internet it 
项 "。 如 果 要 删除 所 有 的 Cookies， 请 按 "删除 Cookies". 


Servlet Session 跟踪 

HTTP 是 一 种 无 状态 "协议 ， 这 意味 着 每 次 客户 端 检 索 网 页 时 ， 客 户 端 打开 一 个 单 
独 的 连接 到 Web 服务 器 ， 服 务 器 会 自动 不 保留 之 前 客户 端 请 求 的 任何 记录 。 

但 是 仍然 有 以 下 三 种 方式 来 维持 Web 客户 端 和 Web 服务 器 之 间 的 session Bis : 


Cookies 
— Web 服务 器 可 以 分 配 一 个 唯一 的 session 会 话 ID 作为 每 个 Web 客户 端的 
cookie， 对 于 客户 端的 后 续 请 求 可 以 使 用 接收 到 的 cookie 来 识别 。 


这 可 能 不 是 一 个 有 效 的 方法 ， 因 为 很 多 浏览 器 不 支持 cookie， 所 以 我 们 建议 不 要 使 
用 这 种 方式 来 维持 session 会 话 。 


隐藏 的 表单 字段 


一 个 Web 服务 器 可 以 发 送 一 个 隐藏 的 HTML 表单 字段 ， 以 及 一 个 唯一 的 session 
Rg ID, WFAA : 


<input type="hidden" name="sessionid" value="12345"> 


该 条 目 意味 着 ， 当 表单 被 提交 时 ， 指 定 的 名 称 和 值 会 被 自动 包含 在 GET 或 POST 
数据 中 。 每 次 当 Web 浏览 器 发 送 回 请求 时 ，session_id 值 可 以 用 于 保持 不 同 的 
Web 浏览 器 的 跟踪 。 

这 可 能 是 一 种 保持 session 会 话 跟踪 的 有 效 方式 ， 但 是 点 击 常规 的 超 文本 链接 («A 


HREF...>) 不 会 导致 表单 提交 ， 因 此 隐藏 的 表单 字段 也 不 支持 常规 的 session 会 话 
跟踪 。 


URL € € 


您 可 以 在 每 个 URL 末尾 追加 一 些 额 外 的 数据 来 标识 session 会 话 ， 服 务 器 会 把 该 
session 会 话 标识 符 与 已 存储 的 有 关 session 会 话 的 数据 相关 联 。 


例如 ，http://w3cschool.cc/file.htm;sessionid=12345，session 会 话 标 识 符 被 附加 
为 Sessionid=12345， 标 识 符 可 被 Web 服务 器 访问 以 识别 客户 端 。 

URL 重 写 是 一 种 更 好 的 维持 session 会 话 的 方式 ， 它 在 浏览 器 不 支持 cookie 时 能 
够 很 好 地 工作 ， 但 是 它 的 缺点 是 会 动态 生成 每 个 URL 来 为 页 面 分 配 一 个 session 

会 话 ID， 即 使 是 在 很 简单 的 静态 HTML 页 面 中 也 会 如 此 。 


HttpSession 对 象 


除了 上 述 的 三 种 方式 ，Servlet 还 提供 了 HttpSession 接口 ， 该 接口 提供 了 一 种 跨 多 
个 页 面 请 求 或 访问 网 站 时 识别 用 户 以 及 存储 有 关 用 户 信息 的 方式 。 


Servlet 容器 使 用 这 个 接口 来 创建 一 个 HTTP 客户 端 和 HTTP 服务 器 之 间 的 session 
会 话 。 会 话 持续 一 个 指定 的 时 间 段 ， 跨 多 个 连接 或 页 面 请 求 。 


您 会 通过 调用 HttpServletRequest 的 公共 方法 getSession() 来 获取 HttpSession 
对 象 ， 如 下 所 示 : 


HttpSession session = request.getSession(); 


你 需要 在 向 客户 端 发 送 任何 文档 内 容 之 前 调用 request.getSession(), F424 T 
HttpSession 对 象 中 可 用 的 几 个 重要 的 方法 : 


方法 


public Object 
getAttribute(String name) 


public Enumeration 
getAttributeNames() 


public long 
getCreationTime() 


public String getld() 


public long 
getLastAccessedTime() 


public int 
getMaxlnactivelnterval() 


public void invalidate() 


public boolean isNew( 


public void 
removeAttribute(String 
name) 


public void 
setAttribute(String name, 
Object value) 


public void 
setMaxlnactivelnterval(int 
interval) 


描述 
该 方法 返回 在 该 session 会 话 中 具有 指定 名 称 的 
对 象 ， 如 果 没 有 指定 名 称 的 对 象 ， 则 返回 null. 
该 方法 返回 String 对 象 的 枚 举 ，String 对 象 包 合 
所 有 绑 定 到 该 session 会 话 的 对 象 的 名 称 。 


该 方法 返回 该 session 会 话 被 创建 的 时 间 ， 自 格 
林 尼 治标 准时 间 1970 年 1 月 1 日 午夜 算 起 ， 以 
毫秒 为 单位 。 


该 方法 返回 一 个 包含 分 配给 该 session 会 话 的 唯 
一 标识 符 的 字符 串 。 
该 方法 返回 客户 端 最 后 一 次 发 送 与 该 session 会 


话 相 关 的 请 求 的 时 间 自 格林 尼 治 标准 时 间 1970 
年 1 月 1 日 午夜 算 起 ， 以 毫秒 为 单位 。 

该 方法 返回 Servlet 容器 在 客户 端 访 问 时 保持 
session 会 话 打开 的 最 大 时 间 间 隔 ， 以 秒 为 单 
位 。 


该 方法 指示 该 session 会 话 无 效 ， 并 解除 绑 定 到 
它 上 面 的 任何 对 象 。 


如 果 客 户 端 还 不 知道 该 session 会 话 ， 或 者 如 果 
客户 选择 不 参 人 该 session 会 话 ， 则 该 方法 返回 
true。 


该 方法 特 从 该 session 会 话 移 除 指定 名 称 的 对 


o 


该 方法 使 用 指定 的 名 称 绑 定 一 个 对 象 到 该 


session 会 话 。 


该 方法 在 Servlet 容器 指示 该 session 会 话 无 效 
之 前 ， 指 定 客户 端 请 求 之 间 的 时 间 ， 以 秒 为 单 
位 。 


Session 跟踪 实例 


本 实例 说 明了 如 何 使 用 HttpSession oo session 会 话 创建 时 间 和 最 后 访问 时 
间 。 如 果 不 存 在 session 会 话 ， 我 们 将 通过 请 求 创建 一 个 新 的 session 会 话 。 


// 导入 必需 的 java X 
import java.io.*; 
import javax.servlet.*; 


import javax.servlet.http.*; 
import java.util.*; 


// 扩展 HttpServlet X 
public class SessionTrack extends HttpServlet { 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 如 果 不 存在 session 会 话 ， 则 创建 一 个 session 对 象 
HttpSession session = request.getSession(true); 
// 获取 session 创建 时 间 
Date createTime = new Date(session.getCreationTime()); 
// 获取 该 网 页 的 最 后 一 次 访问 时 间 
Date lastAccessTime = 
new Date(session.getLastAccessedTime()); 


String title = "欢迎 回 到 我 的 网 站 " ; 

Integer visitCount = new Integer(0); 

String visitCountKey = new String("visitCount"); 
String userIDKey = new String("userID"); 

String userID = new String("ABCD"); 


// 检查 网 页 上 是 否 有 新 的 访问 者 
if (session.isNew()){ 
title = "欢迎 来 到 我 的 网 站 " ; 
session.setAttribute(userIDKey, userID); 
} else { 
visitCount = (Integer)session.getAttribute(visitCountKey), 
visitCount = visitCount + 1; 
userID = (String)session.getAttribute(userIDKey); 


} 


session.setAttribute(visitCountKey,  visitCount); 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
Printwriter out - response.getWriter(); 


String docType - 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolorzN"ZfOfOfON"2Nn" + 
"<hi align=\"center\">" + title + "</h1i>\n" + 
"<h2 align=\"center\">Session 信息 </h2>\n" + 
"<table border=\"1\" align=\"center\">\n" + 
"<tr bgcolor=\"#949494\">\n" + 
" «th»Session 信息 </th><th> 值 </th></tr>\n" + 
"<tr>\n" + 
" <td>id</td>\n" + 


" <td>" + session.getId() + "</td></tr>\n" + 
"<tr>\n" + 

" <td>Creation Time</td>\n" + 

"<td>" + createTime + 

" </td></tr>\n" + 

"<tr>\n" + 

" <td>Time of Last Access</td>\n" + 
"<td>" + lastAccessTime + 

" </td></tr>\n" + 

"<tr>\n" + 

" <td>User ID</td>\n" + 

" <td>" + userID + 

" </td></tr>\n" + 

"<tr>\n" + 

" <td>Number of visits</td>\n" + 

" <td>" + visitCount + "</td></tr>\n" + 
"</table>\n" + 

"«/body»«/htm1»"); 





编译 上 面 的 Servlet SessionTrack, #7 web.xml 文件 中 创建 适当 的 条 目 。 在 浏览 
器 地 址 栏 输入 http:Mocalhost808OSessionTrack， 当 您 第 一 次 运行 时 将 显示 如 下 
结果 : 


<h1> 欢 迎 来 到 我 的 网 站 </h1> 

<h2>Session 信息 </h2> 

<table> 

<tbody> 

«tr bgcolor="#949494"><th>Session 信息 </th><th> 值 </th></tr> 
<tr><td>id</td><td>0AE3EC93FF44E3C525B4351B77ABB2D5</td></tr> 
<tr><td>Creation Time</td><td>Tue Jun 08 17:26:40 GMT+04:00 2014</1 
<tr><td>Time of Last Access</td><td>Tue Jun 08 17:26:40 GMT+04:00 : 
<tr><td>User ID</td><td>ABCD</td></tr> 

<tr><td>Number of visits</td><td>0</td></tr> 

</tbody> 


</table> 








再 次 党 试 运行 相同 的 Servlet， 它 将 显示 如 下 结果 : 


<h1> 欢 迎 回 到 我 的 网 站 </h1> 


<h2>Session 信息 </h2> 


<table> 


<tbody> 


«tr bgcolor="#949494"><th>Session 信息 </th><th> 值 </th></tr> 


<tr><td>id</td><td>0AE3EC93FF44E3C525B4351B77ABB2D5</td></tr> 


<tr><td>Creation Time</td><td>Tue Jun 08 17:26:40 GMT+04:00 2014</1 


<tr><td>Time of Last Access</td><td>Tue Jun 08 17:26:40 GMT+04:00 : 


<tr><td>User ID</td><td>ABCD</td></tr> 


<tr><td>Number of visits</td><td>1</td></tr> 


</tbody> 


</table> 


E a 





删除 Session 会 话 数据 
当 您 完成 了 一 个 用 户 的 session 会 话 数据 ， 您 有 以 下 几 种 选 


移 除 一 个 特定 的 属性 : 您 可 以 调用 public void removeAttribute(String name) 
方法 来 删除 与 特定 的 键 相 关联 的 值 。 to delete the value associated with a 
particular key. 

删除 整个 session 会 话 : 您 可 以 调用 public void invalidate() 方法 来 丢弃 整个 
session 会 话 。 

设置 session 会 话 过 期 时 间 : 您 可 以 调用 public void 
setMaxlnactivelnterval(int interval) 方法 来 单独 设置 session 会 话 超时 。 
注销 用 户 : 如 果 使 用 的 是 支持 servlet 2.4 的 服务 器 ， 您 可 以 调用 logout 来 注 
a Web 服务 器 的 客户 端 ， 并 把 属于 所 有 用 户 的 所 有 session 会 话 设 置 为 无 

x 

web.xml 配置 : 如 果 您 使 用 的 是 Temcat， 除 了 上 述 方法 ， 您 还 可 以 在 
web.xml 文件 中 配置 session 会 话 超 时 ， 如 下 所 示 : 


<session-config> 
<session-timeout>15</session-timeout> 
</session-config> 


上 面 实 例 中 的 超时 时 间 是 以 分 钟 为 单位 ， 将 覆盖 Tomcat 中 默认 的 30 分 钟 超时 时 
间 o 


在 一 个 Servlet 中 的 getMaxlnactivelnterval() 方法 会 返回 session 会 话 的 超时 时 
间 ， 以 秒 为 单位 。 所 以 ， 如 果 在 web.xml 中 配置 session 会 话 超时 时 间 为 15 分 
钟 ， 那 么 getMaxinactivelnterval() 会 返回 900, 


Servlet 数据 库 访问 


本 教程 假定 您 已 经 了 解 了 JDBC 应 用 程序 的 工作 方式 。 在 您 开始 学 习 Servlet 数据 
库 访问 之 前 ， 请 确保 您 已 经 有 适当 的 JDBC 环境 设置 和 数据 库 。 


从 基本 概念 下 手 ， 让 我 们 来 创建 一 个 简单 的 表 ， 并 在 表 中 创建 几 条 记录 。 
创建 数据 库 表 


在 测试 数据 库 TEST 中 创建 Employees 表 ， 请 按 以 下 步骤 进行 : 


步骤 1: 

打开 命令 行 提 示 符 (Command Prompt) ， 并 更 改进 入 到 安装 目录 ， 如 下 所 示 : 
C:\> 
C:\>cd Program Files\MySQL\bin 
C:\Program Files\MySQL\bin> 

步骤 2 : 

登录 到 数据 库 ， 如 下 所 示 : 


C:\Program Files\MySQL\bin>mysql -u root -p 
Enter password: ******** 
mysql> 


步骤 3: 


在 测试 数据 库 TEST 中 创建 Employee 表 ， 如 下 所 示 : 


mysql> use TEST; 
mysql> create table Employees 
( 
id int not null, 
age int not null, 
first varchar (255), 
last varchar (255) 
); 
Query OK, © rows affected (0.08 sec) 
mysql» 


创建 数据 记录 
最 后 ， 在 Employee 表 中 创建 几 条 记录 ， 如 下 所 示 : 


mysql» INSERT INTO Employees VALUES (100, 18, 'Zara', 'Ali'); 
Query OK, 1 row affected (0.05 sec) 


mysql» INSERT INTO Employees VALUES (101, 25, 'Mahnaz', 'Fatma'); 
Query OK, 1 row affected (0.00 sec) 


mysql» INSERT INTO Employees VALUES (102, 30, 'Zaid', 'Khan'); 
Query OK, 1 row affected (0.00 sec) 


mysql» INSERT INTO Employees VALUES (103, 28, 'Sumit', 'Mittal'); 
Query OK, 1 row affected (0.00 sec) 


mysql» 
E- Pi 


访问 数据 库 
下 面 的 实例 演示 了 如 何 使 用 Servlet 访问 TEST 数据 库 。 


// 加 载 必需 的 库 

import java.io.*; 

import java.util.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 
import java.sql.*; 


public class DatabaseAccess extends HttpServlet{ 
public void doGet(HttpServletRequest request, 


HttpServletResponse response) 
throws ServletException, IOException 


// JDBC 驱动 器 名 称 和 数据 库 的 URL 
static final String JDBC_DRIVER="com.mysql.jdbc.Driver"; 
static final String DB URL-"jdbc:mysq1://localhost/TEST"; 


// ”数据 库 的 凭据 
static final String USER 
static final String PASS 


1 Oi 
"password"; 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
Printwriter out - response.getWriter(); 
String title = "数据 库 结 果 "， 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"«hi align=\"center\">" + title + "</hi>\n"); 
tryt 
// 注册 JDBC 驱动 器 
Class.forName("com.mysql.jdbc.Driver"); 


// 打开 一 个 连接 
conn = DriverManager .getConnection(DB_URL, USER, PASS) ; 


// 执行 SQL 查询 

stmt = conn.createStatement(); 

String sql; 

sql = "SELECT id, first, last, age FROM Employees"; 
ResultSet rs = stmt.executeQuery(sql); 


// 从 结果 集中 提取 数据 
while(rs.next()){ 
// 根据 列 名 称 检索 
int id = rs.getInt("id"); 
int age = rs.getInt("age"); 
String first = rs.getString("first"); 
String last = rs.getString("last"); 


// 显示 值 

out .printin("ID: " + id + "<br>"); 
out.println(", Age: " + age + "<br>"); 
DUESDICTOE LMG First rfirst E <br> 0 
out.println(", Last: " + last + "<br>"); 


} 
out.println("«/body»«/html»"); 


// 清理 环境 
rs.close(); 
stmt.close(); 


conn.close(); 
}catch(SQLException se){ 
// x% JDBC 错误 
se.printStackTrace(); 
jcatch(Exception e){ 
// 人 处理 Class.forName 错误 
e.printStackTrace(); 
}finally{ 
// 最 后 是 用 于 关闭 资源 的 块 
try{ 
if(stmt!=null) 
stmt.close(); 
jcatch(SQLException se2){ 
// 我 们 不 能 做 什么 
try{ 
if(conn!=null) 
conn.close(); 
}catch(SQLException se){ 
se.printStackTrace(); 
}//end finally try 
} //end try 


现在 让 我 们 来 编译 上 面 的 Servlet， 并 在 web.xml 文件 中 创建 以 下 条 目 : 


<servlet> 
<servlet -name>DatabaseAccess</servlet -name> 


<servlet-class>DatabaseAccess</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>DatabaseAccess</servlet -name> 
<url-pattern>/DatabaseAccess</url-pattern> 
</servlet -mapping> 


现在 调用 这 个 Servlet， 输 入 链接 : http://localhost:8080/DatabaseAccess , EX. 
示 以 下 响应 结果 : 


«hi align="center"> 数 据 库 结果 </h1> 

ID: 100, Age: 18, First: Zara, Last: Ali 

ID: 101, Age: 25, First: Mahnaz, Last: Fatma 
ID: 102, Age: 30, First: Zaid, Last: Khan 
ID: 103, Age: 28, First: Sumit, Last: Mittal 


Servlet 文件 上 传 


Servlet 可 以 与 HTML form 标签 一 起 使 用 ， 来 允许 用 户 上 传 文件 到 服务 器 。 上 传 的 
文件 可 以 是 文本 文件 或 图 像 文 件 或 任何 文档 。 


创建 一 个 文件 上 传 表单 


下 面 的 HTML 代码 创建 了 一 个 文件 上 传 表单 。 以 下 几 点 需要 注意 : 


e 表单 method 属性 应 该 设置 为 POST 方法 ， 不 能 使 用 GET 方法 。 

。 表单 enctype 属性 点 该 设置 为 multipart/form-data. 

e RŽ action 属性 应 该 设置 为 在 后 端 服务 器 上 处理 文 件 上 传 的 Servlet 文件 。 下 
面 的 实例 使 用 了 UploadServlet Servlet 来 上 传 文件 。 

e 上 传单 个 文件 ， 您 应 该 使 用 单个 带 有 属性 type="file" 的 «input ../> 标签 。 为 了 
允许 多 个 文件 上 传 ， 请 包含 多 个 name 属性 值 不 同 的 input 标签 。 输 入 标签 具 
有 不 同 的 名 称 属性 的 值 。 浏 览 器 会 为 每 个 input 标签 关联 一 个 浏览 按钮 。 


<html> 

<head> 

<title> 文 件 上 传 表 单 </title> 

</head> 

<body> 

<h3> 文 件 上 传 : </h3> 

请 选择 要 上 传 的 文件 : <br /> 

<form action="UploadServlet" method="post" 
enctype="multipart/form-data"> 

<input type="file" name="file" size="50" /> 

<br /> 

<input type="submit" Value=" 上 传 文件 " /> 

</form> 

</body> 

</html> 


这 将 显示 下 面 的 结果 ， 人 允许 用 户 从 本 地 计算 机 选择 一 个 文件 ， 当 用 户 点 击 " 上 传 文 
件 " 时 ， 表 单 会 连同 从 本 地 计算 机 选择 的 文件 一 起 提交 : 


<b> 文 件 上 传 : </b> 

请 选择 要 上 传 的 文件 : <br /> 

<input type="file" name="file" size="50" /> 
<br /> 

<input type="button" Value=" 上 传 文件 " /> 

<br /> 

注 : 这 只 是 虚拟 的 表单 ， 不 会 正常 工作 。 


编写 后 台 Servlet 


以 下 是 Servlet UploadServlet， 会 接受 上 传 的 文件 ， 并 把 它 储存 在 目录 <Tomcat- 
installation-directory>/webapps/data 中 。 这 个 目录 名 也 可 以 使 用 外 部 配置 来 添加 ， 
比如 web.xml 中 的 context-param 元 素 ， 如 下 所 示 : 


«web app» 


«context -param> 


<description>Location to store uploaded file</description> 
<param-name>file-upload</param-name> 
<param-value> 
c:\apache-tomcat-5.5.29\webapps\data\ 
</param-value> 


</context -param> 


</web-app> 


以 下 是 UploadServlet 的 源 代码 ， 可 以 一 次 处 理 多 个 文件 的 上 传 。 在 继续 操作 之 


前 ， 


请 确认 下 列 各 项 : 


下 面 的 实例 依赖 于 FileUpload， 所 以 一 定 要 确保 在 您 的 classpath 中 有 最 新 版 
本 的 commons-fileupload.x.x.jar 文件 。 可 以 从 
http://commons.apache.org/fileupload/ 下 载 。 

FileUpload 依赖 于 Commons ID， 所 以 一 定 要 确保 在 您 的 classpath 中 有 最 新 
版 本 的 commons-io-x.x.jar 文件 。 可 以 从 http://commons.apache.org/io/ 下 


载 。 

在 测试 下 面 实例 时 ， 您 上 传 的 文件 大 小 不 能 大 于 maxFileSize， 否 则 文件 将 无 
法 上 传 。 

请 确保 已 经 提前 创建 好 目录 c:\temp and c:\apache-tomcat- 
5.5.29Webapps data, 


// 导入 必需 的 java E 
import java.io.*; 
import java.util.*; 


import javax.servlet.ServletConfig; 


import javax.servlet.ServletException; 
import javax.servlet.http.HttpServlet; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import org.apache.commons.fileupload.FileItem; 

import org.apache.commons.fileupload.FileUploadException; 
import org.apache.commons.fileupload.disk.DiskFileItemFactory; 
import org.apache.commons.fileupload.servlet.ServletFileUpload; 
import org.apache.commons.io.output.*; 


public class UploadServlet extends HttpServlet { 


private boolean isMultipart; 

private String filePath; 

private int maxFileSize = 50 * 1024; 
private int maxMemSize = 4 * 1024; 
private File file ; 


public void init( 
// 获取 文件 将 被 存储 的 位 置 
filePath = 
getServletContext().getInitParameter("file-upload"); 


public void doPost(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, java.io.IOException { 

// 检查 我 们 有 一 个 文件 上 传 请 求 
isMultipart = ServletFileUpload.isMultipartContent(request); 
response.setContentType(" text/html"); 
java.io.PrintWriter out = response.getWwriter( ); 
if( !isMultipart ){ 

out.println("«html»"); 

out.println("«head»"); 

out.printin("<title>Servlet upload</title>"); 

out.println("«/head»"); 

out.println("«body»"); 

out.println("«p»No file uploaded</p>"); 

out.println("«/body»"); 

out.println("«/html»"); 

return; 
j 
DiskFileltemFactory factory - new DiskFileItemFactory(); 
// 文件 大 小 的 最 大 值 将 被 存储 在 内 存 中 
factory.setSizeThreshold(maxMemSize); 
// Location to save data that is larger than maxMemSize. 
factory.setRepository(new File("c:NNtemp")); 


// 创建 一 个 新 的 文件 上 传 处 理 程序 
ServletFileUpload upload = new ServletFileUpload(factory); 
// 人 允许 上 传 的 文件 大 小 的 最 大 值 


upload.setSizeMax( maxFileSize ); 


try{ 
// 解析 请 求 ， 获 取 文 件 项 
List fileltems = upload.parseRequest(request ) ; 


// 处 理 上 传 的 文件 项 
Iterator i = fileItems.iterator(); 


out.println("«html»"); 
out.println("«head»"); 
out.println("«title»Servlet upload</title>"); 
out.println("«/head»"); 


out.println("«body»"); 
while ( i.hasNext () ) 


( 


FileItem fi = (FileItem)i.next(); 
if ( !fi.isFormField () ) 


{ 


} 
} 


// 获取 上 传 文件 的 参数 
String fieldName = fi.getFieldName(); 
String fileName = fi.getName(); 
String contentType = fi.getContentType(); 
boolean isInMemory = fi.isInMemory(); 
long sizeInBytes = fi.getSize(); 
// 写 入 文件 
if( fileName.lastIndexOf("NN") >= 0 )( 
file = new File( filePath + 
fileName.substring( fileName.lastIndexOf("NN"))) ; 
jelse( 
file = new File( filePath + 
fileName.substring( fileName. lastIndexOf("\\")+1)) ; 


J 
fi.write( file ) ; 
out.println("Uploaded Filename: " + fileName + "«br»"), 


out.println("«/body»"); 
out.println("«/html»"); 


}catch(Exception ex) { 


System.out.println(ex); 


public void doGet(HttpServletRequest request, 


HttpServletResponse response) 


throws ServletException, java.io.IOException { 


throw new ServletException("GET method used with " + 


getClass( ).getName( )+": POST method required."); 


e REI | 


编译 和 运行 Servlet 


编译 上 面 的 Servlet UploadServlet， 并 在 web.xml 文件 中 创建 所 需 的 条 目 ， 如 下 所 


ZN: 


<servlet> 
<servlet -name>UploadServlet</servlet-name> 
<servlet-class>UploadServlet</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>UploadServlet</servlet-name> 
<url-pattern>/UploadServlet</url-pattern> 
</servlet -mapping> 


现在 尝试 使 用 您 在 上 面 创 建 的 HTML 表单 来 上 传 文件 。 当 您 在 浏览 器 中 访 
问 : http://localhost:8080/UploadFile.htm 时 ， 它 会 显示 下 面 的 结果 ， 这 将 有 助 于 您 
从 本 地 计算 机 上 传 任 何 文 件 。 


<b> 文 件 上 传 : </b> 

请 选择 要 上 传 的 文件 : <br /> 

<input type="file" name="file" size="50" /> 
<br /> 

<input type="button" Value=" 上 传 文件 " /> 


如 果 您 的 Servelt 脚本 能 正常 工作 ， 那 么 您 的 文件 会 被 上 传 到 c:\apache-tomcat- 
5.5.29\webappsidata\ 目录 中 。 


Servlet 义理 日 期 

使 用 Servlet 的 最 重要 的 优势 之 一 是 ， 可 以 使 用 核心 Java 中 的 大 多 数 可 用 的 方法 。 
本 章 将 讲解 Java 提供 的 java.util 包 中 的 Date 类 ， 这 个 类 封装 了 当前 的 日 期 和 时 
间 。 

Date 类 支持 两 个 构造 画 数 。 第 一 个 构造 画 数 初始 化 当前 日 期 和 时 间 的 对 象 。 


Date( ) 


FARMERA TSM, SOBSOST 1970 年 1 月 1 日 午夜 以 来 经 过 的 毫秒 


o 


Date(long millisec) 


一 旦 您 有 一 个 可 用 的 Date 对 象 ， 您 可 以 调用 下 列 任意 支持 的 方法 来 使 用 日 期 : 


方法 


boolean after(Date 
date) 


boolean 
before(Date date) 


Object clone( ) 

int 
compareTo(Date 
date) 

int 
compareTo(Object 
obj) 


boolean 
equals(Object 
date) 


long getTime( ) 
int hashCode( ) 


void setTime(long 
time) 


String toString( ) 


描述 


如 果 调 用 的 Date 对 象 中 包含 的 日 期 在 date 指定 的 日 期 
之 后 ， 则 返回 true， 否 则 返回 false. 


如 果 调 用 的 Date 对 象 中 包含 的 日 期 在 date 指定 的 日 期 
之 前 ， 则 返回 true， 否 则 返回 false, 


重复 调用 Date 对 象 。 


把 调用 对 象 的 值 与 date 的 值 进行 比较 。 如 果 两 个 值 是 相 
等 的 ， 则 返回 0。 如 果 调 用 对 象 在 date 之 前 ， 则 返回 一 
个 负 值 。 如 果 调 用 对 象 在 date 之 后 ， 则 返回 一 个 正 值 。 


如 果 obj 是 Date 类 ， 则 操作 等 同 于 compareTo(Date). 
否则 ， 它 会 抛 出 一 个 ClassCastException。 


如 果 调 用 的 Date 对 象 中 包含 的 时 间 和 日 期 与 date 指定 
的 相同 ， 则 返回 true， 否 则 返回 false. 

返回 1970 年 1 月 1 日 以 来 经 过 的 毫秒 数 。 

为 调用 对 象 返 回 哈 希 代码 。 


设置 time 指定 的 时 间 和 日 期 ， 这 表示 从 1970 年 1 月 1 
日 午夜 以 来 经 过 的 时 间 (以 毫秒 为 单位 ) 。 


转换 调用 的 Date 对 象 为 一 个 字符 串 ， 并 返回 结果 。 


获取 当前 的 日 期 和 时 间 


在 Java Servlet 中 获取 当前 的 日 期 和 时 间 是 非常 容易 的 。 您 可 以 使 用 一 个 简单 的 
Date 对 象 的 toString) 方法 来 输出 当前 的 日 期 和 时 间 ， 如 下 所 示 : 


// 导入 必需 的 java E 

import java.io.*; 

import java.util.Date; 
import javax.servlet.*; 
import javax.servlet.http.*; 


// 扩展 HttpServlet X 
public class CurrentDate extends HttpServlet { 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


{ 
// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
PrintWriter out = response.getWriter(); 
String title = "显示 当前 的 日 期 和 时 间 "， 
Date date = new Date(); 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"«hi align=\"center\">" + title + "</h1i>\n" + 
"«h2 align=\"center\">" + date.toString() + "</h2>\n" + 
"</body></htm1>"); 
} 


现在 ， 让 我 们 来 编译 上 面 的 Servlet, #7 web.xml 文件 中 创建 适当 的 条 目 ， 然 后 
通过 访问 http://localhost:8080/CurrentDate 来 调用 该 Servlet。 这 将 会 产生 如 下 的 
结果 : 


<h1i> 显 示 当 前 的 日 期 和 时 间 </h1> 


<h2>Mon Jun 21 21:46:49 GMT+04:00 2010</h2> 


尝试 刷新 URL http://localhost:8080/CurrentDate， 每 隔 几 秒 刷 新 一 次 您 都 会 发 现 显 
示 时 间 的 差异 。 


日 期 比较 


正如 上 面 所 提 到 的 ， 您 可 以 在 Servlet 中 使 用 所 有 可 用 的 Java 方法 。 如 果 您 需要 比 
较 两 个 日 期 ， 以 下 是 方法 : 

您 可 以 使 用 getTime() 来 获取 两 个 对 象 自 1970 年 1 月 1 日 午夜 以 来 经 过 的 时 
i|] (以 毫秒 为 单位 ) ， 然 后 对 这 两 个 值 进 行 比较 。 

您 可 以 使 用 方法 before( )、after( ) 和 equals( )。 由 于 一 个 月 里 12 号 在 18 号 
之 前 ， 例 如 ，new Date(99, 2, 12).before(new Date (99, 2, 18)) 返回 true. 
您 可 以 使 用 compareTo( ) 方法 ， 该 方法 由 Comparable 接口 定义 ， 由 Date 实 


现 。 


使 用 SimpleDateFormat 格式 化 日 期 


SimpleDateFormat 是 一 个 以 语言 环境 敏感 的 方式 来 格式 化 和 解析 日 期 的 具体 类 。 
SimpleDateFormat 允许 您 选择 任何 用 户 定义 的 日 期 时 间 格 式 化 的 模式 。 


让 我 们 修改 上 面 的 实例 ， 如 下 所 示 : 


// 导入 必需 的 java E 

import java.io.*; 

import java.text.*; 

import java.util.Date; 
import javax.servlet.*; 
import javax.servlet.http.*"; 


// 扩展 HttpServlet X 
public class CurrentDate extends HttpServlet { 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


t 
// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
PrintWriter out = response.getWriter(); 
String title = "显示 当前 的 日 期 和 时 间 "; 
Date dNow = new Date( ); 
SimpleDateFormat ft = 
new SimpleDateFormat ("E yyyy.MM.dd 'at' hh:mm:ss a zzz"); 
String docType - 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOfFOFO\">\n" + 
"<h1 align=\"center\">" + title + "</h1>\n" + 
"<h2 align=\"center\">" + ft.format(dNow) + "</h2>\n" + 
"«/body»«/html»"); 
} 


再 次 编译 上 面 的 Servlet， 然 后 通过 访问 http://localhost:8080/CurrentDate 来 调用 
该 Servlet。 这 将 会 产生 如 下 的 结果 : 


<h1i> 显 示 当 前 的 日 期 和 时 间 </h1> 


<h2>Mon 2010.06.21 at 10:06:44 PM GMT+04:00</h2> 


简单 的 日 期 格式 的 格式 代码 


使 用 事件 模式 字符 串 来 指定 时 间 格 式 。 在 这 种 模式 下 ， 所 有 的 ASCI 字母 被 保留 关 
模式 字母 ， 这 些 字母 定义 如 下 : 


e 


3m" Ge = fee © | ap 


zis|miomio(|o 


AC D 


描述 
Era 指示 器 
四 位 数 表 示 的 年 
一 年 中 的 月 
一 月 中 的 第 几 天 


带 有 A.M./P.M. 的 小 时 (1-12) 
一 天 中 的 第 几 小 时 (0~23) 
一 小 时 中 的 第 几 分 

一 分 中 的 第 几 秒 

毫秒 

一 周 中 的 星期 几 

一 年 中 的 第 几 天 

所 在 的 周 是 这 个 月 的 第 几 周 
一 年 中 的 第 几 周 

一 月 中 的 第 几 周 

A.M./P.M. 标记 

一 天 中 的 第 几 小 时 (1~24) 
带 有 A.M./P.M. 的 小 时 (0~11) 
时 区 

Escape for text 

单 引 号 


实例 
AD 
2001 
July 或 07 
10 
12 
22 
30 
55 
234 
Tuesday 
360 
2 (Second Wed.in July) 
40 


10 
Eastern Standard Time 


Delimiter 


如 需 查 看 可 用 的 处 理 日 期 方法 的 完整 列表 ， 您 可 以 参考 标准 的 Java 文档 。 


Servlet W 7n Æ ÆA 


当 文档 移动 到 新 的 位 置 ， 我 们 需要 向 客户 端 发 送 这 个 新 位 置 时 ， 我 们 需要 用 到 网 页 
重 定向 。 当 然 ， 也 可 能 是 为 了 负载 均衡 ， 或 者 只 是 为 了 简单 的 随机 ， 这 些 情况 都 有 
可 能 用 到 网 页 重 定向 。 

重 定向 请 求 到 另 一 个 网 页 的 最 简单 的 方式 是 使 用 response xt RA sendRedirect() 
方法 。 下 面 是 该 方法 的 定义 : 将 请 求 重 定向 到 另 一 页 的 最 简单 的 方法 是 ， 用 方法 的 
sendRedirect() 的 响应 对 象 。 以 下 是 这 种 方法 的 定义 : 


public void HttpServletResponse.sendRedirect(String location) 
throws IOException 


该 方法 把 响应 连同 状态 码 和 新 的 网 页 位 置 发 送 回 浏览 器 。 您 也 可 以 通过 把 
setStatus() 和 setHeader() 方法 一 起 使 用 来 达到 同 祥 的 效果 : 


String site = "http://www.newpage.com" ; 
response.setStatus(response.SC MOVED TEMPORARILY); 
response.setHeader("Location", site); 


实例 


本 实例 显示 了 Servlet 如 何 进行 页 面 重 定向 到 另 一 个 位 置 : 


import java.io.*; 

import java.sql.Date; 

import java.util.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 


public class PageRedirect extends HttpServlet{ 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


// 要 重 定向 的 新 位 置 
String site = new String("http://www.w3cschool.cc"); 


response.setStatus(response.SC_MOVED_TEMPORARILY) ; 
response.setHeader("Location", site); 


现在 让 我 们 来 编译 上 面 的 Servlet， 并 在 web.xml 文件 中 创建 以 下 条 目 : 


<servlet> 
<servlet -name>PageRedirect</servlet -name> 
<servlet-class>PageRedirect</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>PageRedirect</servlet -name> 
<url-pattern>/PageRedirect</url-pattern> 
</servlet -mapping> 


现在 通过 访问 URL http://localhost:8080/PageRedirect 来 调用 这 个 Servlet, 4} 
把 您 转 到 给 定 的 URL http://www.w3cschool.cc o 


Servlet 点 击 计 数 器 
网 页 点 击 计 数 器 


很 多 时 候 ， 您 可 能 有 闪 趣 知道 网 站 的 某 个 特定 页 面 上 的 总 点 击 量 。 使 用 Servlet 来 


计算 这 些 点 击 量 是 非常 简单 的 ， 因 为 一 个 Servlet 的 生命 周期 是 由 它 运行 所 在 的 容 
器 控制 的 。 
以 下 是 实现 一 个 简单 的 基于 Servlet 生命 周期 的 网 页 点 击 计 数 器 需要 采取 的 步骤 : 


在 init) 方法 中 初始 化 一 个 全 局 变量 。 

e 每 次 调用 doGet() 或 doPost() 方法 时 ， 都 增加 全 局 变量 。 

e 如 果 需 要 ， 您 可 以 使 用 一 个 数据 库 表 来 存储 全 局 变量 的 值 在 destroy() 中 。 在 
下 次 初始 化 Servlet 时 ， 该 值 可 在 init) 方法 内 被 读 取 。 这 一 步 是 可 选 的 。 

e 如 果 您 只 想 对 一 个 session 会 话 计数 一 次 页 面 点 击 ， 那 么 请 使 用 isNew() 方法 

来 检查 该 session 会 话 是 否 已 点 击 过 相同 页 面 。 这 一 步 是 可 选 的 。 

人 来 在 网 站 上 展示 页 面 的 总 点 击 量 。 这 一 步 是 

AY xe BY, 


在 这 里 ， 我 们 假设 Web 容器 将 无 法 重新 和 启动。 如 果 是 重新 启动 或 Servlet 被 销毁 ， 
计数 器 将 被 重 置 。 


实例 


本 实例 演示 了 如 何 实现 一 个 简单 的 网 页 点 击 计数 器 : 


import java.io.*; 

import java.sql.Date; 

import java.util.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 


public class PageHitCounter extends HttpServlet{ 
private int hitCount; 
public void init() 


// 重 置 点 击 计数 器 
hitCount = 0; 
b 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
// 该 方法 在 Servlet 被 点 击 时 执行 

// 增加 hitCount 


hitCount--*; 
PrintWriter out = response.getWriter(); 
String title = "eae: 


String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOfFOFO\">\n" + 
"<h1 align=\"center\">" + title + "</hi>\n" + 
"<h2 align=\"center\">" + hitCount + "</h2>\n" + 
"«/body»«/html»"); 


public void destroy() 
{ 


} 
} 


// 这 一 步 是 可 选 的， 但 是 如 果 需 要 ， 您 可 以 把 hitcount 的 值 写 人 到 数据 库 


现在 让 我 们 来 编译 上 面 的 Servlet， 并 在 web.xml 文件 中 创建 以 下 条 目 : 


<servlet> 
<servlet -name>PageHitCounter</servlet -name> 
<servlet-class>PageHitCounter</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>PageHitCounter</servlet -name> 


<url-pattern>/PageHitCounter</url-pattern> 
</servlet -mapping> 


现在 通过 访问 URL http://localhost:8080/PageHitCounter 来 调用 这 个 Servlet, ix 
将 会 在 每 次 页 面 刷新 时 ， 把 计数 器 的 值 增加 1， 结 果 如 下 所 示 : 


<h1> 总 点 击 量 </h1> 


<h2>6</h2> 


网 站 点 击 计数 器 

很 多 时 候 ， 您 可 能 有 闪 e cH eMe 在 Servlet 中 ， 这 也 是 非常 简 
单 的 ， 我 们 可 以 使 用 过 4 滤器 做 到 点 。 

以 下 是 实现 一 个 简单 的 基于 过 滤器 生命 周期 的 网 站 点 击 计 数 器 需要 采取 的 步骤 : 


e 在 过 滤器 的 init() 方法 中 初始 化 一 个 全 局 变量 。 

e 每 次 调用 doFilter 方法 时 ， 都 增加 全 局 变量 。 

e 如果 需要 ， 您 可 以 使 用 一 个 数据 库 表 来 存储 全 局 变量 的 值 在 过 滤器 的 destroy() 
E 在 下 次 初始 化 过 滤器 时 ， 该 值 可 在 init() 方法 内 被 读 取 。 这 一 步 是 可 选 


在 这 里 ， 我 们 假设 Web 容器 将 无 法 重新 和 启动。 如 果 是 重新 启动 或 Servlet RHR, 
点 击 计 数 器 将 被 重 置 。 


实例 
本 实例 演示 了 如 何 实现 一 个 简单 的 网 站 点 击 计数 器 : 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 
import java.util.*; 


public class SiteHitCounter implements Filter{ 
private int hitCount; 


public void init(FilterConfig config) 
throws ServletException{ 
// 重 置 点 击 计数 器 
hitCount = 0; 
j 


public void doFilter(ServletRequest request, 
ServletResponse response, 
FilterChain chain) 
throws java.io.IOException, ServletException { 


// 把 计数 器 的 值 增加 1 
hitCount++; 


// 输出 计数 器 
System.out.println(" 网 站 访问 统计 : "+ hitCount ); 


// 把 请 求 传 回 到 过 滤器 链 
chain.doFilter(request, response) ; 


public void destroy() 
i 


} 
} 


// 这 一 步 是 可 选 的 ， 但 是 如 果 需 要 ， 您 可 以 把 hitcount Hy BA ERGE x 


现在 让 我 们 来 编译 上 面 的 Servlet， 并 在 web.xml 文件 中 创建 以 下 条 目 : 


<filter> 
<filter-name>SiteHitCounter</filter-name> 
<filter-class>SiteHitCounter</filter-class> 
</filter> 


<filter-mapping> 
<filter-name>SiteHitCounter</filter-name> 
<url-pattern>/*</url-pattern> 

</filter -mapping> 


现在 访问 网 站 的 任意 页 面 ， 比 如 http://localhost:8080/ 。 这 将 会 在 每 次 任意 页 面 被 
点 击 时 ， 把 计数 器 的 值 增加 1， 它 会 在 日 志 中 显示 以 下 消息 : 


网 站 访问 统计 1 
网 站 访问 统计 : 2 
网 站 访问 统计 : 3 
网 站 访问 统计 : 4 
网 站 访问 统计 : 5 


Serviet 自动 刷新 页 面 


假设 有 一 个 网 页 ， 它 是 显示 现场 比赛 成 绩 或 股票 市 场 状况 或 货币 兑换 率 。 对 于 所 有 
这 些 类 型 的 页 面 ， 您 需要 定期 刷新 网 页 。 


Java Servlet 提供 了 一 个 机 制 ， 使 得 网 页 会 在 给 定 的 时 间 间 隔 自 动 刷新 。 


刷新 网 页 的 最 简单 的 方式 是 使 用 响应 对 象 的 方法 setlntHeader()。 以 下 是 这 种 方法 
的 定义 : 


public void setIntHeader(String header, int headerValue) 


此 方法 把 头 信息 "Refresh" 连同 一 个 表示 时 间 间 隔 的 整数 值 (以 秒 为 单位 ) 发 送 回 


浏览 器。 


目 动 刷新 页 面 实例 


本 实例 演示 了 Servlet 如 何 使 用 setintHeader() 方法 来 设置 Refresh 头 信 息 ， 从 而 
实现 自动 刷新 页 面 。 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 
import java.util.*; 


// 扩展 HttpServlet X 
public class Refresh extends HttpServlet { 


// 处 理 GET 方法 请 求 的 方法 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 刷新 自动 加 载 的 事件 间隔 为 5 秒 
response.setIntHeader("Refresh", 5); 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 


// 获取 当前 的 时 间 

Calendar calendar = new GregorianCalendar(); 
String am pm; 

int hour - calendar.get(Calendar.HOUR); 

int minute calendar.get(Calendar.MINUTE); 
int second calendar.get(Calendar.SECOND); 


if(calendar.get(Calendar.AM_PM) == 0) 
am_pm = "AM"; 

else 
am_pm = "PM"; 


String CT = hour+":"+ minute +":"+ second +" "+ am pm; 


PrintWriter out = response.getWwriter(); 
String title = "使 用 Servlet 自动 刷新 页 面 " ， 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n"+ 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<h1 align=\"center\">" + title + "</hi>\n" + 
"<p> 当 前 时 间 是 DUE Cp + "</p>\n"); 


} 
// 义理 POST 方法 请 求 的 方法 
public void doPost(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 
doGet(request, response); 


现在 让 我 们 来 编译 上 面 的 Servlet， 并 在 web.xml 文件 中 创建 以 下 条 目 : 


<servlet> 
<servlet -name>Refresh</servlet-name> 
<servlet-class>Refresh</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet-name>Refresh</servlet -name> 


<url-pattern>/Refresh</url-pattern> 
</servlet -mapping> 


现在 通过 访问 URL http://localhost:8080/Refresh 来 调用 这 个 Servlet。 这 将 会 每 
5 秒 钟 显 示 一 次 当前 系统 时 间 。 运 行 该 Servlet， 并 等 待 查看 结果 : 


<h1> 使 用 Servlet 自动 刷新 页 面 </h1> 


当前 时 间 是 : 9:44:50 PM 
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使 用 Servlet 发 送 一 封 电子 邮件 是 很 简单 的 ， 但 首先 您 必须 在 您 的 计算 机 上 安装 


JavaMail 


e 您 可 以 从 Java 标准 网 站 下 载 最 新 版 本 的 JavaMail (版 本 1.2) 。 


API 和 Java Activation Framework) JAF) 。 


e 您 可 以 从 Java 标准 网 站 下 载 最 新 版 本 的 JAF (版 本 1.1.1) 。 


压缩 这 些 文件 ， 在 新 创建 的 顶层 目录 中 ， 您 会 发 现 这 两 个 应 用 程序 的 一 些 
jar 文件 。 您 需要 把 mail.jar 和 activation.jar 文件 添加 到 您 的 CLASSPATH 中 。 


下 载 并 解 


一 封 简单 的 电子 邮件 


下 面 的 实例 将 从 您 的 计算 机 上 发 送 一 封 简单 的 电子 邮件 。 这 里 假设 您 


的 本 地 主机 已 


连接 到 互联 网 ， 并 支持 发 送 电子 邮件 。 同 时 确保 Java Email API 包 和 JAF 包 的 所 
有 的 jar 文件 在 CLASSPATH 中 都 是 可 用 的 。 


// 文件 名 SendEmail.java 


Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 


publ 


java.io.*; 
java.util.*; 
javax.servlet.*; 
javax.servlet.http.*; 
javax.mail.*; 
javax.mail.internet.*; 
javax.activation.*; 


class SendEmail extends HttpServlet{ 


ic void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 收 件 人 的 电子 邮件 ID 
String to = "abcd@gmail.com"; 


// 发 件 人 的 电子 邮件 ID 
String from = "web@gmail.com"; 


// 假设 您 是 从 本 地 主机 发 送 电子 邮件 
String host = "localhost"; 


获取 系统 的 属性 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session wR 
Session session = Session.getDefaultInstance(properties); 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
Printwriter out - response.getWriter(); 


tryt 
// 创建 一 个 默认 的 MimeMessage 对 象 
MimeMessage message = new MimeMessage(session); 
// 设置 From: header field of the header. 
message.setFrom(new InternetAddress(from) ); 
// 设置 To: header field of the header. 
message.addRecipient(Message.RecipientType.TO, 

new InternetAddress(to)); 

// 设置 Subject: header field 
message.setSubject("This is the Subject Line!"); 
// 现在 设置 实际 消息 
message.setText("This is actual message"); 
// 发 送 消息 
Transport.send(message) ; 
String title = "发 送 电 子 邮 件 "， 
String res = "成 功 发 送 消 息 ..."， 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOfFOFO\">\n" + 
"«h1 align=\"center\">" + title + "</hi>\n" + 
"<p align=\"center\">" + res + "</p>\n" + 
"«/body»«/htm1»"); 

jcatch (MessagingException mex) { 
mex.printStackTrace(); 

} 


现在 让 我 们 来 编译 上 面 的 Servlet， 并 在 web.xml 文件 中 创建 以 下 条 目 : 


<servlet> 
<servlet -name>SendEmail</servlet -name> 
<servlet-class>SendEmail</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>SendEmail</servlet -name> 
<url-pattern>/SendEmail</url-pattern> 
</servlet -mapping> 


现在 通过 访问 URL http://localhost:8080/SendEmail 来 调用 这 个 Servlet。 这 将 会 发 
送 一 封 电子 邮件 到 给 定 的 电子 邮件 ID abca@gmaijcom， 并 将 显示 下 面 所 示 的 唤 
应 : 


<h1> 发 送 电子 邮件 </h1> 


成 功 发 送 消息 .. . 


如 果 您 想 要 发 送 一 封 电子 邮件 给 多 个 收 件 人 ， 那 么 请 使 用 下 面 的 方法 来 指定 多 个 电 
子 邮 件 ID : 


void addRecipients(Message.RecipientType type, 
Address[] addresses) 
throws MessagingException 


下 面 是 对 参数 的 描述 : 


e type : 这 将 被 设置 为 TO、CC 或 BCC。 在 这 里 ，CC 代表 抄 送 ，BCC RRA 
件 抄 送 。 例 如 Message.RecipientType.TO。 

。 addresses : 这 是 电子 邮件 ID 的 数组 。 当 指定 电子 邮件 ID 时 ， 您 需要 使 用 
InternetAddress() 方法 。 


发 送 一 封 HTML 电子 邮件 


下 面 的 实例 业 从 您 的 计算 机 上 发 送 一 封 HTML. 格式 的 电子 邮件 。 这 里 假设 您 的 本 地 
主机 已 连接 到 互联 网 ， 并 支持 发 送 电子 邮件 。 同 时 确保 Java Email API 包 和 JAF 
包 的 所 有 的 jar 文件 在 CLASSPATH 中 都 是 可 用 的 。 


本 实例 与 上 一 个 实例 很 类 似 ， 但 是 这 里 我 们 使 用 setContent() 方法 来 设置 第 二 个 参 
数 为 "text/html" 的 内 容 ， 该 参数 用 来 指定 HTML 内 容 是 包含 在 消息 中 的 。 


使 用 这 个 实例 ， 您 可 以 发 送 内 容 大 小 不 限 的 HTML AR. 


// 文件 名 SendEmail.java 


import 
import 
import 
import 
import 
import 
import 


public 


java.io.*; 
java.util.*; 
javax.servlet.*; 
javax.servlet.http.*; 
javax.mail.*; 
javax.mail.internet.*; 
javax.activation.*; 


class SendEmail extends HttpServlet{ 


public void doGet(HttpServletRequest request, 


HttpServletResponse response) 
throws ServletException, IOException 


// 收 件 人 的 电子 邮件 ID 
String to = "abcd@gmail.com"; 


// 发 件 人 的 电子 邮件 ID 
String from = "web@gmail.com"; 


// 假设 您 是 从 本 地 主机 发 送 电子 邮件 
String host = "localhost"; 


// 获取 系统 的 属性 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session 对 象 
Session session = Session.getDefaultInstance(properties); 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
Printwriter out - response.getWriter(); 


try{ 
// 创建 一 个 默认 的 MimeMessage 对 象 
MimeMessage message = new MimeMessage(session); 
// 设置 From: header field of the header. 
message.setFrom(new InternetAddress(from) ); 
// 设置 To: header field of the header. 
message.addRecipient(Message.RecipientType.TO, 

new InternetAddress(to)); 

// 设置 Subject: header field 
message.setSubject("This is the Subject Line!"); 


// 设置 实际 的 HTML 消息 ， 内 容 大 小 不 限 
message.setContent("<h1i>This is actual messagec/h1»", 
"text/html" ); 

// 发 送 消息 


} 
} 


Transport.send(message) ; 
String title = "发 送 电 子 邮件 " 
String res = "成 功 发 送 消息 ,.."; 
String docType = 

"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 


out. 


println(docType + 


"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<h1 align=\"center\">" + title + "</hi>\n" + 


"<p align=\"center\">" + res + "</p>\n" + 


"</body></html>") ; 


}catch 


} 


mex. 


(MessagingException mex) { 
printStackTrace(); 


编译 并 运行 上 面 的 Servlet ， 在 给 定 的 电子 邮件 ID 上 发 送 HTML 消息 。 


在 电子 邮件 中 发 送 附件 


下 面 的 实例 将 从 您 的 计算 机 上 发 送 一 封 带 有 附件 的 电子 邮件 。 这 里 假设 您 
机 已 连接 到 互联 网 ， 并 支持 发 送 电 子 邮 件 。 同 时 确保 Java Email API 包 和 JAF & 
的 所 有 的 jar 文件 在 CLASSPATH 中 都 是 可 用 的 。 


// 文件 名 SendEmail.java 
java.io.*; 
Java.util.*; 


import 
import 
import 
import 
import 
import 
import 


public 


javax. 
javax. 


javax 
javax 


class 


servlet.*; 
servlet .http.*; 


seed loa 
.mail.internet.*; 
javax. 


activation.*; 


SendEmail extends HttpServlet{ 


public void doGet(HttpServletRequest request, 


HttpServletResponse response) 


throws ServletException, IOException 


// 收 件 人 的 电子 邮件 ID 


String 


to = "abcd@gmail.com"; 


// 发 件 人 的 电子 邮件 ID 


String 


from = "web@gmail.com"; 


// 假设 您 是 从 本 地 主机 发 送 电 子 邮 件 


String 


host = "localhost"; 


的 本 地 主 


// 获取 系统 的 属性 
Properties properties = System.getProperties(); 


// 设置 邮件 服务 器 
properties.setProperty("mail.smtp.host", host); 


// 获取 默认 的 Session wR 
Session session = Session.getDefaultInstance(properties); 


// 设置 响应 内 容 类 型 
response.setContentType(" text/html"); 
Printwriter out - response.getWriter(); 


try{ 
// 创建 一 个 默认 的 MimeMessage 对 象 
MimeMessage message = new MimeMessage(session); 


// 设置 From: header field of the header. 
message.setFrom(new InternetAddress(from)); 


// 设置 To: header field of the header. 
message.addRecipient(Message.RecipientType.TO, 
new InternetAddress(to)); 


// 设置 Subject: header field 
message.setSubject("This is the Subject Line!"); 


// 创建 消息 部 分 
BodyPart messageBodyPart = new MimeBodyPart(); 


// 填写 消息 
messageBodyPart.setText("This is message body"); 


// 创建 一 个 多 部 分 消息 
Multipart multipart = new MimeMultipart(); 


// 设置 文本 消息 部 分 
multipart .addBodyPart(messageBodyPart ) ; 


// 第 二 部 分 是 附件 

messageBodyPart = new MimeBodyPart(); 

String filename = "file.txt"; 

DataSource source = new FileDataSource(filename) ; 
messageBodyPart.setDataHandler(new DataHandler(source) ); 
messageBodyPart.setFileName( filename) ; 

multipart .addBodyPart(messageBodyPart ) ; 


// 发 送 完整 的 消息 部 分 
message.setContent(multipart ); 


// 发 送 消息 
Transport.send(message); 


String title = "发 送 电子 邮件 " ; 
String res = "成 功 发 送 电子 邮件 . . ."; 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<hi align=\"center\">" + title + "</h1>\n" + 
"<p align=\"center\">" + res + "</p>\n" + 
"</body></htm1>"); 

jcatch (MessagingException mex) { 
mex.printStackTrace(); 

} 


| 
编译 并 运行 上 面 的 Servlet ， 在 给 定 的 电子 邮件 ID 上 发 送 带 有 文件 附件 的 消息 。 
用 户 身份 认证 部 分 


RE. eee eae ee eee ae ee 
下 属性 : 


props.setProperty("mail.user", "myuser"); 
props.setProperty("mail.password", "mypwd"); 


电子 邮件 发 送 机 制 的 其 余部 分 与 上 面 讲解 的 保持 一 致 。 


Servlet € 


涉及 到 WEB-INF 子 目 录 的 Web 应 用 程序 结构 是 所 有 的 Java web 应 用 程序 的 标 
准 ， 并 由 Servlet API 规范 指定 。 给 定 一 个 顶级 目录 名 myapp， 目 录 结 构 如 下 所 
小 ， 


/myapp 
/images 
/WEB- INF 
/classes 
/lib 


WEB-INF 子 目录 中 包含 应 用 程序 的 部 署 描述 符 ， 名 为 web.xml。 所 有 的 HTML X 
件 都 位 于 顶级 目录 myapp 下 。 对 于 admin 用 户 ， 您 会 发 现 ROOT 目录 是 myApp 
的 父 目 录 。 


创建 包 中 的 Servlet 


WEB-INF/classes 目录 包含 了 所 有 的 Servlet 类 和 其 他 类 文件 ， 类 文件 所 在 的 目录 
结构 与 他 们 的 包 名 称 匹 配 。 例 如 ， 如 果 您 有 一 个 完全 合格 的 类 名 称 
com.myorg.MyServlet， 那 么 这 个 Servlet 类 必须 位 于 以 下 目录 中 : 


/myapp/WEB- INF/classes/com/myorg/MyServlet.class 


下 面 的 例子 创建 包 名 为 com.myorg 的 MyServlet X, 


// 为 包 命名 
package com.myorg; 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.* 


public class MyServlet extends HttpServlet { 
private String message; 
public void init() throws ServletException 


// 执行 必需 的 的 初始 化 
message = "Hello World"; 


} 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


{ 
// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
// 实际 的 逻辑 是 在 这 里 
Printwriter out = response.getWriter(); 
out.println("«hi»" + message + "</hi>"); 
j 


public void destroy() 


// 什么 也 不 做 


编译 包 中 的 Servlet 


编译 包 中 的 类 与 编译 其 他 的 类 没有 什么 大 的 不 同 。 最 简单 的 方法 是 让 您 的 java 文件 
保留 完全 限定 路 径 ， 如 上 面 提 到 的 类 ， 将 被 保留 在 com.myorg 中 。 您 还 需要 在 
CLASSPATH 中 添加 该 目 录 。 


假设 您 的 环境 已 正确 设置 ， 进 入 <Tomcat-installation- 
VG PBT -INF/classes 目录 ， 并 编译 MyServletjava, 40 
下 所 示 


$ javac MyServlet.java 


如 果 Servlet 依赖 于 其 他 库 ， 那 么 您 必须 在 CLASSPATH 中 也 要 引用 那些 JAR X 
件 。 这 里 我 只 引用 了 serviet-apijar JAR 文件 ， 因 为 我 在 Hello World 程序 中 并 没 
有 使 用 任何 其 他 库 。 


op BT EAA BA javac 编译 器 ， 它 是 Sun Microsystems Java 软件 开发 工具 包 

(JDK， 全 称 Java Software Development Kit) 附带 的 。 Microsystems 的 Java 软 
件 开发 工具 包 (JDK) 。 为 了 让 该 命 人 正常 工作 ， 必 须 包括 您 在 PATH 环境 变量 中 
所 使 用 的 Java SDK 的 位 置 。 


如 果 一 切 顺利 ， 上 述 编译 会 在 同一 目录 下 生成 MyServlet.class 文件 。 下 一 节 将 解 
释 如 何 部 把 一 个 已 编译 的 Servlet 部 署 到 生产 中 。 


Serviet 打包 部 署 


默认 情况 下 ，Servlet 应 用 程序 位 于 路 径 <Tomcat-installation- 
directory>/webapps/ROOT 下 ， 且 类 文件 放 在 <Tomcat-installation- 
directory»/webapps/ROOT/WEB-INF/classes 中 。 


如 果 您 有 一 个 完全 合格 的 类 名 称 com.myorg.MyServlet， 那 么 这 个 Servlet 类 必须 
位 于 WEB-INF/classes/com/myorg/MyServlet.class 中 ， 您 需要 在 位 于 <Tomcat- 
installation-directory>/webapps/ROOT/WEB-INF/ 的 web.xml 文件 中 创建 以 下 条 
B: 


«servlet» 
<servlet -name>MyServlet</servlet -name> 
<servlet-class>com.myorg.MyServlet</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet -name>MyServlet</servlet -name> 
<url-pattern>/MyServlet</url-pattern> 
</servlet -mapping> 


上 面 的 条 目 要 被 创建 在 web.xml 文件 中 的 <web-app>...</web-app> 标签 内 。 在 该 
文件 中 可 能 已 经 有 各 种 可 用 的 条 目 ， 但 不 要 在 意 。 


到 这 里 ， 您 基本 上 已 经 完成 了 ， 现 在 让 我 们 使 用 <Tomcat-installation- 
directory>\bin\startup.bat (在 Windows 上 ) 或 <Tomcat-installation- 
directory>/bin/startup.sh (在 Linux/Solaris 等 上 ) 启动 tomcat 服务 器 ， 最 后 在 浏 
览 器 的 地 址 栏 中 输入 http://localhost:8080/MyServlet。 如 果 一 切 顺 利 ， 您 会 看 到 
下 面 的 结果 : 


<hi>Hello World</hi> 


Servlet 调试 

测试 /调试 Servlet 始终 是 开发 使 用 过 程 中 的 难点 。 Servlet 往往 涉及 大 量 的 客户 端 / 
服务 器 交互 ， 可 能 会 出 现 错误 但 又 难以 重 现 。 

这 里 有 一 些 提示 和 建议 ， 可 以 帮助 您 调试 。 


System.out.println() 


System.out.printin() 是 作为 一 个 标记 来 使 用 的 ， 用 来 测试 一 段 特定 的 代码 是 否 被 执 
行 。 我 们 也 可 以 打印 出 变量 的 值 。 此 外 : 


e 由 于 System 对 象 是 核心 Java 对 象 的 一 部 分 ， 它 可 以 在 不 需要 安装 任何 额外 
类 的 情况 下 被 用 于 任何 地 方 。 这 包括 Servlet、JSP、RMI、EJB's、 普 通 的 
Beans 和 类 ， 以 及 独立 的 应 用 程序 。 

e 与 在 断 点 处 停止 不 同 ， 写 入 到 System.out 不 会 干扰 到 应 用 程序 的 正常 执行 流 
程 ， 这 使 得 它 在 时 序 是 至 关 重 要 的 时 候 显 得 尤为 有 价值 。 


下 面 是 使 用 System.out.println() 的 语法 : 


System.out.println("Debugging message"); 


通过 上 面 的 语法 生成 的 所 有 消息 将 被 记录 在 Web 服务 器 日 志文 件 中 。 
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消 息 日 


使 用 适当 的 日 志 记 录 方 法 来 记录 所 有 调试 、 警 告 和 错误 消息 ， 这 是 非常 好 的 想法 ， 
推荐 使 用 log4J 来 记录 所 有 的 消息 。 


Servlet API 还 提供 了 一 个 简单 的 输出 信息 的 方式 ， 使 用 log() 方法 ， 如 下 所 示 : 


// 导入 必需 的 java E 

import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 


public class ContextLog extends HttpServlet { 
public void doGet(HttpServletRequest request, 
HttpServletResponse response) throws ServletException, 
java.io.IOException { 


String par - request.getParameter("par1"); 
// 调用 两 个 ServletContext.log 方法 
ServletContext context = getServletContext( ) 


if (par == null || par.equals("")) 
// 通过 Throwable 参数 记录 版 本 
context.log("No message received:", 
new IllegalStateException("Missing parameter")); 
else 
context.log("Here is the visitor's message: " + par); 


response.setContentType("text/html1"); 
java.io.PrintWriter out = response.getWwriter( ); 
String title = "Context Log"; 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOfFOTO\">\n" + 
"<hi align=\"center\">" + title + "</hi>\n" + 
"<h2 align=\"center\">Messages sent</h2>\n" + 
"«/body»«/html»"); 
} //doGet 


ServletContext 把 它 的 文本 消息 记录 到 Servlet 容器 的 日 志文 件 中 。 对 于 Tomcat, 
这 些 日 志 可 以 在 <Tomcat-installation-directory>/logs 目录 中 找到 。 


这 些 日 志文 件 确 实 对 新 出 现 的 错误 或 问题 的 频率 给 出 指示 。 正 因为 如 此 ， 建 议 在 通 
常 不 会 发 生 的 异常 的 catch 子 句 中 使 用 log) 函数 。 


使 用 JDB 调试 器 


您 可 以 使 用 调试 applet 或 应 用 程序 的 jdb 命令 来 调试 Servlet. 


为 了 调试 一 个 Servlet， 我 们 可 以 调试 sun.servlet.http.HttpServer， 然 后 把 它 看 成 
是 HttpServer 执行 Servlet 来 响应 浏览 器 端的 HTTP 请 求 。 这 每 调试 applet 小 程 
序 非常 相似 。 和 与 调试 applet 不 同 的 是 ， 实际 被 调试 的 程序 是 
sun.applet.AppletViewer。 


六 多 数 调 试 器 会 日 动 隐藏 如 何 调试 applet 的 细节 。 同 样 的 ， 对 于 servlet， 您 必须 
帮 调 试 器 执行 以 下 操作 : 


e 设置 您 的 调试 器 的 类 路 径 classpath， 以 便 它 可 以 找到 sun.servlet.http.Http- 
Server 和 相关 的 类 。 

e 设置 您 的 调试 器 的 类 路 径 classpath， 以 便 它 可 以 找到 您 的 servlet 和 支持 的 
类 ， 通 常 是 在 server_root/servlets 和 server. root/classes 中 。 


您 通常 不 会 希望 server_root/servlets 在 您 的 classpath 中 ， 因 为 它 会 禁用 servlet 
的 重新 加 载 。 但 是 这 种 包含 规则 对 于 调试 是 非常 有 用 的 。 它 允许 您 的 调试 器 在 
HttpServer 中 的 自 定义 Servlet 加 载 器 加 载 Servlet 之 前 在 Servlet 中 设置 断 点 。 


如 果 您 已 经 设置 了 正确 的 类 路 径 classpath， 就 可 以 开始 调试 

sun. Ves http.HttpServer。 可 以 在 您 想 要 调试 的 Servlet 代码 中 设置 断 点 ， 然 后 
通 过 Web 浏览 | 览 器 使 用 给 定 的 

Servlet (http: Illocalhost: nt ne 向 HttpServer 发 出 请 求 。 
您 会 看 到 程序 执行 到 断 点 处 会 停止 


使 用 注释 


代码 中 的 注释 有 助 于 以 各 种 方式 进行 调试 。 注 释 可 用 于 调试 过 程 的 很 多 其 他 方式 


o 


该 Servlet 使 用 Java 注释 和 单行 注释 (1...) , STHER 〈/ …/) 可 用 于 暂时 移 除 部 
分 Java 代码 。 如 果 bug 消失 ， 仔 细 看 看 您 刚才 注释 的 代码 并 找 出 问题 所 在 。 
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A, 3— Servlet 并 没有 像 预期 那样 时 ， 查 看 原始 的 HTTP 请 求 和 响应 是 非常 
有 用 的 。 如 果 您 熟悉 HTTP 结构 ， 您 可 以 阅读 请 求 和 响应 ， 看 看 这 些 头 信 息 究竟 是 
什么 。 


重要 的 调试 技巧 


下 面 列 出 了 一 些 Servlet 调试 的 技巧 : 
Ab 人 


e 请 注意 ，server_root/classes 不 会 重 载 ， 而 server_root/serviets 可 能 会 。 

e 要 求 浏览 器 显示 它 所 显示 的 页 面 的 原始 内 容 。 这 有 助 于 识别 格式 的 问题 。 它 通 
党 是 "视图 "菜单 下 的 一 个 选项 。 

e 通过 强制 执行 完全 重新 加 载 页 面 来 确保 浏览 器 还 没有 缓存 前 一 个 请 求 的 输出 。 
在 Netscape Navigator 中 ， 请 使 用 Shift-Reload， 在 Internet Explorer 中 ， 请 
使 用 Shift-Refresh。 


e 请 确认 servlet 的 init() 方法 接受 一 个 ServletConfig 参数 ， 并 调用 
super.init(config)。 


Servlet 国际 化 


在 我 们 开始 之 前 ， 先 来 看 看 三 个 重要 术语 : 


e 国际 化 (18n) : 这 意味 着 一 个 网 站 提供 了 不 同 版 本 的 翻译 成 访问 者 的 语言 或 
国籍 的 内 容 。 

e 本 地 化 (10n) : 这 意味 着 向 网 站 添加 资源 ， 以 使 其 适应 特定 的 地 理 或 文化 区 
域 ， 例 如 网 站 翻译 成 印 地 文 (Hindi) 。 

e 区域 设置 (locale) : 这 是 一 个 特殊 的 文化 或 地 理 区 域 。 人 
跟 一 个 下 划 线 和 一 个 国家 符号 。 例如 "en. US" 表示 针对 US 的 英语 区 域 设 


当 建 立 一 个 全 球 性 的 网 站 时 有 一 些 注意 事项 。 本 教程 不 会 讲解 这 些 注意 事项 的 完整 
细节 ， 但 它 会 通过 一 个 很 好 的 实例 向 您 演示 如 何 通过 差异 化 定位 〈 即 区 域 设置 ) 来 
让 网 页 以 不 同 语言 呈现 。 


Servlet 可 以 根据 请 求 者 的 区 域 设置 拾取 相应 版 本 的 网 站 ， 并 根据 当地 的 语言 、 文 化 
和 需求 提供 相应 的 网 站 版 本 。 以 下 是 request 对 象 中 返回 Locale 对 象 的 方法 。 


java.util.Locale request.getLocale() 
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下 面 列 出 了 重要 的 区 域 设 置 方 法 ， 您 可 以 使 用 它们 来 检测 请 求 者 的 地 理 位 置 、 话 言 
和 区 域 设置 。 下 面 所 有 的 方法 都 显示 了 请 求 者 浏览 器 中 i 史 置 的 国家 名 称 和 话 证 名 


称 。 


方法 描述 


: 该 方法 以 2 个 大 写字 母 形 式 的 ISO 3166 格式 返回 该 
String getCountry() 区 域 设 置 的 国家 /地 区 代码 。 


String 该 方法 返回 适合 向 用 户 显示 的 区 域 设置 的 国家 的 名 
getDisplayCountry() 称 。 


: 该 方法 以 小 写字 母 形式 的 ISO 639 ,返回 该 区 域 
String getLanguage() 2 2 om 3 格式 返回 该 区 域 


String 该 方法 返回 适合 向 用 户 显示 的 区 域 设 置 的 语言 的 名 

getDisplayLanguage() fh. 

String 该 方法 返回 该 区 域 设置 的 国家 的 三 个 字母 缩写 

getISO3Country() E E 

String LA od ; e SPT MIEL AA ES 
该 方法 返回 该 区 域 设置 的 语言 的 三 个 字母 的 缩写 


getlSO3Language() 


本 实例 演示 了 如 何 显 示 某 个 请 求 的 语言 和 相关 的 国家 : 


import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 
import java.util.Locale; 


public class GetLocale extends HttpServlet{ 
public void doGet(HttpServletRequest request, 


HttpServletResponse response) 
throws ServletException, IOException 


{ 

// 获取 客户 端的 区 域 设 置 

Locale locale = request.getLocale(); 

String language = locale.getLanguage(); 

String country = locale.getCountry(); 

// 设置 响应 内 容 类 型 

response.setContentType("text/htm1"); 

PrintWriter out = response.getWriter(); 

String title = "检测 区 域 设 置 " 

String docType = 

"<!doctype html public \"-//w3c//dtd html 4.0 " + 

"transitional//en\">\n"; 

out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOfFOFO\">\n" + 
"<h1 align=\"center\">" + language + "</hi>\n" + 
"<h2 align=\"center\">" + country + "</h2>\n" + 
"«/body»«/html»"); 

} 
} 
HARE 


Servlet 可 以 输出 以 西欧 语言 (如 英语 、 西 班 牙 语 、 德 语 、 法 语 、 意 大 利 语 、 和 荷兰 语 
等 ) 编写 的 页 面 。 在 这 里 ， 为 了 能 正确 显示 所 有 的 字符 ， 设 置 Content-Language 
头 是 非常 重要 的 。 


第 二 点 是 使 用 HTML 实体 显示 所 有 的 特殊 字符 ， 例 如 ，"fi" 表示 "?"，"j" 表示 UO", 
如 下 所 示 : 


import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*"; 
import java.util.Locale; 


public class DisplaySpanish extends HttpServlet{ 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 
response.setContentType("text/htm1"); 
PrintWriter out = response.getWriter(); 

// 设置 西班牙 语言 代码 
response.setHeader("Content-Language", "es"); 


String title = "En Espa&ntilde;ol"; 

String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<h1>" + "En Espa&ntilde;ol:" + "</h1>\n" + 
"<h1>" + "&iexcl;Hola Mundo!" + "</h1>\n" + 
"«/body»«/htm1»"); 


特定 于 区 域 设 置 的 日 期 


您 可 以 使 用 java.text.DateFormat 类 及 其 静态 方法 getDateTimelnstance() 来 格式 
化 特定 于 区 域 设 置 的 日 期 和 时 间 。 下 面 的 实例 演示 了 如 何 格 式 化 特定 于 某 个 给 定 的 
区 域 设 置 的 日 期 : 


import java.io.*; 

import javax.servlet.*; 
import javax.servlet.http.*; 
import java.util.Locale; 
import java.text.DateFormat; 
import java.util.Date; 


public class DateLocale extends HttpServlet{ 


public void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


// 设置 响应 内 容 类 型 

response.setContentType("text/htm1") ， 

Printwriter out = response.getWriter(); 

// 获取 客户 端的 区 域 设 置 

Locale locale = request.getLocale( ); 

String date = DateFormat.getDateTimeInstance( 
DateFormat.FULL, 
DateFormat.SHORT, 
locale).format(new Date( )); 


String title = "特定 于 区 域 设置 的 日 期 " ; 

String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"<hi align=\"center\">" + date + "</hi>\n" + 
"«/body»«/html»"); 


特定 于 区 域 设 置 的 货 


您 可 以 使 用 java.text.NumberFormat 类 及 其 静态 方法 getCurrencylnstance() 来 格 
式 化 数字 (比如 long 类 型 或 double 类 型 ) 为 特定 于 区 域 设置 的 货币 。 下 面 的 实例 
演示 了 如 何 格式 化 特定 于 某 个 给 定 的 区 域 设 置 的 货币 : 


import 
import 
import 
import 
import 
import 
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java.io. *; 
javax.servlet.*; 
javax.servlet.http.*; 
java.util.Locale; 
java.text.NumberFormat; 
java.util.Date; 


class CurrencyLocale extends HttpServlet{ 


ic void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


设置 响应 内 容 类 型 
sponse.setContentType("text/htm1"); 
intWriter out = response.getWriter(); 
获取 客户 端的 区 域 设 置 
cale locale = request.getLocale( ); 
mberFormat nft = NumberFormat.getCurrencyInstance(locale); 
ring formattedCurr = nft.format(1000000) ; 


ring title = "特定 于 区 域 设 置 的 货币 "; 

ring docType = 

"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 

out.println(docType + 

"<html>\n" + 

"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 

"«h1 align=\"center\">" + formattedCurr + "</hi>\n" + 
"«/body»«/html»"); 


特定 于 区 域 设置 的 百分比 


您 可 以 使 用 java.text.NumberFormat 类 及 其 静态 方法 getPercentlnstance() 来 格式 
化 特定 于 区 域 设置 的 百分比 。 下 面 的 实例 演示 了 如 何 格式 化 特定 于 某 个 给 定 的 区 域 
设置 的 百分比 : 


import java.io.*; 

import javax.servlet.*; 

import javax.servlet.http.*"; 
import java.util.Locale; 
import java.text.NumberFormat; 
import java.util.Date; 


public class PercentageLocale extends HttpServletf{ 
public void doGet(HttpServletRequest request, 


HttpServletResponse response) 
throws ServletException, IOException 


{ 
// 设置 响应 内 容 类 型 
response.setContentType("text/htm1") ; 
Printwriter out = response.getWriter(); 
// 获取 客户 端的 区 域 设 置 
Locale locale = request.getLocale( ); 
NumberFormat nft = NumberFormat.getPercentInstance(locale); 
String formattedPerc = nft.format(0.51); 
String title = "特定 于 区 域 设置 的 百分比 " ; 
String docType = 
"<!doctype html public \"-//w3c//dtd html 4.0 " + 
"transitional//en\">\n"; 
out.println(docType + 
"<html>\n" + 
"<head><title>" + title + "</title></head>\n" + 
"<body bgcolor=\"#fOFOFO\">\n" + 
"«h1 align=\"center\">" + formattedPerc + "</hi>\n" + 
"«/body»«/html»"); 
j 


Spring 教程 


Spring 框架 ， 由 Rod Johnson 开 发 ， 是 一 个 非常 强大 的 反 转 控制 (IOC) 框架 ， 以 
帮助 分 离 项 目 组 件 的 依赖 关系 。 在 本 系列 教程 ， 将 多 个 步骤 提供 一 些 例子 ， 用 来 学 
习 和 解释 Spring 框架 。 新 的 Spring 4.1 教程 (2015/12/12) 增加 了 关于 使 用 Spring 

EL，JavaConfig，AspectJ 和 Spring 对 象 /XML 映射 (OXM) 等 许多 Spring 4.0 的 实 
例 教程 。 


Spring 快速 入门 
快速 入 门 了 解 Spring 框架 开发 的 基础 。 


e 1.0、Spring hello world 实 例 Spring3.0 的 hello world 实例 ， 在 新 的 Spring3.0 开 
发 需要 什么 。 

e 1.1、Spring 松 耦合 的 实例 一 个 例子 用 来 演示 Spring 是 如 何 使 组 件 之 间 松 散 耦 合 
的 


s 
o 


Spring JavaConfig 


Spring 3.0 支 持 JavaConfig， 现 在 可 以 使 用 注解 来 配置 Spring。 


e 1.2. Spring JavaConfig 实例 使 用 @Configuration 和 @Bean 演 示 到 在 Spring 定 
义 bean 

e 1.3, Spring JavaConfig (Import 实例 使 用 @Import 组 织 Bean 类 模块 化 的 实 
例 


Spring 依赖 注入 (D1) 


Spring 如 何 使 用 依赖 注入 (DO) 来 管理 对 象 的 依赖 关系 。 


e 1.4、Spring 依 赖 注入 (DI) Spring 如 何 通 过 应 用 Setter 注 入 和 构造 器 注入 的 依赖 
SEA (DD 设计 模式 实例 

e 1.5, Spring DI 通过 setter 方 法 通过 setter 方 法 依赖 注 和 人 bean 

e 1.6, Spring DI 构造 方法 可 以 通过 构造 方法 依赖 注入 bean 

e 1.7.1, Spring4438 AEA RAIL 构造 画 数 注入 参数 类 型 蚊 义 的 问题 总 是 发 
生 在 一 个 bean 包 含 多 个 构造 方法 有 多 个 参数 


Bean 基 础 


只 需要 在 Spring loC 容 器 使 用 的 类 被 认为 是 “Bean"”， 并 可 在 Spring bean 的 配置 文件 
或 者 通过 注解 来 声明 。 


e 1.7, Spring bean 引用 实例 如 何 指定 相同 或 不 同 的 bean 配 置 文件 中 的 bean 引 
用 互相 访问 。 

e 1.8、 注 入 值 到 Spring Bean 的 属性 三 种 方法 注入 值 到 bean 的 属性 。 

e 1.9、 加 载 多 个 Spring bean 配 置 文件 开发 人 员 总 是 在 不 同 的 模块 文件 夹 归 类 不 
同 的 bean 配置 文件 ， 这 里 有 一 个 技巧 ， 向 您 展示 如 何 加 载 多 个 Spring bean 
的 配置 文件 。 

e 2.0、Spring 内 部 Bean 实 例 每 当 一 个 bean 仅 用 于 一 个 特定 的 属性 ， 它 总 是 建议 
将 其 声明 为 一 个 内 部 bean。 

e 2.1, Spring bean 作 用 域 Bean 作 用 域 是 用 来 决定 哪些 bean 实 例 的 类 型 应 该 是 
从 Spring 容器 中 返回 给 调用 者 。 

e。2.2、Spring 集 合 (List, Set, Map, and Properties) 实例 注入 值 到 集合 类 型 (Fl 
表 ， 集 ， 映 射 和 属性 ) 实例 。 

e 2.3, ListFactoryBean3z fJ 创建 一 个 具体 的 列表 集合 类 (ArrayList 和 
LinkedList) ， 并 注入 到 bean 属性 。 

e 2.4、SetFactoryBean 实 例 创建 一 组 具体 的 Set 和 集合 类 (HashSet 和 
TreeSet) ， 并 注入 到 bean 属 性 。 

e 2.5、MapFactoryBean 实 例 创建 一 个 具体 的 映射 集合 类 (HashMap 和 
TreeMap#) ， 并 注入 到 bean 属 性 。 

。 2.6、Spring 注 入 日 期 到 bean 属 性 — CustomDateEditor 一 般 情 况 下 ，Spring 接 
受 日 期 变量 ， 这 里 有 一 个 技巧 - 使 用 CustomDateEditor 来 解决 。 

e 2.7, Spring PropertyPlaceholderConfigurer 实 例 通过 一 个 特殊 格式 具体 化 部 
署 详情 到 一 个 属性 文件 ， 并 从 bean 配 置 文件 访问 获得 - ${variable} 

e 2.8, Spring bean 配 置 继承 继承 是 非常 有 用 ， 一 个 bean 来 分 享 共同 的 值 ， 属 性 
或 配置 。 

e。2.9、Spring 依 赖 检 查 Spring4 中 提供 了 依赖 检查 模式 ， 以 确保 所 要 求 的 属性 已 
经 在 bean 中 设置 。 

e。3.0、Spring 使 用 @Required 注 解 依 赖 检 查 依赖 检查 注释 模式 。 

e 3.1、 自 定义 @Reduired-style 注 解 创建 自 定义 @Required-style 注 解 ， 相 当 于 
@Required 注解 

e 3.2, Bean InitializingBean 和 DisposableBean 实 例 执行 bean 初始 化 和 销毁 
某 些 动作 (接口 ) 

e 3.3, Bean init-method 和 destroy-method 实例 执行 bean 初始 化 和 销毁 某 些 
动作 (XML) 

e 3.4、Bean @PostConstruct 和 @PreDestroy 实例 执行 bean 初始 化 和 销毁 某 
些 动作 (注解 ) 


Spring 表达 陈 语 言 
Spring 3.0 引 入 了 Spring 表达 语言 ， 或 Spring EL 丰富 而 强大 的 表达 式 语言 。 


e 3.5, Spring EL hello world 实例 使 用 Spring 表达 式 语 言 (EL) 快速 入 门 

e 3.6, Spring EL bean 引用 实例 参考 bean，bean 属 性 使 用 一 个 点 () 符号 。 
e 3.7, Spring EL 方法 调用 实例 直接 调用 Bean 方 法 

e 3.8, Spring EL 操作 符 实 例 Spring EL 支持 大 多 数 标准 的 关系 ， 逻 辑 和 数学 运 
e 3.9, Spring EL 三 元 操作 符 (if-then-else) 实例 有 条 件 的 检查 if else then. 

e 4.0, Spring EL Arrays, Lists, Maps 实例 适用 于 映射 和 列表 。 


e 4.1, Spring EL 正则 表达 式 实例 正则 表达 式 来 计算 评估 条 件 。 
e 4.2、 测 试 Spring EL 与 ExpressionParser 如 何 轻松 地 测试 Spring El. 


Spring 自动 组 件 扫描 


Spring 是 能 够 扫描 ， 检 测 并 自动 注册 bean 的 。 


e 4.3、Spring 自 动 打 描 组 件 让 Spring 自动 扫描 ， 检 测 和 注册 Bean。 
e 4.4、Spring 过 滤器 组 件 自动 扫描 过 过 滤器 自动 扫描 模式 的 某 些 组 件 实例 。 


Spring E 4 At Bean 


Spring 自动 装配 "auto-wiring" 来 装配 或 Bean 类 ， 无 论 是 在 XML 和 注释 。 


。 4.5、Spring 自 动 装配 Beans Spring 5 种 自动 装配 方式 总 结 。 

e 4.6、Spring 由 类 型 (Type) 自 动 装 配 如 果 一 个 bean 的 数据 类 型 是 用 其 它 bean 
属性 的 数据 类 型 ， 那 么 自动 装配 它 。 

e 4.7, Spring EH & f (Name) Ei sr <A 如 果 一 个 bean 的 名 称 与 其 他 bean 属 性 的 

名 称 是 一 样 的 ， 那 么 可 以 自动 装配 它 。 

4.8、Spring 由 构造 方法 自动 装配 由 在 构造 画 数 的 参数 类 型 自动 装 

4.9、Spring 由 AutoDetect 自 动 装配 这 意味 着 选择 ' HORS S Ai Em, 如 果 

默认 构造 酌 数 被 找到 ， 否 则 使 用 “自动 装配 按 类 型 "。 

e 5.0, Spring 使 用 @Autowired 注 解 自动 装配 例子 来 说 明 如 何 定义 注解 “auto- 
wiring” 模式 。 

e 5.1, Spring 自动 装配 @Qualifier 实 例 举 个 例子 来 确定 哪些 Bean 有 资格 自动 装 
配 到 某 个 字段 上 。 


Spring AOP (面向 方面 编程 ) 


Spring AOP 的 模块 化 方面 横 切 关注 点 。 简 单 地 说 ， 就 是 一 个 拦截 器 拦截 一 些 方法 。 


e 5.2, Spring AOP 通 知 实例 — Advice 有 关 不 同类 型 的 Spring 建议 说 明和 示 
例 。 

e 5.3, Spring AOP 实 例 — Pointcut , Advisor 有 关 不 同类 型 的 Spring 的 切入 点 和 
Advisor 的 解释 和 示例 。 

e 5.4, Spring AOP 拦 截 器 的 序列 AOP 拦 截 器 的 顺序 会 影响 功能 。 

e 5.5、 自 动 代 理 创 建 者 实例 一 个 自动 代理 生成 例子 是 用 来 为 Bean 自 动 创 建 代 理 
对 象 ， 以 避免 造成 许多 重复 的 代理 对 象 。 


Spring AOP + AspectJ 框 架 


由 于 Spring 2.0 中 对 AspectJ 更 加 灵活 和 强大 的 支持 。 然 而 ， 本 实例 在 Spring3.0 
中 应 用 说 明 。 


e 5.6, Spring AOP + AspectJ 注 解 实例 一 个 例子 向 您 展示 如 何 将 AspectJ 注解 


与 Spring 框架 集成 。 
e 5.7, Spring AOP + AspectJ 在 XML 配置 实例 Spring AOP 使 用 AspectJ 在 
XML 基本 配置 。 


Spring Object/XML 映射 器 


在 Spring3.0， 对 象 到 XML 映射 (OXM) 从 Spring Web 服 务 到 核心 Spring 框架 。 


e 5.8, Spring Object/XML 了 映射 实例 Spring oxm + castor， 转 换 对 象 到 XML， 反 
之 亦 然 。 


Spring JDBC 支 持 


Spring 提供 了 很 多 辅助 类 简化 整个 JDBC 数据 库 操作 。 


e 5.9, Spring + JDBC 实 例 一 个 例子 来 说 明 如 何 集成 Spring 和 JDBC. 

e 6.0、JdbcTemplate + JdbcDaoSupport 实例 使 用 Spring 的 JdbcTemplate 和 
JdbcDaoSupport 类 来 简化 整个 JDBC 数 据 库 操作 过 程 的 一 个 实例 。 

e 6.1, Spring JdbcTemplate# if) 3z A 这 里 有 一 些 例子 来 说 明 如 何 使 用 
JdbcTemplate 的 query() 方法 来 查询 或 从 数据 库 中 提取 数据 。 

e 6.2、Spring JdbcTemplate batchUpdate() 实例 这 里 是 一 个 
BATCHUPDATE () 例子 来 说 明 如 何 执 行 批量 插入 操作 。 

e 6.3, Spring SimpleJdbcTemplate 查 询 示 例 更 多 的 用 户 查 询 操 作 ， 或 从 数据 库 

中 提取 数据 的 友好 而 简单 的 方法 。 

6.4, Spring SimpleJdbcTemplate batchUpdate() 实 例 使 用 

SimpleJdbcTemplate 类 ， 一 个 Java5 的 友好 补充 JdbcTemplate 的 一 个 批量 更 

新 的 例子 。 

e 6.5、Spring SimpleJdbcTemplate 类 命名 参数 实例 一 个 例子 来 说 明 如 何 使 用 命 
名 参数 作为 SQL 参 数值 ， 而 这 仅仅 是 在 SimpleJdbcTemplate 中 支持 。 


Spring Hibernate 支 持 


Spring 提供 了 许多 方便 的 类 来 支持 Hibernate ORM 框 架 。 
e 6.6、Spring+Hibernate+MySql 实 例 使 用 Spring 和 Hibernate 的 一 个 简单 的 项 


e 6.7, Spring + Hibernate+ MySql 注 解 实例 使 用 Spring 和 Hibernate (注释 版 ) 
的 一 个 简单 的 项 目 。 

e 6.8, Spring AOP 在 Hibernate 的 事务 管理 一 个 例子 来 说 明 如 何 管理 Hibernate 
事务 与 Spring AOP。 

e Struts + Spring + Hibernate 集 成 Spring、Struts 和 Hibernate 框 架 集成 的 实例 。 


Spring E-mail 支 持 


Spring 提供 MailSender 通过 JavaMail API 发 送 电子 邮件 。 


e 6.9、 通 过 MailSender 发 送 电子 邮件 使 用 Spring 的 MailSender 通 过 Gmail 的 
SMTP 服 务 器 发 送 电子 邮件 实例 。 

e 7.0、 在 bean 配 置 文件 中 的 电子 邮件 模板 硬 编码 所 有 电子 邮件 属性 和 消息 ， 正 
文 内 容 不 是 一 个 好 的 做 法 ， 应 该 考虑 在 Spring 的 bean 配 置 文件 中 定义 电子 邮件 
模板 。 

e 7.1、Spring 发 送 带 附件 的 Email 使 用 Spring 来 发 送 带 附件 的 电子 邮件 示例 。 


Spring 与 其 它 Web 框 架 集 成 


Spring 集 成 其 它 Web 框 架 。 


e 7.2、Spring 依 赖 注入 servlet 会 话 监听 器 Spring 提供 了 一 
个 “ContextLoaderListener 监听 器 作为 一 个 通用 的 方法 ， 以 使 Spring 依赖 注入 
会 话 监 听 器 应 用 到 几乎 所 有 其 他 的 web 框 架 。 

e Struts 2 + Spring 集成 实例 Spring 和 Struts2 框 架 集 成 的 实例 。 

e Struts 2 + Spring + Quartz 计划 程序 集成 示例 Spring + Struts 2 + Quartz 集 成 
实例 

e Struts 2 + Spring + Hibernate 集 成 实例 Spring+Struts2+Hibernate 的 集成 实 
例 。 


Spring 问答 


e 7.3、= 资源 捆绑 ResourceBundleMessageSource 示 例 
ResourceBundleMessageSource 解 决 文本 信息 在 不 同 地 区 的 最 常见 类 。 

e 7.4、 访 问 MessageSource 的 bean (MessageSourceAware) 一 个 例子 来 说 明 
如 何 经 由 MessageSourceAware 接口 的 bean 得 到 MessageSource。 

e 资源 加 载 程序 的 getResource() 示 例 Spring 资 源 加 载 器 提供 了 一 个 非常 通用 的 
getResource () 方法 来 从 文件 系统 ， 类 路 径 或 URL 得 到 这 样 的 资源 (MAK 
件 ， 媒 体 文件 ， 图 像 文 件 …) 。 


Spring? Wik 
一 些 Spring 常见 的 错误 消息 : 


Cannot proxy target class because CGLIB2 is not available 

CGLIB is required to process @Configuration classes 
java.lang.ClassNotFoundException: org.exolab.castor.xml.XMLException 
java.lang.ClassNotFoundException: org.apache.xml.serialize.XMLSerializer 


Spring 参考 


e Spring Framework (Wiki) 
e Spring 官方 文档 
e Spring 3.0 文 档 


Spring hello world 实 例 - Spring 教程 


本 教程 介绍 如 何在 Spring3 中 创建 一 个 简单 的 Hello World 例子 。 在 这 篇 文章 中 使 
用 的 技术 或 工具 : 


1. Spring 3.1 
2. MyEclipse 10 
3. JDK 1.6 


提示 : Spring 3 至 少 JDK1.5 才 能 正常 工作 。Spring 3.0 dependencies 在 Spring2.5.x 
中 ， 几 乎 整个 Spring 模块 分 组 在 一 个 单独 的 spring.jar 文件 中 。 由 于 Spring3 中 每 模 
块 被 分 成 一 个 单独 的 jar 文件 ， 例 如 ，spring-core, spring-expression, spring- 
context, spring-aop 等 


1. 创建 一 个 Java 工 程 


TutorialsPoint Java 技术 教程 


打开 创建 一 个 java 工 程 : Helloword， 并 添加 Spring 支持 类 库 ， 右 键 工 程 
has i£" M Eclipse"- ->"Add Spring Capabilites"， 如 下 图 : 


| Add Spring Capabilities 
Add MyEclipse Spring and User libraries to project 


Spring version: © Spring 1.2 © Spring 2.0 © Spring 2.5 © Spring 3.0 ® Spring 3.1 








Select the libraries to add to the buildpath 


ipse-Library £ 
Spring 3.1 Persistence Libraries - <MyEclipse-Library= 
Spring 3.1 Web Libraries - <MyEclipse-Library= 
Spring 3.1 Testing Support Libraries - <MyEclipse-Library= 
ds Security 3.1 - <MyEclipse-Library= 


sas 8 rt 所 所 ad aa ge a | 











JAR Library Installation 
@ Add checked Libraries to project build-path 
© Copy checked Library contents to project folder (TLDs always copied) 





Library Folder: <no jars/zips i in selected libraries> | | Browse... 





Tag Library Installation 





Tag Library Folder: | <no taglibs in selected libraries> | | Browse... 

















2. Spring bean 


一 个 简单 的 Spring bean. 
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package com.yiibai.core; 


[rita 
* Spring bean 


ay, 
public class Helloworld { 
private String name; 


public void setName(String name) { 
this.name = name; 


j 

public void printHello() (1 
System.out.println("Spring 3 : Hello ! " + name); 

j 


4. Spring bean 配置 文件 


创建 Spring 配置 文件 ， 并 声明 所 有 可 用 的 Spring bean. 


File : _applicationContext.xml_ 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-3.0.x: 


«bean id="helloBean" class="com.yiibai.core.HelloWorld"> 
<property name="name" value="Yiibai" /> 
</bean> 


</beans> 


4 ae | 





5. 项 目 结 构 


查看 目录 结构 如 下 : 


TutorialsPoint Java Tx ZU 


EË Helloword 
(B src 
8 com yiibai.core 
(J) Appjava 
BË HelloWorld.java 
45 applicationContext.xml 
mA JRE System Library [Sun JDK 1.6.0 13] 
BA Spring 3.1 Core Libraries 
b org.springframework.aop-3.1.1.RELEASE jar - D:\Program Files (x86) MyE 
b org.springframework.asm-3.1.1.RELEASE jar - D:\Program Files (x86) MyE 
b org.springframework.aspects-3.1.1.RELEASE jar - D:\Program Files (x86) 





bw org.springframework.beans-3.1.1.RELEASE jar - D:\Program Files 





(wa org.springframework.context-3.1.1.RELEASE jar - D:\Program Files (x86) 
b org.springframework.context.support-3.1.1.RELEASE jar - D:\Program File 
m org.springframework.core-3.1.1.RELEASE jar - D:\Program Files (x86) Myt 
bx org.springframework.expression-3.1.1.RELEASE jar - D:\Program Files (x8 
b org.springframework.instrument-3.1.1.RELEASE jar - D:\Program Files (x8 


b org.springframework.instrument.tomcat-3.1.1.RELEASE jar - D:\Program F 


= D L . . . 
pe aopalliance-1.0.jar - D:\Program Files ( 


86)\MyEclipse\MyEclipse 10\confi 






(3 aspectjweaver-1.6.9jar - D:\Program Files (x86)\MyEclipse\MyEclipse 10\ 








Im cglib-nodep-2.2,jar - D:\Program Files (x86)\MyEclipse\MyEclipse 10\con 
(3 commons-pool-1.5.3,jar - D:\Program Files (x86)\MyEclipse\MyEclipse 10 





(aa commons-collections-3.2,jar - D:\Program Files (x86)\MyEclipse\MyEclips 
(3 commons-logging-1.1.1,jar - D:\Program Files (x86)\MyEclipse\MyEclipse 


(org log4j-1.2.16jar - D:\Program Files (x86)\MyEclipse\MyEclipse 10\configur 


6. 执行 代码 


package com.yiibai.core; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App ( 
public static void main(String[] args) ( 
ApplicationContext context - new ClassPathXmlApplicationCor 
"applicationContext.xml"); Helloworld obj = (Hello 
obj.printHello(); 





T. 输出 结果 


Spring 3 : Hello ! Yiibai 





TutorialsPoint Java 技术 教程 


下 载 源 代 码 


http://pan.baidu.com/s/1qWZQoPm 


Spring hello world 实 例 - Spring 教程 2629 


Spring 松 耦 合 实例 - Spring 教程 


面向 对 象 的 概念 ， 是 一 个 很 好 的 设计 来 打破 系统 进入 一 个 组 可 重用 的 对 象 。 然 而 ， 
当 系 统 变 大 ， 九 其 是 在 Java 项 目 ， 上 庞大 的 对 象 依赖 关系 将 一 直 紧 密 耦 合 引起 对 象 难 
以 管理 或 修改 。 在 这 种 情况 下 ， 可 以 使 用 Spring 框架 作为 一 个 核心 模块 轻松 高 效 地 
管理 所 有 的 对 象 依赖 。 


输出 生成 妖 的 例子 


让 我 们 来 看 一 个 例子 ， 假 设 你 的 项 目 有 一 个 函数 输出 的 内 容 ， 以 CSV 或 JSON 格 
式 。 您 的 代码 可 能 看 起 来 像 下 面 的 例子 : 


File : lOutputGenerator.java — 输出 生成 器 接口 


package com.yiibai.output; 
public interface IOutputGenerator 


public void generateOutput(); 


File : CsvOutputGenerator.java — 一 个 CSV 输 出 生成 器 用 来 实现 IOutputGenerator 
接口 。 


package com.yiibai.output.impl; 
import com.yiibai.output.IOutputGenerator; 
public class CsvOutputGenerator implements IOutputGenerator 


public void generateOutput(){ 
System.out.println("Csv Output Generator"); 
j 


File : JsonOutputGenerator.java — 一 个 JSON 输 出 生成 器 用 来 实现 
IOutputGenerator 接 口 。 


package com.yiibai.output.impl; 
import com.yiibai.output.IOutputGenerator; 
public class JsonOutputGenerator implements IOutputGenerator 


{ 
public void generateOutput(){ 


System.out.println("Json Output Generator"); 
} 


有 几 个 方法 来 调用 IOutputGenerator， 以 及 如 何 使 用 Spring 来 避免 对 象 相互 结合 紧 
密 。 


1. 方法 1 - 直接 调用 
正常 的 方式 ， 直 接 调 用 它 。 


package com.yiibai.common; 


import com.yiibai.output.IOutputGenerator; 
import com.yiibai.output.impl.CsvOutputGenerator; 


public class App 


public static void main( String[] args ) 


{ 
IOutputGenerator output = new CsvOutputGenerator(); 
output.generateOutput(); 
j 
j 
存在 问题 


以 这 种 方式 ， 这 个 问题 是 “output”" 紧 密 到 CsvOutputGenerator 厢 合 ， 输 出 生成 的 每 
一 个 变化 可 能 涉及 代码 变化 。 如 果 此 代码 分 散在 你 的 项 目 中 ， 输 出 生成 的 每 一 次 变 
化 都 会 让 你 受苦 。 


方法 2 - 用 辅助 类 调用 它 


可 能 想 创建 一 个 辅助 类 将 所 有 输出 实现 在 类 的 内 部 。 


package com. yiibai.output; 


import com.yiibai.output.IOutputGenerator; 
import com.yiibai.output.impl.CsvOutputGenerator; 


public class OutputHelper 


{ 
IOutputGenerator outputGenerator; 
public OutputHelper(){ 
outputGenerator - new CsvOutputGenerator(); 
j 
public void generateOutput(){ 
outputGenerator.generateOutput(); 
j 
j 
通过 辅助 类 调用 它 


package com.yiibai.common; 
import com.yiibai.output.OutputHelper; 


public class App 


{ 
public static void main( String[] args ) 
{ 
OutputHelper output = new OutputHelper(); 
output.generateOutput(); 
j 
} 
存在 问题 


这 看 起 来 比 之 前 的 更 优雅 ， 只 需要 管理 一 个 辅助 类 ， 但 是 辅助 类 仍 是 紧 耦 合 
CsvOutputGenerator， 输 出 生成 的 每 一 个 变化 仍然 涉及 小 的 代码 更 改 。 


方法 3 -~ Spring 


在 这 种 情况 下 ，Spring 依赖 注入 (DI) 是 一 个 不 错 的 选择 。Spring 可 以 让 输出 生成 松 
散 的 耦合 到 输出 发 生 器 。OutputHelper 类 更 小 的 修改 。 


package com. yiibai.output; 
import com.yiibai.output.IOutputGenerator; 


public class OutputHelper 


{ 
IOutputGenerator outputGenerator; 
public void generateOutput()( 
outputGenerator.generateOutput(); 
} 
public void setOutputGenerator(IOutputGenerator outputGenerato! 
this.outputGenerator - outputGenerator; 
} 
} 





创建 一 个 Spring bean 的 配置 文件 ， 并 在 这 里 声明 所 有 的 Java 对 象 的 依赖 。 


<!-- Spring-Common.xml --> 

«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd'» 


«bean id="OutputHelper" class="com.yiibai.output.OutputHelper": 
«property name-"outputGenerator" ref="CsvOutputGenerator" , 
</bean> 


<bean id="CsvOutputGenerator" class-'com.yiibai.output.impl.Cs| 
<bean id="JsonOutputGenerator" class="com.yiibai.output.impl. Js 


</beans> 
i a | 


通过 Spring 来 调用 它 





package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.output.OutputHelper; 
public class App 


public static void main( String[] args ) 


{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Sprinc 
OutputHelper output = (OutputHelper)context.getBean("Output 
output.generateOutput(); 
} 





现在 ， 只 需要 改变 Spring XML 文件 使 用 不 同 的 输出 生成 器 。 只 修改 Spring XML 
文件 而 不 需要 无 码 修 改 ， 这 意味 着 更 少 的 错误 。 


结论 


有 了 Spring 框架 - 这 种 依赖 注入 (D1) 为 对 象 的 依赖 关系 管理 有 用 的 特性 ， 使 大 型 
Java 项 目 开 发 管理 中 更 优雅 的 ， 高 度 灵 活 和 便于 维护 。 


Spring JavaConfig 实 例 - Spring 教程 


从 Spring 3 起 ，JavaConfig 功 能 已 经 包含 在 Spring 核心 模块 ， 它 允许 开发 者 将 bean 
定义 和 在 Spring 配置 XML 文件 到 Java 类 中 。 但 是 ， 仍 然 允 许 使 用 经 典 的 XML 方式 来 
定义 bean 和 配置 ，JavaConfig 是 另 一 种 蔡 代 解决 方案 。 看 来 看 经 典 的 XML 定义 和 

JavaConfig 的 不 同 ， 如 下 定义 在 Spring 容器 中 的 bean。 


Spring XML file - applicationContext.xml : 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x: 
«bean id="helloBean" class-"com.yiibai.hello.impl.HelloWorldIm[ 

</beans> 


JETE 
等 效 于 以 下 JavaConfig 的 配置 : 





package com.yiibai.config; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import com.yiibai.hello.HelloWorld; 

import com.yiibai.hello.impl.HelloworldImpl; 


QConfiguration 
public class AppConfig ( 


@Bean(name="helloBean" ) 

public HelloWorld helloworld() { 
return new HelloWworldImpl(); 

j 


Spring JavaConfig Hello World 


现在 ， 看 到 一 个 完整 的 Spring JavaConfig 例 子 。 


1. 工程 目录 结构 


这 个 例子 的 目录 结构 如 下 。 


3. Spring Bean 
一 个 简单 的 Bean 


package com.yiibai.hello; 
public interface HelloWorld { 


void printHelloworld(String msg); 


package com.yiibai.hello.impl; 
import com.yiibai.hello.HelloWorld; 
public class HelloworldlImpl implements HelloWorld { 


@Override 
public void printHelloWorld(String msg) { 


System.out.println("Hello : " + msg); 


4. JavaConfig 注解 


使 用 (Configuration 注释 告诉 Spring， 这 是 核心 的 Spring 配置 文件 ， 并 通过 
@Bean 定义 bean。 


package com. yiibai.config; 


import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import com.yiibai.hello.HelloWorld; 

import com.yiibai.hello.impl.HelloworldImpl; 


QConfiguration 
public class AppConfig { 


@Bean(name="helloBean" ) 


public HelloWorld helloworld() { 
return new HelloWworldImpl(); 


j 


5. 执行 结 来 
使 用 AnnotationConfigApplicationContext 加 载 您 的 JavaConfig 类 


package com.yiibai.core; 


import org.springframework.context.ApplicationContext; 

import org.springframework.context.annotation.AnnotationConfigAppl: 
import com.yiibai.config.AppConfig; 

import com.yiibai.hello.HelloWorld; 


public class App ( 
public static void main(String[] args) { 


ApplicationContext context = new AnnotationConfigAppli« 
Helloworld obj = (HelloWorld) context.getBean("helloBean"), 


obj.printHelloworld("Spring Java Config"); 





输出 结果 


Hello : Spring Java Config 


FRR — http://pan.baidu.com/s/1kT ToPSF 


Spring JavaConfig @Import 4 - Spring 教程 


一 般 来 说 , 需要 按 模块 或 类 别 分 割 Spring XML bean (+ 成 多 个 小 文件 , 使 事情 更 容 
易 维 护 和 模块 化 。 例如 ， 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


«import resource="config/customer .xml"/> 
«import resource-"config/scheduler.xml"/» 


«/beans» 





Spring3 JavaConfig 它 等 效 于 @Import 功能 


package com.yiibai.config; 


import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 


@Configuration 
@Import({ CustomerConfig.class, SchedulerConfig.class }) 
public class AppConfig { 


j 


@Import = fl 


请 参阅 使 用 JavaConfig @Import 的 一 个 完整 的 例子 。 


1. 目录 结构 


本 实例 目录 结构 。 


2. Spring Beans 


两 个 简单 的 Spring bean. 


File : CustomerBo.java 


package com.yiibai.core; 
public class CustomerBo { 
public void printMsg(String msg) { 


System.out.println("CustomerBo : " + msg); 


File : SchedulerBo.java 


package com.yiibai.core; 
public class SchedulerBo { 
public void printMsg(String msg) { 


System.out.println("SchedulerBo : " + msg); 


3. @Configuration 示 例 


现在 ， 使 用 JavaConfig @Configuration 声 明 上 述 Bean 类 。 


File : CustomerConfig.java 


package com.yiibai.config; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 


import com.yiibai.core.CustomerBo; 


QConfiguration 
public class CustomerConfig { 


@Bean(name="Customer" ) 
public CustomerBo customerBo(){ 


return new CustomerBo(); 


File : SchedulerConfig.java 


package com.yiibai.config; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import com.yiibai.core.SchedulerBo; 


QConfiguration 
public class SchedulerConfig ( 


@Bean(name="scheduler" ) 
public SchedulerBo suchedulerBo(){ 


return new SchedulerBo(); 


4. @lmport7 f/l 


使 用 @Import 加 载 多 个 配置 文件 。 
File : AppConfig.java 


package com.yiibai.config; 


import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 


QConfiguration 
@Import({ CustomerConfig.class, SchedulerConfig.class }) 
public class AppConfig { 


j 


5. 执行 程序 


加 载 主 配置 文件 ， 并 进行 测试 。 


package com.yiibai.core; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.annotation.AnnotationConfigAppl: 
import com.yiibai.config.AppConfig; 


public class App { 
public static void main(String[] args) { 


ApplicationContext context = new AnnotationConfigApplicatic 
AppConfig.class); 


CustomerBo customer = (CustomerBo) context.getBean("custome 
customer .printMsg("Hello 11"); 


SchedulerBo scheduler = (SchedulerBo) context.getBean("sche 
scheduler.printMsg("Hello 22"); 





输出 结果 


CustomerBo : Hello 11 
SchedulerBo : Hello 22 


FRR — http://pan.baidu.com/s/1basJTk 


Spring 依赖 注入 (DI - Spring 教程 


Ep 依赖 注入 (DJ) 的 设计 模式 是 用 来 定义 对 象 彼此 间 的 依赖 。 它 主要 
两 种 类 型 : 


e Setter 方 法 注入 
e 构造 器 注入 


1. Setter 方 法 注入 

这 是 最 流 J 最 简 单 的 DI 注 入 方法 ， 过 设 受 置 方法 注入 依赖 。 
示例 

帮助 器 类 和 指定 的 setter 方 法 


package com.yiibai.output; 
import com.yiibai.output.IOutputGenerator; 


public class OutputHelper 


{ 
IOutputGenerator outputGenerator; 
public void setOutputGenerator(IOutputGenerator outputGenerato! 
this.outputGenerator - outputGenerator; 
} 
} 


Me SSS ase 
一 个 bean 配置 文件 用 来 声明 bean 和 通过 setter 设置 注入 (property 标 签 ) 的 依赖 。 





«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


«bean id="OutputHelper" class="com.yiibai.output.OutputHelper": 
«property name="outputGenerator"> 
«ref bean="CsvOutputGenerator" /> 
</property> 
</bean> 


«bean id="CsvOutputGenerator" class-'com.yiibai.output.impl.CsvOut[ 
«bean id="JsonOutputGenerator" class="com.yiibai.output.impl.Jsonot 


</beans> 


E = ae 





只 需 注 入 一 个 “CsvOutputGenerator bean 到 “OutputHelper xt Z, 一 个 setter 
方法 (setOutputGenerator)。 


2.4416 EN BE 

此 DI 方法 将 通过 构造 画 数 注入 依赖 。 
示例 

一 个 辅助 类 的 构造 加 数 。 


package com.yiibai.output; 
import com.yiibai.output.IOutputGenerator; 


public class OutputHelper 


{ 

IOutputGenerator outputGenerator; 
OutputHelper(IOutputGenerator outputGenerator)( 
this.outputGenerator - outputGenerator; 

Jj 

y 


bean MEXR Ps HBbean3t38 it 478 PRX (constructor-arg4z Z )i tA io 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


«bean id-"OutputHelper" class="com.yiibai.output.OutputHelper": 
«constructor-arg» 
«bean class="com.yiibai.output.impl.CsvOutputGenerator' 
«/constructor-arg» 
«/bean» 


«bean id="CsvOutputGenerator" class-'com.yiibai.output.impl.CsvOut[ 
«bean id="JsonOutputGenerator" class="com.yiibai.output.impl.Jsonot 


</beans> 





setter Kit EMER A ? 


Spring 框 架 的 设置 有 没有 硬性 规定 ， 只 需要 使 用 适合 你 的 项 目 需 要 的 类 型 注入 。 然 
而 ， 由 于 setter 方 法 注入 简单 ， 它 总 是 大 部 分 使 用 场景 的 选择 。 


参考 


1. http://en.wikipedia.org/wiki/Dependency_injection 


Spring (= Fi Setterik m5E A - Spring 教程 


一 个 简单 的 Spring 例子 来 展示 如 何 通过 setter 方 法 注入 依赖 项 ， 最 常用 DI 方 法 注入 
bean. 


1. lOutputGenerator 
接口 和 实现 类 


package com.yiibai.output; 


public interface IOutputGenerator 


i 
} 


public void generateOutput(); 


package com.yiibai.output.impl; 
import com.yiibai.output.IOutputGenerator; 
public class CsvOutputGenerator implements IOutputGenerator { 


public void generateOutput() { 
System.out.println("This is Csv Output Generator"); 
} 


2. Helper # 


一 个 辅助 类 ， 之 后 使 用 Spring 来 注入 IOutputGenerator。 


package com. yiibai.output; 
import com.yiibai.output.IOutputGenerator; 


public class OutputHelper { 
IOutputGenerator outputGenerator; 


public void generateOutput() ( 
outputGenerator.generateOutput(); 
j 


//DI via setter method 
public void setOutputGenerator(IOutputGenerator outputGenerato! 
this.outputGenerator - outputGenerator; 





3. Spring 配置 


配置 Bean 在 Spring 配置 文件 ， 并 引用 Bean“CsvOutputGenerator 到 
“OutputHelper"， 通 过 property 和 ref 标签 。 


在 这 种 情况 下 ，Spring 将 通过 setter 方 法 注入 Bean "CsvOutputGenerator" 
#1|“OutputHelper’ #, "setOutputGenerator(lOutputGenerator outputGenerator)". 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x; 


«bean id-"OutputHelper" class="com.yiibai.output.OutputHelper": 
«property name="outputGenerator" ref="CsvOutputGenerator" , 
«/bean» 


«bean id="CsvOutputGenerator" class-'com.yiibai.output.impl.Cs| 


«/beans» 


| un m 





4. 执行 结 来 


载 人 一 切 东 西 ， 并 运行 它 。 


package com. yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 
import com.yiibai.output.OutputHelper; 


public class App ( 
public static void main(String[] args) { 
ApplicationContext context - new ClassPathXmlApplicationCor 
"applicationContext.xml"); OutputHelper output = (( 
output.generateOutput(); 





输出 结果 


This is Csv Output Generator 


下 载 源 代码 - http://pan.baidu.com/s/1c1tR6ZQ 


Spring 通过 法 依赖 注入 - Spring 教程 


使 用 Spring 进 行 依赖 ， 通 过 构造 画 数 注入 一 个 bean。 


1. lOutputGenerator 
接口 和 实现 类 


package com.yiibai.output; 
public interface IOutputGenerator 


public void generateOutput(); 


package com.yiibai.output.impl; 
import com.yiibai.output.IOutputGenerator; 
public class JsonOutputGenerator implements IOutputGenerator 


public void generateOutput(){ 
System.out.println("This is Json Output Generator"); 
j 


2. Helper # 


一 个 辅助 类 ， 之 后 使 用 Spring 通过 构造 方法 注入 IOutputGenerator, 


package com. yiibai.output; 
import com.yiibai.output.IOutputGenerator; 


public class OutputHelper { 
IOutputGenerator outputGenerator; 


public void generateOutput() ( 
outputGenerator.generateOutput(); 
j 


//DI via constructor 
public OutputHelper(IOutputGenerator outputGenerator){ 
this.outputGenerator - outputGenerator; 


j 


3. Spring 配置 


请 参阅 下 面 的 Spring bean 配置 ，Spring 将 通过 构造 函数 注入 上 面 的 
“JsonOutputGenerator 到 “OutputHelper #, “public 
OutputHelper(IOutputGenerator outputGenerator) . 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 


xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x; 


«bean id="OutputHelper" class="com.yiibai.output.OutputHelper": 


<constructor -arg> 
<ref bean="JsonOutputGenerator" /> 
</constructor -arg> 
</bean> 


<bean id="JsonOutputGenerator" class="com.yiibai.output.impl. Js 


</beans> 


OSS 


4. 执 行 结 来 


载 入 一切 东西 ， 并 运行 它 。 





package com. yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 
import com.yiibai.output.OutputHelper; 


public class App ( 
public static void main(String[] args) { 
ApplicationContext context - new ClassPathXmlApplicationCor 
"applicationContext.xml"); OutputHelper output = (( 
output.generateOutput(); 





输出 结果 


This is Json Output Generator 


ED AŽ MRL FAENA RSDB, RFRA AEEA GE ESL 
问题 ， 请 阅读 详细 的 解决 方案 。 下 载 代 码 - http:/pan.baidu.com/s/1skwOPqd 


Spring Bean 引 用 例子 - Spring 教程 


在 Spring，bean 可 以 “访问 ”对方 通过 bean 配 置 文件 指定 相同 或 不 同 的 引用 。 


1. Bean 在 不 同 的 XML 文件 
如 果 是 在 不 同 XML 文 件 中 的 bean， 可 以 用 一 个 “ref "标签 , “bean" 属 性 引用 它 。 


«ref bean="someBean"/> 


“CsvOutputGenerator" 或 “JsonOutputGenerator" 通 过 属性 标签 使 用 'ref 属 性 ， -在 
这 个 例子 中 ，Bean "OutputHelper" 在 'Spring-Common.xml' 声明 可 以 访问 其 他 
Bean 在 'Spring-Output.xml'。 


File : Spring-Common.xml 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="OutputHelper" class="com.yiibai.output.OutputHelper": 
<property name="outputGenerator" > 
<ref bean="CsvOutputGenerator"/> 
</property> 
</bean> 


</beans> 





File : Spring-Output.xml 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="CsvOutputGenerator" class-'com.yiibai.output.impl.Cs| 
«bean id="JsonOutputGenerator" class="com.yiibai.output.impl. Js 


</beans> 


«| um 








2. 在 同一 个 XML 文件 中 的 Bean 
如 果 引 用 在 同一 个 XML 文件 中 的 bean， 你 可 以 用 'ref 标签 , “local" 属 性 引用 它 。 


«ref local="someBean"/> 


在 这 个 例子 中 ，Bean "OutputHelper" f£ 'Spring-Common.xml' 声明 可 以 相互 访 
问 “CsvOutputGenerator” 或 “JsonOutputGenerator”。 


File : Spring-Common.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 


xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="OutputHelper" class="com.yiibai.output.OutputHelper": 
<property name="outputGenerator" > 
«ref local="CsvOutputGenerator"/> 
</property> 
</bean> 


«bean id="CsvOutputGenerator" class="com.yiibai.output.impl.Cs\ 
<bean id="JsonOutputGenerator" class="com.yiibai.output.impl. Js 


</beans> 





无 论 是 在 相同 或 不 同 的 XML 文件 , "ref" 标签 可 以 访问 一 个 bean， 但 是 ， 对 于 


i B 的 可 读 性 ， 如 果 引 用 了 相同 的 XML 文件 中 声明 bean, 18 js iz 8 FH" local" E 


如 何 注 入 值 到 Spring bean 属 性 - Spring 教程 


在 Spring 中 ， 有 三 种 方式 注入 值 到 bean 属性 。 


e 正常 的 方式 

。 快捷 方式 

e “p” 模式 
看 到 一 个 简单 的 Java 类 ， 它 包含 两 个 属性 - name 和 type。 稍 后 将 使 用 Spring 注 和 人 
值 到 这 个 bean 属性 。 

package com.yiibai.common; 

public class FileNameGenerator 

{ 

private String name; 


private String type; 


public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 


} 
public String getType() { 
return type; 


public void setType(String type) { 
this.type = type; 
} 


1. 正 弟 方 式 


在 一 个 "value" 标 签注 入 值 ， 并 附 有 “property" 标 签 结 束 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"FileNameGenerator" class-"com.yiibai.common.FileName( 
«property name="name"> 
<value>yiibai</value> 


</property> 
<property name="type"> 
<value>txt</value> 
</property> 
</bean> 
</beans> 


a an 


2, RREAK 


注入 值 “value" 属 性 。 





«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"FileNameGenerator" class-"com.yiibai.common.FileName( 
«property name="name" value="yiibai" /> 
<property name="type" value="txt" /> 

</bean> 


</beans> 


EJE) 





3. “p” 模式 
通过 使 用 "p" 模 式 作 为 注入 值 到 一 个 属性 。 


«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:pz"http://www.springframework.org/schema/p" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="FileNameGenerator" class-"com.yiibai.common.FileName( 
p:name="yiibai" p:type="txt" /> 


</beans> 


«| m 








记 住 声明 xmlns:p-"http://www.springframework.org/schema/p" 在 Spring XML 
bean 配 置 文件 。 


这 g+ 
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这 些 方法 的 使 用 完全 是 基于 个 人 喜好 ， 也 不 会 影响 注 和 人 bean 属性 的 值 。 


Spring bean 加 载 多 个 配置 文件 - Spring 教程 


在 一 个 大 的 项 目 结构 ，Spring bean 配 置 文件 位 于 不 同 的 文件 夹 以 便于 维护 和 模块 

化 。 例 如 ，Spring-Common.xml 在 common Xt 3: rh, Spring-Connection.xml 在 
connection XF 3, Spring-ModuleA.xmlf£ModuleA 文件 夹 等 等 。 你 可 以 加 载 多 个 
Spring bean 的 配置 文件 如 下 代码 中 : 


ApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Spring-Cc 
"Spring-Connection.xml","Spring-ModuleA.xml")); 


a — — HE 
把 所 有 的 Spring XML 文件 放 入 在 项 目 类 路 径 中 。 





project-classpath/Spring-Common.xml 
project-classpath/Spring-Connection. xml 
project-classpath/Spring-ModuleA. xml 


解决 方法 


以 上 方法 是 缺乏 组 织 并 且 很 容易 出 错 ， 更 好 的 办 法 应 组 织 所 有 的 Spring bean 配置 
文件 到 一 个 XML 文 件 。 例 如 ， 创 建 一 一 个 Spring -All-Module.xml 文 件 ， 并 导入 整个 
Spring bean 的 文件 如 下 : File : Spring-All-Module.xml 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x; 


«import resource="common/Spring-Common. xm1"/> 
«import resource-"connection/Spring-Connection.xml"/» 
«import resource-"moduleA/Spring-ModuleA.xml"/» 
</beans> 


人 
现在 ， 可 以 加 载 一 个 这 样 的 XML 文件 : 





ApplicationContext context = 
new ClassPathXmlApplicationContext(Spring-All-Module. xr 








将 这 个 文件 放 和 人 项 目的 类 路 径 。 


project-classpath/Spring-All-Module. xml 


注意 在 Spring3， 所 述 蔡 代 解 决 方案 是 使 用 JavaConfig @lmport. 


Spring 内 部 bean 实 例 - Spring 教程 


在 Spring 框架 中 ， 一 个 bean 仅 用 于 一 个 特定 的 属性 ， 这 是 提醒 其 声明 为 一 个 内 部 
bean。 内 部 bean 支 持 setter 注 入 “property”" 和 构造 器 注入 "constructor-arg“。 下 面 来 
看 看 一 个 详细 的 例子 ， 演 示 使 用 Spring 内 部 bean 。 


package com.yiibai.common; 


public class Customer 


private Person person; 


public Customer(Person person) { 
this.person = person; 
} 


public void setPerson(Person person) { 
this.person = person; 
} 


@Override 
public String toString() { 

return "Customer [person-z" + person + "]"; 
} 


package com.yiibai.common; 


public class Person 


{ 


private String name; 
private String address; 
private int age; 


//getter and setter methods 


@Override 
public String toString() { 
return "Person [address=" + address + ", 
age-" + age + ", name=" + name + "]' 


} 
«| —X D 


很 多 时 候 ， 可 以 使 用 'ref 属性 来 引用 “Person” bean 到 “Customer” Bean, personffj 
属性 如 下 : 





«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"CustomerBean" class-'com.yiibai.common.Customer"- 
«property name="person" ref="PersonBean" /> 
</bean> 


<bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="addressi" /> 
<property name="age" value="28" /> 

</bean> 


</beans> 
回 寺 于 于 > 壮 计 = 


在 一 般 情 况 下 ， 引 用 这 样 也 没有 问题 ， 但 由 于 “yiibai” persion bean 只 用 于 
Customer bean， 这 是 更 好 地 声明 “yiibaij” person 作为 一 个 内 部 bean， 如 下 : 





<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x; 


«bean id="CustomerBean" class-'com.yiibai.common.Customer"- 
«property name="person"> 
<bean class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="addressi" /> 
<property name="age" value="28" /> 
</bean> 
</property> 
</bean> 
</beans> 


1 上 上 上 上 Á.[ 
内 部 bean 也 支持 构造 器 注入 如 下 : 





«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="CustomerBean" class-'com.yiibai.common.Customer"- 
«constructor-arg» 
«bean class="com.yiibai.common.Person"> 
«property name="name" value="yiibai" /> 
<property name="address" value="addressi" /> 
<property name="age" value="28" /> 
</bean> 
</constructor -arg> 
</bean> 
</beans> 


剧 = [- 





注意 : id 或 name 值 在 bean 类 是 没有 必要 以 一 个 内 部 bean 呈现 ， 它 会 简单 地 忽略 
Spring 容 器 。 


执行 结果 : 


package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Spring- 
Customer cust = (Customer )context.getBean("CustomerBean" ); 
System.out.println(cust); 
} 
} 





输出 结果 : 


Customer [person=Person [address=address1, age-28, name=yiibai] ] 


Spring Bean 作 用 域 实例 - Spring 教程 


在 Spring 中 ，bean 作 用 域 用 于 确定 哪 种 类 型 的 bean 实例 应 该 从 Spring 容器 中 返回 
给 调用 者 。bean 支 持 的 5 种 范围 域 : 


. 单 例 - 每 个 Spring loC 容器 返回 一 个 bean 实 例 
原型 - 当 每 次 请 求 时 返回 一 个 新 的 bean 实 例 

. 请 求 - 返回 每 个 HTTP 请 求 的 一 个 Bean 实 例 

. 会 话 - 返回 每 个 HTTP 会 话 的 一 个 bean 实 例 

. 全 局 会 话 - 返回 全 局 HTTP 会 话 的 一 个 bean 实 例 


在 大 多 数 情 况 下 ， 可 能 只 义理 了 Spring 的 核心 作用 域 - 单 例 和 原型 ， 默 认 作 用 域 是 
单 例 。 注 : 意味 着 只 有 在 一 个 基于 web 的 Spring ApplicationContext 情 形 下 有 效 ! 


ORWN = 


单 例 VS 原型 
这 里 有 一 个 例子 来 说 明 ，bean 的 作用 域 单 例 和 原型 之 间 的 不 同 : 
package com.yiibai.customer.services; 
public class CustomerService 
String message; 


public String getMessage() { 
return message; 
} 


public void setMessage(String message) { 
this.message = message; 


} 


1. 单 例 例子 
如 果 bean 配置 文件 中 没有 指定 bean 的 范围 ， 默 认为 单 例 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customerService" 
class="com.yiibai.customer.services.CustomerService" /: 


«/beans» 








package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Spring-( 
CustomerService custA = (CustomerService)context.getBean("« 
custA.setMessage("Message by custA"); 
System.out.println("Message : " + custA.getMessage( )); 
//retrieve it again 
CustomerService custB = (CustomerService)context.getBean(' 
System.out.println("Message : " + custB.getMessage( )); 
} 
} 





输出 结果 


Message : Message by custA 
Message : Message by custA 


由 于 bean BY “CustomerService’ 是 单 例 作用 域 ， 第 二 个 通过 提取 ”custB“ 将 显示 消 
息 由 "custA' 设置 ， 即 使 它 是 由 一 个 新 的 getBean() 方 法 来 提取 。 在 单 例 中 ， 每 个 
Spring loC 容 器 只 有 一 个 实例 ， 无 论 多 少 次 调用 getBean() 方 法 获取 它 ， 它 总 是 返回 
同一 个 实例 。 





2. 原 型 例子 


如 果 想 有 一 个 新 的 “CustomerService”bean 实例 ， 每 次 调用 它 的 时 候 ， 需 要 使 用 原 
型 (prototype) 来 代替 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customerService" class-'com.yiibai.customer.services.( 
scope-"prototype"/» 


«/beans» 





Message : Message by custA 
Message : null 


在 原型 作用 域 ， 必 须 为 每 个 getBean() 方 法 中 调用 返回 一 个 新 的 实例 。 


3. Bean 作 用 域 注 释 
还 可 以 使 用 注释 来 定义 bean 的 作用 域 。 
package com.yiibai.customer.services; 


import org.springframework.context.annotation.Scope; 
import org.springframework.stereotype.Service; 


@Service 
QScope("prototype") 
public class CustomerService 


( 


String message; 
public String getMessage() ( 


return message; 
j 


public void setMessage(String message) { 
this.message - message; 
} 


启用 自动 组 件 扫描 


«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context-"http://www.springframework.org/schema/context" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
http://www.springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context -2 


«context:component-scan base-package-'com.yiibai.customer" , 


</beans> 


I 





下 载 代码 — http://pan.baidu.com/s/107jxMrg 


Spring (List,Set,Map,Properties) 实例 - 
Spring 教程 


下 面 例子 向 您 展示 Spring 如 何 注入 值 到 集合 类 型 (List, Set, Map, and Properties). 
支持 4 个 主要 的 集合 类 型 : 


List — <list/> 

Set - <set/> 

Map — «map/» 
Properties — «props/» 


Spring beans 
一 个 Customer 对 象 ， 有 四 个 集合 属性 。 


package com.yiibai.common; 


import java.util.List; 
import java.util.Map; 
import java.util.Properties; 
import java.util.Set; 


public class Customer 


{ 
private List<Object> lists; 
private Set<Object> sets; 
private Map<Object, Object> maps; 
private Properties pros; 
/AR 

j 


在 bean 配 置 文件 中 不 同 的 代码 片段 用 来 声明 集合 。 


1. List 示 例 


«property name="lists"> 
<list> 
<value>1</value> 
<ref bean="PersonBean" /> 
<bean class="com.yiibai.common.Person"> 
<property name="name" value="yiibaiList" /> 
<property name="address" value="Hainan" /> 
<property name="age" value="28" /> 
</bean> 
</list> 
</property> 


2. Set 示 例 


«property name="Ssets"> 
<set> 
<value>1</value> 
<ref bean="PersonBean" /> 
<bean class="com.yiibai.common.Person"> 
<property name="name" value="yiibaiSet" /> 
<property name="address" value="Hainan" /> 
<property name="age" value="28" /> 
</bean> 
</set> 
</property> 


3. Mapa fil 


<property name="maps"> 
<map> 
<entry key="Key 1" value="1" /> 
<entry key="Key 2" value-ref="PersonBean" /> 
<entry key="Key 3"> 
<bean class="com.yiibai.common.Person"> 
<property name="name" value="yiibaiMap" /> 
<property name="address" value="Hainan" /> 
<property name="age" value="28" /> 
</bean> 
</entry> 
</map> 
</property> 


4. Properties 


<property name="pros"> 
<props> 
«prop key="admin">admin@yiibai.com</prop> 
«prop key="Support">support@yiibai.com</prop> 
</props> 
</property> 


Spring 完整 的 bean 配置 文件 。 


«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="CustomerBean" class-'com.yiibai.common.Customer"- 


<!-- java.util.List --> 

<property name="lists"> 
<list> 

<value>i</value> 


<ref bean="PersonBean" /> 
<bean class="com.yiibai.common.Person"> 
<property name="name" value="yiibaiList" /> 
<property name="address" value="Hainan Haikou" 
<property name="age" value="28" /> 
</bean> 
</list> 
</property> 


<!-- java.util.Set --> 
«property name="Ssets"> 
<set> 
<value>i</value> 
<ref bean="PersonBean" /> 
<bean class="com.yiibai.common.Person"> 
<property name="name" value="yiibaiSet" /> 
<property name="address" value="Hainan Haikou" 
<property name="age" value="28" /> 


</bean> 
</set> 
</property> 
<!-- java.util.Map --> 
<property name="maps"> 
<map> 


«entry key="Key 1" value="1" /> 
<entry key="Key 2" value-ref="PersonBean" /> 
<entry key="Key 3"> 
<bean class="com.yiibai.common.Person"> 
<property name="name" value="yiibaiMap" /> 
<property name="address" value="Hainan Hail 


<property name="age" value="28" /> 


</bean> 
</entry> 
</map> 
</property> 
<!-- java.util.Properties --> 
<property name="pros"> 
<props> 


«prop key="admin">admin@yiibai.com</prop> 
<prop key="Support">support@yiibai.com</prop> 
</props> 
</property> 


</bean> 


<bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibaii" /> 
«property name="address" value="Hainan Haikou 1" /> 
<property name="age" value="28" /> 

</bean> 


</beans> 





package com. yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = new ClassPathXmlApplicationCor 
Customer cust = (Customer)context.getBean("CustomerBean"); 
System.out.println(cust); 
} 
} 





输出 


Customer [lists=[1, [com.yiibai.common.PersonQ4e4ee70b](mailto:com 


E : 
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Spring ListFactoryBean= 9 - Spring 教程 


ListFactoryBean” 类 为 开发 者 提供 了 一 种 在 Spring 的 bean 配 置 文件 中 创建 一 个 具体 
的 列表 集合 类 (ArrayList 和 LinkedList)。 这 里 有 一 个 ListFactoryBean 示例 ， 在 运行 
时 它 将 实例 化 一 个 ArrayList， 并 注入 到 一 个 bean 属性 。 


package com.yiibai.common; 
import java.util.List; 


public class Customer 
t 
private List lists; 
Ulloa 


Spring bean 配 置 文件 - applicationContext.html 文件 的 内 容 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"CustomerBean" class-'com.yiibai.common.Customer"- 
«property name="lists"> 
«bean class="org.springframework.beans.factory.config.| 
«property name="targetListClass"> 
<value>java.util.ArrayList</value> 


</property> 
«property name="SourceList"> 
<list> 
<value>one</value> 
<value>2</value> 
<value>three</value> 
</list> 
</property> 
</bean> 
</property> 
</bean> 
</beans> 





另外 ， 还 可 以 使 用 util 模式 和 来 达到 同样 的 目的 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:util-"http://www.springframework.org/schema/util" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
http://www.springframework.org/schema/util 
http://www.springframework.org/schema/util/spring-util-2.5.xsd' 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
«property name="lists"> 
<util:list list-class="java.util.ArrayList"> 
<value>one</value> 
<value>2</value> 
<value>three</value> 
</util:list> 
</property> 
</bean> 


</beans> 


SSS SSS] 





WiVEZaw util 模式 ， 否 则 会 出 现下 面 的 错误 


Caused by: org.xml.sax.SAXParseException: 
The prefix "util" for element "util:list" is not bound. 


执行 ， 查 看 结果 : 


package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App { 
public static void main(String[] args) { 
ApplicationContext context - new ClassPathXmlApplicationCor 
"applicationContext.xml"); 


Customer cust = (Customer) context.getBean("CustomerBean"), 
System.out.println(cust); 





Customer [lists-[one, 2, three]] Type=[class java.util.ArrayList ] 


4 —Ó 


在 运行 时 实例 化 ArrayList 并 注入 列表 到 客户 的 属性 。 下 载 代码 — 
http://pan.baidu.com/s/1i4aK26h 











Spring SetFactoryBean {ll - Spring 教程 


SetFactoryBean 类 为 开发 者 提供 了 一 种 可 在 Spring bean 配置 文件 创建 一 个 具体 的 
Sets 5 (HashSet 3 和 TreeSet)。 这 里 有 一 个 ListFactoryBean。 例 如 ， 在 运 a E 
将 实例 化 HashSet， 并 注入 到 一 个 bean 属性 中 。 


package com.yiibai.common; 
import java.util.Set; 


public class Customer 
{ 
private Set sets; 
Se 


Spring 的 bean 配 置 文件 。 


«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"CustomerBean" class-'com.yiibai.common.Customer"- 
«property name="Sets"> 
«bean class-"org.springframework.beans.factory.config.: 
«property name="targetSetClass"> 
<value>java.util.HashSet</value> 


</property> 
«property name="SourceSet"> 
<list> 
<value>one</value> 
<value>2</value> 
<value>three</value> 
</list> 
</property> 
</bean> 
</property> 
</bean> 
</beans> 


TE A] 
另外 ， 还 可 以 使 用 util 的 模式 和 来 做 到 同样 的 事情 。 





«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:util-"http://www.springframework.org/schema/util" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
http://www.springframework.org/schema/util 
http://www.springframework.org/schema/util/spring-util-2.5.xsd' 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
«property name="Ssets"> 
<util:set set-class="java.util.HashSet"> 
<value>one</value> 
<value>2</value> 
<value>three</value> 
</util:set> 
</property> 
</bean> 


</beans> 


al — 





Witte AEN util 模式 ， 否 则 会 出 现下 面 的 错误 : 


Caused by: org.xml.sax.SAXParseException: 
The prefix "util" for element "util:set" is not bound. 


package com. yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = new ClassPathXmlApplicationCor 
Customer cust = (Customer)context.getBean("CustomerBean"); 
System.out.println(cust); 
} 
} 








Customer [sets=[2, one, three]] Type=[class java.util.HashSet ] 


实例 化 HashSet， 在 运行 时 注入 到 客户 的 set 集 合 属 性 。 下 载 代码 - 
http://pan.baidu.com/s/107woxQU 


Spring MapFactoryBean 例 子 - Spring 教程 


MapFactoryBean 类 为 开发 者 提供 了 一 种 在 Spring 的 bean 配 置 文件 中 创建 一 个 具体 
的 Map 集 合 类 (HashMap 和 TreeMap)。 这 里 有 一 个 MapFactoryBean。 例 如 ， 在 运 
行 时 它 将 实例 化 一 个 HashMap， 并 注入 到 一 个 bean 属 性 。 


package com.yiibai.common; 
import java.util.Map; 


public class Customer 
t 
private Map maps; 
L A 


Spring 的 bean 配置 文件 。 


«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x; 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
<property name="maps"> 
«bean class="org.springframework.beans.factory.config.? 
<property name="targetMapClass"> 
<value>java.util.HashMap</value> 
</property> 
«property name-"sourceMap"» 
«map» 
«entry key="Keyi" value="one" /» 
«entry key="Key2" value="two" /» 
«entry key="Key3" value="three" /> 
</map> 
</property> 
</bean> 
</property> 
</bean> 


</beans> 
| 
另外 ， 还 可 以 使 用 util 的 模式 和 来 做 到 同样 的 事情 。 





«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:util-"http://www.springframework.org/schema/util" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
http://www.springframework.org/schema/util 
http://www.springframework.org/schema/util/spring-util-2.5.xsd' 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
<property name="maps"> 
<util:map map-class="java.util.HashMap"> 
«entry key="Keyi" value="1" /> 
<entry key="Key2" value="2" /> 
<entry key="Key3" value="3" /> 
</util:map> 
</property> 
</bean> 


</beans> 


KE ee LLLI SSS 





请 记 住 包 函 util 模 式 ， 否 则 会 出 现下 面 的 错误 


Caused by: org.xml.sax.SAXParseException: 
The prefix "util" for element "util:map" is not bound. 


package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = new ClassPathXmlApplicationCor 
Customer cust = (Customer)context.getBean("CustomerBean"); 
System.out.println(cust); 
} 
} 








Customer [maps={Key2=two, Keyi-one, Key3=three}] 


在 运行 时 实例 化 一 个 HashMap 和 注入 到 客户 的 映射 (Map) 属 性 。 下 载 代码 — 
http://pan.baidu.com/s/1kTXsDoj 


Spring 注入 日 期 到 bean 属 性 -CustomDateEditor - 
Spring 教程 


这 一 个 Spring 例子 向 您 展示 如 何 为 bean 属 性 注入 一 个 “日 期 ” 


package com.yiibai.common; 
import java.util.Date; 
public class Customer { 
Date date; 
public Date getDate() { 


return date; 
} 


public void setDate(Date date) { 
this.date = date; 
} 


@Override 
public String toString() { 

return "Customer [date=" + date + "]"; 
} 


bean 配 置 文件 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customer" class="com.yiibai.common.Customer"> 
<property name="date" value="2015-12-31" /> 
</bean> 


</beans> 





package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App ( 
public static void main(String[] args) ( 
ApplicationContext context - new ClassPathXmlApplicationCor 
"SpringBeans.xml"); 


Customer cust = (Customer) context.getBean("customer"); 
System.out.println(cust); 





可 能 会 遇 到 如 下 错误 信息 : 


Caused by: org.springframework.beans.TypeMismatchException: 
Failed to convert property value of type [java.lang.String] to 
required type [java.util.Date] for property 'date'; 


nested exception is java.lang.IllegalArgumentException: 
Cannot convert value of type [java.lang.String] to 


required type [java.util.Date] for property 'date': 
no matching editors or conversion strategy found 


4 1 
解决 办 法 

在 Spring 中 ， 可 以 通过 两 种 方式 注入 日 期 : 

1. Factory bean 


声明 一 个 dateFormat bean， 在 “customer Bean， 引 用 “dateFormat” bean 作 为 一 
个 工厂 bean。 该 工厂 方法 将 调用 SimpleDateFormat.parse() 自 动 转换 成 字符 串 Date 
对 象 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="dateFormat" class="java.text.SimpleDateFormat"> 
<constructor-arg value="yyyy-MM-dd" /> 
</bean> 


«bean id="customer" class="com.yiibai.common.Customer"> 
<property name="date"> 
<bean factory-bean="dateFormat" factory-method="parse": 
<constructor-arg value="2015-12-31" /> 
</bean> 
</property> 
</bean> 


</beans> 


国定 天 





2. CustomDateEditor 
声明 一 个 CustomDateEditor 类 将 字符 串 转 换 成 java.util.Date。 


<bean id="dateEditor" 
class="org.springframework.beans.propertyeditors.CustomDatel 


<constructor -arg> 
<bean class="java.text.SimpleDateFormat"> 
<constructor-arg value="yyyy-MM-dd" /> 
</bean> 
</constructor -arg> 
<constructor-arg value="true" /> 
</bean> 


E == : 


并 声明 另 一 个 “CustomEditorConfigurer， 使 Spring 转换 bean 属性 ， 其 类 型 为 
java.util.Date。 





«bean class="org.springframework.beans.factory.config.CustomEditor( 
«property name="CustomEditors"> 
<map> 
<entry key="java.util.Date"> 
«ref local="dateEditor" /> 
</entry> 
</map> 
</property> 
</bean> 


到 








bean 配 置 文件 的 完整 例子 (applicationContext.xml)。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="dateEditor" 
class="org.springframework.beans.propertyeditors.CustomDate 


«constructor-arg» 
«bean class="java.text.SimpleDateFormat"> 
«constructor-arg value="yyyy-MM-dd" /> 
</bean> 
</constructor -arg> 
<constructor-arg value="true" /> 


</bean> 


<bean class="org.springframework.beans.factory.config.CustomEd: 
«property name="customEditors"> 
<map> 
«entry key="java.util.Date"> 
«ref local-"dateEditor" /> 
</entry> 
</map> 
</property> 
</bean> 


«bean id="customer" class="com.yiibai.common.Customer"> 
<property name="date" value="2015-12-31" /> 
</bean> 
</beans> 


HE = 
FARA - http://pan.baidu.com/s/1bxZyfO 





Spring PropertyPlaceholderConfigurer 3: {|| - 
Spring 教程 


很 多 时 候 ， 大 多 数 Spring 开发 人 员 只 是 把 整个 部 署 的 详细 信息 (数据 库 的 详细 信息 ， 
日 志文 件 的 路 径 ) 写 在 XML bean 配 置 文件 如 下 : 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customerDAO" class="com.yiibai.customer.dao.impl. Jdb¢ 


<property name="dataSource" ref="dataSource" /> 
</bean> 


<bean id-"customerSimpleDAO" class="Ccom.yiibai.customer .dao. im 


<property name="dataSource" ref="dataSource" /> 
</bean> 


<bean id="dataSource" 
class="org.springframework.jdbc.datasource.DriverManagerDat 


«property name-"driverClassName" value="com.mysql.jdbc.Dri\ 
«property name-"url" value-z"jdbc:mysql://localhost:3306/yi: 
«property name="username" value="root" /» 
«property name="password" value="password" /> 

</bean> 


</beans> 


但 是 ， 在 企业 环境 中 ， 部 署 的 细节 通常 只 可 以 由 系统 管理 员 或 数据 库 管 理 员 来 ' 触 
碰 '， 他 们 可 能 会 拒绝 直接 访问 你 的 bean 的 配置 文件 ， 它 们 会 要 求 部 署 配置 一 个 单 
独 的 文件 ， 例 如 ， 一 个 简单 的 性 能 (properties) 文 件 ， 仅 具有 部 署 细节 。 





PropertyPlaceholderConfigurer 示 例 


为 了 解决 这 个 问题 ， 可 以 使 用 PropertyPlaceholderConfigurer 类 通过 一 个 特殊 的 格 
式 在 外 部 部 署 细 节 到 一 个 属性 (properties ) 文 件 ， 以 及 访问 bean 的 配置 文件 — 
${variable}. 


创建 一 个 属性 文件 (database.properties)， 包 括 数据 库 的 详细 信息 ， 把 它 放 到 你 的 


jdbc.driverClassName=com.mysql.jdbc.Driver 
jdbc.url=jdbc:mysql://localhost :3306/yiibai_db 
jdbc.username=root 
jdbc. password=123456 


在 声明 bean 配 置 文件 和 提供 一 个 PropertyPlaceholderConfigurer 映 射 到 刚才 创建 
的 “database.properties" 属 性 文件 。 


<bean 
class="org.springframework.beans.factory.config.PropertyPlé 
<property name="location"> 
<value>database. properties</value> 
</property> 
</bean> 


EEE) 


完整 的 示例 





«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean 
class-"org.springframework.beans.factory.config.PropertyPl: 


«property name="location"> 
«value»database.properties«c/value» 
</property> 
</bean> 


<bean id="customerDAO" class="com.yiibai.customer.dao.impl. Jdb¢ 


<property name="dataSource" ref="dataSource" /> 
</bean> 


<bean id="customerSimpleDAO" 
class="com.yiibai.customer.dao.impl.SimpleJdbcCust¢ 


<property name="dataSource" ref="dataSource" /> 
</bean> 


<bean id="dataSource" 
class="org.springframework.jdbc.datasource.DriverManagerDat 


«property name="driverClassName" value="${jdbc.driverClassl 

«property name="url" value="${jdbc.url}" /> 

«property name="username" value="${jdbc.username}" /> 

<property name="password" value="${jdbc.password}" /> 
</bean> 


</beans> 





可 替代 用 法 还 可 以 使 用 PropertyPlaceholderConfigurer 于 某 个 常量 ， 分 享 给 所 有 其 
他 bean。 例 如 ， 定 义 在 一 个 属性 文件 中 的 日 志文 件 的 位 置 ， 并 通过 S{log.filepath} 
访问 不 同 的 bean 配置 文件 的 属性 值 。 


Spring bean 配 置 继承 - Spring 教程 


在 Spring， 继 承 是 用 为 支持 bean 设 置 一 个 bean 来 分 享 共同 的 值 ， 属 性 或 配置 。 一 
个 子 bean 或 继承 的 bean 可 以 继承 其 父 bean 的 配置 ， 属 性 和 一 些 属性 。 另外 ， 子 
Bean 人 允许 覆盖 继承 的 值 。 请 参见 下 面 的 完整 的 例子 来 告诉 你 如 何 配置 bean 继承 在 
Spring 中 工作 。 


package com.yiibai.common; 
public class Customer { 


private int type; 
private String action; 
private String Country; 


NA 


Bean 配 置 文件 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x; 


<bean id="BaseCustomerMalaysia" class="com.yiibai.common.Custor 
«property name-"country" value="Malaysia" /> 
</bean> 


<bean id="CustomerBean" parent="BaseCustomerMalaysia"> 
«property name="action" value="buy" /> 
<property name="type" value="1" /> 

</bean> 


</beans> 


a — ——g 





以 上 就 是 "BaseCustomerMalaysia” Beant} & fJ country 属性 的 值 ， 
im “CustomerBean” Bean 继承 其 父 (BaseCustomerMalaysia') 这 个 值 。 


执行 它 


package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext("applicationContext 
Customer cust = (Customer )context.getBean("CustomerBean" ); 
System.out.println(cust); 
} 
} 





输出 结果 


Customer [type=1, action=buy, Country=Malaysia] 


CustomerBean Bean RM GAY (“BaseCustomerMalaysia’”) #4 country 属性 。 


继承 抽象 
在 上 面 的 例子 中 ，'BaseCustomerMalaysia' 仍然 能 够 实例 化 ， 例 如 ， 


Customer cust = (Customer )context.getBean("BaseCustomerMalaysia" ); 
i -= 1 


如 果 你 要 让 这 个 bean 作为 一 个 基础 模板 ， 不 允许 别人 来 实例 化 它 ， 可 以 在 一 个 元 
素 中 添加 一 个 “abstract* 的 属性 。 例如 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"BaseCustomerMalaysia" class="com.yiibai.common.Custor 
«property name-"country" value-"Malaysia" /» 
«/bean» 


«bean id="CustomerBean" parent="BaseCustomerMalaysia"> 
<property name="action" value="buy" /> 
«property name="type" value="1" /> 

</bean> 


</beans> 
_ O 让 


现在 , "BaseCustomerMalaysia' Bean 是 一 个 纯粹 的 模板 ， 因 为 Bean 只 能 继承 它 ， 
如 果 试 图 实例 化 它 ， 你 会 遇 到 以 下 错误 消息 。 





Customer cust = (Customer )context.getBean("BaseCustomerMalaysia" ); 


Es= ed 


org.springframework.beans.factory.BeanIsAbstractException: 
Error creating bean with name 'BaseCustomerMalaysia': 
Bean definition is abstract 


纯 继 承 模 板 


其 实 ， 父 bean 是 不 需要 定义 类 的 属性 ， 很 多 时 候 ， 你 可 能 只 需要 一 个 共同 的 属性 
共享 。 这 里 的 是 一 个 例子 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"BaseCustomerMalaysia" abstract="true"> 
«property name-"country" value="Malaysia" /> 
«/bean» 


«bean id="CustomerBean" parent="BaseCustomerMalaysia" 
class="com.yiibai.common.Customer"> 


<property name="action" value="buy" /> 
<property name="type" value="1" /> 
</bean> 
</beans> 


a ee 


在 这 种 情况 下 , "BaseCustomerMalaysia' Bean 是 一 个 纯粹 的 模板 ， 只 分 享 其 
"country" [& lE, 


(BiU 


但 是 ， 仍 然 可 以 指定 的 子 bean 的 新 值 覆盖 继承 的 值 。 让 我 们 来 看 看 这 个 例子 





«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x; 


<bean id="BaseCustomerMalaysia" class="com.yiibai.common.Custor 
<property name="country" value="Malaysia" /> 
</bean> 


<bean id="CustomerBean" parent="BaseCustomerMalaysia"> 
«property name-"country" value="Japan" /> 
<property name="action" value="buy" /> 
<property name="type" value="1" /> 

</bean> 


</beans> 


E mn : 





f£"CustomerBean" Bean R 2% m 4 ("BaseCustomerMalaysia")country 属性 ， 从 
‘Malaysia’ ($c 7; ‘Japan’. 


Customer [Country=Japan, action=buy, type=1] 
7 ot 
Iw -—7 


Spring bean 配 置 继承 是 为 了 避免 多 个 Bean 有 重复 共同 的 值 或 配置 是 非常 有 用 的 。 
下 载 代码 - http://pan.baidu.com/s/1blOgAq 


Spring 依赖 检查 - Spring 教程 


在 Spring 中 ， 可 以 使 用 依赖 检查 功能 ， 以 确保 所 要 求 的 属性 可 设置 或 者 注入 。 


依赖 检查 模式 


4 个 依赖 检查 支持 的 模式 : 

e none -没有 依赖 检查 ， 这 是 默认 的 模式 。 

e simple — 如 果 基 本 类 型 (int, long,double...) 和 集合 类 型 (map, list..) 的 任何 属性 都 
没有 设置 ，UnsatisfiedDependencyException 将 被 抛 出 。 

e objects 一 如 果 对 象 类 型 的 任何 属性 都 没有 设置 ， 
UnsatisfiedDependencyException 将 被 抛 出 。 

e all — 如 果 任 何 类 型 的 任何 属性 都 没有 被 设置 ， 
UnsatisfiedDependencyException 将 被 抛 出 。 


注 : 默认 模式 是 none 
示例 
Customer 和 Person 对 象 的 示例 。 


package com.yiibai.common; 


public class Customer 


{ 
private Person person; 
private int type; 
private String action; 
//getter and setter methods 
} 


package com.yiibai.common; 


public class Person 


{ 
private String name; 
private String address; 
private int age; 


//getter and setter methods 


1. none 依赖 检查 


Spring bean 配 置 文件 使 用 “none” 依赖 检查 模式 。 


«beans xmlns="http://www.springframework.org/schema/beans" 


xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


<bean id="CustomerBean" class="com.yiibai.common.Customer" > 
<property name="action" value="buy" /> 
</bean> 


«bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="address ABC" /> 
<property name="age" value="29" /> 

</bean> 


</beans> 





如 果 没 有 明确 定义 的 依赖 检查 模式 ， 其 默认 为 "none"。 没 有 依赖 检查 将 执行 。 


2. simple 依赖 检查 


Spring bean 的 配置 文件 使 用 “simple” 依 赖 检查 模式 。 


<beans xmlns="http://www.springframework.org/schema/beans" 


xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


<bean id="CustomerBean" class="com.yiibai.common.Customer" 
dependency-check="simple"> 


<property name="person" ref="PersonBean" /> 
<property name="action" value="buy" /> 
</bean> 


<bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="address ABC" /> 
<property name="age" value="29" /> 

</bean> 


</beans> 











在 “type” 属 性 (基本 类 型 或 集合 类 型 )， 如 尚未 设置 ， 
UnsatisfiedDependencyException 将 抛 出 。 


org.springframework.beans.factory.UnsatisfiedDependencyException: 
Error creating bean with name 'CustomerBean' 

defined in class path resource [config/Spring-Customer. xml]: 
Unsatisfied dependency expressed through bean property 'type': 

Set this property value or disable dependency checking for this be: 
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3. objects 依赖 检查 
Spring bean 配 置 文件 的 “objects” 依 赖 检查 模式 。 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


<bean id="CustomerBean" class="com.yiibai.common.Customer" 
dependency-check="objects"> 


<property name="action" value="buy" /> 
<property name="type" value="1" /> 
</bean> 


«bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="address ABC" /> 
<property name="age" value="29" /> 

</bean> 


</beans> 
E cue. 
在 'person' 属 性 (对 象 类 型 )， 尚 未 设置 ， 一 个 UnsatisfiedDependencyException 将 抛 


o 





org.springframework.beans.factory.UnsatisfiedDependencyException: 
Error creating bean with name 'CustomerBean' 

defined in class path resource [config/Spring-Customer. xml]: 
Unsatisfied dependency expressed through bean property 'person': 
Set this property value or disable dependency checking for this be: 


E us | 











4. all 依赖 检查 


Spring bean 配 置 文件 的 “al "依赖 检查 模式 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="CustomerBean" class="com.yiibai.common.Customer" 
dependency-check="al1l"> 


<property name="action" value="buy" /> 
</bean> 


«bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="address ABC" /> 
<property name="age" value="29" /> 

</bean> 


</beans> 
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对 “simple” 和 “objects” 模 式 的 组 合 ， 如 果 有 的 话 类 型 (原型 ， 集 合 和 对 象 ) 的 任何 属性 
都 没有 设置 ， 一 个 UnsatisfiedDependencyException 将 被 抛 出 。 


全 局 默认 的 依赖 检查 


明确 定义 的 依赖 检查 模式 ， 每 个 Bean 配 置 繁琐 且 容 易 出 错 ， 可 以 在 根 元 素 设 置 一 个 
默认 的 依赖 性 检查 属性 强制 根 元 素 内 声明 的 整个 bean 类 适用 此 规则 。 然 而 ， 这 根 默 
认 模 式 将 通过 一 个 bean 自 己 指定 的 模式 下 可 覆盖 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
default -dependency-check="all"> 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
<property name="action" value="buy" /> 
«property name="type" value="1" /> 

</bean> 


<bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="address ABC" /> 
<property name="age" value="29" /> 

</bean> 


</beans> 
l| e ————————— MÀ FT! 
在 这 个 配置 文件 中 声明 所 有 的 Bean 类 默 都 是 “all" 依 赖 检 查 模式 。@Required 注解 


在 大 多 数 情况 下 ， 你 只 需要 确保 特定 属性 已 经 设置 ， 但 有 一 定 是 所 有 的 类 型 (原始 ， 
集合 或 对 象 ) 属 性 。 





Spring 使 用 @Required 注 解 依赖 检查 - Spring 教程 


Spring 依赖 检查 bean 配置 文件 用 于 确定 的 特定 类 型 (基本 ， 集 合 或 对 象 ) 的 所 有 属性 
被 设置 。 在 大 多 数 情 况 下 ， 你 只 需要 确保 特定 属性 已 经 设置 但 不 是 所 有 属性 .. 对 于 
这 种 情况 ， 你 需要 @Required 注解 ， 请 参见 下 面 的 例子 : 


@Required 示 例 


Customer 对 象 ， 适 用 @Required 在 setPerson() 方 法 ， 以 确保 person 属性 已 设 
iB. 


package com.yiibai.common; 
import org.springframework.beans.factory.annotation.Required; 


public class Customer 


( 


private Person person; 
private int type; 
private String action; 


public Person getPerson() ( 
return person; 


@Required 
public void setPerson(Person person) { 
this.person = person; 


} 


简单 地 套用 @Required 注 解 不 会 强制 执行 该 属性 的 检查 ， 还 需要 注册 一 个 
RequiredAnnotationBeanPostProcessor 以 了 解 在 bean 配 置 文 件 @Required 注 解 。 
RequiredAnnotationBeanPostProcessor 可 以 用 两 种 方式 来 启用 。 


1. 2H <context:annotation-config /> 


添加 Spring E FXF 在 bean 配 置 文件 。 


<beans 
xmlns:context-"http://www.springframework.org/schema/context" 


http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-2 


«context:annotation-config /» 
</beans> 
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完整 的 实例 ， 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
XSi:schemaLocation="http://www.springframework.org/schema/beans: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 
http://www. springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context -2 


<context:annotation-config /> 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
<property name="action" value="buy" /> 
<property name="type" value="1" /> 

</bean> 


<bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="address ABC" /> 
<property name="age" value="29" /> 

</bean> 


</beans> 
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2. Z RequiredAnnotationBeanPostProcessor 


直接 在 bean Adie + GN “RequiredAnnotationBeanPostProcessor”. 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 

«bean 

class="org.springframework.beans.factory.annotation.RequiredAnnotat 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
<property name="action" value="buy" /> 
«property name="type" value="1" /> 

</bean> 


<bean id="PersonBean" class="com.yiibai.common.Person"> 
<property name="name" value="yiibai" /> 
<property name="address" value="address ABC" /> 
<property name="age" value="29" /> 
</bean> 
</beans> 


[E SS a eee 
如 果 你 运行 它 ， 下 面 的 错误 信息 会 去 的 ， 因 为 person 的 属性 未 设置 。 





org.springframework.beans.factory.BeanInitializationException: 
Property 'person' is required for bean 'CustomerBean' 


结论 


尝试 @Reqgquired 注 解 ， 它 比 依赖 检查 XML 文件 中 更 加 灵活 ， 因 为 它 可 以 适用 于 只 有 
一 个 特定 属性 。 定 义 @Required 请 阅读 本 文 有 关 如 何 创 建新 的 自 定义 @Required- 
style 注解 。 


Spring É = 3: @Required-styles+ fg - Spring 教程 


@Required 注 解 是 用 来 确保 特定 属性 已 设置 。 如 果 您 迁移 现 有 项 目 到 Spring 框架 或 
有 自己 的 @Required-style 注 解 不 管 是 什么 原因 ，Spring 人 允许 您 定义 自 定义 
@Required-style 注 解 ， 相 当 于 @Required 注 解 。 在 这 个 例子 中 ， 您 将 创建 一 个 名 
为 @Mandatory 定制 @Required-style 注解 ， 相 当 于 @Required 注 解 。 


1. 创 建 @Mandatory 接 口 


package com.yiibai.common; 


import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation.Target; 


@Retention(RetentionPolicy.RUNTIME ) 
QTarget(ElementType.METHOD) 
public @interface Mandatory { 


j 


2. 应 用 它 到 属性 


package com.yiibai.common; 


public class Customer 


{ 


private Person person; 

private int type; 

private String action; 

@Mandatory 

public void setPerson(Person person) { 
this.person = person; 


//getter and setter methods 


3. 注 册 它 


包 画 新 @Mandatory 注 释 到 “RequiredAnnotationBeanPostProcessor' X, 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


<bean 
class="org.springframework.beans.factory.annotation.RequiredAnnotat 

«property name-"requiredAnnotationType" value="com.yiibai. comm 
</bean> 


«bean id="CustomerBean" class="com.yiibai.common.Customer"> 
<property name="action" value="buy" /> 
«property name="type" value="1" /> 

</bean> 


</beans> 


EE E) 


4. 完成 


这 样 做 ， 创 建 了 一 个 新 的 自 定义 命名 @Required-style 的 @Mandatory 注解 ， 相 当 
于 @Required 注解 。 





Spring Bean InitializingBean#]DisposableBean 
实例 - Spring 教程 


在 Spring 中 ，InitializingBean 和 DisposableBean 是 两 个 标记 接口 ， 为 Spring 执行 时 
bean 的 初始 化 和 销毁 某 些 行为 时 的 有 用 方法 。 


1. 对 于 Bean 实 现 InitializingBean， 它 将 运行 afterPropertiesSet() 在 所 有 的 bean 
属性 被 设置 之 后 。 

2. 对 于 Bean 实现 了 DisposableBean， 它 将 运行 destroy() 在 Spring 容器 释放 该 
bean 之 后 。 


示例 


下 面 是 一 个 例子 ， 向 您 展示 如 何 使 用 InitializingBean 和 DisposableBean。 一 个 
CustomerService bean 来 实现 InitializingBean 和 DisposableBean 接口 ， 并 有 一 个 
消息 (message) 属 性 。 


package com.yiibai.customer.services; 


import org.springframework.beans.factory.DisposableBean; 
import org.springframework.beans.factory.InitializingBean; 


public class CustomerService implements InitializingBean, Disposab- 


{ 


String message; 


public String getMessage() { 
return message; 


} 


public void setMessage(String message) { 
this.message = message; 


} 


public void afterPropertiesSet() throws Exception { 
System.out.println("Init method after properties are set : " 


j 


public void destroy() throws Exception { 
System.out.println("Spring Container is destroy! Customer cle 


j 


} 
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File : applicationContext. xml 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"customerService" class="com.yiibai.customer.servic 
«property name="message" value="I'm property message" /> 
</bean> 


</beans> 
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执行 它 
package com.yiibai.common; 


import org.springframework.context.ConfigurableApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App 


{ 
public static void main( String[] args ) 
{ 
ConfigurableApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"appl: 
CustomerService cust = (CustomerService)context.getBean("ct 
System.out.println(cust); 
context.close(); 
j 
j 





该 ConfigurableApplicationContext.close() 将 关闭 该 应 用 程序 的 上 下 文 ， 释 放 所 有 资 
源 ， 并 销毁 所 有 缓存 的 单 例 bean。 它 是 只 用 于 destroy() 方 的 演示 目的 。 


输出 结果 


Init method after properties are set : I'm property message 
com. yiibai.customer.services.CustomerService@4090c06f 
Spring Container is destroy! Customer clean up 


afterPropertiesSet() 方 法 被 调用 在 message 属性 设置 后 ， 而 destroy() 方 法 是 在 调 
用 context.close() 之 后 ;建议 : 不 建议 使 用 InitializingBean 和 DisposableBean 的 接 
口 ， 因 为 它 将 你 的 代码 紧 耦 合 到 Spring 代码 中 。 一 个 更 好 的 做 法 应 该 是 在 bean 的 
配置 文件 属性 指定 init-method 和 destroy-method。 下 载 代码 — 
http://pan.baidu.com/s/1nu3cEXN 


Spring Bean init-method 和 destroy-method 3: 
例 - Spring 教程 
在 Spring 中 ， 可 以 使 用 init-method 和 destroy-method 在 bean 配置 文件 属性 用 于 在 


bean 初 始 化 和 销毁 某 些 动作 时 。 这 是 用 来 蔡 代 InitializingBean 和 DisposableBean 
接口 。 


示例 
这 里 有 一 个 例子 向 您 展示 如 何 使 用 init-method 和 destroy-method。 


package com.yiibai.customer.services; 


public class CustomerService 


{ 
String message; 
public String getMessage() { 
return message; 
j 
public void setMessage(String message) { 
this.message - message; 
j 
public void initIt() throws Exception ( 
System.out.println("Init method after properties are set : " 
} 
public void cleanUp() throws Exception { 
System.out.println("Spring Container is destroy! Customer cle 
} 
} 





File : applicationContext.xml, 在 bean 中 定义 了 init-method 和 destroy-method 属 性 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


<bean id="customerService" class="com.yiibai.customer.services 
init-method="initIt" destroy-method="cleanUp"> 


<property name="message" value="i'm property message" /> 
</bean> 


</beans> 
.4 _ EN 
执行 下 面 的 程序 代码 : 





package com.yiibai.common; 


import org.springframework.context.ConfigurableApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App 


{ 
public static void main( String[] args ) 
{ 
ConfigurableApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"applicat: 
CustomerService cust = (CustomerService)context.getBean( "ci 
System.out.println(cust); 
context.close(); 
} 
} 





ConfigurableApplicationContext.close 将 关闭 应 用 程序 上 下 文 ， 释 放 所 有 资源 ， 并 
销毁 所 有 缓存 的 单 例 bean。 


输出 


Init method after properties are set : I'm property message 
com. yiibai.customer.services.CustomerService@5f49d886 
Spring Container is destroy! Customer clean up 


initlt() 方 法 被 调用 ， 消 息 属性 设置 后 ， 在 context.close() 调 用 后 ， 执 行 cleanUp()75 
法 ; 建议 使 用 init-method 和 destroy-methodbean 在 Bena 配 置 文件 ， 而 不 是 执行 
InitializingBean 和 DisposableBean 接口 ， 也 会 造成 不 必要 的 耦合 代码 在 Spring。 
下 载 源 代码 - http://pan.baidu.com/s/1hreksq4 


Spring @PostConstruct#1@PreDestroy 3: £5 - 
Spring 教程 


在 Spring 中 ， 既 可 以 实现 InitializingBean 和 DisposableBean 接 口 或 在 bean 配 置 文件 
中 指定 init-method 和 destroy-method 在 初始 化 和 销毁 回调 函数 。 在 这 篇 文章 中 ， 
我 们 将 介绍 如 何 使 用 @PostConstruct 和 @PreDestroy 注解 来 做 同样 的 事情 。 


X : @PostConstruct 和 @PreDestroy 标注 不 属于 Spring, € 
是 在 J2EE 库 - common-annotations.jar。 


@PostConstruct 和 @PreDestroy 


一 个 CustomerService Bean 使 用 @PostConstruct 和 @PreDestroy 注释 


package com.yiibai.customer.services; 


import javax.annotation.PostConstruct; 
import javax.annotation.PreDestroy; 


public class CustomerService 


{ 


String message; 


public String getMessage() { 
return message; 


} 


public void setMessage(String message) { 
this.message = message; 


} 


@PostConstruct 
public void initIt() throws Exception { 
System.out.println("Init method after properties are set : 


j 


QPreDestroy 
public void cleanUp() throws Exception { 
System.out.println("Spring Container is destroy! Customer cle 


j 











默认 情况 下 ，Spring 不 会 意识 到 @PostConstruct 和 @PreDestroy 注 解 。 要 启用 它 ， 
要 么 注册 “CommonAnnotationBeanPostProcessor”"， 要 么 在 bean 配 置 文件 的 ' 指 
定 ， 


1. CommonAnnotationBeanPostProcessor 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


«bean class="org.springframework.context.annotation.CommonAnnot 
«bean id="customerService" class="com.yiibai.customer.services 
<property name="message" value="i'm property message" /> 


</bean> 


</beans> 
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2. «context:annotation-config /» 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context-"http: //www.springframework.org/schema/context" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
http://www.springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context -2 


<context:annotation-config /> 
«bean id="customerService" class="com.yiibai.customer.services 


<property name="message" value="i'm property message" /> 
</bean> 


</beans> 





package com.yiibai.common; 


import org.springframework.context.ConfigurableApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App 


{ 
public static void main( String[] args ) 
{ 
ConfigurableApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Spring- 
CustomerService cust = (CustomerService)context.getBean( ci 
System.out.println(cust); 
context.close(); 
} 
} 





输出 结果 


Init method after properties are set : im property message 
com. yiibai.customer.services.CustomerService@47393Ff 


INFO: Destroying singletons in org.springframework.beans.factory. 
support.DefaultListableBeanFactory@77158a: 

defining beans [customerService]; root of factory hierarchy 
Spring Container is destroy! Customer clean up 


E ee |) 


initlt() 方 法 (@PostConstruct) 被 调用 时 ， 消 息 属性 设置 后 cleanUp() 方法 
(@PreDestroy) 是 在 context.close() 执 行 后 被 调用 ;下 载 源 代码 — 
http://pan.baidu.com/s/1qxX2W6xl 


Spring EL hello world: B - Spring 教程 


Spring EL 与 OGNL 和 JSF EL 相似 ， 计 算 评 估 或 在 bean 创 建 时 执行 。 此 外 ， 所 有 的 
Spring 表 达 式 都 可 以 通过 XML 或 注解 。 在 本 教程 中 ， 我 们 闻 学 习 如 何 使 用 Spring 表 
达 式 语言 (SpEL)， 注 入 字符 串 ， 整 数 ，Bean 到 属性 ， 无 论 是 在 XML 和 注释 。 


1. Spring Beans 
两 个 简单 Bean， 后 来 利用 SpEL 注入 值 到 属性 ， 在 XML 和 注释 。 


package com.yiibai.core; 
public class Customer { 
private Item item; 


private String itemName; 


package com.yiibai.core; 
public class Item { 
private String name; 


private int qty; 


3. Spring EL 以 XML 形式 


使 用 SpEL 关 闭 的 #{ SpEL expression } 括 号 ， 请 参阅 XML bean 定 义 文件 下 面 的 例 


o 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-3.0.x: 


«bean id="itemBean" class="com.yiibai.core.Item"> 
<property name="name" value="itemA" /> 
<property name="qty" value="10" /> 

</bean> 


«bean id-"customerBean" class="com.yiibai.core.Customer'"> 
«property name="item" value="#{itemBean}" /> 
«property name="itemName" value="#{itemBean.name}" /> 

</bean> 


</beans> 


4] pape) 





1. {itemBean} — 3+ 
A“itemBean’” =! “customerBean” Bean 


的 “item” 属 性 。 


2. {itemBean.name} 一 注 
入 “itemBean” 的 “name” 属 性 到 
“customerBean" bean 的 "ittemname” 属 性 。 


4. Spring EL 以 注解 形式 


请 参阅 等 效 版 本 注释 模式 。 注 要 在 注解 使 用 使 用 SpEL， 必 须 通 过 注解 注册 您 的 组 
件 。 如 果 注 册 bean 在 XML 和 Java 类 中 定义 @Value， 该 @Value 将 无 法 执行 。 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "customerBean" ) 
public class Customer { 


@Value("#{itemBean}" ) 
private Item item; 


@Value("#{itemBean.name}" ) 
private String itemName; 


ros 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "itemBean") 
public class Item { 


QValue("itemA") //inject String directly 
private String name; 


QValue("10") //inject interger directly 
private int qty; 


public String getName() ( 


return name; 


or 


启用 自动 组 件 扫描。 


«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context-"http://www.springframework.org/schema/context" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x; 
http://www. springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context-3 


«context:component-scan base-package="com.yiibai.core" /> 


</beans> 


«| m 








在 注解 模式 下 ， 可 以 使 用 @Value 定 义 Spring EL。 在 这 种 情况 下 ， 一 个 String 和 
Integer 值 直接 注入 到 “itemBean”， 之 后 又 注入 “itemBean” 到 “customerBean” 属 性 。 


运行 它 ， 无 论 是 使 用 SpEL 在 XML 还 是 注释 都 显示 了 同样 的 结果 : 


package com.yiibai.core; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App ( 
public static void main(String[] args) { 
ApplicationContext context - new ClassPathXmlApplicationCor 


Customer obj - (Customer) context.getBean("customerBean"); 
System.out.println(obj); 





输出 结果 


Customer [item=Item [name=itemA, qty=10], itemName=itemA] 


FRR — http://pan.baidu.com/s/1kTQ7fyZ 


Spring EL bean 引 用 实例 - Spring 教程 


在 Spring EL， 可 以 使 用 点 (.) 符 号 典 套 属性 参考 一 个 bean。 例 
a, *bean.property name", 


public class Customer { 


@Value("#{addressBean.country}") 
private String country; 


在 上 面 的 代码 片段 ， 它 从 “addressBean"” bean 注 入 了 “country” 属 性 到 现在 
的 "customer 类 的 “country" 属 性 的 值 。 


Spring EL 以 注解 的 形式 


请 参阅 下 面 的 例子 ， 演示 如 何 使 用 使 用 SpEL 引用 一 个 bean，bean 属 性 也 它 的 方 


法 。 
package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "customerBean") 
public class Customer ( 


@Value("#{addressBean}") 
private Address address; 


@Value("#{addressBean.country}") 
private String country; 


@Value("#{addressBean.getFullAddress('yiibai')}") 
private String fullAddress; 


//getter and setter methods 


@Override 
public String toString() { 
return "Customer [address=" + address + "\n, country=" + c( 
+ "\n, fullAddress=" + fullAddress + "]"; 











package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


@Component ("addressBean" ) 
public class Address { 


@Value("GaoDeng, QiongShang" ) 
private String street; 


@Value("571100") 
private int postcode; 


@Value("CN") 
private String country; 


public String getFullAddress(String prefix) { 


return prefix + " : " + street + " " + postcode + " " + col 


} 


//getter and setter methods 


public void setCountry(String country) { 
this.country = country; 
} 


@Override 
public String toString() { 
return "Address [street=" + street + ", postcode=" + postc 
+ ", country=" + country + "]"; 





Customer obj = (Customer) context.getBean("customerBean"); 
System.out.println(obj); 


输出 结果 


Customer [address-Address [street-GaoDeng, QiongShang, postcode-57: 
, country=CN 
, fullAddress-yiibai : GaoDeng, QiongShang 571100 CN] 


«| = E B 








Spring EL 以 XML 的 形式 
请 参阅 在 XML 文件 定义 bean 的 等 效 版 本 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x: 


«bean id="customerBean" class="com.yiibai.core.Customer'"> 
«property name="address" value="#{addressBean}" /> 
«property name-"country" value="#{addressBean.country}" /> 
«property name="fullAddress" value="#{addressBean.getFullAc 

</bean> 


<bean id="addressBean" class="com.yiibai.core.Address"> 
«property name-"street" value="GaoDeng, QiongShang" /> 
«property name="postcode" value="571100" /> 
<property name="country" value="CN" /> 

</bean> 


</beans> 
SSS 
FARA - http://pan.baidu.com/s/1pJTgLUN 





Spring EL 方法 调用 实例 - Spring 教程 

Spring 表 达 式 语言 (使 用 SpEL) 人 允许 开发 人 员 使 用 表达 式 来 执行 方法 和 将 返回 值 以 注 
入 的 方式 到 属性 ， 或 叫 作 “ 使 用 SpEL 方 法 调用 ”。 

Spring EL 在 注解 的 形式 

了 解 如 何 实现 Spring EL 方法 调用 与 @Value 注 释 。 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


@Component("customerBean" ) 
public class Customer { 


@Value("#{'yiibai'.toUpperCase()}") 
private String name; 


@Value("#{priceBean.getSpecialPrice()}") 
private double amount; 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 
} 


public double getAmount() { 
return amount; 
b 


public void setAmount(double amount) { 
this.amount - amount; 
} 


@Override 
public String toString() { 

return "Customer [name=" + name + ", amount=" + amount + ” 
} 











package com.yiibai.core; 
import org.springframework.stereotype.Component; 


QComponent ( "priceBean") 
public class Price ( 


public double getSpecialPrice() { 
return new Double(199.09); 
j 


输出 


Customer [name=YIIBAI, amount=199.09] 


一 点 解释 
在 字 串 文本 上 调用 toUpperCase() 方 法 。 


@Value("#{'yiibai'.toUpperCase()}") 
private String name; 


在 ‘priceBean‘ Bean 4 FagetSpecialPrice() 方法 


@Value("#{priceBean.getSpecialPrice()}") 
private double amount; 


Spring EL 在 XML 的 形 陈 


请 参阅 在 XML 文件 定义 bean 的 等 效 版 本 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x; 


«bean id="customerBean" class="com.yiibai.core.Customer"> 
<property name="name" value="#4{'yiibai'.toUpperCase()}" /> 
«property name="amount" value="#{priceBean.getSpecialPrice| 

</bean> 

<bean id="priceBean" class="com.yiibai.core.Price" /> 


</beans> 





输出 


Customer [name=YIIBAI, amount=199.09] 


下 载 代码 - http://pan.baidu.com/s/1mhdwodU 


Spring EL 运算 符 实例 - Spring 教程 


Spring EL 支持 大 多 数 标准 的 数学 ， 逮 辑 和 天 系 运算 符 。 例如 ， 


1. 关系 运算 符 - SF (==, eq), 不 等 于 (!=, ne), 小 于 (<, It), 小 于 或 等 于 (<= , le), 
大 于 (>, gt), 和 大 于 或 等 于 (>=, ge). 

2. HBA - A, 或 , JE (1). 

3. 数学 运算 符 - 加 法 (+), 减法 (-), 乘法 (*), 除法 (/), 除 模 (%) 和 指数 和 (^). 


Spring EL 以 注解 的 形式 
这 个 例子 说 明了 如 何在 SpEL 中 使 用 运算 符 。 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "customerBean" ) 
public class Customer { 


//Relational operators 


@Value("#{1 == 1)") //true 
private boolean testEqual; 


@Value("#{1 != 1)") //false 
private boolean testNotEqual; 


@Value("#{1 « 1}") //false 
private boolean testLessThan; 


@Value("#{1 <= 1)") //true 
private boolean testLessThanOrEqual; 


@Value("#{1 > 1}") //false 
private boolean testGreaterThan; 


@Value("#{1 >= 1}") //true 
private boolean testGreaterThanOrEqual; 


//Logical operators , numberBean.no -- 999 


@Value("#{numberBean.no == 999 and numberBean.no < 900}") //fa. 
private boolean testAnd; 


@Value("#{numberBean.no == 999 or numberBean.no < 900}") //true 
private boolean testOr; 


@Value("#{! (numberBean.no == 999)}") //false 
private boolean testNot; 


//Mathematical operators 


@Value("#{1 + 1}") //2.0 
private double testAdd; 


@Value("#{'1' + '@' + '1'}") //101 
private String testAddString; 


@Value("#{1 - 1}") //0.0 
private double testSubtraction; 


@Value("#{1 * 1}") //1.0 
private double testMultiplication; 


@Value("#{10 / 2}") //5.0 
private double testDivision; 


@Value("#{10 % 10}") //0.0 
private double testModulus ; 


@Value("#{2 ^ 2}") //4.0 
private double testExponentialPower; 


QOverride 
public String toString() (1 

return "Customer [testEqual-" + testEqual + ", testNotEqua- 

+ testNotEqual + ", testLessThan=" + testLessThan 

", testLessThanOrEqual-" + testLessThanOrEqual 
", testGreaterThan=" + testGreaterThan 
", testGreaterThanOrEqual-" + testGreaterThanOrE: 
", testAnd=" + testAnd + ", testOr=" + testOr + ' 
testNot + ", testAdd=" + testAdd + ", testAddStr: 
testAddString + ", testSubtraction=" + testSubtr: 
", testMultiplication=" + testMultiplication 
", testDivision=" + testDivision + ", testModulu: 
testModulus + ", testExponentialPower=" 
testExponentialPower + "]"; 


二 十 十 十 十 十 十 十 十 ++ 





package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "numberBean" ) 
public class Number ( 


QValue("999") 
private int no; 


public int getNo() { 
return no; 
j 


public void setNo(int no) { 
this.no - no; 
} 


执行 


Customer obj = (Customer) context.getBean("customerBean"); 
System.out.println(obj); 


输出 结果 


Customer [testEqual-true, testNotEqual=false, testLessThan=false, 1 


i 





Spring EL 以 XML 形式 


请 参阅 在 XML 文件 定义 bean 的 等 效 版 本 。 在 XML 中 ， 类 似 < 小 于 符号 不 支持 ， 应 
该 使 用 下 面 所 示 文 本 形式 ， 例 如 文本 等 值 ， (<' = 't) 和 (‘<='='le'). 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-3.0.x: 


«bean id="customerBean" class="com.yiibai.core.Customer"> 


<property name="testEqual" value="#{1 == 1}" /> 

<property name="testNotEqual" value="#{1 != 1}" /> 

«property name="testLessThan" value="#{1 lt 1}" /> 

«property name="testLessThanOrEqual" value="#{1 le 1)" /» 
«property name="testGreaterThan" value="#4{1 > 1j" /> 
«property name-"testGreaterThanOrEqual" value="#{1 >= 1)" /> 
«property name="testAnd" value="#{numberBean.no == 999 and ni 
«property name="testOr" value="#{numberBean.no == 999 or numl 
«property name="testNot" value="#{!(numberBean.no == 999)}" , 
<property name="testAdd" value="#{1 + 1}" /> 

«property name="testAddString" value="#{'1' + '@' + '1'}" /> 
«property name="testSubtraction" value="#{1 - 1j" /> 
«property name="testMultiplication" value="#{1 * 1)" /> 
<property name="testDivision" value="#{10 / 2}" /> 

<property name="testModulus" value="#{10 % 10}" /> 


<property 


name-"testExponentialPower" value="#{2 ^ 2}" /> 


</bean> 
«bean id="numberBean" class="com.yiibai.core.Number"> 
<property name="no" value="999" /> 
</bean> 
</beans> 


FARA - http://pan.baidu.com/s/1MLG1w 





Spring EL 三 元 运算 (if-then-else) 实 例 - Spring 
程 


Spring EL 支持 三 元 运算 符 ， 执 行 “if then else” 条 件 检查 。 例如 ， 


condition ? true : false 


Spring EL 以 注解 形式 


Spring EL 三 元 运算 符 可 使 用 @Value 注 解 。 在 这 个 例子 中 ， 如 
5RitemBean.qtyOnHand”/\F100, ii “customerBean.warning’#true, AR! 
将 其 设置 为 false。 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "customerBean" ) 
public class Customer { 


@Value("#{itemBean.qtyOnHand « 100 ? true : false}") 
private boolean warning; 


public boolean isWarning() 1 
return warning; 
} 


public void setWarning(boolean warning) { 
this.warning = warning; 
} 


@Override 
public String toString() { 

return "Customer [warning=" + warning + "]"; 
} 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "itemBean") 
public class Item { 


QValue("99") 
private int qtyOnHand; 


public int getQtyOnHand() ( 
return qtyOnHand; 
j 


public void setQtyOnHand(int qtyOnHand) { 
this.qtyOnHand = qtyOnHand; 
} 


输出 


Customer [warning=true ] 


Spring EL 以 XML 形式 
请 参阅 在 XML 文件 定义 bean 的 等 效 版 本 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x; 


«bean id-"customerBean" class="com.yiibai.core.Customer"> 
«property name="warning" 
value="#{itemBean.qtyOnHand < 100 ? true 
«/bean» 


«bean id="itemBean" class="com.yiibai.core.Item"> 
«property name="qtyOnHand" value="99" /> 
</bean> 


</beans> 








Customer [warning=true] 


在 XML 中 ， 需 要 小 于 运算 符 使 用 "<" 奉 换 “<"。 下 载 代码 - 
http://pan.baidu.com/s/1qXjtJru 


Spring EL Lists,Maps X: 4 - Spring 教程 


在 这 篇 文章 中 ， 我 们 将 介绍 如 何 使 用 Spring ELM Map 和 List 中 获得 值 。 事 实 上 ， 
使 用 SpEL 与 Map 和 List 的 工作 方式 与 Java 是 完全 一 样 的 。 请 参阅 例如 : 


//get map whete key = 'MapA' 
@Value("#{testBean.map[ 'MapA']}") 
private String mapA; 


//get first value from list, list is 0-based. 


QValue("Z(testBean.list[0])") 
private String list; 


Spring EL 以 注解 的 形式 


在 这 里 ， 创 建 了 一 个 HashMap 和 ArrayList， 并 添加 了 一 些 初始 测试 数据 。 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "customerBean") 
public class Customer { 


QValue("Z(testBean.map['MapA'])") 
private String mapA; 


@Value("#{testBean.list[0]}") 
private String list; 


public String getMapA() { 
return mapA; 
j 


public void setMapA(String mapA) { 
this.mapA - mapA; 
j 


public String getList() ( 
return list; 
} 


public void setList(String list) { 
this.list = list; 
} 


@Override 
public String toString() { 
return "Customer [mapA=" + mapA + ", list=" + list + "]"; 


package com.yiibai.core; 


import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.List; 

import java.util.Map; 

import org.springframework.stereotype.Component; 


QComponent ("testBean") 
public class Test { 


private Map<String, String» map; 
private List<String> list; 


public Test() { 
map = new HashMap<String, String>(); 
map.put("MapA", "This is MapA"); 
map.put("MapB", "This is MapB"); 
map.put("MapC", "This is MapC"); 


list = new ArrayList<String>(); 
list.add("List0"); 
list.add("List1"); 
list.add("List2"); 


} 


public Map<String, String> getMap() { 
return map; 
} 


public void setMap(Map<String, String> map) { 
this.map = map; 
} 


public List<String> getList() { 
return list; 
j 


public void setList(List<String> list) ( 
this.list - list; 


Customer obj = (Customer) context.getBean("customerBean"); 
System.out.println(obj); 


输出 结果 : 


Customer [mapA=This is MapA, list=List0] 


Spring EL 以 XML 的 形式 
请 参阅 在 XML 文件 定义 bean 的 等 效 版 本 。 


«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-3.0.x: 


«bean id-"customerBean" class-"com.yiibai.core.Customer"-» 
«property name="mapA" value="#{testBean.map['MapA']}" /> 
«property name="list" value="#{testBean.list[0]}" /> 

</bean> 


<bean id="testBean" class="com.yiibai.core.Test" /> 


</beans> 





FARA - http://pan.baidu.com/s/1gdTxfKv 


Spring EL 正则 表达 陈 实 例 - Spring 教程 
Spring EL 支持 正则 表达 式 ， 可 使 用 一 个 简单 的 关键 词 “matches"。 如 下 实例 ， 


@Value("#{'100' matches '\\d+' }") 
private boolean isDigit; 


它 测 ix 100'z B= 过 正则 表达 A \d+‘ 测试 过 的 一 个 有 效 的 数字 。 


Spring EL 以 注解 的 形式 


请 参阅 下 面 的 Spring EL 正则 表达 式 的 例子 ， 这 里 有 部 分 挫 入 三 元 运算 符 ， 这 使 得 
Spring EL 非常 灵活 ， 功 能 强大 。 下 面 的 例子 应 该 是 不 言 自 明 的 。 


package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "customerBean") 
public class Customer { 


// email regular expression 
String emailRegEx = "^[ A-Za-z0-9-]-*(NN.[ A-Za-z0-9-]*)" + 
"*@[A-Za-z0-9]+(\\. [A-Za-z0-9]+)*(\\. [A-Za-z](2, 3) $" ; 


// if this is a digit? 
@Value("#{'100' matches '\\d+' }") 
private boolean validDigit; 


// if this is a digit + ternary operator 
@Value("#{ ('100' matches '\\d+') == true ? " + 

"'yes this is digit' : 'No this is not a digit' }") 
private String msg; 
// if this emailBean.emailAddress contains a valid email addre: 
@Value("#{emailBean.emailAddress matches customerBean.emailRegt 
private boolean validEmail; 


//getter and setter methods, and constructor 











package com.yiibai.core; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Component; 


QComponent ( "emailBean") 
public class Email { 


@Value("admin@yiibai.com" ) 
String emailAddress; 


M 


输出 


Customer [isDigit-true, msg=yes this is digit, isValidEmail-true] 


EE 


Spring EL 以 XML 的 形式 
请 参阅 在 XML 文 件 定义 bean 的 等 效 版 本 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x; 


«bean id-"customerBean" class="com.yiibai.core.Customer"> 
«property name="validDigit" value="#{'100' matches '\d+' }" , 
<property name="msg" 

value="#{ ('100' matches '\d+') == true ? 'yes this is dig: 
<property name="validEmail" 
value="#{emailBean.emailAddress matches 'A[_A-Za-z0-9-]+(\ 
</bean> 


«bean id="emailBean" class="com.yiibai.core.Email"> 
<property name="emailAddress" value="admin@yiibai.com" /> 
</bean> 
</beans> 


SSS — # 
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TutorialsPoint Java 技术 教程 


参考 


1. Spring EL 三 元 运算 符 (ifthen-else) 实 例 


Spring EL 正则 表达 式 实例 - Spring 教程 2733 


Spring 目 动 扫 摘 组 件 - Spring 教程 


通常 情况 下 ， 声 明 所 有 的 Bean 类 或 组 件 的 XML bean 配 置 文件 ， 这 样 Spring 容器 可 
以 检测 并 注册 Bean 类 或 组 件 。 其 实 ，Spring 是 能 够 自动 扫描 ， 检 测 和 预定 义 的 项 
目 包 并 实例 化 bean， 不 再 有 繁琐 的 Bean 类 声明 在 XML 文件 中 。 下 面 是 一 个 简单 的 
Spring 项 目 ， 包 括 客 户 服务 和 DAO 层 。 让 我 们 来 探讨 手动 申明 组 件 和 自动 扫描 组 件 
之 间 的 不 同 。 


1、 手 动 声明 组 件 


看 到 在 Spring 的 一 个 正常 方式 来 声明 一 个 bean。 


一 个 正常 的 bean. 


package com.yiibai.customer.dao; 


public class CustomerDAO 


{ 
@Override 
public String toString() { 
return "Hello , This is CustomerDAO"; 
} 
} 
DAO Æ. 


package com.yiibai.customer.services; 
import com.yiibai.customer.dao.CustomerDAO; 


public class CustomerService 


{ 


CustomerDAO customerDAO; 


public void setCustomerDAO(CustomerDAO customerDAO) { 
this.customerDAO - customerDAO; 
} 


@Override 
public String toString() { 

return "CustomerService [customerDAO=" + customerDAO + "]" 
Jj; 











bean 配 置 文件 (applicationContext.xml)， 在 Spring 中 的 一 个 普通 bean 配置 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customerService" class-'com.yiibai.customer.services 
«property name-"customerDAO" ref="CustomerDAO" /> 
</bean> 


<bean id="customerDAO" class="com.yiibai.customer .dao.Customerl 


</beans> 





package com. yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App 


t 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Spring- 
CustomerService cust = (CustomerService)context.getBean( "ci 
System.out.println(cust); 
j 
j 





输出 结果 


CustomerService [customerDAO-Hello , This is CustomerDAO] 


2. Bx za (1318 


现在 ， 启 用 Spring 组 件 打 描 功能 。 使 用 @Component 注 释 来 表示 这 是 类 是 一 个 自动 
扫描 组 件 。 


package com. yiibai.customer.dao; 
import org.springframework.stereotype.Component; 


@Component 
public class CustomerDAO 


{ 


@Override 
public String toString() { 

return "Hello , This is CustomerDAO"; 
} 


DAO 层 ， 添 加 @Component， 表 明 这 也 是 一 个 自动 打 描 组 件 。 


package com.yiibai.customer.services; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Component; 


import com.yiibai.customer.dao.CustomerDAO; 


Component 
public class CustomerService 


{ 
@Autowired 
CustomerDAO customerDAO; 


QOverride 
public String toString() { 

return "CustomerService [customerDAO-" + customerDAO + "]" 
} 


} 
二 L 
将 这 个 “context:component" 在 bean 配 置 文件 ， 这 意味 着 ， 在 Spring 中 启用 自动 扫 


描 功能 。base-package 是 指明 存储 组 件 ，Spring 闻 扫描 该 文件 夹 ， 并 找 出 Bean( 注 
解 为 @Component) 并 注册 到 Spring 容器 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context-"http://www.springframework.org/schema/context" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
http://www.springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context -2 


«context:component-scan base-package="com.yiibai.customer" /> 
</beans> 


«| = 


>| 








执行 它 
package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Sprinc 
CustomerService cust = (CustomerService)context.getBean("c! 
System.out.println(cust); 
j 
j 





输出 结果 


CustomerService [customerDAO-Hello , This is CustomerDAO] 
这 是 Spring 中 的 自动 扫描 组 件 如 何 工 作 。 


AES. Bab 121828 PF A 


默认 情况 下 ，Spring 将 小 写 部 件 的 第 一 字符 - 
从 'CustomerService' 到 'CustomerService'。 可 以 检索 该 组 件 名 称 
为 “CustomerService”。 


CustomerService cust = (CustomerService)context.getBean("customerSe 


«| = 











要 创建 组 件 的 自 定 义 名 称 ， 你 可 以 这 样 自 定义 名 称 : 


QService("AAA") 
public class CustomerService 


现在 ， 可 以 用 'AAA' 这 个 名 称 进行 检索 。 


CustomerService cust = (CustomerService)context.getBean("AAA"); 


自动 组 件 扫描 注释 类 型 
在 Spring2.5 中 ， 有 4 种 类 型 的 组 件 自动 扫描 注释 类 型 


e @Component - 指示 自动 扫描 组 件 。 

e @Repository — 表示 在 持久 层 DAO 组 件 。 
e @Service — 表示 在 业务 层 服务 组 件 。 

e @Controller - 表示 在 表示 层 控制 器 组 件 。 


因此 ， 使 用 哪 一 个 ? 其 实 并 不 那么 重要 。 参 见 @Repository，@Service 或 
(Controller 源 代码 。 


@Target({ElementType.TYPE}) 
QRetention(RetentionPolicy.RUNTIME) 
@Documented 

@Component 

public @interface Repository { 


String value() default ""; 


你 可 能 会 发 现 ， 所 有 的 @Repository, @Service 或 @Controller 被 注解 为 
@Component。 因 此 ， 我 们 可 以 只 使 用 @Component 对 所 有 组 件 进行 自动 打 描 ? 
是 的 ，Spring 会 自动 扫描 所 有 组 件 的 ( Component 注解 。 


它 工作 正常 ， 但 不 是 一 个 好 的 做 法 ， 为 便于 阅读 ， 应 该 始终 声明 @Repository，@ 
Service 或 @Controller 在 指定 的 层 ， 使 你 的 代码 更 易于 阅读 ， 如 下 : 


DAO 层 


package com. yiibai.customer.dao; 
import org.springframework.stereotype.Repository; 


@Repository 
public class CustomerDAO 
{ 
@Override 
public String toString() { 
return "Hello , This is CustomerDAO"; 
} 


Service E 


package com.yiibai.customer.services; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Service; 


import com.yiibai.customer.dao.CustomerDAO; 


@Service 
public class CustomerService 
{ 

@Autowired 

CustomerDAO customerDAO; 


QOverride 
public String toString() ( 
return "CustomerService [customerDAO=" + customerDAO + "]" 
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在 这 个 Spring 自动 组 件 扫描 的 教程 ， 您 已 经 了 解 如 何 使 Spring 自动 扫描 您 的 组 件 。 
在 这 篇 文章 中 ， 我 们 将 展示 如 何 使 用 组 件 过 滤器 自动 扫描 过 程 。 


1. 过 滤 组 件 - 包含 


参见 下 面 的 例子 中 使 用 Spring “过滤” 扫描 并 注册 匹配 定义 “regex"， 即 使 该 类 组 件 的 
名 称 未 标注 @Component 。 


DAO 层 


package com.yiibai.customer.dao; 


public class CustomerDAO 


1 
QOverride 
public String toString() (1 
return "Hello , This is CustomerDAO"; 
} 
} 
Service 层 


package com.yiibai.customer.services; 


import org.springframework.beans.factory.annotation.Autowired; 
import com.yiibai.customer.dao.CustomerDAO; 


public class CustomerService 


1 
@Autowired 
CustomerDAO customerDAO; 
QOverride 
public String toString() (1 
return "CustomerService [customerDAO-" + customerDAO + "]" 
Jj; 
} 


d MM 
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«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context-"http: //www.springframework.org/schema/context" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 
http://www.springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context -2 


«context:component-scan base-package="com.yiibai" > 


<context:include-filter type="regex" 
expression="com.yiibai.customer.dao.*DAO.*" 


<context:include-filter type="regex" 
expression="com.yiibai.customer.services. *S¢ 


</context: component - scan> 


</beans> 





package com. yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext(new String[] {"Spring-At 
CustomerService cust = (CustomerService)context.getBean("cı 
System.out.println(cust); 
j 
} 





输出 


CustomerService [customerDAO-Hello , This is CustomerDAO] 


在 这 个 XML 过 滤 中 ， 所 有 文件 的 名 称 中 包含 DAO  Service(DAO., Services.) 单 
词 将 被 检测 并 在 Spring 容器 中 注册 。 


2. 过 滤 组 件 - 不 包含 


另外 ， 您 还 可 以 排除 指定 组 件 ， 以 避免 Spring 检测 和 Spring 容器 注册 。 不 包括 在 
这 些 文件 中 标注 有 @Service 。 


«context:component-scan base-package="com.yiibai.customer" > 
<context:exclude-filter type="annotation" 
expression="org.springframework.stereotype.Service" /> 
</context:component-scan> 





不 包括 那些 包含 DAO 这 个 词组 文件 名 。 


<context:component-scan base-package="com.yiibai" > 
<context:exclude-filter type="regex" 
expression="com.yiibai.customer.dao.*DAO.*" /> 
</context :component-scan> 


a Er] 
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Spring 自动 装配 Beans - Spring 教程 


在 Spring 框架 ， 可 以 用 auto-wiring 功能 会 自动 装配 Bean。 要 启用 它 ， 只 需要 
义 “autowire" 属 性 。 


Bt 
a} 


«bean id="customer" class="com.yiibai.common.Customer" autowire="b\ 


«| I 








在 Spring 中 ， 支 持 5 自动 装配 模式 。 


e no 一 缺 省 情况 下 ， 自 动 配置 是 通过 “ref" 属 性 手动 设 定 

e byName — 根据 属性 名 称 自动 装配 。 如 果 一 个 bean 的 名 称 和 其 他 bean 属 性 的 名 
称 是 一 样 的 ， 将 会 自 装配 它 。 

e byType — 按 数据 类 型 自动 装配 。 如 果 一 个 bean 的 数据 类 型 是 用 其 它 bean 属 性 
的 数据 类 型 ， 兼容 并 自动 装 ALT 

e constructor — TE J43& WBMEMNbyTypeA XXe 

e autodetect — 如 果 找 到 默认 的 构造 画 数 ， 使 用 “自动 装配 用 构造 ”; 否则 ， 使 用 “ 按 
类 型 自动 装配 ”。 


示例 
Customer 和 Person 对 象 自动 装配 示范 。 


package com.yiibai.common; 
public class Customer 
{ 
private Person person; 
public Customer(Person person) { 
this.person = person; 
} 
public void setPerson(Person person) { 


this.person = person; 
} 


OO 


package com.yiibai.common; 


public class Person 


{ 
} 


Lae 


1. Auto-Wiring ‘no’ 
这 是 默认 的 模式 ， 你 需要 通过 'ref 属性 来 连接 bean. 


<bean id="customer" class="com.yiibai.common.Customer"> 
<property name="person" ref="person" /> 
</bean> 


<bean id="person" class="com.yiibai.common.Person" /> 


2. Auto-Wiring ‘byName’ 


按 属性 名 称 自动 装配 。 在 这 种 情况 下 ， 由 于 对 “person”bean 的 名 称 是 相同 
T "customer" bean 的 属性 (“person”) 名 称 ， 所 以 ，Spring 会 自动 通过 setter 方 法 将 其 
装配 — "setPerson(Person person)". 


«bean id="customer" class="com.yiibai.common.Customer" autowire="b\ 
<bean id="person" class="com.yiibai.common.Person" /> 


PD O 
查看 完整 的 示例 -~ Spring 按 名 称 自动 装配 





3. Auto-Wiring ‘byType’ 


通过 按 属性 的 数据 类 型 自动 装配 Bean。 在 这 种 情况 下 ， 由 于 “Person"” bean 中 的 数 
据 类 型 是 与 “customer bean 的 属性 (Person 对 象 ) 的 数据 类 型 一 样 的 ， 所 以 ，Spring 
会 自动 通过 setter 方 法 将 其 自动 装配 。- “setPerson(Person person)". 


«bean id="customer" class="com.yiibai.common.Customer" autowire="b\ 
<bean id="person" class="com.yiibai.common.Person" /> 


E iia zs 





查看 完整 的 示例 - Spring 通过 类 型 自动 装配 


4. Auto-Wiring ‘constructor’ 


通过 构造 画 数 参数 的 数据 类 型 按 属性 自动 装配 Bean。 在 这 种 情况 下 ， 由 于 “person” 
bean 的 数据 类 型 与 ‘customer” bean 的 属 性 (Person 对 象 ) 的 构造 图 数 参 数 的 数据 类 型 

一 样 的 ， 所 以 ，Spring 通 过 构造 方法 自动 装配 — "public Customer(Person 
person)". 


«bean id="customer" class="com.yiibai.common.Customer" autowire="c<¢ 


<bean id="person" class="com.yiibai.common.Person" /> 


‘| _ # 








查看 完整 的 示例 — *. </p> <pre><bean id=) 


[查看 完整 的 示例 — Yhttp://www.yiibai. com/spring/spring- autowiring-by- 
constructor.html>Spring 通 过 构造 方法 自动 装配 </a&gt; </p> 


&lt;h2&gt; 
5N. Auto-Wiring ‘autodetect’ 
&lt;/h2&gt; 


&lt;p&gt; 
如 果 找 到 默认 的 构造 画 数 ， 则 使 用 “构造 方法 “; 否则 ， 使 用 “byType”。 在 这 科 
&lt;/p&gt; 





«pre» «bean id=)Spring 按 AutoDetect 自 动 装配 成 功 . 
注 这 是 一 件 好 事 ， 这 两 个 auto-wire’ 和 ‘dependency-check’ 相 结 合 ， 以 确保 属性 始 
终 自动 装配 成 功 。 


«bean id="customer" class="com.yiibai.common.Customer" 
autowire="autodetect" dependency-check="objects /> 


<bean id="person" class="com.yiibai.common.Person" /> 


结论 
在 我 看 来 ，Spring ‘auto-wiring 以 极 大 的 成 本 做 出 更 快 开发 效率 - 它 增 加 了 对 整个 
bean 配置 文件 复杂 性 ， 基 至 不 知道 哪些 bean 将 自动 装配 哪个 Bean。 


在 实践 中 ， 我 更 项 向 手动 关联 创建 ， 它 始终 是 干净 ， 也 很 好 地 工作 ， 或 者 使 用 
@Autowired 注解 ， 这 是 更 加 灵活 和 建议 。 


Spring AOP 通 知 实例 — Advice - Spring 教程 


Spring AOP (Fl 73 IH AR FS HEAR, 用 于 在 模块 化 方面 的 横 切 关注 点 。 简单 得 说 ， 它 
只 是 一 个 拦截 器 拦截 一 些 过 程 ， 例 如 ， 当 一 个 方法 执行 ，Spring AOP 可 以 劫持 一 
个 执行 的 方法 ， 在 方法 执行 之 前 或 之 后 添加 额外 的 功能 。 在 Spring AOP 中 ， 有 4 种 
类 型 通知 (advices) 的 支持 : 


通知 (Advice) 之 前 - 该 方法 执行 前 运行 

通知 (Advice) 返 回 之 后 - 运行 后 ， 该 方法 返回 一 个 结果 
通知 (Advice) 抛 出 之 后 - 运行 方法 抛 出 异常 

环绕 通知 - 环绕 方法 执行 运行 ， 结 合 以 上 这 三 个 通知 。 


下 面 的 例子 显示 Spring AOP 通知 如 何 工作 。 


简单 的 Spring 例子 
创建 一 个 简单 的 客户 服务 类 及 一 个 print 方 法 作为 演示 。 


package com.yiibai.customer.services; 


public class CustomerService { 
private String name; 
private String url; 


public void setName(String name) { 


this.name = name; 
} 


public void setUrl(String url) { 
this.url = url; 


j 
public void printName() ( 
System.out.println("Customer name : " + this.name); 
j 
public void printURL() (1 
System.out.println("Customer website : " + this.url); 
j 


public void printThrowException() ( 
throw new IllegalArgumentException(); 
j 


File : applicationContext.xml — 一 个 bean 配 置 文件 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="YiiBaii Mook Kim" /> 
«property name="url" value="http://ww.yiibai.com" /> 

</bean> 


</beans> 


BJ 





执行 它 
package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App { 
public static void main(String[] args) { 
ApplicationContext appContext = new ClassPathXmlApplicatior 
new String[] { "Spring-Customer.xml" }); 


CustomerService cust = (CustomerService) appContext.getBear 


System out pacato dd rodeo acd Ed ek E) . 
: : ; 
cust.printName(); 
System out rt esq SL 
cust.printURL(); 
System out prede used AE 
try { 

cust.printThrowException(); 
) catch (Exception e) { 





*ckckckck kck ko k ko ck ko k kkckkc ke kkk*k*k*kk* 


Customer name : Yiibai Mook Kim 
Wok X*ck kckkck Ac ckck Kk ko ck k ko kk k kk k kk 


Customer website : http://www.yiibai.com 


一 个 简单 的 Spring 项 目 用 来 注入 (Dl)bean 和 输出 一 些 字符 串 。 


Spring AOP 通知 


现在 ， 附 加 Spring AOP 建议 到 上 述 的 客户 服务 。 


1. 之 前 通知 
它 会 在 方法 执行 之 前 执行 。 创 建 一 个 实现 MethodBeforeAdvice 接口 的 类 。 


package com.yiibai.aop; 


import java.lang.reflect.Method; 
import org.springframework.aop.MethodBeforeAdvice; 


public class HijackBeforeMethod implements MethodBeforeAdvice 
{ 
@Override 
public void before(Method method, Object[] args, Object target: 
throws Throwable { 
System.out.println("HijackBeforeMethod : Before method 





在 bean 配置 文件 (applicationContext.xml)， 创 建 一 个 bean 的 
HijackBeforeMethod 类 ， 并 命名 为 “customerServiceProxy” 作为 一 个 新 的 代理 对 


o 


e ‘target’ — 定义 你 想 拦 截 的 bean。 
e ‘interceptorNames’ 一 定义 要 应 用 这 个 代理 /目标 对 象 的 类 (通知 )。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 

http: //www.springframework.org/schema/beans/spring-beans-2 


«bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="Yiibai Mook Kim" /> 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


«bean id="hijackBeforeMethodBean" class-"com.yiibai.aop.Hijackt 


«bean id="customerServiceProxy" 
class="org.springframework.aop.framework.ProxyFact 


«property name="target" ref="CustomerService" /> 


<property name="interceptorNames"> 
<list> 
<value>hijackBeforeMethodBean</value> 
</list> 
</property> 
</bean> 
</beans> 


二 eee | 


再 次 运行 它 ， 现 在 得 到 新 的 customerServiceProxy bean, 而 不 是 原来 的 
CustomerService bean. 





package com. yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 
import com.yiibai.customer.services.CustomerService; 


public class App ( 
public static void main(String[] args) { 
ApplicationContext appContext - new ClassPathXmlApplicatior 
new String[] ( "Spring-Customer.xml" 3); 


CustomerService cust - 
(CustomerService) appContext.getBe: 


System out fo goal e ual a bod decus ESQ S a gU M ais) . 
: f ; 
cust.printName(); 
System out pn Er tr te osse act. 
cust.printURL(); 
SY Sem Oui mt 
try { 

cust.printThrowException(); 
} catch (Exception e) { 





输出 结果 


ee 


HijackBeforeMethod : Before method hijacked! 


Customer name : Yiibai Mook Kim 
KK Rk ee ek ke ke Kk ek ke ke kek kk ke, 


HijackBeforeMethod : Before method hijacked! 
Customer website : http://www. yiibai.com 


*okckckck kck ko k ko ck ko k kk kk ke kkk*k*k*kk* 


HijackBeforeMethod : Before method hijacked! 


它 将 运行 HijackBeforeMethod 的 before() 方法 ， 在 每 个 CustomerService 的 方法 
之 前 执行 。 


2. 返 回 后 通知 


该 方法 返回 一 个 结果 之 后 它 将 执行 。 创 建 一 个 实现 AfterReturningAdvice 接 口 的 


类 
Fo 


package com.yiibai.aop; 


import java.lang.reflect.Method; 
import org.springframework.aop.AfterReturningAdvice; 


public class HijackAfterMethod implements AfterReturningAdvice 
{ 
@Override 
public void afterReturning(Object returnValue, Method method, 
Object[] args, Object target) throws Throwable { 
System.out.println("HijackAfterMethod : After method h: 





bean 配 置 文件 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 

http: //www.springframework.org/schema/beans/spring-beans-2 


«bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="Yong Mook Kim" /> 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


«bean id="hijackAfterMethodBean" class="com.yiibai.aop.HijackAt 


«bean id="customerServiceProxy" 
class="org.springframework.aop. framework. ProxyFact¢ 


«property name="target" refz'customerService" /> 


<property name="interceptorNames"> 
<list> 
<value>hijackAfterMethodBean</value> 
</list> 
</property> 
</bean> 
</beans> 


> 
再 次 运行 ， 输 出 





wn 


Customer name : Yiibai Mook Kim 
HijackAfterMethod : After method hijacked! 


大 炎炎 炎炎 炎炎 火炎 炎炎 炎炎 炎炎 炎炎 类 炎炎 火炎 火炎 类 


Customer website : http://www.yiibai.com 
HijackAfterMethod : After method hijacked! 


*okckckck kck ko ko ko ok ck ck kk kk k kk k*k*k*k* 


cia 17 HijackAfterMethod 的 afterReturning() 方 法 ， 在 每 次 CustomerService A 
法 返回 结果 之 后 。 


3. 抛 出 后 通知 


它 将 在 执行 方法 抛 出 一 个 异常 后 。 创 建 一 个 实现 ThrowsAdvice 接 口 的 类 ， 并 创建 一 
个 afterThrowing 方 法 拦截 抛 出 : lllegalArgumentException 异 常 。 

package com.yiibai.aop; 

import org.springframework.aop.ThrowsAdvice; 

public class HijackThrowException implements ThrowsAdvice { 


public void afterThrowing(IllegalArgumentException e) throws TI 
System.out.println("HijackThrowException : Throw exception 





bean 配 置 文件 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 

http: //www.springframework.org/schema/beans/spring-beans-2 


«bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="Yong Mook Kim" /> 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


«bean id="hijackThrowExceptionBean" class="com.yiibai.aop.Hijac 


<bean id="customerServiceProxy" 
class="org.springframework.aop.framework.ProxyFact 


«property name="target" ref="CustomerService" /> 


<property name="interceptorNames"> 
<list> 
<value>hijackThrowExceptionBean</value> 
</list> 
</property> 
</bean> 
</beans> 


Ei ES zm 


再 次 运行 ， 输 出 





*okckckck kck ck ko kok ck k kk kk kk kk*k*k*k* 


Customer name : Yiibai Mook Kim 


*okckckck kck ko ko ko k ck ck kk kk kk kk*k*k*k* 


Customer website : http://www.yiibai.com 


*ockckckck kck ko ko ko k ck k kk kk kk kkk*k*k* 


HijackThrowException : Throw exception hijacked! 


它 将 运行 HijackThrowException 的 afterThrowing()753&, 2052 CustomerService 
的 方法 抛 出 异常 。 


4. 环 绕 通 知 


它 结合 了 上 面 的 三 个 通知 ， 在 方法 执行 过 程 中 执行 。 创 建 一 个 实现 了 
Methodinterceptor 接 口 的 类 。 必 须 调用 “methodlnvocation.proceed();” 继续 在 原来 
的 方法 执行 ， 否 则 原来 的 方法 将 不 会 执行 。 


package com.yiibai.aop; 
import java.util.Arrays; 


import org.aopalliance.intercept.MethodInterceptor; 
import org.aopalliance.intercept.MethodInvocation; 


public class HijackAroundMethod implements MethodInterceptor { 
QOverride 
public Object invoke(MethodInvocation methodInvocation) throws 
System.out.println("Method name : " 
* methodInvocation.getMethod().getName()); 
System.out.println("Method arguments 5 
+ Arrays.toString(methodInvocation.getArguments()): 


// same with MethodBeforeAdvice 
System.out.println("HijackAroundMethod : Before method hij: 


try { 
// proceed to original method call 


Object result - methodInvocation.proceed(); 


// same with AfterReturningAdvice 
System.out.println("HijackAroundMethod : Before after | 


return result; 


) catch (IllegalArgumentException e) { 
// same with ThrowsAdvice 
System.out.println("HijackAroundMethod : Throw exceptic 
throw e; 





bean 配 置 文件 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 

http: //www.springframework.org/schema/beans/spring-beans-2 


«bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="Yong Mook Kim" /> 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


<bean id="hijackAroundMethodBean" class-"com.yiibai.aop.Hijack/ 


«bean id="customerServiceProxy" 
class="org.springframework.aop. framework. ProxyFact¢ 


«property name="target" refz'"customerService" /> 


<property name="interceptorNames"> 
<list> 
<value>hijackAroundMethodBean</value> 
</list> 
</property> 
</bean> 
</beans> 


-1 0 9. 
再 次 运行 ， 输 出 





*okckckck kck ko ko ko k ck k k kk kk kk k*k*k*k* 


Method name : printName 

Method arguments : [] 

HijackAroundMethod : Before method hijacked! 
Customer name : YiiBai Mook Kim 
HijackAroundMethod : Before after hijacked! 
*ockckck kockockck kock ck ko kock ck ck k ck kk kkkk* 

Method name : printURL 

Method arguments : [] 

HijackAroundMethod : Before method hijacked! 
Customer website : http://www.yiibai.com 
HijackAroundMethod : Before after hijacked! 
*ckckck kockock ck kock ok ko kock ck k k ck k kk kkk* 

Method name : printThrowException 

Method arguments : [] 

HijackAroundMethod : Before method hijacked! 
HijackAroundMethod : Throw exception hijacked! 


4JHijackAroundMethod 的 invoke() 方 法 ， 在 每 一 个 CustomerService 方法 


总 结 

大 部 分 的 Spring 开发 者 都 只 是 实现 了 “环绕 通知 "， 因 为 它 可 以 对 所 有 通知 类 型 ， 但 
更 好 的 做 法 应 该 是 选择 最 合适 的 通知 类 型 来 满足 要 求 。 切 入 点 在 这 个 例子 中 ， 在 一 
客户 服务 类 中 的 所 有 方法 都 自动 拦截 (通知 )。 但 在 大 多 数 情况 下 ， 可 能 需要 使 用 切 
入 点 和 Advisor 通 过 它 的 方法 名 拦截 它 的 方法 。 下 载 代码 — 


Spring AOP & Bll(Pointcut, Advisor) - Spring 教程 


在 上 一 个 Spring AOP 通 知 的 例子 ， 一 个 类 的 整个 方法 被 自动 拦截 。 但 在 大 多 数 情况 
下 ， 可 能 只 需要 一 种 方式 来 拦截 一 个 或 两 个 方法 ， 这 就 是 为 什么 引入 ' 切 入 点 ' 的 原 

因 。 它 允许 你 通过 它 的 方法 名 来 拦截 方法 。 另外， 一 个 “切入 点 "必须 具有 “Advisor' 

相关 联 。 在 Spring AOP 中 ， 有 三 个 非常 专业 术语 - Advices, Yiibaicut , Advisor， 把 
它 在 非 官方 的 方式 .… 


e Advice — 指示 之 前 或 方法 执行 后 采取 的 行动 。 
e Yiibaicut — 指明 哪些 方法 应 该 拦截 ， 通 过 方法 的 名 称 或 正则 表达 式 模 式 。 
e Advisor — 分 组 "通知 "和 ”切入 点 "成 为 一 个 单元 ， 并 把 它 传递 到 代理 工厂 对 象 。 


再 次 回顾 上 一 个 Spring AOP 通 知 的 例子 


File : CustomerService.java 


package com.yiibai.customer.services; 


public class CustomerService 


{ 
private String name; 
private String url; 
public void setName(String name) { 
this.name = name; 
} 
public void setUrl(String url) { 
this.url - url; 
} 
public void printName(){ 
System.out.println("Customer name : " + this.name); 
} 
public void printURL(){ 
System.out.println("Customer website : " + this.url); 
} 
public void printThrowException(){ 
throw new IllegalArgumentException(); 
} 
} 


File : applicationContext.xml 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 

http: //www.springframework.org/schema/beans/spring-beans-2 


«bean id="customerService" class-'com.yiibai.customer.services 
«property name="name" value="Yong Mook Kim" /> 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 
«bean id="hijackAroundMethodBeanAdvice" class-'com.yiibai.aop.! 


«bean id="customerServiceProxy" 
class="org.springframework.aop.framework.ProxyFact¢ 


«property name="target" refz'"customerService" /> 


<property name="interceptorNames"> 
<list> 
<value>hijackAroundMethodBeanAdvice</value> 
</list> 
</property> 
</bean> 
</beans> 





File : HijackAroundMethod.java 


package com.yiibai.aop; 


import java.util.Arrays; 
import org.aopalliance.intercept.MethodInterceptor; 
import org.aopalliance.intercept.MethodInvocation; 


public class HijackAroundMethod implements MethodInterceptor { 
QOverride 
public Object invoke(MethodInvocation methodInvocation) throws 
System.out.println("Method name à 
* methodInvocation.getMethod().getName()); 
System.out.println("Method arguments A 
+ Arrays.toString(methodInvocation.getArguments()): 


System.out.println("HijackAroundMethod : Before method hij: 


try { 
Object result - methodInvocation.proceed(); 


System.out.println("HijackAroundMethod : Before after | 
return result; 


) catch (IllegalArgumentException e) { 


System.out.println("HijackAroundMethod : Throw exceptic 
throw e; 





package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.customer.services.CustomerService; 


public class App ( 
public static void main(String[] args) { 
ApplicationContext appContext = new ClassPathXmlApplicatior 
new String[] { "applicationContext.xml" }); 


CustomerService cust = (CustomerService) appContext 
.getBean("customerServiceProxy"); 


System out prime te aie RARE eat ae acta 1 
: : ; 
cust.printName(); 
System out rmtn ee ee a 
cust.printURL(); 
System OUR tn 
try { 

cust.printThrowException(); 
} catch (Exception e) { 





输出 


*okckckck kck ko ko ko k ck ok kk kk k kk k*k*k*k* 


Method name : printName 

Method arguments : [] 

HijackAroundMethod : Before method hijacked! 
Customer name : Yiibai 

HijackAroundMethod : Before after hijacked! 
*ckckck kockckck kock ck ck ko ck ck k ck ck ko kk kkk* 

Method name : printURL 

Method arguments : [] 

HijackAroundMethod : Before method hijacked! 
Customer website : http://www.yiibai.com 
HijackAroundMethod : Before after hijacked! 
*Wockckck kockockck kock ck ko ko ck ck ck k ck k kk kk ke 

Method name : printThrowException 

Method arguments : [] 

HijackAroundMethod : Before method hijacked! 
HijackAroundMethod : Throw exception hijacked! 


客户 服务 类 的 全 部 方法 被 截获 。 后 来 ， 我 们 展示 如 何 使 用 “切入 点 "只 拦截 
printName() 方 法 。 


切入 点 的 例子 


可 以 通过 以 下 两 种 方式 相 匹 配 的 方法 : 


1. 名 称 匹 配 
2. 正则 表达 式 匹配 


1.9) A 5a - 名 称 匹 配 的 例子 


通过 “切入 点 "和 “advisor 拦截 printName() 方 法 。 创 建 NameMatchMethodYiibaicut 切 
入 点 bean， 并 提出 要 在 “mappedName” 属 性 值 来 拦截 方法 名 。 


<bean id="customerYiibaicut" 
class-"org.springframework.aop.support.NameMatchMethodYiib: 
<property name-"mappedName" value="printName" /» 
</bean> 


Dc ———A———————————————— (2252 ve] 


$) DefaultYiibaicutAdvisor 通知 bean， 通 知 和 切入 点 相关 联 。 





«bean id="customerAdvisor" 
class="org.springframework.aop.support .DefaultYiibaicutAdv: 
<property name="pointcut" ref="customerYiibaicut" /> 
«property name="advice" ref="hijackAroundMethodBeanAdvice" 
</bean> 


BEM 





更 换代 理 “interceptorNames” 到 “customerAdvisor”( 它 
是 “hijackAroundMethodBeanAdvice”) 。 


<bean id="customerServiceProxy" 
class="org.springframework.aop.framework.ProxyFactoryBean": 


«property name="target" refz'"customerService" /> 


<property name="interceptorNames"> 
<list> 
<value>customerAdvisor</value> 
</list> 
</property> 
</bean> 


Eee 
全 部 bean 配 置 文件 





«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="Yiibai" /> 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


«bean id="hijackAroundMethodBeanAdvice" class-'com.yiibai.aop.! 


«bean id="customerServiceProxy" 
class-"org.springframework.aop.framework.ProxyFact« 


«property name="target" refz'"customerService" /> 


«property name="interceptorNames"> 
«list» 
<value>customerAdvisor</value> 
</list> 
</property> 
</bean> 


<bean id="customerYiibaicut" 
class="org.springframework.aop.support .NameMatchMet 
<property name="mappedName" value="printName" /> 
</bean> 


<bean id="customerAdvisor" 
class="org.springframework.aop.support.DefaultYiil 
«property name="pointcut" ref="customerYiibaicut" /> 
«property name="advice" ref="hijackAroundMethodBeanAdvice" 
</bean> 


</beans> 





再 次 运行 ， 输 出 


*okckckck kck ko ko ko k ck k kk kc kk kkk*k*k*k* 


Method name : printName 

Method arguments : [] 

HijackAroundMethod : Before method hijacked! 
Customer name : Yiibai 

HijackAroundMethod : Before after hijacked! 


*okckckck kck ko ko ko k ck ok kk kk k kk k*k*k*k* 


Customer website : http://www.yiibai.com 


*okckckck kck ko ko ko k ck ck kk kc kk kkkk*k*k* 


现在 ， 只 拦截 printName() 方 法 。YiibaicutAdvisor Spring 提供 了 YiibaicutAdvisor 
类 来 保存 工作 声明 advisor 和 切入 点 到 不 同 的 bean， 可 以 使 用 
NameMatchMethodYiibaicutAdvisor 两 者 结合 成 一 个 bean。 


zo A 


<bean id="customerAdvisor" 
class-"org.springframework.aop.support.NameMatchMethodYiib: 


«property name-"mappedName" value="printName" /> 
«property name-"advice" ref="hijackAroundMethodBeanAdvice" 


</bean> 


‘| == 








2.0 Ara - 正则 表达 式 的 例子 


也 可 以 通过 使 用 正则 表达 式 匹 配 切 人 点 方法 的 名 称 — 
RegexpMethodYiibaicutAdvisor. 


«bean id="customerAdvisor" 


class-"org.springframework.aop.support.RegexpMethodYiibaicti 
«property name="patterns"> 
«list» 
<value>.*URL.*</value> 
</list> 
</property> 


«property name="advice" ref="hijackAroundMethodBeanAdvice" 
</bean> 


E PEE Ds 





现在 ， 它 拦截 方法 名 称 中 有 “URL” 的 方法 。 在 实践 中 ， 可 以 用 它 来 管理 DAO 层 ， 声 
BA“ DAO.” 拦截 所 有 的 DAO 类 来 支持 事务 。 


FARA - http:/pan.baidu.com/s/1pJU2PoJ 


Spring 目 动 代理 创建 者 实例 - Spring 教程 


在 上 一 篇 Spring AOP 实 例 — advice, pointcut 和 advisor, 必须 手动 创建 一 个 代理 
bean(ProxyFactryBean)， 对 每 个 Bean 需 要 AOP 支 持 。 这 不 是 一 种 有 效 的 方式 ， 例 
如 ， 如 果 想 在 客户 模块 ， 所 有 的 DAO 类 实现 SQL 日 志 支 持 ( 提 醒 ) 的 AOP 功 能 ， 那 么 
必须 手动 创建 很 多 代理 工厂 bean， 因 此 在 bean 配 置 文件 可 能 会 泛 小 代理 类 。 幸 运 
的 是 ，Spring 有 两 个 自动 代理 创建 者 来 自动 创建 代理 bean。 


1. BeanNameAutoProxyCreator 示 例 
在 此 之 前 ， 必 须 手 动 创建 一 个 代理 bean(ProxyFactryBean)。 


<beans xmlns="http://www.springframework.org/schema/beans" 

xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2 


«bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="Yiibai Mook Kim" /> 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


«bean id="hijackAroundMethodBeanAdvice" class-'com.yiibai.aop.! 


«bean id="customerServiceProxy" 
class="org.springframework.aop.framework.ProxyFactoryBean": 


«property name="target" ref="CcustomerService" /> 


<property name="interceptorNames"> 
<list> 
<value>customerAdvisor</value> 
</list> 
</property> 
</bean> 


<bean id="customerAdvisor" 
class="org.springframework.aop.support .NameMatchMethodTutot 
<property name="mappedName" value="printName" /> 
<property name="advice" ref="hijackAroundMethodBeanAdvice" 
</bean> 
</beans> 


«| aa 








并 代理 名 称 “customerServiceProxy” 获 得 bean. 


CustomerService cust = (CustomerService)appContext .getBean("custome 
‘| — — B 


在 自动 代理 机 制 ， 只 需要 创建 一 个 的 BeanNameAutoProxyCreator， 并 包含 所 有 你 
的 bean( 通 过 bean 的 名 字 ， 或 正则 表达 式 名 ) 和 "advisor 作为 一 个 单位 。 








«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 

http: //www.springframework.org/schema/beans/spring-beans-2 


«bean id="customerService" class-'com.yiibai.customer.services 
«property name="name" value="Yiibai Mook Kim" /» 
«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


«bean id="hijackAroundMethodBeanAdvice" class-'com.yiibai.aop.! 


«bean id="customerAdvisor" 
class="org.springframework.aop.support .NameMatchMethodTutot 
<property name="mappedName" value="printName" /> 
«property name="advice" ref="hijackAroundMethodBeanAdvice" 

</bean> 


<bean 
class="org.springframework.aop.framework.autoproxy .BeanName 
<property name="beanNames"> 
<list> 
<value>*Service</value> 
</list> 
</property> 
<property name="interceptorNames"> 
<list> 
<value>customerAdvisor</value> 
</list> 
</property> 
</bean> 
</beans> 


T E ee 





现在 ， 可 以 通过 “CustomerService” 的 原始 名 称 获 取 bean, 如 果 知 道 这 个 bean 已 经 代 
理 。 


CustomerService cust = (CustomerService)appContext.getBean("custom: 


‘ 一 一 一 








2. DefaultAdvisorAutoProxyCreator 示 例 


这 个 DefaultAdvisorAutoProxyCreator 是 非常 强大 的 ， 如 果 有 任何 的 bean 可 相 提 
并 论 ，Spring 会 自动 创建 一 个 代理 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 

http: //www.springframework.org/schema/beans/spring - beans -2 


<bean id="customerService" class="com.yiibai.customer.services 
<property name="name" value="Yiibai Mook Kim" /> 


«property name="url" value="http://ww.yiibai.com" /> 
</bean> 


«bean id="hijackAroundMethodBeanAdvice" class-'com.yiibai.aop.! 


«bean id-"customerAdvisor" 


class-"org.springframework.aop.support.NameMatchMethodTutoi: 
«property name="mappedName" value="printName" /> 


«property name="advice" ref="hijackAroundMethodBeanAdvice" 
</bean> 


<bean class-"org.springframework.aop.framework.autoproxy.De! 


</beans> 





这 仅仅 是 对 权力 ， 因 为 你 不 用 管 什 么 Bean 应 该 被 代理 ， 可 以 做 的 就 是 相信 Spring 
会 做 最 适合 你 的 。 如 果 要 实现 这 个 到 你 的 项 目 ， 请 妥善 保管 。 下 载 代 码 -— 
http://pan.baidu.com/s/1pKdqtjt 


Spring AOP+AspectJ 注 解 实 例 - Spring 教程 


在 本 教程 中 ， 我 们 将 向 你 展示 如 何 将 AspectJ 注 解 集成 到 Spring AOP 框 架 。 在 这 个 
Spring AOP+ AspectJ 示例 中 ， 让 您 轻松 实现 拦截 方法 。 常 见 AspectJ 的 注解 : 


. @Before — 方法 执行 前 运行 

. @After — 运行 在 方法 返回 结果 后 

. @AfterReturning — 运行 在 方法 返回 一 个 结果 后 ， 在 拦截 器 返回 结果 。 
. @AfterThrowing 一 运行 方法 在 抛 出 异常 后 ， 

. @Around - 围绕 方法 执行 运行 ， 结 合 以 上 这 三 个 通知 。 


注意 Spring AOP 中 没有 AspectJ 支持 ， 请 阅读 AE Spring AOP 例子 。 


OOD 


1. 目录 结构 


4 {2 5.6-SpringDemo 

4 § src 

4 {8 comyilbai.aspect 

pË LoggingAspectjava 
4 册 comyibai.core 
|J] Appjava 
4 IB comyiibai.customer.bo 
J) CustomerBo java 


4 册 com yiibai.customer.bo.impl 





[jS CustomerBolmpl.java 
45 applicationContext.xml 

mi, JRE System Library [JavaSE-1.6] 

BA Spring 3.1 Core Libraries 


看 到 这 个 例子 的 目录 结构 。 smaa . 


2. Spring Beans 


普通 bean 中 有 几 个 方法 ， 后 来 通过 AspectJ 注解 拦截 。 


package com.yiibai.customer.bo; 
public interface CustomerBo { 
void addCustomer(); 
String addCustomerReturnValue(); 
void addCustomerThrowException() throws Exception; 


void addCustomerAround(String name); 


package com.yiibai.customer.bo.impl; 
import com.yiibai.customer.bo.CustomerBo; 
public class CustomerBoImpl implements CustomerBo { 


public void addCustomer(){ 
System.out.println("addCustomer() is running "); 
j 


public String addCustomerReturnValue(){ 
System.out.println("addCustomerReturnValue() is running "), 
return "abc"; 


} 


public void addCustomerThrowException() throws Exception { 
System.out.println("addCustomerThrowException() is running 
throw new Exception("Generic Error"); 


} 


public void addCustomerAround(String name) { 
System.out.println("addCustomerAround() is running, args : 





4. 2 FHAspectJ 


在 Spring 配置 文件 ， 把 ”， 并 定义 Aspect( 拦 截 ) 和 普通 的 bean。 


File : applicationContext.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:aop-z"http://www.springframework.org/schema/aop" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x: 
http://www. springframework.org/schema/aop 
http://www. springframework.org/schema/aop/spring-aop-3.0.xsd "> 


<aop:aspectj-autoproxy /> 
«bean id="customerBo" class-'com.yiibai.customer.bo.impl.Custor 


<!-- Aspect --> 
«bean id="logAspect" class="com.yiibai.aspect.LoggingAspect" /: 


</beans> 


EEJ EEE) 





4. AspectJ @Before 


在 下 面 例 子 中 ，logBefore() 方 法 将 在 customerBo 接 口 的 addCustomer() 方 法 的 执 
行 之 前 被 执行 。AspectJ 的 “切入 点 "是 用 来 声明 哪 种 方法 将 被 拦截 ， 应 该 参考 Spring 
AOP 切 入 点 指南 ， 支 持 切 入 点 表达 式 的 完整 列表 。 


File : LoggingAspect.java 


package com.yiibai.aspect; 


import org.aspectj.lang.JoinYiibai; 
import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.Before; 


@Aspect 
public class LoggingAspect { 


QBefore("execution(* com.yiibai.customer.bo.CustomerBo.addCust« 
public void logBefore(JoinYiibai joinYiibai) { 


System.out.println("logBefore() is running!"); 
System.out.println("hijacked : " + joinYiibai.getSignaturei 
System. out.println("******"); 








CustomerBo customer = (CustomerBo) appContext.getBean("customerBo" 
customer .addCustomer(); 


«| = 











输出 结果 


logBefore() is running! 
hijacked : addCustomer 


KKKKKK 


addCustomer() is running 


5. AspectJ @After 


在 下 面 例子 中 ，logAfter() 方 法 将 在 customerBo 接口 的 addCustomer() 方 法 的 执行 
之 后 执行 。 


File : LoggingAspect.java 


package com.yiibai.aspect; 


import org.aspectj.lang.JoinYiibai; 
import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.After; 


QAspect 
public class LoggingAspect { 


QAfter("execution(* com.yiibai.customer.bo.CustomerBo.addCustor 
public void logAfter(JoinYiibai joinYiibai) ( 


System.out.println("logAfter() is running!"); 
System.out.println("hijacked : " + joinYiibai.getSignaturei 
System.out.println("******"); 





运行 它 


CustomerBo customer = (CustomerBo) appContext.getBean("customerBo"' 
customer.addCustomer(); 


本 - 











输出 结果 


addCustomer() is running 
logAfter() is running! 
hijacked : addCustomer 


KKKKKK 


6. AspectJ @AfterReturning 


在 下 面 例子 中 ，logAfterReturning() 方 法 将 在 customerBo 接口 的 


addCustomerReturnValue() 方 法 执行 之 后 执行 。 此 外 ， 还 可 以 截取 返回 的 值 使 


用 “returning” 属 性 。 
要 截取 返回 的 值 ， 对 “returning” 属 性 (结果 ) 的 值 必须 用 相同 的 方法 参数 (结果 )。 
File : LoggingAspect.java 


package com.yiibai.aspect; 


import org.aspectj.lang.JoinYiibai; 
import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.AfterReturning; 


QAspect 
public class LoggingAspect { 


QAfterReturning( 
pointcut = "execution(* com.yiibai.customer.bo.Customer 
returning- "result") 

public void logAfterReturning(JoinYiibai joinYiibai, Objec 


System.out.println("logAfterReturning() is running!"); 


System.out.println("hijacked : " + joinYiibai.getSignatur 
System.out.println("Method returned value is : " + result 
System.out.println( vss 

} 


Bo ,ad 


t rest 


e().gt 
); 





运行 它 


CustomerBo customer = (CustomerBo) appContext.getBean("custom 
customer .addCustomerReturnValue(); 


erBo"' 





SEE | 





addCustomerReturnValue() is running 
logAfterReturning() is running! 
hijacked : addCustomerReturnValue 
Method returned value is : abc 


KKKKKK 


7. AspectJ @AfterReturning 


在 下 面 的 例子 中 ， 如 果 customerBo 接口 的 addCustomerThrowException() 方 法 抛 
出 异常 logAfterThrowing() 方 法 将 被 执行 。 


File : LoggingAspect.java 


package com.yiibai.aspect; 


import org.aspectj.lang.JoinYiibai; 
import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.AfterThrowing; 


QAspect 
public class LoggingAspect { 


QAfterThrowing( 
pointcut = "execution(* com.yiibai.customer.bo.CustomerBo.adt 
throwing- "error") 
public void logAfterThrowing(JoinYiibai joinYiibai, Throwable « 


System.out.println("logAfterThrowing() is running!"); 


System.out.println("hijacked : " + joinYiibai.getSignature() .ge 
System.out.println("Exception : " + error); 

System out printiim( 5555)» 

j 





运行 它 


CustomerBo customer = (CustomerBo) appContext.getBean("customerBo" 
customer .addCustomerThrowException(); 





addCustomerThrowException() is running 
logAfterThrowing() is running! 

hijacked : addCustomerThrowException 

Exception : java.lang.Exception: Generic Error 


KKKKKK 


Exception in thread "main" java.lang.Exception: Generic Error 


UD ausa 


8. AspectJ @Around 


在 下 面 例子 中 ，logAround() 方 法 将 在 customerBo 接 口 的 addCustomerAround() 方 
法 执行 之 前 执行 ， 必须 定义 "joinYiibai.proceed();” 控制 何 时 拦截 器 返回 控制 到 原来 
的 addCustomerAround() 方 法 。 


File : LoggingAspect.java 


package com.yiibai.aspect; 


import org.aspectj.lang.ProceedingJoinYiibai; 
import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.Around; 


@Aspect 


public class LoggingAspect { 


QAround("execution(* com.yiibai.customer.bo.CustomerBo.addCustor 


public void 


System.out 


System.out. 
joinYiibai. 
System.out. 


System.out. 


logAround(ProceedingJoinYiibai joinYiibai) throws TI 


.println("logAround() is running!"); 
System.out. 
System.out. 


println("hijacked method : " + joinYiibai.getSignati 
println("hijacked arguments : " + Arrays.toString(j« 


println("Around before is running!"); 
proceed(); //continue on the intercepted method 
println("Around after is running!"); 


picto a ee ae 





CustomerBo customer = (CustomerBo) appContext.getBean("customerBo"' 
customer.addCustomerAround("yiibai"); 


bi 


- ee 





El 
输出 结果 





logAround() is running! 

hijacked method : addCustomerAround 

hijacked arguments : [yiibai] 

Around before is running! 

addCustomerAround() is running, args : yiibai 
Around after is running! 


KKKKKK 
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它 总 是 建议 采用 最 少 AspectJ 注解 。 这 是 关于 Spring AspectJ 的 一 篇 相当 长 的 文 
章 。 进 一 步 的 解释 和 例子 ， 请 访问 下 面 的 参考 链接 。 下 载 源 代 码 - 
http://pan.baidu.com/s/1boo4f9P 


Spring Object 到 XML 映射 实例 - Spring 教程 


Spring 的 Object/XML 映 射 季 对 象 转 换 到 XML， 或 反之 亦 然 。 这 个 过 程 也 被 称 为 


1. XML Marshalling — 转换 对 象 到 XML 
2. XML UnMarshalling — 转换 XML 到 对 象 


在 本 教程 中 ， 我 们 将 介绍 如 何 使 用 Spring 的 OXM 来 做 转换 ， Object <--- Spring 
oxm ---> XML. 


SE: 为 什么 使 用 Spring 的 OXM 有 好 处 ?请 阅读 本 Spring 对 
象 /XML 映射 的 文章 。 


这 里 我 们 创建 一 个 Java 工程 ， 整 个 工程 的 目录 如 下 所 示 : 
4 i$ 5 5.8- -SpringDemo| 


4 ge src 
4 iH com yiibai.core 
(J) Appjava 
B$ XMLConverter.java 
4 §§ comyiibai.core.model 
四 Customer.java 
di? applicationContext.xml 
Ej) JRE System Library [JavaSE-1.6] 
BA Spring 3.0 Core Libraries 
4 Bi Spring 3.0 Web Libraries 
org.springframework.web-3.0.5.RELEASE.jar - D:\Program Files (x86) MyEc 


0! 


5 


0! 


$ com.springsource.org.apache.commons.fileupload-1.2.0.jar - D:\Program 


(à com.springsource.org.apache.commons.httpclient-3.1.0,jar - D:\Program F 


(à com.springsource.org.codehaus.jackson.mapper-1.0.0,jar - D:\Program Fil 
(à org.springframework.oxm-3.0.5.RELEASE jar - D:\Program Files (x86) MyE« 





( org.springframework.web.servlet-3.0.5.RELEASE jar - D:\Program Files (x8€ 


(i org.springframework.web.portlet-3.0.5.RELEASE.jar - D:\Program Files (x8t 
(i org.springframework.web.struts-3.0.5.RELEASE jar - D:\Program Files (x86) 


一 个 简单 对 象 


一 个 简单 的 对 象 ， 之 后 将 其 转换 成 XML 文件 。 


package com.yiibai.core.model; 
public class Customer { 


String name; 
int age; 
boolean flag; 
String address; 


//standard getter, setter and toString() methods. 


3. Marshaller 和 Unmarshaller 
这 个 类 将 义理 通过 Spring 的 OXM 接口 的 转换 : Marshaller 和 Unmarshaller. 


package com.yiibai.core; 


import java.io.FileInputStream; 

import java.io.FileOutputStream; 

import java.io.IOException; 

import javax.xml.transform.stream.StreamResult; 
import javax.xml.transform.stream.StreamSource; 
import org.springframework.oxm.Marshaller; 
import org.springframework.oxm.Unmarshaller; 


public class XMLConverter ( 


private Marshaller marshaller; 
private Unmarshaller unmarshaller; 


public Marshaller getMarshaller() { 


return marshaller; 
} 


public void setMarshaller(Marshaller marshaller) { 
this.marshaller = marshaller; 
} 


public Unmarshaller getUnmarshaller() { 
return unmarshaller; 
} 


public void setUnmarshaller(Unmarshaller unmarshaller) { 
this.unmarshaller = unmarshaller; 
} 


public void convertFromObjectToXML(Object object, String filep: 
throws IOException { 


FileOutputStream os = null; 
try { 

os = new FileOutputStream(filepath); 

getMarshaller().marshal(object, new StreamResult(os)); 
} finally { 

if (os != null) { 

os.close(); 
} 


} 


public Object convertFromXMLToObject(String xmlfile) throws IOE 


FileInputStream is = null; 
try { 

is = new FileInputStream(xmlfile); 

return getUnmarshaller().unmarshal(new StreamSource(is` 
} finally T 

if (is != null) { 

is.close(); 
} 





4. Spring 配置 


在 Spring 的 bean 配置 文件 ， 注 入 CastorMarshaller 作为 XML 绑 定 框架 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-3.0.x: 


«bean id="XMLConverter" class="com.yiibai.core.XMLConverter"> 
«property name="marshaller" ref="castorMarshaller" /> 
«property name-"unmarshaller" ref="castorMarshaller" /> 

</bean> 

«bean id="castorMarshaller" class-"org.springframework.oxm.cas! 


</beans> 





运行 它 


package com.yiibai.core; 


import 
import 
import 
import 


public 


java.io. IOException; 
org.springframework.context.ApplicationContext; 
org.springframework.context.support.ClassPathXmlApplication( 
com.yiibai.core.model.Customer; 


class App ( 


private static final String XML FILE NAME = "customer .xml"; 


public static void main(String[] args) throws IOException { 


ApplicationContext appContext - new ClassPathXmlApplicatior 
XMLConverter converter = (XMLConverter) appContext.getBeani 


Customer customer - new Customer(); 
customer.setName("yiibai"); 
customer.setAge(28); 
customer.setFlag(true); 
customer.setAddress("Haikou haidiandao"); 


System.out.println("Convert Object to XML!"); 

//from object to XML file 
converter.convertFromObjectToXML(customer, XML FILE NAME); 
System.out.println("Done Nn"); 


System.out.println("Convert XML back to Object!"); 

//from XML to object 

Customer customer2 = (Customer )converter.convertFromxXMLToOk 
System.out.println(customer2); 

System.out.println("Done"); 





输出 结果 


Convert Object to XML! 


Done 


Convert XML back to Object! 
Customer [name=yiibai, age=28, flag=true, address=Haikou Haidiandac 


Done 


EE; 





FRAY XML 文件 *customerxml" 将 在 项 目的 根 文件 夹 中 生成 。 


File : customer.xml 


<?xml version="1.0" encoding="UTF-8"?> 

<customer flag="true" age="28"> 
<address>Haikou Haidiandao</address> 
<name>yiibai</name> 

</customer> 


XML 映射 


等 等 ， 为 什么 fag 和 age 可 转换 为 属性 ? 这 是 一 种 来 控制 哪些 字段 点 为 属性 或 元 素 的 
使 用 的 方式 ? 当然 ， 您 可 以 使 用 Castor XML 映射 定义 对 象 和 XML 之 间 的 关系 。 


创建 以 下 映射 文件 ， 并 把 它 放 到 你 的 项 目的 classpath, 


File : mapping.xml 


<mapping> 
«class name="com.yiibai.core.model.Customer"> 


«map-to xml-"customer" /> 


«field name="age" type="integer"> 
«bind-xml name="age" node="attribute" /> 
</field> 


<field name="flag" type="boolean"> 
«bind-xml name="flag" node="element" /> 
</field> 


<field name="name" type="string"> 
«bind-xml name="name" node="element" /> 
</field> 


«field name="address" type="string"> 
<bind-xml name="address" node="element" /> 
</field> 
</class> 
</mapping> 


在 Spring bean 配 置 文件 ， 上 述 通过 “mappingLocation” 注 入 mapping.xml 到 
CastorMarshaller 。 注 : 这 里 需要 加 入 一 个 org.springframework.oxm.*jar 包 ， 这 
^ GHB MyEclipse 库 的 Spring 3.0 Web Libaries 中 。 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-3.0.x; 


«bean id="XMLConverter" class="com.yiibai.core.XMLConverter"> 
«property name="marshaller" ref="castorMarshaller" /> 
<property name="unmarshaller" ref="castorMarshaller" /> 

</bean> 

«bean id="castorMarshaller" class-"org.springframework.oxm.cas! 
«property name="mappingLocation" value-"classpath:mapping.: 

«/bean» 


«/beans» 
图 = 
再 次 测试 ，XML 文 件 *customer.xmlp" 将 被 更 新 。 


File : customer.xml 





<?xml version="1.0" encoding="UTF-8"?> 
<customer age="28"> 

<flag>true</flag> 

<name>yiibai</name> 

<address>Haikou Haidiandao</address> 
</customer> 


参考 : http://my.oschina.net/u/1455908/blog/311723 F 23, X: f — 
http://pan.baidu.com/s/1dEo0bnz 


Spring+JDBC 实 例 - Spring 教程 


1. Customer x 
在 这 个 例子 中 ， 我 们 使 用 的 是 MySQL 数 据 库 。 


CREATE TABLE “customer” ( 
"CUST ID' int(10) unsigned NOT NULL AUTO INCREMENT, 
"NAME, varchar(100) NOT NULL, 
`AGE` int(10) unsigned NOT NULL, 
PRIMARY KEY ( CUST ID) 
) ENGINE-InnoDB AUTO INCREMENT-1 DEFAULT CHARSET=utf8; 


2. Customer 模 型 


添加 一 个 客户 模型 用 来 存储 用 户 的 数据 。 


package com.yiibai.customer.model; 
import java.sql.Timestamp; 


public class Customer 


{ 

int custId; 

String name; 

int age; 

//getter and setter methods 
} 


4. 数据 访问 对 象 (DAO) 模式 


Customer Dao 接口 . 


package com. yiibai.customer.dao; 


import com. yiibai.customer.model.Customer; 


public interface CustomerDAO 


{ 


public void insert(Customer customer); 
public Customer findByCustomerId(int custId); 


客户 的 DAO 实 现 ， 使 用 JDBC 发 出 简单 的 insert 和 select SQL 语句 。 


package com 


Import 
Import 
Import 
Import 
Import 
Import 
Import 


public 
{ 


java. 
java. 
java. 
java. 


.yiibai.customer.dao.impl; 


sql.Connection; 
sql.PreparedStatement; 
sql.ResultSet; 
sql.SQLException; 


javax.sql.DataSource; 
com. yiibai.customer .dao.CustomerDAO; 
com. yiibai.customer .model.Customer ; 


class JdbcCustomerDAO implements CustomerDAO 


private DataSource dataSource; 


public void setDataSource(DataSource dataSource) { 
this.dataSource = dataSource; 


} 


public void insert(Customer customer) { 


String sql = "INSERT INTO CUSTOMER " + 


"(CUST ID, NAME, AGE) VALUES (?, ?, ?)"; 


Connection conn - null; 


try 


( 


conn - dataSource.getConnection(); 
PreparedStatement ps - conn.prepareStatement(sq1); 
ps.setInt(1, customer.getCustId()); 
ps.setString(2, customer.getName()); 

ps.setInt(3, customer.getAge()); 
ps.executeUpdate(); 

ps.close(); 


} catch (SQLException e) { 


throw new RuntimeException(e); 


) finally { 


if (conn != null) ( 
try { 


conn.close(); 
} catch (SQLException e) {} 


} 


public Customer findByCustomerId(int custId){ 
String sql = "SELECT * FROM CUSTOMER WHERE CUST_ID = ?"; 


Connection conn = null; 


try { 
conn = dataSource.getConnection(); 


PreparedStatement ps = conn.prepareStatement(sq1); 

ps.setInt(1, custId); 

Customer customer - null; 

ResultSet rs - ps.executeQuery(); 

if (rs.next()) { 

customer - new Customer( 

rs.getInt("CUST ID"), 
rs.getString("NAME"), 
rs.getInt("Age") 


); 
j 
rs.close(); 
ps.close(); 
return customer; 
) catch (SQLException e) { 
throw new RuntimeException(e); 
} finally { 
if (conn != null) { 
try { 
conn.close(); 
} catch (SQLException e) {} 


5. Spring beant E 


创建 customerDAO 和 数据 源 在 Spring bean 配置 文件 中 。 


File : Spring-Customer.xml 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


<bean id-"customerDAO" class="com.yiibai.customer .dao.impl. Jdbc 
<property name="dataSource" ref="dataSource" /> 
</bean> 


</beans> 


«| NE 








File : Spring-Datasource.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


<bean id="dataSource" 
class="org.springframework.jdbc.datasource.DriverManagerDat 


«property name="driverClassName" value="com.mysql.jdbc.Dri\ 
«property name-"url" value="jdbc:mysql://localhost :3306/yi: 
<property name="username" value="root" /> 
<property name="password" value="password" /> 

</bean> 


</beans> 


Eee 





File : Spring-Module.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«import resource="database/Spring-Datasource.xml" /> 
«import resource-"customer/Spring-Customer.xml" /> 


«/beans» 





6.55 H 2& 74 


本 实例 完整 目录 结构 。 
4 i53 5.9-SpringDemo 
4 (3B src 

4 [8 comyiibai.common 
(J) Appjava 

4 册 com yiibai.customer.dao 
四 CustomerDAO java 

4 [8 com yiibai.customer.dao.impl 
[J] JdbcCustomerDAO java 

4 {8 com yiibai.customer.model 
|J] Customer java 

4 上 customer 
df? Spring-Customer.xml 

4 {B database 
Ø Spring-Datasource.xml 

|Æ applicationContext.xml| 

mi JRE System Library [JavaSE-1.6] 

BA Spring 3.1 Core Libraries 

BA Spring 3.1 Persistence Libraries 

4 Bi MySQL-Connector 


| mysql-connector-java-5.1.37-bin,jar - D:\software\libraries\mysq| 
> 二 4—Lna 
7. 运 行书 


package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 

import org.springframework.context.support.ClassPathXmlApplication( 
import com.yiibai.customer.dao.CustomerDAO; 

import com.yiibai.customer.model.Customer; 


public class App 
{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext("applicationContext 


CustomerDAO customerDAO = (CustomerDAO) context.getBean('ci 
Customer customer = new Customer(1, "yiibai",29); 
customerDAO.insert(customer); 


Customer customeri = customerDAO.findByCustomerId(1); 
System.out.println(customer1); 
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输出 结果 : 


Customer [age-29, custId=1, name-yiibai] 


下 载 源 代码 — http://pan.baidu.com/s/1SR2GI 


Spring+JDBC 实 例 - Spring 教程 2786 


Spring JdbcTemplate+JdbcDaoSupport £j - 
Spring 教程 


在 Spring JDBC 开 发 中 ， 可 以 使 用 JdbcTemplate 和 JdbcDaoSupport 类 来 简化 整 
个 数据 库 的 操作 过 程 。 在 本 教程 中 ， 我 们 将 重复 上 一 篇 文章 Spring+JDBC 例 子 ， 看 
之 前 (无 JdbcTemplate 支 持 ) 和 之 后 ( 含 JdbcTemplate 的 支持 ) 之 间 不 同 的 例子 。 


1. 不 使 用 JdbcTemplate 示 例 


如 果 不 用 JdbcTemplate， 必 须 创 建 大 量 的 宛 余 代 码 ( 创 建 连接 ， 关闭 连接 ， REF 
E 更 新 和 删除 。 它 的 效率 并 不 是 很 高 ， 容 
ZU a EE. 


private DataSource dataSource; 


public void setDataSource(DataSource dataSource) { 
this.dataSource = dataSource; 
} 


public void insert(Customer customer){ 


String sql = "INSERT INTO CUSTOMER " + 
"(CUST_ID, NAME, AGE) VALUES (?, ?, ?)"; 
Connection conn = null; 


try { 
conn = dataSource.getConnection(); 
PreparedStatement ps = conn.prepareStatement(sql); 
ps.setInt(1, customer.getCustId()); 
ps.setString(2, customer.getName()); 
ps.setInt(3, customer.getAge()); 
ps.executeUpdate(); 
ps.close(); 


) catch (SQLException e) { 
throw new RuntimeException(e); 


} finally { 
if (conn != null) { 
try { 
conn.close(); 
} catch (SQLException e) {} 


2. 使 用 JdbcTemplate 示 例 
使 用 JdbcTemplate 可 节省 大 量 的 元 余 代 码 ， 因 为 JdbcTemplate 类 会 自动 处 理 它 。 


private DataSource dataSource; 
private JdbcTemplate jdbcTemplate; 


public void setDataSource(DataSource dataSource) { 
this.dataSource = dataSource; 

} 

public void insert(Customer customer ) { 


String sql = "INSERT INTO CUSTOMER " + 
"(CUST_ID, NAME, AGE) VALUES (?, ?, ?)"; 


jdbcTemplate = new JdbcTemplate(dataSource); 


jdbcTemplate.update(sql, new Object[] { customer.getCustId! 
customer .getName( ), customer .getAge() 
}); 





看 看 有 什么 不 同 ? 


3. 使 用 JdbcDaoSupport 示 例 


通过 扩展 JdbcDaoSupport， 设 置 数据 源 ， 并 且 JdbcTemplate 在 你 的 类 中 不 再 是 
必需 的 ， 只 需要 正确 的 数据 源 注入 JdbcCustomerDAO。 可 以 使 用 
getJdbcTemplate() 方 法 得 到 JdbcTemplate。 


public class JdbcCustomerDAO extends JdbcDaoSupport implements Cus! 


//no need to set datasource here 
public void insert(Customer customer) { 


String sql = "INSERT INTO CUSTOMER " + 
"(CUST ID, NAME, AGE) VALUES (?, ?, ?)"; 


getJdbcTemplate().update(sql, new Object[] { customer.getcCi 
customer .getName( ), customer .getAge() 
}); 











«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="dataSource" 
class="org.springframework. jdbc.datasource.DriverManagerDé 


«property name-"driverClassName" value="com.mysql.jdbc.Dri\ 
«property name="url" value="jdbc:mysql://localhost :3306/yi: 
<property name="username" value="root" /> 
<property name="password" value="password" /> 

</bean> 


</beans> 


[JE ee: 





«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id-"customerDAO" class="com.yiibai.customer .dao.impl. Jdbc 
<property name="dataSource" ref="dataSource" /> 
</bean> 


</beans> 
i fi 
注 : 在 Spring JDBC 开 发 ， 它 总 是 建议 使 用 ， 总 是 建议 使 用 JdbcTemplate 和 


JdbcDaoSupport， 而 不 使 用 自己 的 JDBC 编 程 代码 。 下 载 代 码 - 
http://pan.baidu.com/s/1bnIGdiR 





Spring JdbcTemplate 坦 询 实例 - Spring 教程 


这 里 有 几 个 例子 向 您 展示 如 何 使 用 JdbcTemplate 的 query() 方 法 来 查询 或 从 数据 库 提 
取 数 据 。 整 个 项 目的 目录 结构 如 下 : 


1. 查 询 单 行 数据 
这 里 有 两 种 方法 来 查询 或 从 数据 库 中 提取 单行 记录 ， 并 将 其 转换 成 一 个 模型 类 。 


1.1 自 定义 RowMapper 


在 一 般 情况 下 ， 它 总 是 建议 实现 RowMapper 接口 来 创建 自 定义 的 RowMapper， 以 
满足 您 的 需求 。 


package com.yiibai.customer.model; 


import java.sql.ResultSet; 
import java.sql.SQLException; 


import org.springframework.jdbc.core.RowMapper ; 
public class CustomerRowMapper implements RowMapper 


public Object mapRow(ResultSet rs, int rowNum) throws SQLExcept 
Customer customer - new Customer(); 
customer.setCustId(rs.getInt("CUST ID")); 
customer.setName(rs.getString("NAME")); 
customer.setAge(rs.getInt("AGE")); 
return customer; 





它 传递 给 queryForObject() 方 法 ， 返 回 的 结果 将 调用 自 定义 mapRow() 方 法 的 值 匹 
配 到 属性 。 


public Customer findByCustomerId(int custId){ 
String sql = "SELECT * FROM CUSTOMER WHERE CUST ID = ?"; 


Customer customer = (Customer)getJdbcTemplate().queryForObject! 
sql, new Object[] ( custId }, new CustomerRowMapper( )), 


return customer; 


} 
到 








1.2 BeanPropertyRowMapper 


在 Spring2.5 中 ， 带 有 一 个 方便 RowMapper 实现 所 谓 “BeanPropertyRowMapper”， 
它 可 以 通过 匹配 行 的 名 字 的 列 值 映 射 到 一 个 属性 。 只 要 确保 这 两 个 属性 和 列 具有 相 
同 的 名 称 ， 如 属性 "CUSTID' 将 匹配 到 列 名 为 : "CUSTID' 或 下 划 线 “CUST_ID”。 


public Customer findByCustomerId2(int custId) { 
String sql = "SELECT * FROM CUSTOMER WHERE CUST_ID = ?"; 
Customer customer = (Customer )getJdbcTemplate().queryForObject\ 
sql, new Object[] { custId }, 


new BeanPropertyRowMapper(Customer.class) ); 


return customer; 





2, FIST 


现在 ， 查 询 或 从 数据 库 中 提取 多 行 ， 并 且 将 它 转换 成 一 个 列表 。 


2.1 手 动 映 射 它 


~ 


返回 多 行 ，RowMapper 不 支持 queryForList() 方 法 ， 需 要 手动 映射 它 。 


public List<Customer> findAll(){ 
String sql = "SELECT * FROM CUSTOMER"; 
List<Customer> customers = new ArrayList<Customer>(); 
List<Map> rows = getJdbcTemplate().queryForList(sql); 
for (Map row : rows) { 
Customer customer = new Customer(); 
customer .setCustId((Long)(row.get("CUST_ID"))); 
customer .setName( (String) row.get("NAME")); 


customer .setAge( (Integer )row.get("AGE")); 
customers.add(customer ); 


} 


return customers; 


2.2 BeanPropertyRowMapper 
最 简单 的 解决 方案 是 使 用 BeanPropertyRowMapper 类 。 


public List<Customer> findAll(){ 
String sql = "SELECT * FROM CUSTOMER"; 


List<Customer> customers = getJdbcTemplate().query(sql, 
new BeanPropertyRowMapper (Customer.class) ); 


return customers; 


3. 查 询 单 值 
在 这 个 例子 中 ， 展 示 了 如 何 从 数据 库 中 坦 询 或 提取 单个 列 值 。 


3.1 单 列 名 


它 显 示 了 如 何 查 询 单 个 列 名 作为 字符 串 。 


public String findCustomerNameById(int custId){ 
String sql = "SELECT NAME FROM CUSTOMER WHERE CUST ID = ?"; 


String name = (String)getJdbcTemplate().queryForObject( 
sql, new Object[] { custId }, String.class); 


return name; 


3.2、 行 总 效 
它 展示 了 如 何 从 数据 库 中 查询 行 的 总 数 。 
public int findTotalCustomer (){ 
String sql = "SELECT COUNT(*) FROM CUSTOMER"; 


int total = getJdbcTemplate().queryForInt(sql); 


return total; 


B 
di 
ar 


package com. yiibai.common; 


import java.util.ArrayList; 
import java.util.List; 


import org.springframework.context.ApplicationContext; 

import org.springframework.context.support.ClassPathXmlApplication( 
import com.yiibai.customer.dao.CustomerDAO; 

import com.yiibai.customer.model.Customer; 


public class JdbcTemplateApp 
{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext("Spring-Customer . xm- 


CustomerDAO customerDAO = (CustomerDAO) context.getBean('k 


Customer customerA = customerDAO.findByCustomerId(1); 
System.out.println("Customer A : " + customerA); 


Customer customerB = customerDAO.findByCustomerId2(1); 
System.out.println("Customer B : " + customerB); 


List<Customer> customerAs = customerDAO.findAll(); 
for(Customer cust: customerAs)( 

System.out.println("Customer As : " + customerAs); 
} 


List<Customer> customerBs = customerDAO.findAll2(); 
for(Customer cust: customerBs){ 

System.out.println("Customer Bs : " + customerBs); 
} 


String customerName = customerDAO.findCustomerNameById(1), 
System.out.println("Customer Name : " + customerName); 


int total = customerDAO.findTotalCustomer(); 
System.out.println("Total : " + total); 





% 
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JdbcTemplate 类 ， 附 带 了 很 多 有 用 的 重 载 查询 方法 。 它 提醒 参考 现 有 的 查询 方法 在 
创建 自己 的 自 定义 查询 方法 之 前 ， 因 为 Spring 已 经 做 给 你 了 。 下 载 代码 - 
http://pan.baidu.com/s/1gecQHmN 


TutorialsPoint Java 技术 教程 


Spring JdbcTemplate & 39 & PI - Spring 教程 2795 


Spring SimpleJdbcTemplate 4 i474! - Spring 教 
程 

这 里 有 几 个 例子 来 说 明 如 何 使 用 SimpleJdbcTemplate query() 方 法 来 查询 或 从 数据 

库 中 提取 数据 。 在 JdbcTemplate query() 方法 ， 需 要 手动 转换 返回 的 结果 转换 为 一 
个 目标 对 象 类 型 ， 并 传递 一 个 对 象 数 组 作为 参数 。 在 SimpleJdbcTemplate 类 ， 它 是 


更 加 人 性 化 和 简单 。jdbctemplate VS simplejdbctemplate 请 比较 JdbcTemplate 类 
的 示例 和 SimpleJdbcTemplate 类 的 示例 。 


1. 查 询 单 行 
这 里 有 向 你 展示 了 如 何 查询 或 从 数据 库 中 提取 单行 的 两 种 方式 ， 并 将 其 转换 成 一 个 


模型 类 。 


1.1 自 定 义 RowMapper 


在 一 般 情 况 下 ， 它 总 是 建议 来 实现 RowMapper 接口 来 创建 自 定义 的 RowMapper， 
以 满足 您 的 需求 。 


package com.yiibai.customer.model; 


import java.sql.ResultSet; 
import java.sql.SQLException; 


import org.springframework.jdbc.core.RowMapper; 


public class CustomerRowMapper implements RowMapper 


public Object mapRow(ResultSet rs, int rowNum) throws SQLExcept 
Customer customer - new Customer(); 
customer.setCustId(rs.getInt("CUST ID")); 
customer.setName(rs.getString("NAME")); 
customer.setAge(rs.getInt("AGE")); 
return customer; 





public Customer findByCustomerId(int custId){ 
String sql = "SELECT * FROM CUSTOMER WHERE CUST_ID = ?"; 


Customer customer = getSimpleJdbcTemplate().queryForObject( 
sql, new CustomerParameterizedRowMapper(), custId); 


return customer; 


1.2 BeanPropertyRowMapper 


ftSimpleJdbcTemplate X, #22 (#FA“ParameterizedBeanPropertyRowMapper' 代 
& 'BeanPropertyRowMapper", 


public Customer findByCustomerId2(int custIid)( 
String sql = "SELECT * FROM CUSTOMER WHERE CUST ID = ?"; 


Customer customer = getSimpleJdbcTemplate().queryForObject(sql, 
ParameterizedBeanPropertyRowMapper.newInstance(Customer .: 


return customer; 





2, FIST 


从 数据 库 查 询 或 提取 多 行 记录 ， 并 将 其 转换 成 一 个 列表 。 


2.1 ParameterizedBeanPropertyRowMapper 


public List<Customer> findAll(){ 


String sql = "SELECT * FROM CUSTOMER"; 


List<Customer> customers = 
getSimpleJdbcTemplate().query(sql, 
ParameterizedBeanPropertyRowMapper.newInstance(Customer 


return customers; 








3. 查 询 单 值 
查询 或 提取 数据 库 中 的 单个 列 的 值 。 


3.13: 51 4 
它 显示 了 如 何 查询 单个 列 名 作为 字符 串 。 
public String findCustomerNameById(int custId){ 


String sql = "SELECT NAME FROM CUSTOMER WHERE CUST_ID = ?"; 


String name = getSimpleJdbcTemplate().queryForObject( 
sql, String.class, custId); 


return name; 


3.2、 行 总 数 
它 展示 了 如 何 从 数据 库 中 查询 行 的 总 数 。 
public int findTotalCustomer(){ 
String sql - "SELECT COUNT(*) FROM CUSTOMER"; 


int total = getSimpleJdbcTemplate().queryForInt(sql); 


return total; 


& 
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package com. yiibai.common; 


import java.util.ArrayList; 
import java.util.List; 


import org.springframework.context.ApplicationContext; 

import org.springframework.context.support.ClassPathXmlApplication( 
import com.yiibai.customer.dao.CustomerDAO; 

import com.yiibai.customer.model.Customer; 


public class SimpleJdbcTemplateApp 
{ 


public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext("Spring-Customer . xm- 


CustomerDAO customerSimpleDAO = 
(CustomerDAO) context.getBean("customerSimpleDAO"), 


Customer customerA = customerSimpleDAO.findByCustomerId(1: 
System.out.println("Customer A : " + customerA); 


Customer customerB - customerSimpleDAO.findByCustomerId2(: 
System.out.println("Customer B : " + customerB); 


List<Customer> customerAs = customerSimpleDAO.findAll(); 
for(Customer cust: customerAs)( 

System.out.println("Customer As : " + customerAs); 
} 


List<Customer> customerBs = customerSimpleDAO.findAll2(); 

for(Customer cust: customerBs){ 
System.out.println("Customer Bs : " + customerBs); 

} 


String customerName = customerSimpleDAO. findCustomerNameB\ 
System.out.println("Customer Name : " + customerName); 


int total - customerSimpleDAO.findTotalCustomer(); 
System.out.println("Total : " + total); 





v 
Re 


& 


+ 
Isi 


SimpleJdbcTemplate 是 不 能 代替 JdbcTemplate 的 ， 它 只 是 一 个 Java5 的 友好 补充 
它 。 下 载 代 码 - http://pan.baidu.com/s/1eRisz6M 
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Spring SimpleJdbcTemplate 3: 45 4 2:35 3: I - 
Spring 教程 
在 JdbcTemplate， 这 些 SQL 参 数 通 过 一 个 特殊 的 占 位 符 “? "符号 表示 ， 并 通过 位 置 


绑 定 。 现 在 的 问题 是 ， 每 当 参 数 的 顺序 发 生 了 变化 ， 你 必须 也 要 改变 参数 绑 定 ， 这 
是 容易 出 错 ， 繁 琐 的 维护 。 

为 了 解决 这 个 问题 ， 可 以 使 用 “命名 参数 ”，SQL 参 数 是 由 一 个 冒号 开始 后 续 定义 的 
名 称 ， 而 不 是 位 置 。 在 另外 的 ， 命 名 参数 只 是 在 SimpleJdbcTemplate 类 和 
NamedParameterJdbcTemplate 支 持 。 


请 参见 下 面 的 三 个 例子 用 来 使 用 命名 参数 在 Spring。 


示例 1 
例子 向 您 展示 如 何 使 用 命名 参数 在 一 个 INSERT 语句。 


//insert with named parameter 
public void insertNamedParameter(Customer customer) { 


String sql = "INSERT INTO CUSTOMER " + 
"(CUST_ID, NAME, AGE) VALUES (:custId, :name, :age)"; 


Map<String, Object» parameters = new HashMap<String, Object 
parameters.put("custId", customer.getCustId()); 
parameters.put("name", customer.getName()); 
parameters.put("age", customer.getAge()); 


getSimpleJdbcTemplate().update(sql, parameters); 





示例 2 
例子 来 说 明 如 何 使 用 命名 参数 在 批 处 理 操作 语句 。 


public void insertBatchNamedParameter(final List<Customer> custome} 


String sql = "INSERT INTO CUSTOMER " + 
"(CUST_ID, NAME, AGE) VALUES (:custId, :name, :age)"; 


List<SqlParameterSource> parameters = new ArrayList<SqlParé 
for (Customer cust : customers) { 

parameters.add(new BeanPropertySqlParameterSource(cust 
} 


getSimpleJdbcTemplate().batchUpdate(sql, 
parameters.toArray(new SqlParameterSource[0])); 





示例 3 
另 一 个 例子 ， 在 一 个 批 处 理 操作 语句 中 使 用 命名 参数 。 


public void insertBatchNamedParameter2(final List<Customer> custome 


SqlParameterSource[] params = 
SqlParameterSourceUtils.createBatch(customers.toArray()); 


getSimpleJdbcTemplate().batchUpdate( 


"INSERT INTO CUSTOMER (CUST ID, NAME, AGE) VALUES (:custId, 
params); 


=== Á—À—H 
下 载 源 代码 - http://pan.baidu.com/s/1hqPrzJu 
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这 个 例子 将 创建 一 个 简单 的 Java 项 目 结构 ， 并 演示 如 何 使 用 Hibernate 在 Spring 
框架 进行 MySQL 数据 库 的 数据 处 理工 作 ( 插 入 ， 选 择 ， 更 新 和 删除 )。 


最 终 项 目 结构 


最 终 的 项 目 文件 结构 应 该 看 起 来 如 下 面 的 图 中 显示 。 
4 35$ 6.6-SpringDemo 
4 $8 src 
4 册 comyiibai.common 
|J] Appjava, 
4 出 com.yiibai.stock.bo 
[J] StockBo.java 
4 由 comyiibai.stock.bo.impl 
[J] StockBolmpl.java 
4 {8 comyiibai.stock.dao 
[J] StockDao.java 
4 [B comyiibai.stock.dao.imp! 
JJ] StockDaolmpl.java 
4 i8 com yiibai.stock.model 
四 Stockjava 
4 {B hibernate 
& Stock.hbm.xml 
4 {B properties 
database.properties 
4 {B spring.beans 
Æ Stock.xml 
4 {B spring.config 
Æ BeanLocations.xml 
{B spring.database 
mi, JRE System Library [JavaSE-1.6] 
» BA Spring 3.1 Core Libraries 
» BA Spring 3.1 Persistence Libraries 
» wi Hibernate 3.3 Annotations & Entity Manager 
» wi, Hibernate 3.3 Core Libraries 


1. 创 建 表 


在 MySQL 数 据 库 中 创建 一 张 “stock" 表 。 SQL 语句 如 下 : 


CREATE TABLE `yiibai`.`stock` ( 

"STOCK ID' int(10) unsigned NOT NULL AUTO INCREMENT, 

"STOCK CODE' varchar(10) NOT NULL, 

"STOCK NAME, varchar(20) NOT NULL, 

PRIMARY KEY (STOCK ID') USING BTREE, 

UNIQUE KEY "UNI STOCK NAME" (STOCK NAME ), 

UNIQUE KEY "UNI STOCK ID' (STOCK CODE') USING BTREE 
) ENGINE-InnoDB AUTO INCREMENT-1 DEFAULT CHARSET=utf8; 


2. Model & BO & DAO 


模型 中 ， 业 务 对 象 (BO) 和 数据 访问 对 象 (DAO) 模 式 是 有 助 于 清楚 地 识别 层 ， 以 避免 
弄 乱 项 目 结构 。 


Stock Model 
Stock 模型 类 以 后 用 于 存储 库存 数据 。 


package com.yiibai.stock.model; 

import java.io.Serializable; 

public class Stock implements Serializable { 
private static final long serialVersionUID = 1L; 
private Long stockId; 
private String stockCode; 


private String stockName; 


//getter and setter methods... 


Stock Business Object (BO)) 


Stock 业务 对 象 (BO) 接 口 和 实现 ， 它 是 用 来 存储 项 目的 业务 功能 ， 真 正 的 数据 库 操 
作 (CRUD) 的 工作 不 应 该 参与 这 一 个 类 ， 而 是 有 一 个 DAO(StockDao) 类 来 做 到 这 一 


JNO 


package com.yiibai.stock.bo; 
import com.yiibai.stock.model.Stock; 
public interface StockBo { 

void save(Stock stock); 

void update(Stock stock); 


void delete(Stock stock); 
Stock findByStockCode(String stockCode); 


package com.yiibai.stock.bo.impl; 

import com.yiibai.stock.bo.StockBo; 

import com.yiibai.stock.dao.StockDao; 

import com.yiibai.stock.model.Stock; 

public class StockBoImpl implements StockBo{ 
StockDao stockDao; 
public void setStockDao(StockDao stockDao) { 


this.stockDao = stockDao; 
} 


public void save(Stock stock)t{ 
stockDao.save(stock); 
j 


public void update(Stock stock){ 
stockDao.update(stock); 
j 


public void delete(Stock stock){ 
stockDao.delete(stock); 
j 


public Stock findByStockCode(String stockCode) { 
return stockDao.findByStockCode(stockCode); 
j 


Stock Data Access Object 


Stock DAO 接 口 和 实现 ，DAO 实 现 类 扩展 了 Spring B“HibernateDaoSupport”, LA 
使 Spring 框架 支持 Hibernate。 现在 ， 你 可 以 通过 getHibernateTemplate() 执 行 
Hibernate 功能 。 


package com.yiibai.stock.dao; 


import com.yiibai.stock.model.Stock; 


public interface StockDao { 


void save(Stock stock); 

void update(Stock stock); 

void delete(Stock stock); 

Stock findByStockCode(String stockCode); 


package com.yiibai.stock.dao.impl; 


import java.util.List; 


import org.springframework.orm.hibernate3.support.HibernateDaoSupp: 


import com.yiibai.stock.dao.StockDao; 
import com.yiibai.stock.model.Stock; 


public class StockDaoImpl extends HibernateDaoSupport implements S1 


public void save(Stock stock)t{ 
getHibernateTemplate().save(stock); 


j 


public void update(Stock stock){ 
getHibernateTemplate().update(stock); 
} 


public void delete(Stock stock){ 
getHibernateTemplate().delete(stock); 


} 


public Stock findByStockCode(String stockCode) { 
List list = getHibernateTemplate().find( 
"from Stock where stockCode=?", stockCode 


); 
return (Stock)list.get(0); 





用 于 存储 Spring, Hibernate 等 配置 文件 。 


Hibernate Configuration 


创建 Hibernate 映射 文件 (Stock.hbm.xml) 的 Stock 表 ， 把 它 放 
f£"resources/hibernate/" X14 3« rh, 


<?xml version="1.0"?> 
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"» 


<hibernate-mapping> 
«class name="com.yiibai.stock.model.Stock" table="stock" catal 
«id name="stockId" type="java.lang.Long"> 
<column name="STOCK_ID" /> 
<generator class="identity" /> 
</id> 
«property name-"stockCode" type="string"> 
«column name-"STOCK CODE" length="10" not-null="true" i 
«/property» 
«property name-"stockName" type="string"> 
«column name-z"STOCK NAME" length="20" not-null="true" i 
</property> 
</class> 
</hibernate-mapping> 


SSS 





Spring Configuration 
Database related.... 


创建 一 个 属性 文件 (database.properties) 数 据 库 的 详细 信息 ， 把 它 放 
f£“resources/properties” 文件 夹 中 。 这 是 很 好 的 做 法 ， 不 同 于 数据 库 细节 并 将 
Spring bean 配置 成 不 同 的 文件 。 


database.properties 


jdbc.driverClassName-com.mysql.jdbc.Driver 
jdbc.url=jdbc:mysql://localhost:3306/yiibai 
jdbc.username=root 

jdbc .password=password 


为 你 的 数据 库 创 建 一 个 "dataSource”bean 配 置 文件 (DataSource.xml)， 并 从 
database.properties 导 入 的 属性 ， 把 它 放 入 到 “resources/database” 文件 夹 中 。 


DataSource.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<bean 
class-"org.springframework.beans.factory.config.PropertyPlaceholde! 
«property name="location"> 
<value>properties/database.properties</value> 
</property> 
</bean> 


<bean id="dataSource" 
class="org.springframework. jdbc.datasource.DriverManagerDé 
«property name="driverClassName" value="${jdbc.driverClassName_ 
«property name="url" value="${jdbc.url}" /> 
«property name="username" value="${jdbc.username}" /> 
<property name="password" value="${jdbc.password}" /> 
</bean> 


</beans> 


Je E 





Hibernate 关联 .…. 


创建 一 个 会 话 工 厂 bean 配置 文件 (Hibernate.xml)， 把 它 放 入 “resources/database” 
文件 夹 中 。 这 个 LocalSessionFactoryBean 中 设置 一 个 共享 的 Hibernate 
SessionFactory 在 一 个 Spring 应 用 程序 上 下 文 。 


Hibernate.xml 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<!-- Hibernate session factory --> 
<bean id="sessionFactory" 
class-"org.springframework.orm.hibernate3.LocalSessionFactoryt 


«property name="dataSource"> 
«ref bean="dataSource"/> 
</property> 


<property name="hibernateProperties"> 
<props> 
«prop key="hibernate.dialect">org.hibernate.dialect .MySQLI 
«prop key="hibernate.show_sql">true</prop> 
</props> 
</property> 


<property name="mappingResources"> 
<list> 
<value>/hibernate/Stock.hbm.xml</value> 
</list> 
</property> 


</bean> 
</beans> 


Aoo ëR 





Spring beans related.... 


创建 一 个 bean 配 置 文件 (Stock.xml) 的 BO 和 DAO 类 ， 把 它 放 入 “resources/spring” 
Xith, kh DAO(stockDao)bean 注入 到 bo(stockBo)bean; SessionFactory 
的 bean 成 stockDao。 


Stock.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<!-- Stock business object --> 
«bean id="stockBo" class-'com.yiibai.stock.bo.impl.StockBoImpl" 


«property name-'"stockDao" ref="stockDao" /> 
</bean> 


<!-- Stock Data Access Object --> 
«bean id="stockDao" class="com.yiibai.stock.dao.imp1l.StockDaoIm 
«property name="SessionFactory" ref="sessionFactory"></{ 


</bean> 


</beans> 


I nc —— —————————!áÜMÀÀ226] 





导 和 人 所 有 的 Spring bean 配 置 文件 合并 为 一 个 文件 (BeanLocations.xml)， 把 它 变 成 
了 “resources/config” 文 件 夹 。 


BeanLocations.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<!-- Database Configuration --> 

«import resource="../database/DataSource. xm1"/> 

«import resource="../database/Hibernate.xml"/> 

<!-- Beans Declaration --> 

«import resource="../beans/Stock.xmLl"/> 
</beans> 


C lt 
6. 运行 它 
把 所 有 的 文件 和 配置 ， 运 行 它 。 


package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


import com.yiibai.stock.bo.StockBo; 
import com.yiibai.stock.model.Stock; 


public class App 
{ 
public static void main( String[] args ) 
{ 
ApplicationContext appContext = 
new ClassPathXmlApplicationContext("spring/config/BeanLoc 


StockBo stockBo = (StockBo)appContext.getBean("stockBo"); 


/** insert **/ 

Stock stock = new Stock(); 
stock.setStockCode("7668"); 
stock.setStockName("HAIO"); 
stockBo.save(stock); 


/** select **/ 
Stock stock2 - stockBo.findByStockCode("7668"); 
System.out.println(stock2); 


/** update **/ 
stock2.setStockName( "HAIO-1"); 
stockBo.update(stock2); 


/oleleten: A 
stockBo.delete(stock2); 


System.out.println("Done"); 





输出 结果 : 


Hibernate: insert into yiibai.stock (STOCK CODE, STOCK NAME) value: 
Hibernate: select stockO .STOCK ID as STOCK1 © , stockO .STOCK CODI 
Stock [stockCode-7667, stockId=1, stockName-HAIO] 

Hibernate: update yiibai.stock set STOCK CODE-?, STOCK NAME-? where 
Done 











下 载 代 码 - http://pan.baidu.com/s/1i4f40tB 


Spring AOP 在 Hibernate 事 务 管理 - Spring 教程 


事务 管理 是 用 来 以 确保 数据 库 中 数据 的 完整 性 和 一 致 性 。Spring AOP 技 术 人 允许 开发 
者 管理 事务 的 声明 。 这 里 有 一 个 例子 来 说 明 如 何 使 用 Spring AOP 来 管理 Hibernate 
事务 。 整 个 工程 的 文件 结构 如 下 所 示 : 


PS 这 里 很 多 Hibernate 和 Spring 配置 文件 是 隐藏 的 ， 只 有 一 些 重 要 的 文件 显示 ， 如 
果 你 想 看 全 部 文件 ， 请 在 文章 的 结尾 下 载 完 整 的 项 目 代 码 。 


1.6] ER 
MySQL 表 的 脚本 ， 一 个 “product" 表 


CREATE TABLE  "yiibai' . product’ ( 
"PRODUCT ID' bigint(20) unsigned NOT NULL AUTO INCREMENT, 
"PRODUCT CODE' varchar(20) NOT NULL, 
"PRODUCT DESC'^ varchar(255) NOT NULL, 
PRIMARY KEY ("PRODUCT ID') USING BTREE 
) ENGINE-InnoDB AUTO INCREMENT-4 DEFAULT CHARSET=utf8; 


CREATE TABLE  "yiibai' . product qoh' ( 
QOH_ID bigint(20) unsigned NOT NULL AUTO INCREMENT, 
"PRODUCT ID' bigint(20) unsigned NOT NULL, 
"QTY^ int(10) unsigned NOT NULL, 
PRIMARY KEY (^QOH ID ), 
KEY "FK product qoh product id' ("PRODUCT ID ), 
CONSTRAINT '^FK product qoh product id FOREIGN KEY ("PRODUCT ID 
REFERENCES “product ("PRODUCT ID') 
) ENGINE-InnoDB AUTO INCREMENT-41 DEFAULT CHARSET=utf8; 





2. 产 品 业 务 对 象 


在 这 个 “productBo” 实 现 save() 方 法 将 插入 记录 到 “product" 通 过 “ProductDao”， 并 通 
过 “productQohBo” 类 库存 量 到 “productQoh' 表 。 


package com.yiibai.product.bo.impl; 


import com.yiibai.product.bo.ProductBo; 
import com.yiibai.product.bo.ProductQohBo; 
import com.yiibai.product.dao.ProductDao; 
import com.yiibai.product.model.Product; 
import com.yiibai.product.model.ProductQoh; 


public class ProductBolImpl implements ProductBo{ 


ProductDao productDao; 
ProductQohBo productQohBo; 


public void setProductDao(ProductDao productDao) { 
this.productDao - productDao; 


j 


public void setProductQohBo(ProductQohBo productQohBo) { 
this.productQohBo - productQohBo; 


j 


//this method need to be transactional 
public void save(Product product, int qoh){ 


productDao.save(product); 
System.out.println("Product Inserted"); 


ProductQoh productQoh = new ProductQoh( ); 
productQoh.setProductId(product.getProductId()); 
productQoh.setQty(qoh); 


productQohBo. save(productQoh); 
System.out.println("ProductQoh Inserted"); 


Spring 的 bean 配置 文件 。 


<!-- Product business object --> 
<bean id="productBo" class="com.yiibai.product.bo.impl.ProductB¢ 
<property name="productDao" ref="productDao" /> 
<property name="productQohBo" ref="productQohBo" /> 
</bean> 


<!-- Product Data Access Object --> 

<bean id="productDao" class-'com.yiibai.product.dao.impl.Produci 
«property name="SessionFactory" ref="sessionFactory"></prope 

</bean> 


4 <a 








运行 它 


Product product = new Product(); 
product.setProductCode("ABC"); 
product.setProductDesc("This is product ABC"); 


ProductBo productBo = (ProductBo)appContext.getBean("productBo' 
productBo.save(product, 100); 


‘ — B 


pl 








假设 save() RBABAMRE, MRE HHH AproductQohBo.save(), & R$&A— 
条 记录 到 “product* 表 ， 没 有 记录 将 被 插入 到 “productQoh' 表 。 这 是 一 个 严重 的 问 
题 ， 在 数据 库 中 打破 数据 一 致 性 。 


3.34 EH 


声明 “Transactionlnterceptor bean, LA”HibernateTransactionManager' 
Hibernate 事 务 ， 并 且 通 过 必要 的 属性 。 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<bean id="transactionInterceptor" 
class="org.springframework.transaction.interceptor.Transact: 
«property name="transactionManager" ref="transactionManager" /: 
<property name="transactionAttributes"> 
<props> 
«prop key="save">PROPAGATION_REQUIRED</prop> 
</props> 
</property> 
</bean> 


<bean id="transactionManager" 
class="org.springframework.orm.hibernate3.HibernateTransact 
«property name="dataSource" ref="dataSource" /> 
«property name-'"sessionFactory" ref="sessionFactory" /> 
</bean> 


</beans> 


EN 
事务 属性 





在 事务 拦截 器 ， 必 须 定义 的 事务 的 属性 “传播 行为 "应 使 用 。 这 意味 着 ， 如 果 一 个 事 
务 “ProductBolmpl.save() 方 法 被 调用 另外 的 "productQohBo.save()' 方 法 ， 事 务 应 该 
怎么 传播 ? 它 能 继续 在 现 有 的 事务 中 运行 ?或 者 为 自己 开始 一 个 新 的 事务 。 


由 Spring 支 持 传播 的 7 种 类 型 : 


e PROPAGATION REQUIRED - 支持 当前 事务 ;如 果 不 存在 则 创建 一 个 新 的 。 
e PROPAGATION_SUPPORTS - 支持 当前 事务 ;如 果 不 存 在 执行 非 事务 。 

e PROPAGATION MANDATORY - 支持 当前 事务 ;如 果 当 前 不 存在 事务 抛 出 异 
常 。 

PROPAGATION_REQUIRES_NEW - 创建 一 个 新 的 事务 ， 如 果 当 前 事务 暂 


PROPAGATION NOT SUPPORTED - 不 支持 当前 的 事务 ;而 始终 执行 非 事 


务 。 

PROPAGATION NEVER - 不 支持 当前 的 事务 ;如 果 当 前 事务 存在 则 抛 出 异 
常 。 

PROPAGATION NESTED - OR 4ARIFESSRESS RAT, RAG 
PROPAGATION REQUIRED 一 样 。 


在 大 多 数 情 况 下 ， 可 能 只 需要 使 用 PROPAGATION_REQUIRED。 此 外 ， 必 须 定义 
方法 来 支持 这 个 事务 属性 。 方 法 名 支持 通配符 格式 ，save* 会 匹配 所 有 的 方法 名 以 
save(...) 开 始 的 方法 。 


事务 管理 器 


在 Hibernate 事 务 ， 需 要 使 用 HibernateTransactionManager 。 如 果 只 对 付 纯 
JDBC，useDataSourceTransactionManager; 而 如 果 是 JTA， 需 要 使 用 
JtaTransactionManager 。 


4. 代 理工 厂 bean 


创建 一 个 新 的 代理 工厂 bean 的 ProductBo， 并 设置 “interceptorNames” 属 性 。 


<!-- Product business object --> 
«bean id="productBo" class="com.yiibai.product.bo.impl.ProductBc 
<property name="productDao" ref="productDao" /> 
<property name="productQohBo" ref="productQohBo" /> 
</bean> 


<!-- Product Data Access Object --> 

«bean id="productDao" class="com.yiibai.product.dao.impl.Produci 
«property name="SessionFactory" ref="sessionFactory"></prope 

</bean> 


<bean id="productBoProxy" 
class="org.springframework.aop.framework.ProxyFactoryBean"> 
<property name="target" ref="productBo" /> 
<property name="interceptorNames"> 

<list> 

<value>transactionInterceptor</value> 

</list> 

</property> 
</bean> 


| 





运行 它 


Product product = new Product(); 
product.setProductCode("ABC"); 
product.setProductDesc("This is product ABC"); 


ProductBo productBo = (ProductBo)appContext.getBean("productBok 
productBo.save(product, 100); 


E — : 





代理 bean' productBoProxy' 和 save() 方 法 是 支持 事务 ， 现 在 ， 里 面 
productBo.save() 方 法 任何 异常 会 导致 整个 事务 回 滚 ， 没 有 数据 会 被 插入 到 数据 库 
中 。 下 载 代 码 - http://pan.baidu.com/s/1qXynbo4 


参考 


1. http://static.springsource.org/spring/docs/2.5.x/api/org/springframework/trans 
action/TransactionDefinition.html 
2. http://static.springsource.org/spring/docs/2.5.x/reference/transaction.html 


Spring 在 bean 配 置 文件 中 定义 电子 邮件 模板 - 
Spring 教程 


在 上 一 篇 Spring 电子 邮件 教程 ， 硬 编码 的 所 有 电子 邮件 属性 和 消息 的 方法 体 中 的 内 
容 ， 这 是 不 实际 的 ， 应 予以 避免 。 应 该 考虑 在 Spring bean 配置 文件 中 定义 电子 邮 
件 模 板 。 


1.Spring 的 邮件 发 件 人 


Java 类 使 用 Spring 的 MailSender 接 口 发 送 电 子 邮件 ， 并 使 用 String.Format 传递 变 
量 bean 配 置 文件 替换 电子 邮件 中 的 '%s'。 


File : MailMail.java 


package com.yiibai.common; 


import org.springframework.mail.MailSender; 
import org.springframework.mail.SimpleMailMessage; 


public class MailMail 


( 


private MailSender mailSender; 
private SimpleMailMessage simpleMailMessage; 


public void setSimpleMailMessage(SimpleMailMessage simpleMailM: 


this.simpleMailMessage - simpleMailMessage; 
} 


public void setMailSender(MailSender mailSender) { 
this.mailSender = mailSender; 
} 
public void sendMail(String dear, String content) { 
SimpleMailMessage message = new SimpleMailMessage(simpleMai- 


message.setText(String. format ( 
simpleMailMessage.getText(), dear, content) ); 


mailSender.send(message); 








2. Bean 的 配置 文件 


定义 电子 邮件 模板 "customeMailMessage' 和 邮件 发 件 人 信息 的 bean 配 置 文件 。 
File : Spring-Mail.xml 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<bean id="mailSender" class="org.springframework.mail.javamail. Javé 
«property name="host" value-'"smtp.gmail.com" /> 
«property name="port" value="587" /> 
<property name="username" value="username" /> 
<property name="password" value="password" /> 


«property name="javaMailProperties"> 
<props> 
<prop key="mail.smtp.auth">true</prop> 
<prop key="mail.smtp.starttls.enable">true</prop> 
</props> 
</property> 
</bean> 


<bean id="mailMail" class="com.yiibai.common.MailMail"> 

<property name="mailSender" ref="mailSender" /> 

«property name-"simpleMailMessage" ref="CcustomeMailMessage" /> 
</bean> 


«bean id="customeMailMessage" 
class="org.springframework.mail.SimpleMailMessage"> 


«property name="from" value="from@no-spam.com" /> 
<property name="to" value="to@no-spam.com" /> 
<property name="Subject" value="Testing Subject" /> 
<property name="text"> 
<value> 
<! [CDATA[ 
Dear %s, 
Mail Content : %s 
]]> 
</value> 
</property> 
</bean> 


</beans> 








package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext("applicationContext.:» 
MailMail mm = (MailMail) context.getBean("mailMail"); 
mm.sendMail("Yiibai", "This is text content"); 
} 
} 





输出 


Dear Yiibai, 
Mail Content : This is text content 


代码 下 载 -~ http://pan.baidu.com/s/1cOUPsFA 


Spring 发 送 带 附件 邮件 - Spring 教程 


下 面 是 一 个 例子 使 用 Spring 通过 Gmail SMTP 服 务 器 来 发 送 电 子 邮 件 附 件 。 为 了 包 
含 附件 的 电子 邮件 ， 你 必须 使 用 Spring 的 JavaMailSender 及 MimeMessage 来 代替 
MailSender & SimpleMailMessage. 


2.Spring 的 邮件 发 件 人 


必须 使 用 JavaMailSender 代替 MailSender 发 送 附 件 ， 并 用 MimeMessageHelper 
附加 的 资源 。 在 这 个 例子 中 ， 它 会 得 到 “ci\log.txt” 从 文件 系统 
(FileSystemResource) 作 为 电子 邮件 附件 的 文本 文件 。 


除了 文件 系统 ， 您 还 可 以 从 URL 路 径 (UrIResource 对 象 )， 类 路 径 (使 用 
ClassPathResource)，InputStream(lnputStreamResource) 的 任何 资源 .…… 请 参考 
Spring 的 AbstractResource 类 的 实现 。 


File : MailMail.java 


package com.yiibai.common; 


import javax.mail.MessagingException; 
import javax.mail.internet .MimeMessage; 


import org.springframework.core.io.FileSystemResource; 
import org.springframework.mail.MailParseException; 

import org.springframework.mail.SimpleMailMessage; 

import org.springframework.mail.javamail.JavaMailSender; 
import org.springframework.mail.javamail.MimeMessageHelper; 


public class MailMail 
{ 
private JavaMailSender mailSender; 
private SimpleMailMessage simpleMailMessage; 


public void setSimpleMailMessage(SimpleMailMessage simpleMailMe 
this.simpleMailMessage - simpleMailMessage; 


j 


public void setMailSender(JavaMailSender mailSender) { 
this.mailSender - mailSender; 


j 


public void sendMail(String dear, String content) { 


MimeMessage message - mailSender.createMimeMessage(); 


try{ 
MimeMessageHelper helper = new MimeMessageHelper(message, 1 


helper.setFrom(simpleMailMessage.getFrom()); 
helper.setTo(simpleMailMessage.getTo()); 
helper.setSubject(simpleMailMessage.getSubject()); 
helper.setText(String.format( 
simpleMailMessage.getText(), dear, content)); 


FileSystemResource file = new FileSystemResource("C:\\log.1 
helper.addAttachment(file.getFilename(), file); 


jcatch (MessagingException e) { 
throw new MailParseException(e); 


j 


mailSender.send(message); 





3. Bean 配 置 文件 


配置 mailSender bean， 电 子 邮 件 模板 ， 并 指定 Gmail 的 SMTP 服 务 器 电子 邮件 的 详 
细 信 息 。 


File : Spring-Mail.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd'» 


«bean id="mailSender" class-'org.springframework.mail.javamail.Jav: 
«property name="host" value-'"smtp.gmail.com" /> 
«property name="port" value="587" /» 
«property name-"username" value="yiibai.com@gmail.com" /> 
«property name="password" value="password" /> 


«property name="javaMailProperties"> 
<props> 
<prop key="mail.smtp.auth">true</prop> 
<prop key="mail.smtp.starttls.enable">true</prop> 
</props> 
</property> 
</bean> 


<bean id="mailMail" class="com.yiibai.common.MailMail"> 

<property name="mailSender" ref="mailSender" /> 

«property name="SimpleMailMessage" ref="CustomeMailMessage" /> 
</bean> 


«bean id="customeMailMessage" 
class="org.springframework.mail.SimpleMailMessage"> 


«property name="from" value="from@no-spam.com" /> 
<property name="to" value="to@no-spam.com" /> 
<property name="Subject" value="Testing Subject" /> 
<property name="text"> 
<value> 
<! [CDATA[ 
Dear %S, 
Mail Content : %s 
]]> 
</value> 
</property> 
</bean> 


</beans> 





package com.yiibai.common; 


import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App 


{ 
public static void main( String[] args ) 
{ 
ApplicationContext context = 
new ClassPathXmlApplicationContext("applicationContext 
MailMail mm = (MailMail) context.getBean("mailMail"); 
mm.sendMail("Yiibai", "This is text content"); 
} 
} 





输出 结果 


Dear Yiibai, 
Mail Content : This is text content 
Attachment : log.txt 


下 载 代码 — http://pan.baidu.com/s/1jHn9VLW 


Spring 依赖 注入 servlet 会 话 监听 器 - Spring 教程 


Spring 提供 了 一 个 “ContextLoaderListener 监听 器 ， 以 使 Spring 依赖 注入 到 会 话 
监听 器 。 在 本 教程 中 ， 通 过 添加 一 个 Spring 依赖 注入 一 个 bean 到 会 话 监听 器 修改 
HttpSessionListener 例子 。 


1. Spring Beans 


创建 一 个 简单 的 计数 服务 来 打印 创建 的 会 话 总 数 。 


File : CounterService.java 


package com. yiibai.common; 
public class CounterService{ 


public void printCounter(int count){ 
System.out.println("Total session created : " + count); 
j 


File : counter.xml — Bean 配 置 文件 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="counterService" class="com.yiibai.common.CounterServ: 


</beans> 


E 一 一 一 





2. WebApplicationContextUtils 


使 用 "WebApplicationContextUtils" 来 获得 Spring 上 下 文 ， 以 后 可 以 得 到 任何 声明 
Spring 的 Bean 在 一 个 正常 的 Spring 方式 。 


File : SessionCounterListener.java 


package com. yiibai.common; 


import 
import 
import 
import 
import 


public 


javax.servlet.http.HttpSession; 
javax.servlet.http.HttpSessionEvent; 
javax.servlet.http.HttpSessionListener; 
org.springframework.context.ApplicationContext; 
org.springframework.web.context.support.webApplicationConte) 


class SessionCounterListener implements HttpSessionListener 


private static int totalActiveSessions; 


public static int getTotalActiveSession()( 


j 


return totalActiveSessions; 


QOverride 
public void sessionCreated(HttpSessionEvent argO) { 


j 


totalActiveSessions++; 
System.out.println("sessionCreated - add one session inl 
printCounter(arg0); 


@Override 
public void sessionDestroyed(HttpSessionEvent arg0) { 


j 


totalActiveSessions--; 
System.out.println("sessionDestroyed - deduct one sessi« 
printCounter(arg0); 


private void printCounter(HttpSessionEvent sessionEvent)( 


HttpSession session - sessionEvent.getSession(); 
ApplicationContext ctx - 
WebApplicationContextUtils. 
getWebApplicationContext(session.getServletC: 


CounterService counterService - 
(CounterService) ctx.getBean("counterService' 


counterService.printCounter(totalActiveSessions); 





3. 集成 


唯一 的 问题 是 ， 如 何 使 Web 应 用 程序 知道 在 哪里 可 以 加 载 Spring bean 配置 文 
件 ? 秘诀 是 在 “web.xml" 文 件 中 。 


1. SEAf“ContextLoaderListener’/E 7; —T EIT 2s, {Web s Fate Fe An Spring 
上 下 文 加 载 程序 。 
2. 配置 “contextConfigLocation”， 并 定义 Spring 的 bean 配 置 文件 。 


File : web.xml 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app 2 3.dtd" > 


«web - app» 
<display-name>Archetype Created Web Application</display -name> 


<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>/WEB-INF/Spring/counter .xml</param-value> 
</context -param> 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
«/listener-class» 
</listener> 


<listener> 
<listener-class> 
com. yiibai.common.SessionCounterListener 
</listener-class> 
</listener> 


<servlet> 
<servlet-name>Spring DI Servlet Listener</servlet-name> 
<servlet-class>com.yiibai.common.App</servlet-class> 
</servlet> 


<servlet-mapping> 
<servlet-name>Spring DI Servlet Listener</servlet-name> 
<url-pattern>/Demo</url-pattern> 
</servlet -mapping> 
</web-app> 
| 


File : App.java 


package com. yiibai.common; 


import java.io.IOException; 

import java.io.Printwriter; 

import javax.servlet.http.HttpServlet; 

import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import javax.servlet.http.HttpSession; 


public class App extends HttpServlet{ 


public void doGet(HttpServletRequest request, HttpServletResponse 


throws IOException{ 


HttpSession session = request.getSession(); //sessionCreate 


session.setAttribute("url", "yiibai.com"); 
session.invalidate();  //sessionDestroyed() is executed 


PrintWriter out = response.getWriter(); 
out.println("«html»"); 
out.println("«body»"); 


out.println("«hi»Spring Dependency Injection into Servlet I 


out.println("«/body»"); 
out.println("«/html»"); 





启动 Tomcat， 并 访问 URL “http://localhost:8080/7.2-SpringDemo/" 
输出 结果 


sessionCreated - add one session into counter 
Total session created : 1 

sessionDestroyed - deduct one session from counter 
Total session created : 0 


看 看 控制 台 的 输出 ， 会 得 到 通过 Spring Di 记 数 服务 的 bean， 并 打印 会 话 的 总 数 。 


K 


结 


AN 


C 


在 Spring 中 , “ContextLoaderListener 是 一 个 通用 的 方法 集成 Spring 依赖 注入 到 几 
乎 所 有 的 Web 应 用 程序 。 下 载 代码 — http://pan.baidu.com/s/1bpmhQY 


* 


Spring % Jm 487f 
ResourceBundleMessageSourcez;nf/l| - Spring 


教程 


在 Spring 中 ， 你 可 以 使 用 ResourceBundleMessageSource 从 属性 文件 ， 基 于 解决 
所 选择 的 区 域 设置 文本 信息 。 参 见 下 面 的 例子 : 


1. 目录 结构 


本 实例 审查 目录 结构 如 下 所 示 : 
4 E 7.3-SpringDemo 
4 ( src 
4 iH com.yiibai.common 
(J] Appjava 
4 iH com,yiibai.customer.services 
(JS CustomerService java 
4 {B locale.customer 
messages en US.properties 
messages zh CN.properties 
43 applicationContext.xml 
Æ locale.xml 
mi JRE System Library [JavaSE-1.6] 
BA Spring 3.1 Core Libraries 


2. Properties X (+ 


创建 两 个 属性 文件 ， 一 个 是 英文 字符 (messages_en_US.properties)， 另 一 种 为 中 
国字 符 (messages_zh_CN.properties)。 把 它 放 到 项 目的 类 路 径 中 ( 见 上 图 )。 


File : messages_en_US.properties 
customer .name=Yong Mook Kim, age : (0j, URL : {1} 
File : messages_zh_CN.properties 


customer.name-Nu6613Nu767ENu6559Nu7A0B, age \: {0}, URL \: {1} 


1£^u6613767E6559W7A0B' 是 中 文 Unicode 字符 。 


3. Bean 配 置 文件 


包含 属性 文件 到 bean 的 配置 文件 。 这 两 
个 "messages_en_US.properties” 和 “messages_zh_CN.properties" 考 虑 放 Spring 
的 一 个 文件 中 ， 只 需要 包含 文件 名 一 次 ，Spring 会 自动 找到 正确 的 语言 环境 。 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www. springframework.org/schema/beans/spring-beans-2.5.x: 


<bean id="messageSource" 
class="org.springframework.context.support.ResourceBundleMme 
<property name="basename"> 
<value>locale\customer \messages</value> 
</property> 
</bean> 


</beans> 
Ki BEEN 
P.S 假设 这 两 个 文件 位 于 “项 目 根 目录 ”文件 夹 中 。 





4. 运行 它 


package com.yiibai.common; 


import java.util.Locale; 
import org.springframework.context.ApplicationContext; 
import org.springframework.context.support.ClassPathXmlApplication( 


public class App ( 
public static void main(String[] args) { 


ApplicationContext context 
= new ClassPathXmlApplicationContext("locale.xml"); 


String name - context.getMessage("customer.name", 
new Object[] { 28,"http://www.yiibai.com" }, Locale 


System.out.println("Customer name (English) : " + name); 
String namechinese = context.getMessage("customer.name", 


new Object[] (29, "http://www.yiibai.com" }, 
Locale.SIMPLIFIED CHINESE), 





System.out.println("Customer name (Chinese) : " + namechine 
} 
} 
mmm 
输出 结果 





El Console $3 ^ GL Problems| @ Javadoc Declaration 其 % | Ex B 图 图 | m= wa 
<terminated> App (41) [Java Application] D:\Program Files (x86)\MyEclipse\Common\binary\com.sun,java,jdk.win32.x8€ 
log4j:WARN No appenders could be found for logger (org.springframework.core.env.StandardEnvironment). 
log4j:WARN Please initialize the log4j system properly. 

log4j:WARN See hittp://logging.apache.org/log4j/1.2/faq.html#noconfig for more info. 

Customer name (English) : Yiibai, age : 28, URL : http://www.yiibai.com 

Customer name (Chinese) : 易 百 教程 , age : 28, URL : http://www.yiibai.com 

Customer name (English) : Yiibai, age : 28, URL : http://www.yiibai.com 

|! Customer name (Chinese) : 易 百 教程 , age : 29, URL: http://www.yiibai.com 


解释 : 


1. 在 context.getMessage()， 第 二 个 参数 是 消息 参数 ， 必 须 把 它 作 为 对 象 数组 。 
如 果 没 有 参数 值 可 用 ， 可 以 只 传递 一 个 空 (null)。 


context.getMessage("customer.name",null, Locale.US); 


1. Locale.US'RÉM"messages en US.properties";& EE, m 
Locale.SIMPLIFIED CHINESEREA "messages zh CN.properties" # Evia. 


FRR — http://pan.baidu.com/s/1gdPt5Ur 


Struts2 教 程 


Apache Struts 2 是 一 种 流行 的 Java 模 型 - 视图 - 控制 器 (MVC) 框架 ， 成 功 地 结 
合 了 WebWork 和 Struts1.x 两 种 web 框架 。 


Apache Struts2 与 Struts1 完 全 不 同 ， 它 的 核心 功能 都 是 使 用 拦截 实现 “ 值 栈 "的 概 
念 ，OGNL 表 达 式 和 Struts2 标 签 来 解决 应 用 程序 数据 ， 很 多 注解 和 约定 ， 使 这 个 框 
架 更 加 易于 使 用 。 在 本 教程 中 ， 它 提供 了 许多 使 用 Struts2 的 MVC 框 架 的 实例 和 解 
释 。 

欢迎 来 到 易 百 教程 学 习 Struts2。 


Struts2 快速 入 门 


Struts2 快 速 入 门 的 例子 。 


e Struts 2 hello world (XML 版 本 ) 使 用 XML 文件 的 Struts 2 Hello World 示例 
e Struts 2 Hello World (注解 版 本 ) 使 用 注释 的 Struts 2 Hello World 示例 
e @ResultPath 注释 示例 @ResultPath 注释 说 明和 示例 


Struts2 配置 


任何 关于 Struts2 的 配置 文件 。 


e 多 个 Struts 配 置 文件 示例 拆 分 大 的 Struts 配 置 文件 分 成 多 个 小 的 配置 文件 。 

e Struts2 命名 空间 配置 和 解释 Struts2 命 名 空间 是 一 个 新 的 概念 ， 用 来 处 理 多 个 
模块 ， 由 下 式 给 出 一 个 命名 空间 对 应 的 每 个 模块 。 

e Struts2 开 发 模式 启用 了 Struts2 开 发 模式 将 会 使 调试 变 得 更 容易 。 

e 如 何 删 除 Struts2 动 作 的 后 绥 扩 展 名 Ri action y RAZAIAN, FAA 
户 友好 的 ， 可 以 删除 或 用 另 一 个 扩展 名 来 取代 它 。 


Struts2 动作 和 表单 


Struts 2 的 动作 和 表单 数据 管理 。 


e 使 用 Struts2 动 作 Struts 2 的 动作 说 明和 示例 。 

e Struts 2 ActionError & ActionMessage Example Struts 2 的 ActionError 和 
ActionMessage 的 解释 和 例子 。 

e Struts 2 ModelDriven example 自动 将 的 表单 数据 传输 到 对 象 。 


Struts2 拦截 器 


关于 Struts 2 的 拦截 器 。 


映射 拦截 动作 配置 拦截 器 动作 。 

重 写 拦截 器 参数 几 种 方法 来 覆盖 拦截 器 的 参数 。 

拦截 器 栈 的 例子 拦截 器 堆栈 用 于 建立 一 组 的 拦截 器 ， 以 再 利用 。 

创建 自己 的 拦截 器 创建 自己 的 拦截 器 指南 ， 以 满足 您 的 需求 。 
execAndWait 拦 截 器 例子 一 个 非常 方便 的 拦截 器 长 时 间 运 行动 作 在 后 人 台 ， 显 示 
用 户 的 自 定义 的 等 待 页 面 。 


Struts 2 UI 标签 


Struts 2 的 UI 标签 ， 来 泻 染 HTML 表 单 和 非 表 单 组 件 。 


TextBox 文 档 示 例 Struts2 <s:textfield> 文本 实例 . 

Password 示例 Struts2 <s:password> 密码 实例 . 

Hidden 隆 藏 值 示例 Struts2 <s:hidden> 隐藏 值 例子 

Textarea - 文本 域 Struts2 <s:textarea> textarea 例 子 

Radio 单 选 按键 示例 Struts2 <s:radio> radio 单 选 按钮 例子 

预选 单 选 按钮 预选 单 选 按钮 值 示例 

复 选 框 heckbox 示例 Struts2 «s:checkbox» 复 选 框 示例 

复 选 框 checkboxes 示例 Struts2 <s:checkboxlist> 多 发 复 选 框 的 例子 

设置 复 选 框 的 默认 值 设置 多 个 复 选 框 的 默认 值 

下 拉 框 示例 Struts2 <s:select> 下 拉 框 例子 

自动 选择 下 拉 框 示例 自动 选择 下 拉 框 值 指南 

组 合 框 示 例 Struts2 <s:combobox> 组 合 框 的 例子 

head 示例 Struts2 «s:head», 呈现 一 个 HTML 头 组 件 

文件 上 传 示例 Struts2 <s:file> 文件 上 传 示例 

多 文件 上 传 示例 Struts2 «s:file» 多 文件 上 传 示 例 

级 联 选择 示例 Struts2 <s:doubleselect>, 创建 两 个 HTML 下 拉 框 ， 当 第 一 下 拉 
列表 中 选择 ， 第 二 下 拉 列 表 将 相应 地 改变 

updownselect 示例 Struts2 <s:updownselect>, 创建 一 个 带 有 按钮 ， 向 上 或 向 
下 移动 在 选择 组 件 的 选项 选择 HTML 组 件 。 

optiontransferselect 示例 Struts2 <s:optiontransferselect>, 两 

个 “Updownselect" 选 择 组 件 排 列 在 左 侧 和 右 侧 ， 在 它们 中 间 包 含有 按钮 来 移动 
自己 的 选择 选项 。 

datetimepicker 日 期 选择 Struts2 <s:datetimepicker>, 将 呈现 一 个 文本 框 和 追 
加 后 面 的 日 历 图 标 ， 单 击 日 历 图 标 上 会 提示 的 日 期 时 间 选 择 器 组 件 。 
autocompleter 自 动 完成 示例 Struts2 <s:autocompleter>, 一 个 组 合 框 ， 会 自动 
提示 下 拉 的 提示 菜单 ， 在 用 户 输入 文本 框 时 。 

autocompleter + JSON 示例 举 个 例子 ， 使 用 JSON 数 据 填 充 到 autocompleter 
组 件 。 


Struts 2 控制 标签 


在 Struts2 PAV ARE iA, FORMA, AN, KEA EAH. 


<s:iterator> 45 4 3X fV zn Bl Struts23& (V 2845 ARER — T dà, CAUSA 
的 java.util.Collection 或 java.util.Iterator 


e «sif», <s:elself>, <s:else> 标签 示例 Struts2 if,elseif 和 else 标 签 被 用 来 执行 基 

本 条 件 检 查 。 

eii E 签 示 例 Struts2 <s:append> 标 签 用 来 组 合 几 个 迭代 器 (由 列表 或 

映射 创建 ) 到 一 个 迭代 器 

e eats 标签 示例 struts2 <s:generator> 标 记 用 于 基于 在 页 中 提供 “val" 属 
性 ， 以 产生 一 个 迭代 。 

e <s:merge> 标 签 示 例 Struts2 <s:merge> 标 签 用 来 合并 几 个 迭代 器 (以 列表 或 映 

射 创 建 ) 成 一 个 迭代 器 。 

<sisort> 标 签 示 例 Struts2 <s:sort> 是 用 于 排序 一 个 列表 ， 它 通过 使 用 

java.util.Comparator 来 实现 。 

subset tag example Struts2 <s:subset> 标 记 用 于 输出 一 个 迭代 元 素 的 子 集 或 部 

分 。 


Struts2 数据 标签 


Struts2 数 据 标 签 ， 从 ValueStack 中 获取 数据 ， 或 将 数据 放 人 ValusStack。 


e <Ss:a> 标 签 示 例 Struts2 的 <s:a> 标 签 被 用 于 泻 染 HTML 的 “<a>” 标 签 

e «s:action» 45 Zzr jl Struts2 的 <s:action> 标 签 答 用 来 直接 在 一 个 JSP 页 面 中 调用 
Action 类 

e <s:bean> 标 签 示 例 Struts2 的 <s:bean> 标 签 用 来 在 JSP 页 面 中 实例 化 一 个 类 

e <s:date> 标 签 示 例 Struts2 的 <s:date> 标 签 用 来 在 J JSP 页 面 格式 Date 对 象 。 

e <s:debug> 标 签 示 例 Struts 2 的 <s:debug> 标 签 是 一 个 非常 有 用 的 调试 标记 ， 用 
于 输出 “ 值 栈 "的 内 容 ， 并 在 JSP 页 面 中 输出 “堆栈 上 下 文 " 的 详细 信息 。 

e <s:include> 标 签 示 例 Struts 2 的 <s:include> 标 签 用 来 直接 包含 JSP 或 HTML 页 

面 到 当前 页 面 。 

e p i18n> 标 签 示例 Struts 2 的 <s:i18n> 标 签 用 来 获取 声明 的 资源 包 ， 而 不 仅仅 是 
资源 包 ， 也 可 获取 当前 操作 相关 联 的 消息 。 

e <s:param> 标 签 示 例 Struts2 的 <s:param> 标 签 用 来 参数 化 其 他 标签 

e <s:property> 标 签 ATDI Struts2 的 <s:property> 标 签 用 来 从 一 个 类 获取 当前 默认 
Action 类 的 属性 值 。 

° <s:push> 标 签 示例 Struts2 的 <s:push> 标 签 用 来 推 值 到 堆栈 的 顶部 ， 以 便 它 可 
以 容易 访问 或 参考 。 

e «s:set»45 Zn 9l Struts2 的 <s:set> 标 签 用 来 在 指定 的 范围 内 (S FH, Bid, ik 
求 ， 页 面 ， 或 动作 ) 赋值 给 一 个 变量 

e -s:text» 4; Ez (9l Struts2 的 <s:text> 标 签 用 于 从 操作 类 取出 资源 包 消 息 

e <SsiUr|> 标 签 示 例 Struts2 的 <s:url> 标签 用 来 创建 一 个 URL， 并 输出 作为 文本 格 
I 
式 


Struts2 资源 包 和 本 地 化 


Struts2 的 资源 包 来 支持 网 络 定位 功能 (多 语言 ) 


e 资源 包 使 用 示例 Struts2 的 资源 包 的 解释 和 例子 
e i18n 或 本 地 化 示例 一 个 Struts 2 的 国际 化 和 多 语言 的 例子 来 说 明 如 何 使 用 资源 
包 来 显示 不 同 语言 的 消息 


e key 属性 示例 Struts 2 key 属 性 在 Ul 组 件 是 处 理 本 地 化 的 常用 方法 ， 也 UI 标 签 


码 的 一 个 非常 有 效 的 方法 
e Chinese 本 地 化 问题 一 个 常见 的 中 国 本 地 化 的 问题 
e 配置 全 局 资源 包 配置 Struts2 的 全 局 资源 包 指 南 


Struts2 主 题 


Struts2 的 布局 是 由 “XHTML 主题 设计 的 ， 所 以 了 解 Struts2 主题 概念 是 必须 的 。 
e Struts2 主题 和 模板 Struts 2 主题 和 模板 的 说 明和 示例 


Struts2 集 成 其 它 框 架 


Struts2 与 任何 他 人 框架 的 整合 - Spring, Hibernate, Quartz, Log4j.… 


Struts2 + Spring 集成 实例 Struts2 和 Spring 框架 集成 。 
Struts2 + Quartz 调 度 集成 实例 Struts2 和 Quartz 调 度 框 架 集成 。 
Struts2 + Hibernate 集成 实例 集成 Struts2 和 Hibernate 框架 。 


Plugin" 集 成 Struts2 和 Hibernate3 


编 


Struts2 + Hibernate 使 用 “Full Hibernate Plugin" 插 件 集 成 使 用 “Full Hibernate 


e Struts2 + Spring + Hibernate 集 成 实例 集成 Struts2，Spring 和 Hibernate 三 个 框 
ES 


e Struts 2 + Log4j 集成 实例 集成 Struts 2 和 Log4j 框架 . 


Struts2 FAQ 


e FilterDispatcher 和 StrutsPrepareAndExecuteFilter 区 别 ? 关于 开发 问 
filterdispatcher 和 strutsprepareandexecutefilter 之 间 的 差异 。 


e 在 Struts2 中 获取 HttpServletRequest 获取 Struts2 HttpServletRequest 对 象 的 


实例 。 
e 在 Struts2 获 取 HttpServletResponse 对 象 在 Struts2 中 如 何 获取 
HttpServletResponse 对 象 实例 


例 
e 在 Struts2 中 配置 静态 参数 (有 示例 代码 ) 在 Struts2 配 置 静态 参数 实例 
e Struts2 下 载 文 件 实例 (有 实例 代码 ) Struts2 实 现下 载 文件 实例 
Struts2 和 JSON 实例 (有 实例 代码 ) 举 个 例子 来 说 明 Struts2 集 成 JSON 数 
据 。 


Struts2 参考 


e Struts2 官方 文档 
e Struts2 通用 标签 
e http://en.wikipedia.org/wiki/Apache_ Struts 


在 Struts2 中 如 何 获取 ServletContext 对 象 FEStruts2# FXServietContext xt R 32 


Struts 2 hello world (XML 版 本 ) - Struts2 教 程 


在 这 个 例子 中 ， 我 们 将 学 习 如 何在 Struts 2 中 创建 一 个 Hello World 例 子 。 
使 用 以 下 库 或 工具 : 


e MyEclipse 10 
e Struts 2.1 


整个 工程 结构 如 下 图 所 示 : 


[$ Package Explorer °3 fe Type Hierarchy zi oe 
4 E struts2-xml-demo 
4 E src 
4 册 com yiibai.user.action 
四 WelcomeUserAction,java 
Tt struts.xml 
mi, JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
mi Struts 2 Core Libraries 
4 © WebRoot 
& META-INF 
4 区 WEB-INF 
& lib 
[Xf web.xml 
P indexjsp 
J? loginjsp 
J? welcome user.jsp 





1. 创建 一 个 Web 项 目 工程 


启动 打开 MyEclipse， 创 建 一 个 Web 工 程 名 称 为 : struts2-xml-demo， 选 择 File -> 
New -> Web Project ， 如 下 图 所 示 : 


TutorialsPoint Java 技术 教程 


Create a Web Project 


Create a web project in the workspace or an external location 





Web Project Details 
Project Name: struts2-xml-demo 


Location: Use default location 


Directory: |D:\workspce\struts2-xml-demo | | Browse... 





Source folder: src 
Web root folder: WebRoot 
Context root URL: /struts2-xml-demo 
J2EE Specification Level 
@JavaEE5.0 ©J2EE14  ()J2bE 13 


Maven 
回 Add Maven support 
Learn more about Maven4MyEClipse... 


JSTL Support 
[ ]Add JSTL libraries to WEB-INF/lib folder? 














在 这 个 项 目 上 添加 struts2 的 支持 ， 右 键 点 击 struts2-xml-demo 工程 ， 选 择 
MyEclipse -> Add Struts Capabilities， 在 弹出 的 对 话 框 中 选择 Strut 2.1， 如 下 图 所 
ZN: 
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Struts Support for MyEclipse Web Project 


Enable project for Struts development 


Web project: struts2-xml-demo 
Web-root folder: /WebRoot 


Servlet specification: 2.5 


Struts specification: © Struts 1.1 © Struts 1.2 © Struts 1. | @ siruts 21 | 


Struts 2 filter name: struts2 


URL pattern: @ *.action © *.do 








2. JSP 视 图 文件 


这 是 一 个 JSP 登 录 页面， 它 使 用 Struts2 标 签 来 显示 用 户 名 ， 密 码 输入 框 和 提交 按 
钮 。 


Fie : login.jsp 


<%@ page contentType="text/html; charset=UTF-8"%> 
<%@ taglib prefix="s" uri="/struts-tags"%> 
«html» 
<head></head> 
<body> 
<hi>Struts 2 Hello World Example</h1i> 


«s:form action="Welcome"> 
<s:textfield name="username" label="Username" /> 
«s:password name="password" label="Password" /> 
<s:submit /> 

«/s:form» 


«/body» 
«/html» 


X fF: welcome user.jsp - 一 个 JSP 视 图 用 来 页 面 显 示 欢 迎 信息 给 用 户 。 


«949 page contentType="text/html; charset=UTF-8"%> 
«99 taglib prefix="s" uri="/struts-tags"%> 
<html> 
<head></head> 
<body> 
<hi>Struts 2 Hello World 示例 </h1> 


<h2> 

Hello 

«s:property value="username" /> 
</h2> 


</body> 
</html> 


对 Struts1 和 Struts2 有 非常 相似 的 UI 标签 语法 ， 只 是 在 命名 HTML 元 素 ， 例 如 ， 术 
语 有 一 点 不 同 : 


Struts 1 


<%Q@taglib uri="http://struts.apache.org/tags-html" prefix="htm1"% 
<html:form action="Welcome"> 

«html:text property="username"/> 
«/html: form» 


EY 
Struts 2 


«99 taglib prefix="s" uri="/struts-tags" 96» 
«s:form action="Welcome"> 

<s:textfield name="username" label="Username"/> 
</s:form> 


5. 动作 ， 所 有 的 业务 逻辑 放 在 这 里 


一 个 简单 的 Struts2 的 Action 类 ， 它 里 面 声 明 的 所 有 业务 逻辑 。 


File : WelcomeUserAction.java 


package com.yiibai.user.action; 


Vines 


* 


* @author yiibai.com 
* 


ur 
public class WelcomeUserAction { 


private String username; 


public String getUsername() { 
return username; 


} 


public void setUsername(String username) { 
this.username = username; 


} 


// all struts logic here 
public String execute() { 


return "SUCCESS"; 


在 Struts2 中 ，Action 类 实现 任何 接口 或 扩展 任何 类 不 是 必需 的 ， 但 它 需 要 创建 一 个 
execute() 方 法 来 实现 所 有 的 业务 逻辑 ， 并 返回 一 个 字符 串 值 ， 告 诉 用 户 重 定向 到 哪 


o 


注意 您 可 能 会 看 到 一 些 用 户 实现 com.opensymphony.xwork2.Action #, 但 它 是 
完全 可 选 的 (不 是 必须 的 )， 因 为 com.opensymphony.xwork2.Action 只 是 提供 一 些 方 
便 的 常量 。Struts1 中 的 Action 类 需要 扩展 org.apache.struts.action.Action。 但 是 ， 
Struts 2 的 Action 类 是 可 选 的 ， 但 是 仍然 允许 执行 
com.opensymphony.xwork2.Action 的 一 些 方 便 的 常量 ， 或 者 扩展 
com.opensymphony.xwork2.ActionSupport 对 于 一 些 常见 的 默认 动作 执行 的 功能 。 


5. Struts 配 置 文件 


Strut 配 置 文件 是 用 来 连接 所 有 的 东西 在 一 起 。 XML 文件 名 必须 是 “struts.xml"。 在 
这 个 实例 中 ， 它 位 于 


File : struts.xml 


_<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts 
<struts> 
«package name="user" namespace="/User" extends="struts-default' 
<action name="Login"> 
<result>/login.jsp</result> 
</action> 
«action name="Welcome" class="com.yiibai.user.action.Welcor 
«result name="SUCCESS">/welcome_user.jsp</result> 
</action> 
</package> 
</struts>_ 


AA E 





声明 包 和 包含 动作 类 ， 动 作 类 是 不 言 自明 的 ， 但 你 仍 可 能 会 感 兴趣 下 面 的 新 标签 : 
1. package name="user” 就 在 包 名 ， 并 不 真正 去 关心 它 。 

2. namespacez"/User" 它 用 于 匹配 /UserURL 模 式 。 

注意 实际 上 ，Struts2 的 命名 空间 相当 于 Struts 的 1 多 个 功能 模块 


3. extends=”struts-default” 这 意味 着 该 包 是 扩展 了 struts-default 包 组 件 和 拦截 
器 ， 这 是 在 struts-default.xml 中 文件 中 声明 的 ， 位 于 struts2-core.jar 文件 的 根 目 
录 。 


6. web.xml 


配置 Web 点 用 程序 部 署 描述 符 (web.xml) 文 件 Struts2 的 集成 到 Web 项 目 。 


File web.xml 


_<?xml version="1.0" encoding="UTF-8"?> 
<web-app version="3.0" 
xmins="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xm1/ns/javaee/web-app 3 0.xsd"> 
<display-name></display -name> 
<welcome-file-list> 
<welcome-file>index. jsp</welcome-file> 
</welcome-file-list> 
<filter> 
<filter-name>struts2</filter -name> 
<filter-class> 
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndt 
</filter-class> 
</filter> 
<filter -mapping> 
<filter-name>struts2</filter -name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping></web-app>_ 


Ed 





T. 运行 测试 结 来 
在 Struts2 中 ， 可 以 直接 使 用 .action 后 级 访问 操作 类 。 如 下 URL : 
http://localhost:8080/struts2-xml-demo/User/Login.action 


_ kica [| n 
|] localhost:8080/struts2-» x V. 


€ > C [!localhost8080/struts2-xml-demo/User/Login.ac § 














Th 到 

Struts 2 Hello World Example | 
Username: liibaicom = = = 

Password: [eee 000000 | 
| Submit | 

















提交 后 到 http://localhost:8080/Struts2Example/User/Welcome.action 显示 如 下 : 
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€ > C D localhost:8080/struts2-xml-demo/User/Welcome.ary? 
Struts 2 Hello World 示例 





Hello yiibai. com 
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Struts2 注 解 示例 - Struts2 教 程 


在 这 个 教程 ， 我 们 重复 使 用 以 前 STRUST2 Hello World(XML 版 本 ) 的 例子 ， 并 将 其 
转换 成 注解 版 本 。 


Struts2 注解 概念 


Struts2 注 解 是 由 Struts 2 的 约定 插件 的 支持 ， 所 以 ， 必 须要 了 解 其 背后 的 "扫描 方 
法 "和 “命名 转换 ”机制 的 魔力 。 


1. 扫 搞 方法 


许多 Struts 2 的 文章 或 书籍 说 ， 可 以 配置 过 滤器 的 “init- 
param" 或 “struts.convention.action.packages" 告 诉 Struts2， 其 中 扫描 注解 的 类 。 例 


如 ， 


web.xml 


<filter> 
<filter-name>struts2</filter -name> 
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</fi- 
«init-param» 
<param-name>actionPackages</param- name> 
<param-value>com. yiibai.common</param-value> 
</init -param> 
</filter> 


E ewm m 


从 测试 (Struts22.1.6 和 2.1.8 版 本 )， 这 是 不 正确 的 ， 不 管 你 把 在 "param-value" 还 是 
"struts.convention.action.packages", 在 Struts 2 会 忽略 它 ， 并 只 扫描 指定 的 文件 夹 
命名 : struts, struts2, action 或 actions 。 


下 面 是 扫描 工作 


1. 扫描 其 位 于 包 的 命名 注解 的 类 “struts, struts2, action 或 actions". 
2. 接着 ， 扫 摘 相 匹配 下 列 任 一 条 件 的 文件 : 

o 实例 了 com.opensymphony.xwork2.Action 接口 。 

o 扩展 了 com.opensymphony.xwork2.ActionSupport 类 

o 文件 名 用 动作 (例如 : UserAction，LoginAction) 结 


详细 请 查看 这 里 Struts 2 约定 插件 文件 





2. 命名 转换 器 


Struts 2 的 约定 插件 将 所 有 的 注解 操作 文件 名 转换 为 指定 的 格式 。 
例如 : LoginAction.java 


1. 首先 ， 去 掉 "Action "字符 在 文件 名 的 末尾 ， 如 果 存 在 的 话 。 
2. 其 次 ， 转 换文 件 名 的 第 一 个 字母 为 小 写 。 


因此 ， 去 除 结束 并 转换 第 一 个 字母 为 小 写 后 ，LoginAction.action 将 变 为 
login.action。 Struts2 约 定 插件 的 “扫描 方法 "和 “命名 转换 "特性 真正 带 来 了 很 多 的 便 
利和 好 处 ， 只 有 当 你 的 Struts2 项 目 正 确 下 面 的 命名 约定 才 会 带 来 好 人 多; 否则 ， 这 将 
是 一 场 灾难 。 


Struts 2 注解 例子 


现在 是 时 候 开 始 转换 过 程 了 ， 我 们 使 用 MyEclipse 10 创建 一 个 工程 为 : 
struts2example. 


最 终 的 项 目 结构 


{2 Package Explorer 23 AG’ oO 
E struts2-xml-demo 
4 $$ struts2example 
4 $8 src 
4 {8 comyiibai.user.action 
|J] LoginAction,java 
|J] WelcomeUserAction.java 
Et struts.xml 
Bi, JRE System Library [Sun JDK 1.6.0 
mi Java EE 6 Libraries 
=) Struts 2 Core Libraries 
4 @& WebRoot 
(z» META-INF 
(z» WEB-INF 
J indexjsp 
J? loginjsp 
J? welcome userJsp 


13] 


2. LoginAction 


扩展 ActionSupport 并 创建 了 LoginAction， 什 么 也 不 做 ，ActionSupport 默认 返回 
“success” 字符 串 , 这 将 匹配 (Result 并 重 定位 到 “pages/login.jsp“. 


注解 版 本 


package com.yiibai.user.action; 


import org.apache.struts2.convention.annotation.Namespace; 
import org.apache.struts2.convention.annotation.Result; 
import org.apache.struts2.convention.annotation.ResultPath; 


import com.opensymphony.xwork2.ActionSupport; 


@Namespace("/User" ) 

QResultPath(valuez"/") 

@Result (name="success", location-"/login.jsp") 
public class LoginAction extends ActionSupport{ 


} 


XML 实现 版 本 


**«package name="user" namespace="/User" extends="struts-default"> 
<action name="Login"> 
<result>/login.jsp</result> 
</action> 
</package>** 


DENN DD 
3. WelcomeUserAction 


重 写 execute() 方 法 并 指定 (Q Action 和 Q Result 注解 。 
注解 版 本 


package com.yiibai.user.action; 


import org.apache.struts2.convention.annotation.Action; 
import org.apache.struts2.convention.annotation.Namespace; 
import org.apache.struts2.convention.annotation.Result; 
import org.apache.struts2.convention.annotation.ResultPath; 


import com.opensymphony.xwork2.ActionSupport; 
@Namespace("/User" ) 
@ResultPath(value="/") 
public class WelcomeUserAction extends ActionSupport{ 
private String username; 
public String getUsername() { 


return username; 


public void setUsername(String username) { 
this.username = username; 
Jj 


@Action(value="Welcome", results={ 

@Result (name="success", location="welcome_user.jsp") 
3) 
public String execute() ( 


return SUCCESS; 


XML 实现 版 本 


«package name="user" namespace="/User" extends="struts-default"> 
«action name="Welcome" class="com.yiibai.user.action.WelcomeUse) 
«result name="SUCCESS">/welcome_user.jsp</result> 
</action> 

</package> 





Struts 2 注解 — @Action, (Result 和 (Namespace 不 言 自 明 ， 可 以 将 它 与 XML 比 
较 。@ResultPath 可 能 需要 一 点 点 的 解释 ， 请 参阅 本 @ResultPath 示 例 


4. JSP 3L ES RA 


普通 JSP 视 图 页 面 来 接受 用 户 名 和 密码 后 点 击 提交 按钮 ， 并 重 定向 到 一 个 欢迎 页 
面 。 


login.jsp 


<%@ page contentType="text/html; charset=UTF-8"%> 
«99 taglib prefix="s" uri="/struts-tags"%> 
<html> 
<head></head> 
<body> 
<hi>Struts 2 注解 示例 </h1> 


<s:form action="Welcome"> 
«s:textfield name="username" label=" 用 户 名 " /> 
«s:password name="password" label=" 密 码 " /> 
«s:submit value=" 提 交 "/> 

«/s:form» 


«/body» 
«/html» 


welcome user.jsp 


«99 page contentType="text/html; charset=UTF-8" 96» 
«99 taglib prefix="s" uri="/struts-tags" 96» 

<html> 

<head></head> 

<body> 

<hi>Struts 2 注解 示例 </h1> 

<h4> 您 好 ，<s:property value="username"/></h4> 


</body> 
</html> 


5. struts.xml 


所 有 类 注解 无 需 创 建 struts.xml 文件 。 


6. web.xml 


只 要 创建 一 个 典型 的 web.xml 文 件 ， 并 声明 FilterDispatcher 过 滤器 标准 。 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app 2 3.dtd" > 


«web app» 
<display-name>Struts 2 Web Application</display-name> 


«filter» 
«filter-name»struts2«/filter-name- 
«filter-class»org.apache.struts2.dispatcher.FilterDispatcherc/1 
</filter> 


<filter -mapping> 
<filter -name>struts2</filter -name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


</web-app> 
E NENNEN 





T. 运行 测试 
LoginAction.action 改 为 login.action， 请 参阅 上 面 的 “命名 转换 器 "。 
http://localhost:8080/struts2example/User/login.action 











/ [à localhost:8080/struts2e, x V | sa 








€ C | D localhost:8080/struts2example/User/login.action 


Struts 2 注解 示例 


用 户 名 : yiibai com 
SE: fee 


| 提交 | 








提交 到 http://localhost:8080/Struts2Example/User/Welcome.action 后 显示 : 


TutorialsPoint Java 技术 教程 


€ > C |D localhost:8080/struts2example/User/Welcome.action;jsessionid=AFBCOD v? | = 
Struts 2 注解 示例 


您 好 ，yiibai. com 








1. Struts 2 约定 插件 文档 
2. Strust 2 Hello World (XML 版 本 ) 
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Struts2 @ResultPath 注 释 示例 - Struts2 教 程 


在 Struts 2 中 , @ResultPath 注解 用 于 控制 Struts2 找 到 存储 的 结果 或 JSP 页 面 。 默 认 
情况 下 ， 它 会 找到 结果 页 在 “WEB-INF/content/ 文件 夹 。 不 知道 为 什么 在 Struts2 
注解 设置 “WEB-INF/content/” 作为 默认 目录 , 但 是 大 部 分 的 应 用 并 不 将 结果 页 放 入 
到 “WEB-INF/content/” 目录 . 可 能 Struts2 惯 例 也 并 不 是 一 个 标准 的 文件 夹 结 构 。 我 
一 般 是 在 Struts 2 根 路 径 作 为 默认 的 文件 夹 。 


@ResultPath 示例 


1. 默认 结果 路 径 


在 登录 动作 类 ,设置 User 作为 命名 空间 , 并 重 定 向 到 “pages/login.jsp” 页 面 。 
P.S 假设 struts2example 是 上 下 文 servlet 名 称 


@Namespace("/User" ) 
QResult(namez"success", location-"pages/login.jsp") 
public class LoginAction extends ActionSupport{ 


j 
ime, AX: 
http://localhost:8080/struts2example/User/login.action 


Struts 2 将 从 默认 位 置 找到 “login.jsp” 结 果 页 面 : 


/struts2example/WEB-INF/content/User/pages/login. jsp 


2. 定制 结果 路 径 
如 果 JSP 结 果 页 面 存储 在 其 他 位 置 ， 那 么 可 以 使 用 @ResultPath 注 释 设 置 改变 它 。 


QNamespace("/User") 

QResultPath(valuez"/") 

@Result (name="success", location-"pages/login.jsp") 
public class LoginAction extends ActionSupport{ 


} 


再 一 次 访问 : 


http://localhost:8080/struts2example/User/login.action 


现在 Struts2 将 从 不 同 的 位 置 找到 “login.jsp” 结 果 页 面 : 


/Struts2Example/User/pages/login. jsp 


全 局 @ResultPath 


@ResultPath 只 适用 于 类 级 别 。 在 全 局 范围 内 应 用 它 ， 可 以 在 struts.xml 文件 中 进 
行 配 置 。 


struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 
«struts» 

«constant name-"struts.convention.result.path" value="/"/> 
«/struts» 


[LE 


1. Struts 2 @ResultPath 注解 文档 


Struts2 include(22)4 Nadia Xx - Struts2 教 程 


Struts 2 自 带 有 "包含 文件 功能， 包含 多 个 Struts 配 置 文件 合并 为 一 个 单元 。 


单个 Struts 配 置 文件 
让 我 们 来 看 看 一 个 糟糕 的 Struts 2 配置 示例 。 
struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 


«package name="default" namespace="/" extends="Sstruts-default"> 
</package> 


<package name="audit" namespace="/audit" extends="struts-default"> 
«action name="WelcomeAudit"> 
<result>pages/welcome_audit.jsp</result> 
</action> 
</package> 


«package name="user" namespace="/user" extends="struts-default"> 
«action name="WelcomeUser"> 
<result>pages/welcome_user.jsp</result> 
</action> 
</package> 


</struts> 
| 


在 上 面 的 Struts 配 置 文件 中 ， 组 织 所 有 “用 户 " 和 “审核 "配置 设置 在 一 个 文件 中 ， 这 不 
是 建议 的 ， 必须 回避 。 应 该 打破 这 种 形式 ， 而 将 struts.xml 文 件 分 成 更 小 的 模块 相关 
的 部 分 。 


多 个 Struts 配 置 文件 


在 Struts2， 应 该 给 每 个 模块 一 个 Struts 配 置 文件 。 在 这 种 情况 下 ， 可 以 创建 三 个 文 
件 : 


1. audit-struts.xml — 闻 所 有 审计 模块 设置 在 这 里 。 


2. user-struts.xml — 将 所 有 用 户 模块 设置 在 这 里 。 
3. struts.xml - 默认 设置 ， 包 含 struts-audit.xml 和 Struts-user.xml 两 个 文件 。 


struts-audit.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 


«package name="audit" namespace="/audit" extends="struts-default"> 
«action name="WelcomeAudit"> 
<result>pages/welcome_audit.jsp</result> 
</action> 
</package> 


</struts> 
EY 


struts-user.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 
«package name="user" namespace="/user" extends="struts-default"> 
«action name="WelcomeUser"> 
<result>pages/welcome_user.jsp</result> 
</action> 
</package> 
</struts> 


| 


struts.xml 
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<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 

«struts» 


«package name="default" namespace="/" extends="struts-default"> 
</package> 


«include file="conf/user-struts.xml"></include> 
«include file="conf/audit-struts.xml"></include> 


</struts> 
加 二 
现在 文件 夹 结构 看 起 来 如 下 : 








4 这 struts2example 
4 $8 src 
4 {8 com yiibai.user.action 
> [J] LoginAction java 
> [J] WelcomeUserAction,java 
4 {B conf 
4f audit-struts.xml. 
QE user-struts.xml 
$E struts.xml 
> mà JRE System Library [Sun JDK 1.6.0 13] 
> mA Java EE 6 Libraries 
> BA Struts 2 Core Libraries 
4 © WebRoot 
> (£» META-INF 
b (£g WEB-INF 
[J* indexjsp 
P loginjsp 
J? welcome user.jsp 
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Struts2 命 名 空间 配置 和 解释 - Struts2 教 程 


Struts 2 的 命名 空间 是 一 个 新 的 概念 ， 用 来 处理 多 个 模块 。 由 下 式 给 出 一 个 命名 空 
间 的 每 个 模块 。 此 外 ， 它 还 可 以 用 来 避免 位 于 不 同 的 模块 相同 的 操作 名 称 之 间 的 冲 


yu 
Ko 


看 下 面 的 一 张 图 来 了 解 一 个 URL 匹 配 Struts 2 的 动作 命名 空间 。 
















口 struts2 命 名 空间 示例 yii x 
c Q | [5localhost:8080[s 


Ld 
Welcome — namespace = co 


servlet 名 称 








1. 命名 空间 配置 


让 我 们 通过 一 个 Struts2 的 命名 空间 配置 的 例子 来 了 解 它 是 如 何 与 URL 和 文件 夹 相 匹 
配 。 


PS 包 中 的 “name" 不 会 影响 结果 ， 只 是 给 一 个 有 意义 的 名 字 。 


struts.xml 


**«?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts 
<struts> 
«package name="default" namespace="/" extends-'struts-default": 
«action name="SaywWelcome"> 
<result>/pages/welcome.jsp</result> 
</action> 
</package> 


«package name-"common" namespace="/common" extends="Struts -defé 
«action name="SayWelcome"> 
<result>/common/pages/welcome. jsp</result> 
</action> 
</package> 


«package name="user" namespace="/user" extends="struts-default' 
«action name="SaywWelcome"> 
<result>/common/user/welcome.jsp</result> 
</action> 
</package> 
</struts>** 


si ag 
Struts 2 的 动作 命名 空间 映射 到 文件 夹 结 构 。 





4 由 com.yiibal.common 
四 HelloWorld.java 
Et struts.xml 
mA JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
mi Struts 2 Core Libraries _— Namespace = "common" 
4 © WebRoot 
4 (& common 
4 & pages 
J? welcome.jsp 
© META-INF om 
4 & pages 
P welcome.jsp 


namespace = "/" 


4 @ user 


4 e ie NE 
[P welcome.jsp "T" 


(z» WEB-INF 
P indexjsp 


namespace = "user" 


2. JSP 3 ES RA 


3 JSP 页 面 视 图 具有 相同 的 文件 名 ， 但 是 在 不 同 的 模块 位 置 。 


根 — pages/welcome.jsp 


<html> 
<head> 
<title>Struts2 命 名 空间 示例 - yiibai.com</title> 
</head> 
<body> 
<h1>Struts2 命 名 空间 示例 </h1> 
<h4>welcome - namespace = "root"</h4> 
</body> 
</html> 


Common 模块 — common/pages/welcome.jsp 


<html> 
<head> 
<title>Struts2 命 名 空间 示例 - yiibai.com</title> 
</head> 
<body> 
<h1>Struts2 命 名 空间 示例 </h1> 
<h4>Welcome - namespace = "common"</h4> 
</body> 
</html> 


User 模块 ~ user/pages/welcome.jsp 


<html> 
<head> 
<title>Struts2 命 名 空间 示例 - yiibai.com</title> 
</head> 
<body> 
<h1>Struts2 命 名 空间 示例 </h1> 


<h4>Welcome - namespace = "user"</h4> 


</body> 
</html> 


3. 映射 — 如 何 工作 ? 


示例 1 URL : http://localhost:8080/Struts2Example/SayWelcome.action 
将 匹配 根 命名 空间 。 


«package name="default" namespace="/" extends="struts-default": 
«action name="SayWelcome"> 
<result>/pages/welcome.jsp</result> 
</action> 
</package> 


E | 





这 会 显示 pages/welcome.jsp 页 面 的 内 容 


示例 2 URL : http://localhost:8080/Struts2Example/common/SayWelcome.action 
这 会 匹配 common 命名 空间 的 内 容 : 


«package name="common" namespace="/common" extends="Sstruts -defé 
«action name="SaywWelcome"> 
<result>/common/pages/welcome. jsp</result> 
</action> 
</package> 


4] _ & 





这 会 显示 **common/pages/welcome.jsp ** 5i HHA 
示例 3 URL : http://localhost:8080/Struts2Example/user/SayWelcome.action 这 会 
匹配 common 命名 空间 的 内 容 : 


«package name="user" namespace="/user" extends="struts-default"> 
«action name="SayWelcome"> 
<result>/common/user/welcome. jsp</result> 
</action> 
</package> 


这 会 显示 user/pages/welcome.jsp 页 面 的 内 容 . 


考 


1. Struts2 命 名 空间 配置 参考 
代码 下 载 : http://pan.baidu.com/s/1hqe1nZe 


y 


Struts2 开 发 者 模式 - Struts2 教 程 


在 Struts2 开 发 中 ， 这 应 该 是 第 一 个 学 习 配 置 的 值 。 为 了 启用 Struts 2 的 开发 模式 ， 
可 以 通过 自动 配置 显著 增加 Struts2 的 开发 速度 和 属性 文件 加 载 ， 以 及 人 额外 的 日 志和 
调试 功能 。 

注 : 自动 重新 加 载 功 能 真 的 是 一 个 方便 的 功能 。 每 次 修改 属性 或 XIWVL 配 置 文件 更 
改 ， 应 用 程序 不 再 需要 重启 才能 生效 。 默 认 情 况 下 ，Struts 2 的 开发 模式 是 禁用 

的 。 

启用 Struts2 开 发 模式 

将 “struts.devMode” 的 值 设 置 为 true， 可 以 在 Struts 的 属性 文件 或 XML 配置 文件 。 


struts.properties 


struts.devMode = true 


struts.xml 


<struts> 
«constant name-"struts.devMode" value="true" /> 
</struts> 


禁用 Struts 2 的 开发 模式 


设置 "struts.devMode" 为 false， 无 论 是 在 Struts 属 性 文件 或 XML 配置 文件 。 


struts.properties 


struts.devMode = false 


struts.xml 


<struts> 
«constant name-"struts.devMode" value="false" /> 
</struts> 


开发 模式 只 适合 于 开发 和 调试 环境 。 在 生产 环境 中 ， 你 必须 禁用 它 。 因 为 整个 应 用 
程序 的 配置 它 会 引起 对 性 能 显著 影响 ， 属 性 文件 将 在 每 次 请 求 重新 加 载 ， 许 多 额外 
的 日 志和 调试 信息 也 将 提供 。 


参考 


1. Struts 2 开发 模式 文档 


如 何 删 除 Struts2 动 作 的 后 缀 扩展 名 - Struts2 教 程 
在 Struts2 中 ， 所 有 动作 类 有 一 个 默认 的 后 级 action 扩展 。 例如 ， 


<struts> 
«package name="default" namespace="/" extends="struts-default"> 
<action name="SayStruts2"> 
<result>pages/printStruts2.jsp</result> 
</action> 
</package> 
</struts> 


Sa) 
如 要 访问 “SayStruts2” 动 作 类 ， 需 要 使 用 以 下 网 址 : 


Action URL : http://localhost:8080/Struts2bExample/SayStruts2.actior 
二 


配置 动作 扩展 


Struts 2 是 允许 配置 扩展 名 的 ， 要 对 其 进行 更 改 ， 只 需要 声明 一 个 常 
数 “struts.action.extension” 值 : 


1. html 扩展 
更 改动 作 类 为 .html 的 扩展 名 。 


<struts> 
«constant name="struts.action.extension" value="html"/> 
«package name="default" namespace="/" extends="struts-default"> 
<action name="SayStruts2"> 
<result>pages/printStruts2.jsp</result> 
</action> 
</package> 
</struts> 


El BH > 
现在 ， 可 以 通过 访问 “SayStruts2” 动 作 类 ， 使 用 如 下 URL : 








Action URL : http://localhost:8080/Struts2bExample/SayStruts2.html 
Ei — E 


2. 不 使 用 扩展 
动作 类 更 改 为 空 的 扩展 。 








<struts> 
«constant name="sStruts.action.extension" value=""/> 
«package name="default" namespace="/" extends="Sstruts-default"> 
<action name="SayStruts2"> 
<result>pages/printStruts2.jsp</result> 
</action> 
</package> 
</struts> 
ee ee rn] 
现在 ， 可 以 通过 如 下 的 URL 来 访问 “SayStruts2' 动作 类 : 


Action URL : http://localhost:8080/Struts2bExample/SayStruts2 


使 用 Struts2 动 作 - Struts2 教 程 


在 Struts2 中 ， 会 花 大 部 分 的 时 间 用 在 用 动作 来 处 理工 作 。 动作 类 包含 业务 逻辑 ， 获 
取 资 源 包 ， 保 存 数据 ， 验 证 ， 并 选择 应 发 回 给 用 户 的 视图 的 结果 页 面 。 这 是 Struts2 
的 核心 ， 所 以 必须 要 了 解 动 作 的 基本 概念 。 


1. 动作 - Action 


Struts 2 动作 不 强迫 你 实现 任何 接口 或 扩展 类 ， 它 只 是 需要 你 实现 一 个 execute() 方 
法 返回 一 个 字符 串 来 表示 其 应 该 返回 的 结果 页 面 。 


package com.yiibai.user.action; 
public class LoginAction{ 
//business logic 
public String execute() { 
return "success"; 
} 


在 struts.xml 中 ， 配 置 使 用 Action 类 动作 (action) 标 记 和 类 属性 。 定 义 结 果 页 面 用 结果 
的 标签 和 动作 名 称 返回 给 用 户 ， 可 以 用 它 来 访问 动作 类 的 名 称 属 性 。 


«package name="user" namespace="/User" extends="struts-default"> 
«action name="validateUser" class="com.yiibai.user.action.LoginAc 
«result name="Success">pages/welcome. jsp</result> 
</action> 
<package> 


E 
现在 ， 可 以 通过 .action 扩展 名 后 级 访问 动作 。 





http://localhost:8080/Struts2Example/User/validateUser.action 


默认 .action 是 可 配置 的 ， 只 需要 设置 “struts.action.extension” 的 值 ， 以 满足 您 的 需 
要 。 


可 选 动作 接口 


Struts 2# 有 一 -个 可 选 的 动作 接口 (com. opensymphony.xwork2.Action)。 通 过 实现 
这 个 接口 ， 它 带 来 了 一 些 方便 和 好 处 ， 看 下 面 的 源 代码 : 


package com.opensymphony.xwork2; 

public interface Action { 
public static final String SUCCESS - "success"; 
public static final String NONE - "none"; 
public static final String ERROR - "error"; 
public static final String INPUT - "input"; 
public static final String LOGIN - "login"; 
public String execute() throws Exception; 


这 个 接口 是 非常 简单 的 ， 配 有 5 常用 常数 值 : success, error, none, input and 
logic。 现 在 的 动作 类 可 以 直接 使 用 常量 。 


package com.yiibai.user.action; 
import com.opensymphony.xwork2.Action; 
public class LoginAction{ 
//business logic 
public String execute() { 
return SUCCESS; 


} 


不 明白 为 什么 很 多 Struts 开 发 人 员 喜 欢 实现 此 动作 接口 ， 它 更 好 地 扩展 了 
ActionSupport。 


3. ActionSupport 


Support 类 ， 通 常 的 做 法 是 提供 接口 的 默认 实现 。 
ActionSupport (com.opensymphony.xwork2.ActionSupport), 一 个 非常 强大 和 方 
便 的 类 ， 它 提供 了 几 个 重要 接口 的 缺 省 实现 : 


public class ActionSupport implements Action, Validateable, 
ValidationAware, TextProvider, LocaleProvider, Serializable { 


ActionSupport 类 提供 一 些 功 能 : 
1. 验证 — 声明 一 个 validate() 方 法 ， 并 在 里 面 实现 验证 代码 。 
1. 文字 本 地 化 - 使 用 gettext() 方 法 来 获得 资源 包 的 消息 。 


package com.yiibai.user.action; 
import com.opensymphony.xwork2.ActionSupport; 
public class LoginAction extends ActionSupport{ 
private String username; 
private String password; 
public String getPassword() { 
return password; 


public void setPassword(String password) { 
this.password = password; 


public String getUsername() { 
return username; 


public void setUsername(String username) { 
this.username = username; 


//business logic 
public String execute() { 
return "SUCCESS"; 
} 
//simple validation 
public void validate(){ 


if("".equals(getUsername())){ 
addFieldError("username", getText("username.required") | 


if("".equals(getPassword())){ 
addFieldError("password", getText("password.required"): 





在 大 多 数 情况 下 ， 应 该 扩展 此 类 妥当 ， 方 便 提 供 功能 ， 除 非 你 有 理由 不 这 样 做 。 这 
也 是 一 个 很 不 错 的 学 习 类 ， 以 了 解 如 何 做 一 些 重要 的 Struts2 接 口 的 实现 。 


4. 动作 注释 


Struts 2 对 注解 有 很 好 的 支持 ， 你 可 以 摆脱 XML 文 件 ， 并 使 用 @action 在 动作 类 上 蔡 
换 。 


package com.yiibai.user.action; 


import org. 
import org. 
import org. 
import org. 
import com. 
@Namespace( 


apache.struts2.convention. 
apache.struts2.convention. 
apache.struts2.convention. 
apache.struts2.convention. 


annotation.Action; 
annotation.Namespace; 
annotation.Result; 
annotation.ResultPath; 


opensymphony.xwork2.ActionSupport; 


"/User") 


QResultPath(valuez"/") 
public class ValidateUserAction extends ActionSupport{ 


@Action(value="Welcome", 


results= 


{ 


QResult(namez"success",location-"pages/welcome user.jsp") 


3) 
public 


String execute() ( 


return SUCCESS; 


j 


Hn "—————ÀÁ aul 


K 


+ 
Iri 


AT 


C 


扩展 ActionSupport 类 ， 它 适合 在 大 多 数 情况 下 。 


Struts2 的 ActionError&ActionMessage 示 例 - 
Struts2 教 程 


本 教程 显示 使 用 Struts2 的 ActionError 和 ActionMessage 类 。 


1. ActionError — 是 用 来 发 送 错误 信息 反馈 给 用 户 - 通过 <s:actionerror/> 来 显 
示 。 


<s:if test="hasActionErrors()"> 
<div class="errors"> 
<s:actionerror/> 
</div> 
</s:if> 


1. ActionMessage 一 用 于 发 送信 息 的 反馈 消息 给 用 户 ， 通 过 
«s:actionmessage/» 来 显示 。 


«s:if test="hasActionMessages()"> 
«div class="welcome"> 
<s:actionmessage/> 
</div> 
</s:if> 


这 里 有 一 个 简单 的 登录 表单 ， 如 果 用 户 名 不 等 于 “yiibai.com" 将 显示 错误 消息 
(actionerror)， 否 则 重 定 向 到 另 一 个 页 面 ， 显 示 欢 迎 信息 (ActionMessage)。 此 外 ， 
所 有 的 标签 和 错误 消息 检索 来 自 资源 包 ( 属 性 文件 )。 


1. 文件 夹 结构 


在 MyEclipse 中 创建 一 个 web 工 程 ， 名 称 为 : struts2-errormsg， 看 这 个 项 目 结构 ， 
如 下 图 : 


Hi Package Explorer 23 Eu ^L 
a 13$ struts2-errormsg 
4 名 src 
4 {8 com yibai.user.action 
|J] LoginAction java 
LoginAction.properties 
global.properties 
LoginAction.properties 
VE struts.xml 
Ej JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
=) Struts 2 Core Libraries 
4 {> WebRoot 
(z» META-INF 
4 {> pages 
W? loginjsp 
p? welcomejsp 
4 (zz WEB-INF 
& lib 
K? web.xml 
[P indexjsp 


2. 属性 文件 


一 共有 两 个 属性 文件 用 来 存储 信息 ， 其 中 LoginAction.properties 文件 放 在 
com.yiibai.user.action 包 下 。 


LoginAction.properties 


#Welcome messages 

welcome.hello = 你 好 

#error message 

username.required = 用 户 名 不 可 以 为 空 
password.required = 密码 不 可 以 为 空 


global.properties 


#Global messages 
global.username = 用 户 名 
global.password = 密码 
global.submit = 提交 
global.reset = BE 


3. 动作 -Action 


一 个 经 典 的 动作 类 ， ue 单 的 检查 ， 以 确认 用 户 名 是 否 等 于 “yiibai.com"， 并 使 
用 addActionError() 设 置 错 误 信 息 或 addActionMessage() 设 置 成 功 的 消息 。 


package com.yiibai.user.action; 
import com.opensymphony.xwork2.ActionSupport; 
public class LoginAction extends ActionSupport{ 


private String username; 
private String password; 


public String getPassword() ( 
return password; 
B 


public void setPassword(String password) ( 
this.password - password; 
} 


public String getUsername() { 
return username; 
} 


public void setUsername(String username) { 
this.username = username; 
} 


//business logic 
public String execute() { 


return "SUCCESS"; 


} 


//simple validation 
public void validate(){ 
if("yiibai.com".equals(getUsername()))( 
addActionMessage("You are valid user!"); 
selse{ 
addActionError("I don't know you, dont try to hack me!' 





4. JSP 5i Ha 


两 个 fa] 单 的 JSP 页 on 面 以 及 CSS 样 式 自 定义 错 误 消 息 10 


login.jsp 


<%@ page contentType="text/html; charset=UTF-8" %> 
«99 taglib prefix="s" uri="/struts-tags" %> 
<html> 
<head> 
<title>Struts2 ActionError & ActionMessage 示例 </title> 
<style type="text/css"> 
„errors ( 
background-color :#FFCCCC; 
border:1px solid #CC0000; 
width: 400px; 
margin-bottom: 8px; 
} 
„errors lif 
list-style: none; 


</style> 
</head> 
<body> 
<h1>Struts2 ActionError & ActionMessage 示例 </h1> 
<s:if test="hasActionErrors()"> 
<div class="errors"> 
<s:actionerror/> 
</div> 
</s:if> 
<s:form action="validateUser"> 
<s:textfield key="global.username" name="username"/> 
<s:password key="global.password" name="password"/> 
«s:submit key="global.submit" name-"submit"/» 
«/s:form» 
«/body» 
</html> 


welcome.jsp 


**<%@ page contentType="text/html; charset=UTF-8"%> 
«99 taglib prefix="s" uri="/struts-tags"%> 
<html> 
<head> 
<title>Struts2 ActionError & ActionMessage 示例 </title> 
<style type="text/css"> 
.welcome { 
background-color: #DDFFDD; 
border: 1px solid #009900; 
width: 200px; 
} 
.welcome li { 
list-style: none; 


} 
</style> 
</head> 
<body> 
<h1>Struts 2 ActionError & ActionMessage 示 例 </h1> 
«s:if test="hasActionMessages()"> 
«div class="welcome"> 
<s:actionmessage /> 
</div> 
</s:if> 
<h4> 
«s:property value="getText('welcome.hello')" /> 
«s:property value="username" /> 
</h4> 
</body> 
«/html»** 


5. struts.xml 


链接 所 有 的 在 一 起 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
«constant name="struts.custom.ii18n.resources" value="global" /> 


«package name="user" namespace="/user" extends="struts-default"> 
«action name="login"> 
<result>/pages/login. jsp</result> 
</action> 
<action name="validateUser" class="com.yiibai.user.action.Log: 
«result name="SUCCESS">/pages/welcome. jsp</result> 
«result name="input">/pages/login.jsp</result> 
</action> 
</package> 


</struts> 


剧 = T 





在 Struts2，ActionError 和 ActionMessage 功 能 和 用 法 与 Struts1 非 常 相 似 。 


se £A 2A ` vi 
6. 运行 并 测试 
http:/Nocalhost:8080/struts2-errormsg/user/login.action 


| = z meae) 
j [Ò Struts2 ActionError & A x \ | 

| € = Ib localhost:8080/struts2-errormsg/user/login.action TR = 
Struts2 ActionError & 
ActionMessage 示例 











用 户 名 : 
密码 : 

















用 户 名 是 无 效 的 ， 显 示 错 误 信息 : <s:actionerror/> 


TutorialsPoint Java 技术 教程 


[5 —— x WEE 


€ > CQ [localhost 8080/struts2-errormsg/user/validateUser. "3? 三 


Struts2 ActionError & 
ActionMessage 示例 





I don t know you, dont try to hack me! 











[5 Struts2 ActionError Q&A x W — 


e> C [5 localhost:8080/struts2-errormsg/user/validateUser.aciv? = 


Struts 2 ActionError & 
ActionMessagey il 


JR yiibai. com 








源 代 码 下 载 — Struts2-ActionError-ActionMessage.zip 
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Struts2 模 型 驱动 实例 - Struts2 教 程 


这 里 我 们 创建 一 个 web 工 程 为 : struts2-modeldrive ， 用 于 讲解 演示 Struts2 模 型 驱 
动 这 一 章 内 容 的 学 习 。 

如 果 一 个 动作 实现 了 “模型 驱动 ”- ModelDriven 接口 ， 它 就 获得 了 表单 数据 自动 传输 
到 对 象 的 额外 能 力 。 请 参见 下 面 的 完整 的 例子 : 


1. 域 对 象 


一 个 顾客 (customer) 对 象 ， 有 setter 和 getter 方法 。 


Customer.java 


package com.yiibai.common; 
public class Customert{ 


String name; 
int age; 


public String getName() ( 
return name; 


public void setName(String name) { 
this.name - name; 


public int getAge() { 
return age; 


public void setAge(int age) { 
this.age - age; 
j 


2. 动作 - Action 


Action 类 ， 实 现 了 模型 驱动 ModelDriven 接口 ， 声 明 getModel() 方 法 返回 客户 的 对 
象 。 当 表单 数据 提交 到 这 个 动作 ， 它 会 自动 将 表单 数据 传输 到 客户 的 属性 。 
客户 对 象 必须 手动 初始 化 。 


CustomerAction.java 


package com.yiibai.common.action; 

import com. yiibai.common.Customer; 

import com.opensymphony.xwork2.ActionSupport; 
import com.opensymphony.xwork2.ModelDriven; 


public class CustomerAction extends ActionSupport 
implements ModelDriven{ 


//have to initialize it 
Customer customer - new Customer(); 


public String execute() throws Exception ( 


return SUCCESS; 


j 


public Object getModel() { 


return customer; 


3. JSP 5i E 


JSP 页 面 的 模型 驱动 (ModelDriven) 的 示范 。 


addCustomer.jsp 


<%@ taglib prefix="s" uri="/struts-tags" 96» 
<html> 
<head> 
</head> 


<body> 
<hi>Struts 2 ModelDriven example</h1i> 


<h2>Add Customer</h2> 

<s:form action="customerAction" > 
<s:textfield name="name" label="Name" /> 
<s:textfield name="age" label="Age" value=""/> 
<s:submit /> 

«/s:form» 


«/body» 
«/html» 


success.jsp 


«99 taglib prefix="s" uri="/struts-tags" %> 
«html» 
«head» 
</head> 


<body> 
<hi>Struts 2 ModelDriven example</h1i> 


<h2>Customer Details</h2> 
Name : «s:property value="name" /><br> 
Age : <S:property value="age" /><br> 


</body> 
</html> 


4. struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
«constant name-"struts.devMode" value="true" /> 


«package name="default" namespace="/" extends-'struts-default": 


<action name="addCustomerAction" 
class="com.yiibai.common.action.CustomerAction" > 
«result name="sSuccess">pages/addCustomer .jsp</result> 
</action> 


<action name="customerAction" 
class="com.yiibai.common.action.CustomerAction" > 
«result name="Success">pages/success. jsp</result> 
</action> 
</package> 


</struts> 


RTE 





5. 示例 
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访问 客户 表 ， 填 写 表 格 (name : “yiibai.com”, age ”“26”) 并 点 击 提交 按钮 ， 表 单数 
据 (name & age) 将 自动 转移 到 客户 的 属性 (name & age) ( 按 属性 名 称 匹配 )。 


http://localhost:8080/struts2-modeldrive/addCustomerAction.action 


[5 Struts 2 ModelDrivenz- x \ - 


Struts 2 ModelDriveny; ýl 


Add Customer 





Name: ylibai.com 
Age: (26 














http://localhost:8080/struts2-modeldrive/customerAction.action 


[ Struts 2 ModelDrivenz- x \ - 


e> C [5 localhost:8080/struts2modeldrive/customerAction.action VE = 
Struts 2 ModelDriveny, ýl 


Customer Details 


Name : ylibai. com 
Age : 26 





工程 源 代码 下 载 - http://pan.baidu.com/s/1hqxyjf2 


Struts2 模 型 驱动 实例 - Struts2 教 程 2878 


Struts2 了 映射 拦截 动作 - Struts2 教 程 


Struts 2 的 开发 者 用 来 声明 行为 属于 一 个 包 ， 扩 展 “struts-default“, 其 中 包含 默认 设 
置 的 拦截 。 


«package name="default" namespace="/" extends="struts-default"> 
<action name="testingAction" 
class="com.yiibai.common.action.TestingAction" > 
«result name="Success">pages/result.jsp</result> 
</action> 
</package> 


拦截 器 的 默认 设置 进行 分 组 为 “defaultStack” 在 struts-default.xml 文 件 中 ， 它 位 于 
struts2-core.jar 文件 ，“defaultStack” 提 供 所 有 的 核心 Struts2 功 能 ， 这 是 最 适合 应 用 
的 需要 。 


试 着 学 习 struts-default.xml 文 件 ， 它 总 是 最 好 的 拦截 器 的 参考 。 


映射 拦截 动作 
为 了 其 它 的 拦截 器 映射 到 动作 ， 请 使 用 "interceptor-ref 元 素 。 


«package name="default" namespace="/" extends="struts-default"> 
<action name="testingAction" 
class="com.yiibai.common.action.TestingAction" > 
<interceptor-ref name="timer"/> 
<interceptor-ref name="logger"/> 
«result name="Success">pages/result.jsp</result> 
</action> 
</package> 


在 上 面 的 代码 片段 ， 交 其 映射 imer” 和 “logger 通过 "interceptor-ref 元 素 拦 截 
到 “TestingAction” 动 作 类 。 拦 截 器 会 按 它 们 声明 的 顺序 触发 。 


由 于 “TestingAction” 它 声明 自己 的 拦截 器 ， 它 的 直接 失去 拦截 器 的 所 有 继承 默认 设 
置 ， 你 必须 明确 才能 使 用 它 ， 见 下 面 声 明 “defaultStack” 的 例子 。 


«package name="default" namespace="/" extends="Sstruts-default"> 
<action name="testingAction" 
class="com.yiibai.common.action.TestingAction" > 
<interceptor-ref name="timer"/> 
<interceptor-ref name="logger"/> 
<interceptor-ref name="defaultStack"/> 
«result name="Success">pages/result.jsp</result> 
</action> 
</package> 


参考 


1. Struts 2 拦截 器 文档 


Struts2 重 写 拦 堆 器 参数 - Struts2 教 程 
在 Struts2 中 ， 可 以 设置 或 通过 普通 的 标签 重 写 拦截 器 的 参数 。 见 下 面 的 例子 : 


«package name="default" namespace="/" extends="struts-default"> 
<action name="whateverAction" 
class="com.yiibai.common.action.WhateverAction" > 
<interceptor-ref name="workflow"> 

<param name="excludeMethods">whateverMethod</param> 

</interceptor-ref> 
«result name="Success">pages/whatever .jsp</result> 
</action> 

</package> 


然而 ， 在 上 面 的 代码 片段 ， 动 作 类 被 声明 为 自己 的 拦截 器 ， 它 会 导致 继 
承 “defaultStack” 拦 截 器 的 直接 丢失 。 


如 果 你 想 保持 “defaultStack” 拦 截 器 ， 并 覆盖 工作 流 的 excludeMethods 参 数 呢 ? 没 
问题 ， 试 试 这 个 : 


«package name="default" namespace="/" extends="struts-default"> 
<action name="whateverAction" 
class="com.yiibai.common.action.WhateverAction" > 
<interceptor-ref name="defaultStack"> 

<param name="workflow.excludeMethods">whateverMethod</parar 

</interceptor-ref> 
<result name="Success">pages/whatever .jsp</result> 
</action> 

</package> 





上 面 的 代码 片段 籽 保 持 “defaultStack” 拦 截 并 覆盖 “workflow” 参 数 。 


参考 


1. Struts2 拦 截 器 文档 
2. Struts2 流 程 拦 截 器 文档 


Struts2 拦 二 器 栈 的 例子 - Struts2 教 程 
很 多 时 候 ， 相 同 的 一 组 拦截 器 可 以 适用 于 不 同 的 动作 类 ， 例 如 ， 


«package name="default" namespace="/" extends="Sstruts-default"> 


<action name="checkInAction" 
class="com.yiibai.common.action.CheckInAction" > 
<interceptor-ref name="timer"/> 

<interceptor-ref name="logger"/> 
<interceptor-ref name="defaultStack" /> 
«result name="success">/pages/checkIn.jsp</result> 
</action> 


<action name="checkOutAction" 
class="com.yiibai.common.action.CheckOutAction" > 
<interceptor-ref name="timer"/> 

<interceptor-ref name="logger"/> 
«interceptor-ref name="defaultStack" /> 
«result name="sSuccess">/pages/checkOut .jsp</result> 
</action> 


</package> 


在 上 述 情 况 下 ， 它 有 许多 重复 工作 以 及 不 能 重复 使 用 。 


幸运 的 是 ， 在 Struts 2 自 带 的 拦截 器 栈 ， 使 开发 人 员 建 立 一 组 拦截 到 一 个 单元 名 
AREP, 和 可 以 通过 “ 栈 名 字 ” 引 用 操作 它 。 


最 佳 做 法 建议 组 合 相同 的 一 组 拦截 器 到 一 个 拦截 器 栈 摆脱 重复 的 工作 ， 并 增加 了 项 
目的 可 重用 性 。 


«package name="default" namespace="/" extends="Struts-default"> 


<interceptors> 
<interceptor-stack name="defaultStackwithLog"> 
<interceptor-ref name="timer"/> 
<interceptor-ref name="logger"/> 
<interceptor-ref name="defaultStack" /> 
</interceptor-stack> 
</interceptors> 


<action name="checkInAction" 
class="com.yiibai.common.action.CheckInAction" > 
<interceptor-ref name="defaultStackwithLog"/> 
«result name="success">/pages/checkIn.jsp</result> 
</action> 


<action name="checkOutAction" 
class="com.yiibai.common.action.CheckOutAction" > 
<interceptor-ref name="defaultStackwithLog"/> 
«result name="Success">/pages/checkOut .jsp</result> 
</action> 


</package> 


在 上 面 的 例子 更 新 ， 声 明 一 个 拦截 器 栈 ， 命 名 为 “defaultStackWithLog "其 中 包 
f&'timer", “logger” 和 “defaultStack” 拦截 器 ， 并 且 它 通过 “interceptor-ref 元 素 引 用 
一 个 正常 的 拦截 器 。 


参考 


1. Struts2 拦 截 器 文档 


Struts2 execAndWait# #4230 - Struts2 教 程 


在 Struts2 中 附带 一 个 名 cies cH ec RE 
m acd 间 运 行 操作 在 后 台 ， cma aD UN 在 
本 教程 中 ， 它 显示 了 一 个 完整 的 使 用 Struts2 ， execAndWait 拦截 器 的 例子 


1. 动作 
一 个 普通 的 动作 类 ， 有 一 个 长 时 间 运 行进 程 ， 证 明了 execAndWait 效 果 。 


LongProcessAction.java 


package com.yiibai.common.action; 

import com.opensymphony.xwork2.ActionSupport; 

public class LongProcessAction extends ActionSupport{ 

public String execute() throws Exception ( 
//it should be delay few seconds, 
//unless you have a super powerful computer. 
for(int i =0; i«1000000; i++){ 
System.out.println(i); 


} 
return SUCCESS; 


2. JSP iH 


创建 两 个 页 面 : 


1. waitjsp- 显示 给 用 户 ， 长 时 间 运 行 的 进程 。 
2. success.jsp - 显示 给 用 户 的 过 程 完成 之 后 。 


HTML meta refresh 记得 把 元 刷新 的 等 待 页 面 项 部 ; 否则 ， 该 网 页 将 不 重 定向 到 成 
功 页 面 ， 即 使 该 过 程 完成 。 


在 这 个 waitjsp， 元 刷新 设置 在 每 5 秒 网 页 重新 加 载 ， 如 果 该 过 程 完成 后 ， 将 重 定向 
到 success.jsp, 否则 留 在 同一 个 页 面 。 


wait.jsp 


<%@ page contentType="text/html; charset=UTF-8"%> 

«99 taglib prefix="s" uri="/struts-tags" %> 

<html> 

<head> 

<title>Struts 2 execAndWait 示例 </title> 

<meta http-equiv-"refresh" content="5;url=<s:url includeParams-"al. 
</head> 


<body> 
<hi>Struts 2 execAndWait 示例 </h1> 


<h3>Please wait while we process your request...</h3> 


</body> 
</html> 


本 Se M 





success.jsp 


«99 page contentType="text/html; charset=UTF-8"%> 
«99 taglib prefix="s" uri="/struts-tags" %> 
<html> 

<head> 

<title>Struts 2 execAndWait 示例 </title> 

</head> 


<body> 
<hi>Struts 2 execAndwait 示例 </h1> 


<h3>Done</h3> 


</body> 
</html> 


— ^v^ ` * 
3. HUTT AS EHE Bas 
链接 动作 类 并 声明 “execAndWait' 拦 截 器 。execAndWait 参数 
1. delay (optional) : 以 宫 秒 为 单位 初始 延迟 显示 在 waitjsp。 默 认 是 没有 延迟 的 。 
2. delaySleeplnterval (optional) : 时 间 间 隔 是 以 毫秒 为 单位 来 检查 后 台 进 程 是 否 
已 经 完成 ， 默 认 值 是 100 毫 秒 。 


struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 
«constant name-"struts.devMode" value-"true" /» 


«package name="default" namespace="/" extends-'struts-default": 
«action name="longProcessAction" 


class="com.yiibai.common.action.LongProcessAction" > 


«interceptor-ref name="execAndWait"> 
<param name="delay">1000</param> 


<param name="delaySleepInterval">500</param> 
</interceptor-ref> 


«result name="wait">/pages/wait .jsp</result> 
«result name="Success">/pages/success.jsp</result> 
</action> 


</package> 
</struts> 


二 


在 这 种 情况 下 ， 将 延迟 1 秒 显 示 至 waitjsp， 并 检查 后 台 进 程 是 否 在 每 500 室 秒 完 


成 。 即 使 这 个 过 程 完 成 后 ， 它 仍然 需要 等 待 wait.jsp 元 刷新 来 触发 页 面 重 载 。 


4. 示例 


访问 网 址 : http://localhost:8080/struts2execandwait/longProcessAction.action 


lace) bola) 








Struts 2 execAndWait — x bu 








| € C. | D localhost:8080/struts2execandwait/longProcessAction.action wm 
Struts 2 execAndWait 示例 


Please wait while we process your request... 
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延 时 1 秒 ， 显 示 在 waitjsp. [| 


当 该 过 程 完成 时 ， 自 动 显示 在 Success.jsp。 








[ Struts 2 execAndWait 7 x V. 


| € > C |B localhost:8080/struts2execandwait/longProcessAction.action;jsessivy| = 
Struts 2 execAndWait 示例 


Done 


Po 


代码 下 载 : http://pan.baidu.com/s/1062BHGY 


参考 


1. Struts2 execAndWait 拦 截 器 文档 
2. HTML Meta Refresh 


Struts2 execAndWait 拦 截 器 例子 - Struts2 教 程 2887 


Struts2 文 件 上 传 例 子 - Struts2 教 程 


在 Struts2， <s:file> 标签 用 于 创建 一 个 HTML 文 件 上 传 组 件 ， 人 允许 用 户 从 本 地 磁 急 
选择 文件 ， 并 将 其 上 传 到 服务 器 。 在 本 教程 中 ， 您 将 创建 与 文件 上 传 组 件 JSP 页 
面 ， 设 置 最 大 大 小 和 人 允许 上 传 文件 的 内 容 类 型 ， 并 显示 上 传 文件 的 详细 信息 。 


这 里 创建 一 个 Web 工 程 : strut2uploadfile， 来 演示 在 多 个 复 选 框 如 何 设置 的 默认 
值 ， 整 个 项 目的 结构 如 下 图 所 示 : 


3$ strut2uploadfile 
GB src 
[B comyiibai.common.action 
加 FileUploadAction,java 
global.properties 
Et struts.xml 
mA JRE System Library [Sun JDK 1.6.0 13] 
mA Java EE 6 Libraries 
mA Struts 2 Core Libraries 
(z» WebRoot 
(z» META-INF 
(& pages 
P fileupload.jsp 
P resultjsp 
(z» WEB-INF 
J? indexjsp 


1. 动作 类 


Action 类 的 文件 上 传 ， 声 明 “File" 变 量 来 存储 用 户 上 传 的 文件 ， 两 个 字符 串 变 量 以 存 
储 文件 名 和 内 容 类 型 。 “文件 上 传 拦截 器 "通过 设置 "X" 的 ContentType()， 并 设 
置 “X”FileName() 会 自动 注入 上 传 的 文件 细节 ， 确 保 方法 名 拼写 正确 。 


P.S X 是 以 存储 上 传 的 文件 中 的 变量 。 


文件 上 传 功能 是 依赖 于 “文件 上 传 拦截 器 ”， 确 保 将 其 纳入 行动 的 堆栈 。 幸 运 的 是 ， 
默认 的 堆栈 已 经 包含 了 “文件 上 传 拦截 器 ”。 


FileUploadAction.java 


package com. yiibai.common.action; 


import java.io.File; 


import com.opensymphony.xwork2.ActionSupport; 


public class FileUploadAction extends ActionSupport{ 


private File fileUpload; 
private String fileUploadContentType; 
private String fileUploadFileName; 


public String getFileUploadContentType() ( 
return fileUploadContentType; 
} 


public void setFileUploadContentType(String fileUploadContentT\ 
this.fileUploadContentType = fileUploadContentType; 
} 


public String getFileUploadFileName() { 
return fileUploadFileName; 
j 


public void setFileUploadFileName(String fileUploadFileName) { 
this.fileUploadFileName - fileUploadFileName; 
j 


public File getFileUpload() { 
return fileUpload; 
} 


public void setFileUpload(File fileUpload) { 
this.fileUpload = fileUpload; 

} 

public String execute() throws Exception{ 
return SUCCESS; 


} 


public String display() { 
return NONE; 
} 











使 用 <s:file> 标 签 来 泻 染 一 个 文件 上 传 组件 ， 并 设置 表单 的 enctype 类 型 
为 :“multipart/form-data”。 


fileupload.jsp 
«99 taglib prefix="s" uri="/struts-tags" %> 
«html» 
«head» 
«s:head /» 
«/head» 


«body» 
<hi>Struts 2 «s:file» file upload example</h1> 


«s:form action-"resultAction" namespace="/" 
method-"POST" enctype="multipart/form-data"> 


«s:file name="fileUpload" label="Select a File to upload" size="40' 
«s:submit value-"submit" name="Submit" /> 
«/s:form» 


«/body» 
«/html» 


s————————————————————sresmÀ 





result.jsp 


«99 taglib prefix="s" uri="/struts-tags" %> 
<html> 


<body> 
<hi>Struts 2 <s:file> file upload example</h1> 


<div><div class-"ads-in-post hide if width less 800"> 

«script async srcz"//pagead2.googlesyndication.com/pagead/js/adsbyt 

<!-- 728x90 - After2ndH4 --» 

«ins class-"adsbygoogle hide if width less 800" 
style="display:inline-block;width:728px; height :90px" 
data-ad-client="ca-pub-2836379775501347" 
data-ad-slot="3642936086" 
data-ad-region="yiibairegion"></ins> 


<script> 

(adsbygoogle = window.adsbygoogle || []).push({}); 
</script> 

</div></div><h2> 


File Name : <s:property value="fileUploadFileName"/> 
</h2> 


<h2> 
Content Type : «s:property value="fileUploadContentType"/> 
«/h2» 


«h2» 
File : «s:property value="fileUpload"/> 
</h2> 


</body> 
</html> 





3. struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 


«constant name-"struts.devMode" value="true" /> 
«constant name-"struts.custom.ii18n.resources" value="global" , 


«package name="default" namespace="/" extends="Sstruts-default": 


<action name="fileUploadAction" 
class="com.yiibai.common.action.FileUploadAction" method="¢ 
«result name="none">/pages/fileupload.jsp</result> 
</action> 


«action name="resultAction" class="com.yiibai.common.action.Fi- 
<interceptor-ref name="exception"/> 
«interceptor-ref name="1i118n"/> 
<interceptor-ref name="fileUpload"> 
<param name="allowedTypes">text/plain</param> 
<param name="maximumSize">10240</param> 
</interceptor-ref> 
<interceptor-ref name="params"> 
«param name="excludeParams">dojo\..*,4struts\. .*</{ 
</interceptor-ref> 
<interceptor-ref name="validation"> 
<param name="excludeMethods">input, back, cancel, brov 
</interceptor-ref> 
<interceptor-ref name="workflow"> 
<param name="excludeMethods">input, back, cancel, brov 
</interceptor-ref> 


«result name="Success">/pages/result.jsp</result> 
«result name="input">/pages/fileupload.jsp</result> 


</action> 
</package> 
</struts> 


EJE 


文件 大 小 限制 在 这 个 例子 中 ， 您 将 通过 “文件 上 传 拦截 * 上 传 文件 大 小 的 限制 , 该 值 
以 字 节 为 单位 计数 。 在 本 实例 中 ， 上 载 文件 的 最 大 尺寸 是 10KB。 


注 : 上 传 文件 的 默认 最 大 文件 大 小 为 2MB 


文件 类 型 可 以 通过 设置 “文件 上 传 拦截 器 "允许 的 文件 类 型 。 在 这 种 情况 下 ， 上 传 文 
件 只 接受 “text/plain" 的 类 型 。 


在 Struts2 中 ， 有 好 几 种 方面 做 到 这 一 点 ， 查 看 Struts2 的 文件 上 传 文档 。 
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4. 示例 


http:/Nocalhost:8080/Struts2Example/fileUploadAction.action 


[5 localhost:8080/strut2up x 


€ > Œ D localhost:8080/strut2uploadfile/fileUploadAction.action 7v | = 





Struts 2 «s:file» 上 传 文件 实例 


Select a File to upload: | 选择 文件 yiibai.txt 





错误 信息 提示 ， 如 果 您 上 传 一 个 文件 ， 该 文件 超过 10KB， 或 者 未 选 文本 文件 。 


[5 localhost:8080/strut2up x 


€ > @ |D localhost:8080/strut2uploadfile/resultAction.action 


Struts 2 <s:file> 上 传 文件 实例 


File too large: fileUpload “yiibai. large. txt” 
"upload 1d363be9 15109c6f6d5 8000 00000008. tmp” 1280635 


Select a File to upload: 选择 文件 | 未 选择 任何 文件 





上 传 名 为 “yiibai.com.txt* 的 文本 文件 , 文件 大 小 : 5kb. 
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[5 localhost:8080/strut2up x 


> © [localhost:8080/strut2uploadfile/resultAction.action 





Struts 2 <s:file> 上 传 文件 实例 


File Name : yiibai. txt 
Content Type : text/plain 


File : 
E: \workspace\myecl ise\. metadat a\. me_tcat \work\Catalina\] ocalhost\strut2u 





上 传 的 文件 将 被 视 为 一 个 临时 文件 ， 具 有 长 的 随机 文件 名 ， 如 : 
upload376584a7_129811223798000_00000010.tmp. 请 确保 这 个 临时 文件 复制 到 
其 他 地 方 。 阅读 文件 实用 文档 复制 文件 。 


参考 


Struts 2 文件 文档 

http://struts.apache.org/2.0.14/docs/file-upload.html 
http://struts.apache.org/2.0.14/docs/how-do-we-upload-files.html 
http://commons.apache.org/io/api-1.4/org/apache/commons/io/FileUtils.html 


FRR — http://pan.baidu.com/s/1eQDH07S 


EONS 
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Struts2 资 源 包 使 用 示例 - Struts2 教 程 


要 使 用 资源 包 从 属性 文件 检索 消息 ， 必 须 了 解 Struts2 的 资源 包 搜 索 顺序 : 


资源 包 搜 索 顺 序 


资源 包 中 搜索 按 以 下 顺序 : 


. ActionClass.properties 

. Interface.properties 

. BaseClass.properties 
ModelDriven's model 

. package.properties 

. 搜索 国际 化 消息 键 的 层次 结构 本 身 
.全 局 资源 属性 


请 参阅 Struts2 资 源 包 文档 详细 解释 。 


在 实践 中 ， 是 不 可 能 组 织 属性 的 文件 的 顺序 。 所 以 ， 只 要 了 解 几 个 常用 的 搜索 顺序 
应 该 是 足够 了 : package.properties 和 global resource properties。 参 见 下 图 : 


NOORWN= 


4 $$ struts2resourcebundle 
4 (8 src 
4 中 com 
package.properties 
4 [A com yiibai 
package.properties 
4 [A com yiibai.user 
package.properties 
4 {8 comyilbai.user.action 
|J] LoginActionjava 
LoginAction.properties 
package.properties 
E$ struts.xml 
mA JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
ES) Struts 2 Core Libraries 
4 世 WebRoot 
(z» META-INF 
4 & pages 
f leginjsp 
J? welcome.jsp 
(z» WEB-INF 
J? indexjsp 


如 果 com.yiibai.user.action.LoginAction 想 通过 资源 包 获 得 消息 ， 它 将 搜索 


1. com.yiibai.user.action.LoginAction.properties (找到 ， 退 出 ， 否 则 下 一 个 ) 

2. com yiibai.user.action.package.properties (找到 ， 退 出 ， 否 则 下 一 个 ) 

3. com.yiibai.user.package.properties (找到 ， 退 出 ， 否 则 下 一 个 ) ... 一 路 不 断 在 
每 个 父 目录 的 根 目 录 查 找 package.properties 

4. 查找 全 局 资源 属性 ， 如 果 将 其 配置 在 应 用 程序 中 。 


明白 这 搜索 顺序 可 以 给 你 更 多 的 信心 来 决定 正确 的 文件 夹 的 属性 文件 。 
获取 资源 包 

下 面 是 访问 该 资源 包 的 几 个 例子 : 

P.S 'username.required' 和 ‘username’ 在 一 个 属性 文件 中 的 键 。 

1. 动作 类 


在 Action 类 ， 可 以 扩展 了 ActionSupport 和 通过 getText('key') HAG RA RE. 


public class LoginAction extends ActionSupport{ 


public void validate(){ 
if("".equals(getUsername())){ 
addFieldError("username", getText("username.required") | 





2. <S:property> 标 签 


在 属性 标记 ， 使 用 getText(‘key’). 


<s:property value="getText('username')" /> 


3. <s:text>iz & 
在 text 标 签 ， 设 置 *name” 属 性 的 键 。 


<s:text name="username" /> 


4. Key 属 性 
UI 组 件 的 主要 属性 有 特殊 的 功能 ， 坦 看 这 个 key 属 性 例子 详细 信息 。 


«s:textfield key="username" /> 


5. 118n 标 签 


国际 化 i18n 标签 可 以 从 “name" 属 性 声明 指定 资源 包 得 到 消息 。 在 这 个 例子 中 ， 它 要 
xk Mcom/yiibai/user/package.properties 3214 HL 3 f& “username” 的 消息 。 


«s:i18n name="Ccom.yiibai.user.package" > 
<s:text name="username" /> 
«/s:i18n» 


访问 URL http://localhost:8080/struts2resourcebundle/user/login.action, HLA F 


结果 : 
Ab 二 


| € > QC [D localhost:8080/struts2resourcebundle/user/login.action QT? = 


| Struts2 Login 登录 示例 





“Load from com package. properties” 








global. username: yiibai.com 
global. password: m 





| global.submit | 








下 载 完整 的 项 目 实 践 (struts2resourcebundle) — http://pan.baidu.com/s/1dD2UQ2! 


Struts2 本 地 化 和 国际 化 - Struts2 教 程 


Struts 2 的 国际 化 (I18N) 和 本 地 化 (i10n) 或 多 语言 的 例子 ， 来 说 明 如 何 使 用 资源 包 来 
显示 不 同 语言 的 消息 。 在 这 个 例子 中 ， 您 将 创建 一 个 简单 的 登录 屏幕 ， 通 过 Struts 
2 的 UI 组 件 显 示 来 自 资源 包 的 消息 ， 并 更 改 基于 所 选 的 语言 选项 的 语言 环境 。 


1. 工程 结构 


项 目 结构 ， 如 下 图 片 显 示 : 


$$ i18nlocalization 
4 (S src 
[B com.yiibai.common.action 
四 LocaleActionjava 
| [B com yiibai.user.action 
{2) LoginActionjava 
LoginAction de.properties 
LoginAction fr.properties 
LoginAction zh CN.properties 
LoginAction.properties 
global de.properties 
global fr.properties 
global zh CN.properties| 
global.properties 
T$ struts.xml 
mA JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
ES) Struts 2 Core Libraries 
(z» WebRoot 
(z» META-INF 
(& pages 
[P loginjsp 
[P welcome.jsp 
(z» WEB-INF 
\J? indexjsp 


2. Properties X {4 


确保 属性 文件 命名 为 国家 指定 的 代码 。 在 一 些 “ 非 欧洲 "或 “ 非 英语 "之 类 的 字符 ， 应 该 
始终 编码 的 内 容 native2ascii 属 性 


global.properties 


#Global messages 
global.username = Username 
global.password = Password 
global.submit = Submit 


global_zh_CN.properties 


#Global messages 

global.username = Nu7528Nu6237Nu540d 
global.password = \u5bc6\u7801 
global. submit=\u63d0\u4ea4 


global_fr.properties 


#Global messages 

global.username Nom d'utilisateur 
global.password Mot de passe 
global.submit = Soumettre 


global_de.properties 


#Global messages 
global.username = Benutzername 
global.password = Kennwort 
global.submit = Einreichen 


请 仔细 阅读 Struts2 资 源 包 的 例子 来 了 解 Struts 2 的 自动 搜索 属性 文件 。 


3. 动作 类 


两 个 动作 类 ，LocaleAction 基 本 上 是 什么 都 不 做 ， 而 LoginAction 会 做 一 个 
验证 和 通过 gettext() 显 示 来 自 资 源 包 错误 信息 。 


LocaleAction.java 


KR 


间 


单 的 


package com. yiibai.common.action; 

import com.opensymphony.xwork2.ActionSupport; 

public class LocaleAction extends ActionSupport{ 
//business logic 


public String execute() { 
return "SUCCESS"; 
} 


LoginAction.java 


package com.yiibai.user.action; 
import com.opensymphony.xwork2.ActionSupport; 
public class LoginAction extends ActionSupport{ 


private String username; 
private String password; 


//...getter and setter methods 


//business logic 

public String execute() { 
return "SUCCESS"; 

} 


//simple validation 
public void validate(){ 
if("".equals(getUsername())){ 
addFieldError("username", getText("username.required") | 


} 
if("".equals(getPassword())){ 
addFieldError("password", getText("password.required"): 


j 


} 
Aoo: ilit] 


4. 视图 页 向 


一 个 登录 页 面 带 有 一 个 文本 框 ， 密 码 和 提交 UI 组 件 。 为 了 支持 Struts2 本 地 化 ， 必 
须 声 明 <%@ page contentType="text/html;charset=UTF-8" %> 在 您 的 视图 页 面 ， 
否则 能 将 有 问题 的 “UTF-8 数 据 " 正 确 显示 ， 尤 其 是 中 国 汉字 。 阅 读 这 篇 文章 ， 关 于 
Struts2 中 国 本 土 化 问题 。 


login.jsp 


«99 page contentType="text/html;charset=UTF-8" %> 
«99 taglib prefix="s" uri="/struts-tags" %> 
<html> 

<head> 

</head> 


<body> 
<hi>Struts 2 localization example</h1> 


<s:form action="validateUser" namespace="/user"> 


«s:textfield key="global.username" name="username" /> 
<s:password key="global.password" name="password"/> 
«s:submit key="global.submit" name="submit" /> 


«/s:form» 


«s:url id-"localeEN" namespace="/" action="locale" > 
«s:param name="request_locale" >en</s:param> 

</s:url> 

«s:url id-"localezhCN" namespace="/" action="locale" > 
«s:param name="request_locale" >zh_CN</s:param> 

</s:url> 

«s:url id-"localeDE" namespace="/" action="locale" > 
«s:param name="request_locale" >de</s:param> 

</s:url> 

«s:url id-"localeFR" namespace="/" action="locale" > 
«s:param name="request_locale" >fr</s:param> 


</s:url> 

<s:a href="%{localeEN}" >English</s:a> 
«s:a href="%{localezhCN}" >Chinese</s:a> 
«s:a href="%{localeDE}" >German</s:a> 
«s:a href="%{localeFR}" >France</s:a> 
</body> 

</html> 


要 更 改 黑 认 的 语言 环境 ， 只 需要 声明 “request _ locale" 参 数 ， 设 置 你 喜欢 的 语言 代 
码 ， 并 传递 给 一 个 Action 类 。 在 Struts2 中 ， 
com.opensymphony.xwork2.interceptor118nlnterceptor 拦截 器 , 在 struts- 
default.xml 中 声明 将 拦截 Action 类 ， 并 相应 地 人 处理 语言 环境 。 


5. 显示 资源 包 的 消息 ? 


在 Struts2， 有 很 多 的 方式 来 显示 所 选择 的 语言 或 语言 环境 的 资源 包 的 信息 。 有 天 示 
例 7 


<s:textfield key="global.username" name="username" /> 
<s:text name="global.username" /> 

<s:property value="getText('global.username')" /> 
<s:text name="global.password" /> 


在 Struts1， 有 一 个 标准 的 bean:message 来 显示 资源 包 的 消息 。 但 是 在 Struts 2 
中 ， 有 这 人 么 多 相当 于 显示 资源 包 的 消息 (甚至 内 部 的 工作 不 同 ) 方 式 ， 基 本 上 ， 无 论 
选择 的 是 什么 ， 在 Struts2 也 将 显示 正确 的 资源 包 的 消息 。 


6. struts.xml 
Struts2 的 配置 文件 ， 链 接 一 起 。 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 


«constant name-"struts.custom.ii18n.resources" value="global" /: 
«constant name="Sstruts.devMode" value="true" /> 


«package name="user" namespace="/user" extends="struts-default' 
«action name="login"> 
<result>/pages/login. jsp</result> 
</action> 
«action name="validateUser" class="com.yiibai.user.action.L¢ 
«result name="SUCCESS">/pages/welcome.jsp</result> 
«result name="input">/pages/login.jsp</result> 
</action> 
</package> 


«package name="default" namespace="/" extends-'struts-default": 
«action name="locale" class="com.yiibai.common.action.Locale 
«result name="SUCCESS">/user/pages/login. jsp</result> 
</action> 

</package> 


</struts> 





7. 示例 


http://localhost:8080/i1 8nlocalization/user/login.action 
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www.yiibai.com 





(€) @ | localhost8080/i18nlocalization/locale.action 





Struts2 本 地 化 示例 


Username: 








Password: 


English Chinese German France 





http://localhost:8080/i1 8nlocalization/locale.action?request_locale=en 


www.yiibai.com 


(€) @ | localhost:8080/i18nlocalization/locale.action 


Struts2 本 地 化 示例 


Username: 














Password: 


English Chinese German France 





http://localhost:8080/i18nlocalization/locale.action?request locale-zh CN 
[| 


http://localhost:8080/i1 8nlocalization/locale.action?request_locale=de 
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www.yiibai.com 





(eje localhost:8080/i18nlocalization/locale.action?request_locale=de "wu | 





Struts2 本 地 化 示例 


Benutzername: 
Kennwort: 








English Chinese German France 





http://localhost:8080/i1 8nlocalization/locale.action?request_locale=fr 


www.yiibai.com 


€) & | localhost:8080/i18nlocalization/locale.action?request locale-fr 


Struts2 本 地 化 示例 


Nom dutilisateur: 

















Mot de passe: 


English Chinese German France 





1. http://struts.apache.org/2.1.8/docs/localization.html 


2. http://www.yiibai.com/java/java-convert-chinese-character-to-unicode-with- 
native2ascii/ 


3. http://www.yiibai.com/struts2/struts-2-resource-bundle-example/ 
4. http://www.yiibai.com/struts/struts-internationalizing-or-localization-example/ 


代码 下 载 - http://pan.baidu.com/s/1jGCUaJ8 
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Struts2 key 键 属性 示例 - Struts2 教 程 


在 Struts2， 在 Ul 组 件 的 “key" 属 性 来 外 理 本 地 化 的 常用 方法 ， 也 是 编码 Ul 标 签 的 一 个 
非常 有 效 的 方式 。 见 下 面 两 种 情况 : 


1. Properties 属 性 文件 


属性 文件 包含 一 条 消息 。 
global.properties 


global.username = Username 


2. 示例 1 


如 果 分 配 一 个 "key" 属 性 到 一 个 文本 框 。 键 (key) 属 性 会 从 资源 包 中 获取 信息 ， 并 使 
其 在 默认 XHTML text. 攻 模板 基础 上 演 染 。 


«s:form action="validateUser"> 
<s:textfield key="global.username" /> 
«/s:form» 


现在 它 将 会 使 用 “global.username (left-side)" $1 “Username (right-side)", J m Acta 
应 的 XHTML text.tfl 模 板 。 


<td class="tdLabel"> 

«label for="validateUser_{left-side}" class="label">{right-side_ 
</td> 
<td> 

<input type="text" name="{left-side}" value="" id="validateUser_ 
</td> 





最 后 的 HTML 


<td class="tdLabel"> 
«label for="validateUser_global_username" class="label">Username 
</td> 


<td> 

<input type="text" name="global.username" value="" id="validatel 
</td> 
‘| ae 








键 属 性 将 使 用 {left-side} 作 为 文本 框 名 称 和 ID; {right-side} 作为 标签 值 。 


3. 示例 2 
在 某 些 情况 下 ， 可 能 需要 显 式 声明 的 一 个 不 同 的 名 称 的 文本 框 。 


<S:form action="validateUser"> 
<s:textfield key="global.username" name="username"/> 
«/s:form» 


现在 key 属 性 将 使 用 “Username {right-sidey 来 只 匹配 的 标签 值 ， 文本 框 的 名 称 和 ID 
将 明确 覆盖 。 


最 后 的 HTML 


<td class="tdLabel"> 

«label for="validateUser_username" class="label">Username:</labe 
</td> 
<td> 

<input type="text" name="username" value="" id="validateUser_use 
</td> 


人 IE 
key 属 性 可 以 提高 你 的 开发 速度 ， 使 代码 更 有 效 ， 这 是 值得 学 习 的 。 





Struts2 中 文本 地 化 问题 - Struts2 教 程 


一 个 Struts2 的 国际 化 定位 的 问题 ， 用 来 显示 中 国 汉 字 ... 


案例 1 : 属性 有 特殊 字符 的 文件 


属性 文件 存储 用 户 名 ， 密 码 信 息 ， 并 以 中 文字 符 提交 。 此 属性 文件 以 UTF-8 格 式 创 
建 的 ， 但 内 容 不 使 用 native2ascii 编码 。 





“| global_zh_CN.properties - Notepad — 
File Edit Format View Help 





Global messages 
global.username 
global.password 


BE 


global. submi t=t#2 


让 我 们 试 着 通过 一 些 Ul 标 签 ， 来 显示 中 国 汉 字 。 坦 看 页 面 声 明 为 UTF-8 格 式 的 
HTML 元 标记 来 显示 。 
E 


«meta http-equiv-"Content-Type" content-"text/html; charset=UTF-8" 
«/head» 


«s:form action="validateUser"> 
«s:textfield key="global.username" name="username"/> 
«s:password keyz"global.password" name="password"/> 
«s:submit key="global.submit" name-"submit" /> 


<div>Testing 1 : «s:property value="getText('global.username' )' 
<div>Testing 2 : <s:text name="global.password" /></div></br/> 
«/s:form» 


«s:url id="localezhCN" namespace="/" action="locale" > 
«s:param name="request_locale" >zh_CN</s:param> 
</s:url> 


<s:a href="%{localezhCN}" >Chinese</s:a> 











Struts 2 localization example 


Testing 1: cg" ae a 
Testing 2 :密码 
Chinese is not display correctly 
用 户 名 : 
密码 : 


pao | 


结果 English Chinese German France 
邻 人 惊奇 的 是 ， 以 下 三 个 UI 标 签 都 能 够 正确 地 显示 中 国 消息 
<s:textfield key="global.username" name="username"/> 


<s:password key="global.password" name="password"/> 
Testing 2 : <s:text name="global.password" /> 


Am, "s:submit" 和 “getText()” 却 无 法 显示 呢 ? 据 Java 的 国际 化 文档 ， 要 使 用 资源 
包 正 确 显示 特殊 字符 ， 则 必须 用 native2ascii 工具 进行 处 理 。 


深入 到 TextProvider getText() 的 源 代 码 后 ， 它 使 用 的 资源 bundle.getString() 来 从 资 
源 包 检索 的 消息 ， 所 以 不 正确 的 消息 是 合理 的 。 但 是 ， 为 什么 "s:text", “s:textfield” 
和 “s:password” 能 够 正确 显示 了 中 文 的 消息 ， 为 什么 “s:submit* 会 失败 ?在 有 太 多 
的 问题 ， 让 我 们 看 看 示例 2... 


案例 2 : 有 特殊 字符 的 属性 文件 (编码 ) 


这 一 次 ， 属 性 文件 使 用 native2ascii 工 具 义 理 中 国 汉 字 的 编码 正确 。 


“| global zh CN.properties - Notepac 
File Edit Format View Help 


#Global messages 

global.username \u7528\u6237\u540d 
|global. password \u5bc6\u7801 
global. submit=\u63d0\u4ea4 





结果 如 下 所 示 : 











— o —  — = 


b —— ; x 
ume | 
€ © | D localhost:8080/globalresource/user/login.action 
Struts2 本 地 化 示例 


Testing 1 : 用 户 名 


Testing 2 : 77? 


9???- yiibai.com 
?? Doe 





提交 


English Chinese German France 

















——— 





其 结果 是 完全 逆转 ， 现 在 “s:submit” 和 “getText()” 是 能 够 正确 地 显示 它 ， 但 其 他 UI 


组 件 失 败 。 这 里 是 按 预期 方式 工作 的 ， 因 为 在 Struts 2 推荐 使 用 getText()， 以 显示 
国际 化 或 本 地 化 的 消息 。 问 题 是 ， 为 什么 “s:submit" 会 不 同 呢 ? 


Struts2.. 哪 里 有 问题 ? 


这 里 有 几 个 问题 : 

1. 为 什么 s:submit 有 如 此 不 同 的 效果 ? 

2. 对 国际 化 应 该 是 非常 简单 的 ， 为 什么 在 Struts 2 有 这 种 问题 ? 或 者 我 们 误解 了 
Struts2 国际 化 如 何 工作 了 ? 

3. 为 什么 有 这 么 多 的 方式 来 显示 来 自 资源 包 的 消息 ?为 什么 不 直接 组 织 成 一 个 方 
法 ? 在 Struts1， 只 需 使 用 “bean:message”， 为 什么 Struts 2 中 它 看 起 来 很 复 
x? 

4. Struts2 的 支持 XML 资 源 包 ? 我 们 可 能 不 太 喜 欢 用 native2ascii 工 具 对 数据 进行 
编码 为 UTF-8 格 式 ， 它 使 属性 文件 不 可 读 。 Apache Wicket 的 在 这 个 问题 做 了 
很 好 的 工作 ， 可 能 是 在 Struts 2 中 吸取 教训 。 

5 那么， 如 何 正确 地 在 Struts2 中 显示 中 国 汉字 ? 


许多 文章 和 教程 使 用 以 下 方法 来 显示 资源 包 的 消息 : 


<s:text name="global.username"/> 
«s:property value-"getText('global.username')"/» 


然而 ， 这 仅 适 用 于 英国 或 一 些 “ 英 语 状 (欧洲 )” 的 字符 ， 如 法 文 ， 德 文 。 但 对 中 文 或 
日 文 ， 这 两 种 方法 将 返回 完全 不 同 的 输出 。 真 的 不 知道 Struts2 的 本 地 化 该 怎么 办 
了 。 


解决 办 法 


问题 是 在 HTML meta 标 签 ， 


<head> 
«meta http-equiv-"Content-Type" content-"text/html; charset=UTF-8" 
</head> 





sd 
在 Struts1， 上 述 meta 标 签 必 须 正 确 显 示 UTF-8 的 数据 ， 但 这 在 Struts2 是 有 问题 
的 。 


在 Struts2，meta 标 签 不 起 作用 ， 我 们 应 该 把 <%@ page 
contentType-"text/html;charset-UTF-8" %> 标 签 放 在 页 面 的 第 一 行 。 例 如 下 面 的 代 
码 片断 : 





<%@ page contentType-"text/html;charset-UTF-8" %> 
«99 taglib prefix="s" uri="/struts-tags" %> 











<html> 
<head> 
</head> 
结果 显示 如 下 : 
ee kas] be me 
' [5 www.yiibai.com x Y 
[s Œ | D localhost:8080/globalresource/user/login.action Q * 2? = 
Struts2 本 地 化 示例 


Testing 1 : 用 户 名 
Testing 2 : 用 户 名 


用 户 名 : yiibai.com 
| 密码 : | — 








Er 


1 English Chinese German France 


| 


所 有 的 中 文 消 息 正确 显示 。 

















回答 之 前 的 问题 


1. 为 什么 s:submit 有 如 此 不 同 的 效果 ? A: 暂 无 评论 

2. 对 国际 化 应 该 是 非常 简单 的 ， 为 什么 在 Struts 2 有 这 种 问题 ? 或 者 我 们 误解 了 
Struts2 国际 化 如 何 工 作 了 ? A: 确保 把 * <%@ page 
contentType="text/html;charset=UTF-8" %>” 放 在 页 面 的 第 一 行 。* 


5. 


. 为 什么 有 这 么 多 的 方式 来 显示 来 自 资 源 包 的 消息 ? 为 什么 不 直接 组 织 成 一 个 方 


法 ? 在 Struts1， 只 需 使 用 “bean:message”， 为 什么 Struts 2 中 它 看 起 来 很 复 
% ? A: s:text, key, getText(), name... , 所 有 的 都 能 够 正确 地 显示 中 文 或 UTF- 
8 编码 的 数据 ， 只 要 确保 把 正确 的 “字符 集 ” 放 在 视图 页 面 中 。* 


.Struts2 的 支持 XML 资 源 包 ? 我 们 可 能 不 太 喜 欢 用 native2ascii 工 具 对 数据 进行 


编码 为 UTF-8 格 式 ， 它 使 属性 文件 不 可 读 。 Apache Wicket 的 在 这 个 问题 做 了 
很 好 的 工作 ， 可 能 是 在 Struts 2 中 吸取 教训 。A: 希 望 在 Struts2 的 下 一 版 本 可 以 
支持 在 XML 资源 包 。 

那么 ， 如 何 正确 地 在 Struts2 中 显示 中 国 汉 字 ? A: 看 看 上 页 的 解决 办 法 


参考 


1. 


2. 
3. 


4. 
5. 


http://www. yiilbai.com/java/java-convert-chinese-character-to-unicode-with- 
native2ascii.html 

http://forums.sun.com/thread.jspa?threadID=5185040 
http://www.coderanch.com/t/452139/Struts/applicationresources-properties- 
utf-characters#2013557 

http://struts.apache.org/2.1.8/docs/localization.html 
http://nxzon00.blog.163.com/blog/static/10489241620088121449163/ 


下 载 代码 (globalresource) — http://pan.baidu.com/s/1mgzt3dQ 


TutorialsPoint Java 技术 教程 


Struts2+Spring 集 成 实例 - Struts2 教 程 


在 本 教程 中 ， 我 们 来 学 习 Struts2 和 Spring 的 集成 。 





Struts 2 Libraries 
Add Struts 2 and User Libraries to the project 





Select the libraries to add to project buildpath 
Show: [V] MyEclipse Libraries | |User Libraries 





Struts 2 Core Libraries - <MyEclipse-Library= 

Struts 2 DOJO Libraries - «MyEclipse-Library» 
Struts 2 DWR Libraries - «MyEclipse-Library» 
Struts 2 Jasper Libraries - <MyEclipse-Library= 
Struts 2 JFreeChart Libraries - <MyEclipse-Library> į 
Struts 2 JSF Libraries - <MyEclipse-Library= 

Struts 2 Miscellaneous Libraries - <MyEclipse-Library> 
Struts 2 Plexus Libraries - <MyEclipse-Library= 
Struts 2 Portlet Libraries - <MyEclipse-Library= 
Struts 2 REST Libraries - <MyEclipse-Library> 
Struts 2 SiteMesh Libraries - «MyEclipse-Library» 





Sj [3] [3 [9p ES) C9) [9] [9] [3p [3p [3] [S] 


Struts 2 Spring Libraries - <MyEclipse-Library= 


[3] 


Struts 2 Struts 1 Support Libraries - «MyEclipse-Library» 
View and edit libraries... 








1. 工程 结构 


Struts2+Spring 集 成 实例 - Struts2 教 程 2912 


TESI ERRINA EE dog. 
4 32 struts2spring 
4 i src 
4B com,yiibai.user.action 
» [J] UserAction java 
[J] UserSpringAction.java 





4 册 com yiibai.user.bo 
四 UserBo.java 
4 册 com yiibai.user.bo.impl 
四 UserBolmpl.java 
V struts.xml 
BA JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
=) Struts 2 Core Libraries 
BA Struts 2 Spring Libraries 
4 @& WebRoot 
& META-INF 
4 (& pages 
[P userjsp 
4 区 WEB-INF 
& lib 
Æ applicationContext.xml 
(Xf web.xml 
[P indexjsp 


2. Spring 4 IF zs 


fc i Spring 4 Iris "org.springframework.web.context. ContextLoaderListener" 到 


web.xml X fF rh, 


web.xml 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app 2 3.dtd" > 


«web - app» 
<display-name>Struts 2 Web Application</display -name> 


<filter> 
<filter -name>struts2</filter -name> 
<filter-class> 
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndE) 
</filter-class> 
</filter> 


<filter -mapping> 
<filter -name>struts2</filter -name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 


</web-app> 


1 





3. 注册 Spring Bean 
注册 所 有 的 Spring Beans 配置 在 applicationContext.xml 文件 中 , Spring 监 听 器 会 自 
动 找 到 这 个 XML 文件 。 


applicationContext.xml 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


«bean id="userBo" class="com.yiibai.user.bo.impl.UserBoImp1" /: 
«bean id="userSpringAction" class="com.yiibai.user.action.User‘s 
<property name="userBo" ref="userBo" /> 


</bean> 


</beans> 


«| zm 








UserBo.java 


package com.yiibai.user.bo; 
public interface UserBo( 


public void printUser(); 


UserBolmpl.java 


package com.yiibai.user.bo.impl; 
import com.yiibai.user.bo.UserBo; 
public class UserBoImpl implements UserBo( 


public void printUser(){ 
System.out.println("printUser() is executed..."); 
j 


UserSpringAction.java 


package com.yiibai.user.action; 
import com.yiibai.user.bo.UserBo; 
public class UserSpringAction{ 


//DI via Spring 
UserBo userBo; 


public UserBo getUserBo() ( 
return userBo; 
j 


public void setUserBo(UserBo userBo) ( 
this.userBo - userBo; 
} 


public String execute() throws Exception { 


userBo.printUser(); 
return "success"; 


4. Struts.xml 


在 此 声明 的 所 有 关系 。 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 
«constant name-"struts.devMode" value-"true" /» 


«package name="default" namespace="/" extends-"'struts-default": 


«action name="userAction" 
class="com.yiibai.user.action.UserAction" > 


«result name="Success">pages/user .jsp</result> 
</action> 


<action name="userSpringAction" 
class="userSpringAction" > 
«result name="Success">pages/user .jsp</result> 
</action> 
</package> 


</struts> 


uj SSS SSS se 





5. 示例 


现在 ， 所 有 的 Struts2 和 Spring 的 集成 工作 已 经 完成 ， 现 在 看 到 下 面 的 用 例 来 访问 
Spring 的 “userBo”Bean。 


e。 用 例 1: 让 Spring 充当 Struts2 的 Action 类 ， 并 访问 Spring 的 Bean。 
e 用例 2 : 在 Struts2 的 Action 类 中 访问 Spring 的 Bean。 


用 例 1 


在 这 个 例子 中 ，userSpringAction 充 当 Struts2 的 Action 类 ， 也 可 以 使 用 普通 Spring 
的 方式 注入 Spring 的 userBo。 


//struts.xml 
<action name="userSpringAction" 
class="userSpringAction" > 
«result name="Success">pages/user .jsp</result> 
</action> 


//applicationContext. xml 

<bean id="userSpringAction" class="com.yiibai.user.action.UserSprir 
<property name="userBo" ref="userBo" /> 

</bean> 


‘ — 3g 


要 访问 此 操作 ， 请 使 用 网 址 : 
http://localhost:8080/struts2spring/userSpringAction.action 








用 例 2 


默认 情况 下 ，Spring 监 听 器 启用 “通过 匹配 bean 的 名 字 自 动 装配 “<。 因此 ， 它 会 通过 
setUserBo 自 动 传递 Spring “userBo” Bean 到 UserAction。 请 参阅 下 面 的 Struts2 动 
作 : 


Spring 的 自动 装配 功能 可 以 修改 为 name( 黑 认 ), type, auto 或 constructor, 可 能 需 
要 参考 Struts2 的 Spring 插件 文档 。 


UserAction.java 


package com.yiibai.user.action; 


import com.yiibai.user.bo.UserBo; 
import com.opensymphony.xwork2.ActionSupport; 


public class UserAction extends ActionSupport{ 


//DI via Spring 
UserBo userBo; 


public UserBo getUserBo() { 


return userBo; 
J 


public void setUserBo(UserBo userBo) ( 
this.userBo - userBo; 

} 

public String execute() throws Exception { 


userBo.printUser(); 
return SUCCESS; 


要 访问 此 操作 ， 请 使 用 网 址 : http://localhost:8080/struts2spring/userAction.action 


[3 www.yiibai.com x Y 













€ Œ | [5 localhost:8080/struts2spring/userSpringAction.action 


Struts2 + Spring 集成 示例 


com. yiibai. user. bo. impl. UserBoImpl@lTcei e333 





K 


WebApplicationContextUtils 另外 ， 也 可 以 使 用 Spring 通用 
WebApplicationContextUtils 类 来 直接 获得 Spring 的 bean。 


package com.yiibai.user.action; 


import org.apache.struts2.ServletActionContext; 
import org.springframework.web.context.WebApplicationContext; 
import org.springframework.web.context.support.WebApplicationConte; 


import com.yiibai.user.bo.UserBo; 
import com.opensymphony.xwork2.ActionSupport; 


public class UserAction extends ActionSupport{ 
public String execute() throws Exception ( 
WebApplicationContext context - 
WebApplicationContextUtils.getRequiredWebApplicationCor 


ServletActionContext.getServle! 


); 


UserBo userBo1 = (UserBo)context.getBean("userBo"); 
userBo1.printUser(); 


return SUCCESS; 





这 是 一 个 又 长 又 自 的 文章 ( 包 教 不 包 会 )， 请 下 载 完整 的 项 目 并 按照 源 代码 去 一 步 步 
实现 。 


参考 


1. Struts2 Spring 插件 文档 
2. Struts + Spring 集成 实例 


代码 下 载 - http://pan.baidu.com/s/1dDhqQ5b 


Struts2+Hibernate 使 用 Full Hibernate Plugin 
成 - Struts2 教 程 

在 上 篇 Struts2 + Hibernate 集 成 实例 中 , 它 使 用 servlet 上 下 文 监 听 Hibernate 的 
Session， 而 且 把 Struts2 和 Hibernate 框 架 集 成 。 

但 是 ， 总 有 一 些 东 西 要 提高 。 在 本 教程 中 ， 我 们 将 展示 如 何 整 合 
Struts2+Hibernate， 并 使 用 Struts2 一 个 名 为 “Full Hibernate Plugin“ 的 插件 。 

见 下 面 的 集成 步骤 : 


1. 18 “Full Hibernate Plugin" jar 放 和 到 工程 类 路 径 。 

2. 1H “@SessionTarget” 注释 来 注入 到 Hibernate session; 
+4“@TransactionTarget” 注释 注入 到 Hibernate 事务 。 

3. 在 struts.xml, 让 包 扩 展 “hibernate-default*， 而 不 是 默认 的 堆栈 。 


看 看 下 面 的 关系 : 


Struts 2 <-- (Full Hibernate Plugin) ---> Hibernate <----- > Databa: 


FE ———————— —————— —— í— ]n!áÀÍ—À 
X, 本 教程 是 从 以 前 的 Struts2 + Hibernate 集 成 实例 (servlet context listener) E 3/r 


版 本 。 因 此 ，JSP 和 Hibernate 配置 基本 相同 ， 只 是 整合 的 部 分 是 有 点 不 同 ， 党 试 
比较 既 能 发 现 不 同 。 


1. 工程 结构 





在 节 教 程 ， 我 们 创建 一 个 工程 名 为 full-hibernate 的 web 工 程 。 看 看 这 个 项 目 文件 夹 
4 355 full-hibernate 
4 $8 src 
4 {8 comyiibai 
[J] HibernateSessionFactory.java 
4 {8 comyiibai.customer.action 
四 CustomerActionjava 
4 {8 comyiibai.customer.dao 
[JJ CustomerDAO java 
4 {8 comyiibai.customer.dao.impl 
加 CustomerDAOImpl.java 
4 [B comyiibai.customer.hibernate 
2b Customer.hbm.xml 
4 [8 comyiibai.customer.model 
加 Customerjava 
© hibernate.cfg.xml 
E$ struts.xml 
Bi, JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
= Hibernate 3.3 Annotations & Entity Manager 
=) Hibernate 3.3 Core Libraries 
mA Struts 2 Core Libraries 
BA MySQL 
= Referenced Libraries 
4 © WebRoot 
E META-INF 


的 完整 结构 。 4 & pages 


2. MySQL 创 建 表 脚本 
Customer 表 结构 


CREATE TABLE “customer” ( 
"customer id^ bigint(20) unsigned NOT NULL AUTO INCREMENT, 
"name" varchar(45) NOT NULL, 
“address” varchar(255) NOT NULL, 
"create date datetime NOT NULL, 
PRIMARY KEY ('^customer id') 
) ENGINE-InnoDB AUTO INCREMENT-2 DEFAULT CHARSET=utf8; 


3. Hibernate 相 关 配 置 


所 有 Hibernate 的 模型 和 配置 的 东西 。 


Customerjava - 7; customer 表 创 建 一 个 类 。 


package com. yiibai.customer.model; 
import java.util.Date; 
public class Customer implements java.io.Serializable { 


private Long customerId; 
private String name; 
private String address; 
private Date createdDate; 


//getter and setter methods 


Customer.hbm.xml - Hibernate 的 customer 表 了 映射 。 


<?xml version="1.0"?> 
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"» 
«!-- Generated 20 Julai 2010 11:40:18 AM by Hibernate Tools 3.2.5.t 
<hibernate-mapping> 
«class name="com.yiibai.customer .model.Customer" 
table="Customer" catalog="yiibai"> 
«id name="CustomerId" type="java.lang.Long"> 
<column name="CUSTOMER_ID" /> 
<generator class="identity" /> 
</id> 
<property name="name" type="string"> 
«column name="NAME" length="45" not-null="true" /> 
</property> 
«property name="address" type="string"> 
<column name="ADDRESS" not-null="true" /> 
</property> 
«property name-"createdDate" type="timestamp"> 
«column name-"CREATED DATE" length="19" not-null-"true' 
</property> 
</class> 
</hibernate-mapping> 





文件 : hibernate.cfg.xml, Hibernate 数据 库 配 置 


<?xml version="1.0" encoding="utf-8"?> 

<!DOCTYPE hibernate-configuration PUBLIC 

"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd": 

<hibernate-configuration> 
<session-factory> 


<property 
<property 
<property 
<property 
<property 
<property 
<property 
<property 


5. DAO 


name="hibernate. 
name="hibernate. 
name="hibernate. 
name="hibernate. 
name="hibernate. 


bytecode.use_reflection_optimizer">fé 
connection. password">password</propet 
connection.url">jdbc:mysql://localho: 
connection.username">root</property> 
dialect">org.hibernate.dialect .MySQLI 


name="Show_sql">true</property> 
name="format_sql">true</property> 
name="use_sql_comments">false</property> 
«mapping resource="com/yiibai/customer/hibernate/Customer .hbm.: 
</session-factory> 
</hibernate-configuration> 





实现 DAO 设 计 模 式 执 行 数 据 库 操作 。 在 CustomerDAOImpl X, 声明 Hibernate 会 话 
和 事务 为 类 成 员 。 在 Struts 2 的 项 目 初 始 化 ，“Full Hibernate Plugin" 使 用 
@SessionTarget 和 @TransactionTarget 分 别 标注 将 注入 相应 的 Hibernate 会 话 和 


CustomerDAO.java 


package com. yiibai.customer.dao; 


import java.util.List; 


import com.yiibai.customer.model.Customer; 


public interface CustomerDAO( 


void addCustomer(Customer customer); 


List«Customer» listCustomer(); 


CustomerDAOImpl.java 


package com. yiibai.customer.dao.impl; 


import 


import 
import 


import 
import 
import 
import 


public 


java.util.List; 


org.hibernate.Session; 
org.hibernate.Transaction; 


com. googlecode.s2hibernate.struts2.plugin.annotations.Sessic 
com.googlecode.s2hibernate.struts2.plugin.annotations.Trans: 


com.yiibai.customer.dao.CustomerDAO; 
com.yiibai.customer.model.Customer; 


class CustomerDAOImpl implements CustomerDAO{ 


QSessionTarget 
Session session; 


QTransactionTarget 
Transaction transaction; 


//add the customer 
public void addCustomer(Customer customer ) { 


} 


session.save(customer); 


//return all the customers in list 
public List<Customer> listCustomer(){ 





return session.createQuery("from Customer").list(); 


6. Action 


在 Action 类 ， 调 用 DAO 类 来 执行 数据 库 操作 。 


CustomerAction.java 


package com.yiibai.customer.action; 


import java.util.ArrayList; 
import java.util.Date; 
import java.util.List; 


import com.yiibai.customer.dao.CustomerDAO; 

import com.yiibai.customer.dao.impl.CustomerDAOImpl; 
import com.yiibai.customer.model.Customer; 

import com.opensymphony.xwork2.ActionSupport; 

import com.opensymphony.xwork2.ModelDriven; 


public class CustomerAction extends ActionSupport 
implements ModelDriven{ 


Customer customer - new Customer(); 
List<Customer> customerList = new ArrayList«Customer»(); 
CustomerDAO customerDAO = new CustomerDAOImpl(); 


public String execute() throws Exception { 
return SUCCESS; 
j 


public Object getModel() ( 
return customer; 
} 


public List<Customer> getCustomerList() { 
return customerList; 
} 


public void setCustomerList(List<Customer> customerList) { 
this.customerList = customerList; 
} 


//save customer 
public String addCustomer() throws Exception{ 


//save it 

customer .setCreatedDate(new Date()); 
customerDAO.addCustomer (customer); 
//reload the customer list 

customerList - null; 

customerList - customerDAO.listCustomer(); 


return SUCCESS; 


} 


//list all customers 
public String listCustomer() throws Exception{ 


customerList = customerDAO.listCustomer(); 


return SUCCESS; 


T. JSP nw 


JSP 页 面 添加 并 列 出 客户 。 


customer.jsp 


«99 taglib prefix="s" uri="/struts-tags" %> 
«99 taglib prefix="s" uri="/struts-tags" %> 
<html> 
<head> 
</head> 


<body> 
<hi>Struts 2 Full Hibernate Plugin example</h1i> 


<h2>Add Customer</h2> 
<s:form action="addCustomerAction" > 


<s:textfield name="name" label="Name" value="" /> 
«s:textarea name="address" label="Address" valuez"" cols="50" rov 
<s:submit /> 

«/s:form» 


<h2>All Customers</h2> 


<s:if test="customerList.size() > 0"> 
«table border="1px" cellpadding="8px"> 


<tr> 
<th>Customer Id</th> 
<th>Name</th> 
<th>Address</th> 
<th>Created Date</th> 
</tr> 
<s:iterator value="CustomerList" status="userStatus"> 
<tr> 
<td><s:property value-"customerId" /></td> 
<td><s:property value="name" /></td> 
<td><s:property value="address" /></td> 
<td><s:date name="createdDate" format="dd/MM/yyyy" /><, 
</tr> 
</s:iterator> 
</table> 
</s:if> 
<br/> 
<br/> 
</body> 
</html> 


| = E 





8. struts.xml 


链接 所 有 一 让 包 扩 展 “hibernate-defaultP 来 代替 “struts-default. 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 
«constant name-"struts.devMode" value="true" /» 


«package name="default" namespace="/" extends="hibernate-default' 


<action name="addCustomerAction" 
class="com.yiibai.customer.action.CustomerAction" method="addCt 


«result name="Success">pages/customer.jsp</result> 
</action> 


«action name="listCustomerAction" 
class="com.yiibai.customer.action.CustomerAction" method="list( 

«result name="Success">pages/customer .jsp</result> 
</action> 


</package> 
</struts> 





9. 实例 
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访问 以 下 网 址 : http://localhost:8080/full-hibernate/addCustomerAction.action 
(e cw | 





[5 pe-20151109psmq:808¢ 
€ > QC |D pc-20151109psmq:8080/full-hibernate/addCustomerAction.action 


Struts2 Full Hibernate Plugin 实例 
添加 顾客 


Name: 




















Address: 








所 有 顾客 








[5 pc-20151109psmq;808c x 
€ SC |D pc-20151109psmq:8080/full-hibernate/addCustomerAction.action 


Struts2 Full Hibernate Plugin 实例 
添加 顾客 


Name: 

















Address: 











所 有 顾客 


Customer Id Name Address 
pe 
易 百 教 程 | 海南 海口 
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参考 


1. Struts2 Full Hibernate 插 件 文档 
2. Struts2 + Hibernate 集 成 实例 
3. 安装 库 到 Maven 本 地 资源 库 


下 载 代码 


下 载 所 有 源 代码 - http://pan.baidu.com/s/106tjSam 
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Struts2+Hibernate 集 成 实例 - Struts2 教 程 


在 Struts2 中 ， 没 有 官方 的 插件 集成 Hibernate 框 架 。 但 是 ， 可 以 通过 以 下 步骤 解决 
方法 : 
1. 注册 一 个 自 定 义 的 ServletContextListener 
2. 在 ServletContextListener 类 ,初始 化 Hibernate 会 话 ， 并 将 其 存储 到 servlet 上 
下 文 。 
3. 在 动作 类 , 可 以 通过 servlet 上 下 文 的 Hibernate 会 话 ， 并 执行 任务 正常 的 
Hibernate 操 作 。 


请 参阅 它们 的 关系 : 


Struts 2 <-- (Servlet Context) ---> Hibernate <----- > Database 


在 本 教程 中 ， 在 Struts 中 2 开发 我 们 显示 了 一 个 简单 的 客户 模块 (添加 和 列表 功能 )， 
并 使 用 Hibernate 进行 数据 库 操 作 。 使 用 上 述 部 分 机 制 集成 (存储 和 检索 在 servlet 上 
下 文 Hibernate 的 Session)。 


1. 工程 目录 结构 


来 看 看 这 个 完整 的 项 目 文件 天 结构 。 
4 355 struts2hibernate 
4 $8 src 
4 {8 comyiibai 
[JJ HibernateSessionFactory.java 
4 {8 com yiibai.customer.action 
{2) CustomerAction,java 
4 {B comyiibai.customer.hibernate 
& Customer.hbm.xml 
4 {8 com yiibai.customer.model 
四 Customerjava 
4 [B comyiibai.listener 
|J] HibernateListener.java 
© hibernate.cfg.xml 
E$ struts.xml 
E) JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
mi Struts 2 Core Libraries 
Ej, Hibernate 3.3 Annotations & Entity Manager 
= Hibernate 3.3 Core Libraries 
BA MySQL 
4 {> WebRoot 
(£z META-INF 
i pages 
(& WEB-INF 
(J? indexjsp 


2. MySQL 表 结构 脚本 
创建 一 个 客户 (customer) 表 。 下 面 是 SQL 表 脚本 。 


CREATE TABLE “customer” ( 
"customer id' bigint(20) unsigned NOT NULL AUTO INCREMENT, 
"name? varchar(45) NOT NULL, 
‘address varchar(255) NOT NULL, 
"create date datetime NOT NULL, 
PRIMARY KEY ('^customer id') 
) ENGINE-InnoDB AUTO INCREMENT-2 DEFAULT CHARSET=utf8; 


4. Hibernate 相关 配置 


Hibernate 的 模型 和 配置 的 东西 。 
Customer.java — 创建 客户 表 对 应 的 一 个 类 。 


package com. yiibai.customer.model; 
import java.util.Date; 
public class Customer implements java.io.Serializable { 


private Long customerId; 
private String name; 
private String address; 
private Date createdDate; 


//getter and setter methods 


Customer.hbm.xml — Hibernate 映 射 文件 客户 表 。 


<?xml version="1.0"?> 
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping> 
«class name="Ccom.yiibai.customer .model.Customer" 
table-"customer" catalog="yiibai"> 


<id name="CustomerId" type="java.lang.Long"> 
<column name="CUSTOMER_ID" /> 
<generator class="identity" /> 
</id> 
<property name="name" type="string"> 
«column name="NAME" length="45" not-null="true" /> 
</property> 
«property name="address" type="string"> 
<column name="ADDRESS" not-null="true" /> 
</property> 
«property name-"createdDate" type="timestamp"> 
«column name-"CREATED DATE" length="19" not-null-"true' 
</property> 
</class> 
</hibernate-mapping> 





hibernate.cfg.xml - Hibernate 数 据 库 配置 文件 


<?xml version="1.0" encoding="utf-8"?> 

<!DOCTYPE hibernate-configuration PUBLIC 

"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd": 

<hibernate-configuration> 
<session-factory> 


<property 
<property 
<property 
<property 
<property 
<property 
<property 
<property 


name="hibernate. 
name="hibernate. 
name="hibernate. 
name="hibernate. 
name="hibernate. 


bytecode.use_reflection_optimizer">fé 
connection. password">password</propet 
connection.url">jdbc:mysql://localho: 
connection.username">root</property> 
dialect">org.hibernate.dialect.MySQLI 


name="Show_sql">true</property> 
name="format_sql">true</property> 
name="use_sql_comments">false</property> 


«mapping resource="com/yiibai/customer/hibernate/Customer .hbm.> 
</session-factory> 
</hibernate-configuration> 





5. Hibernate ServletContextListener 


创建 一 个 类 ServletContextListener, 并 初始 化 Hibernate 会 话 ， 并 将 其 存储 到 servlet 


EPX 


HibernateListener .java 


package com.yiibai.listener; 
import java.net.URL; 


import javax.servlet.ServletContextEvent; 
import javax.servlet.ServletContextListener ; 


import org.hibernate.SessionFactory; 
import org.hibernate.cfg.Configuration; 


public class HibernateListener implements ServletContextListener { 


private Configuration config; 

private SessionFactory factory; 

private String path = "/hibernate.cfg.xml"; 

private static Class clazz = HibernateListener.class; 


public static final String KEY NAME - clazz.getName(); 


public void contextDestroyed(ServletContextEvent event) { 
// 


} 


public void contextInitialized(ServletContextEvent event) { 


try { 
URL url = HibernateListener.class.getResource(path); 


config = new Configuration().configure(url); 
factory = config. buildSessionFactory(); 


//save the Hibernate session factory into serlvet conte 

event.getServletContext().setAttribute(KEY NAME, factor 
) catch (Exception e) { 

System.out.println(e.getMessage()); 





f£ web.xml 文件 中 注册 监听 器 。 


web.xml 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app 2 3.dtd" > 


«web - app» 
<display-name>Struts 2 Web Application</display -name> 


<filter> 
<filter-name>struts2</filter -name> 
<filter-class> 


org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExeci 


«/filter-class» 
«/filter» 


«filter-mapping» 
«filter-name»struts2«/filter-name- 
<url-pattern>/*</url-pattern> 

</filter-mapping> 


<listener> 
<listener-class> 


com.yiibai. listener .HibernateListener 


</listener-class> 
</listener> 


</web-app> 


" 





6. Action 


在 动作 类 , 可 以 通过 servlet 上 下 文 的 Hibernate 会 话 和 执行 正常 的 Hibernate 任 务 。 


CustomerAction.java 


package com.yiibai.customer.action; 


import 
import 
import 


import 
import 
import 


import 
import 
import 
import 


java.util.ArrayList; 
java.util.Date; 
java.util.List; 


org.apache.struts2.ServletActionContext; 
org.hibernate.Session; 
org.hibernate.SessionFactory; 


com.yiibai.customer.model.Customer; 
com.yiibai.listener.HibernateListener; 
com.opensymphony.xwork2.ActionSupport; 
com.opensymphony.xwork2.ModelDriven; 


public class CustomerAction extends ActionSupport 
implements ModelDriven{ 


Customer customer = new Customer(); 
List<Customer> customerList = new ArrayList<Customer>(); 


public String execute() throws Exception { 
return SUCCESS; 
j 


public Object getModel() ( 
return customer; 
j 


public List«Customer» getCustomerList() { 
return customerList; 
j 


public void setCustomerList(List«Customer» customerList) ( 
this.customerList = customerList; 
j 


//save customer 
public String addCustomer() throws Exception{ 


//get hibernate session from the servlet context 
SessionFactory sessionFactory - 
(SessionFactory) ServletActionContext.getServletConte» 
.getAttribute(HibernateListener.KEY NAME); 


Session session - sessionFactory.openSession(); 


//save it 
customer.setCreatedDate(new Date()); 


session. beginTransaction(); 
session.save(customer); 
session.getTransaction().commit(); 


//reload the customer list 
customerList - null; 
customerList = session.createQuery("from Customer").list(), 


return SUCCESS; 


} 


//list all customers 
public String listCustomer() throws Exception{ 


//get hibernate session from the servlet context 
SessionFactory sessionFactory = 
(SessionFactory) ServletActionContext.getServletConte> 


.getAttribute(HibernateListener.KEY NAME); 
Session session - sessionFactory.openSession(); 
customerList = session.createQuery("from Customer").list(), 


return SUCCESS; 


} 


«| m 








7. JSP nw 


JSP 页 面 用 来 添加 和 列 出 的 客户 。 


customer.jsp 


«9€ taglib prefix="s" uri="/struts-tags" %> 
«html» 
«head» 
</head> 


<body> 
<hi>Struts 2 + Hibernate integration example</h1> 


<h2>Add Customer</h2> 
<s:form action="addCustomerAction" > 


<s:textfield name="name" label="Name" value="" /> 
«s:textarea name="address" label="Address" value="" cols="50" rov 
<s:submit /> 

«/s:form» 


<h2>All Customers</h2> 


<s:if test-"customerList.size() > 0"> 
«table border="1px" cellpadding="8px"> 


<tr> 
<th>Customer Id</th> 
<th>Name</th> 
<th>Address</th> 
<th>Created Date</th> 
</tr> 
<s:iterator value="CustomerList" status="userStatus"> 
<tr> 
<td><s:property value="CustomerId" /></td> 
<td><s:property value="name" /></td> 
<td><s:property value="address" /></td> 
<td><s:date name="createdDate" format="dd/MM/yyyy" /><, 
</tr> 
</s:iterator> 
</table> 
</s:if> 
<br/> 
<br/> 
</body> 
</html> 


有 Eee 





8. struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
«constant name-"struts.devMode" value="true" /> 


«package name="default" namespace="/" extends="Sstruts-default"> 


<action name="addCustomerAction" 
class="com.yiibai.customer.action.CustomerAction" method="addCt 

«result name="Success">pages/customer.jsp</result> 
</action> 


«action name="listCustomerAction" 
class="com.yiibai.customer.action.CustomerAction" method="list( 

«result name="Success">pages/customer .jsp</result> 
</action> 


</package> 
</struts> 


El = 





9. 实例 测试 执行 


访 问 客 户 模块 : http://localhost:8080/struts2hibernate/listCustomerAction.action 
ea 





|) localhost:8080/struts2h x b Y 





| € © | [5 localhost:8080/struts2hibernate/listCustomerAction.action Q2 £z 
| Struts2 + Hibernate 集成 实例 


添加 顾客 


Name: 易 百 教程 
海南 海口 
Address: 


| Submit 


所 有 顾客 


Customer Id | Hane Address Created Date 
1 yiibai | Hainan Haikou | 02/12/2015 
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在 名 称 和 地 址 字段 










填写 ， 点 击 提交 按钮 ， 插 入 的 客户 的 详细 信息 会 马上 列 出 结果 。 





[' localhost:8080/struts2hi x \ 
€ > @ D localhost:8080/struts2hibernate/addCustomerAction.action 


Struts2 + Hibernate 集成 实例 
添加 顾客 


Name: 














Address: 








Eme ae [e [eme 
NN CT ce 


1. Struts2 + Hibernatef& A “Full Hibernate Plugin" 集 成 
2. ServletContextListener 文档 
3. Struts + Hibernate 集 成 实例 


代码 下 载 - http://pan.baidu.com/s/1hqhQJ7A 
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Struts2+Springt+tHibernate Fx 3: JJ - Struts2 教 
程 
在 本 教程 中 ， 它 显示 的 集成 “Struts2 + Spring + Hibernate“， 请 务必 检查 以 下 之 前 
继续 学 习 教程 。 

1. Struts2 + Hibernate 集 成 实例 

2. Struts2 + Spring 集成 实例 
参见 集成 步骤 总 结 : 
. 获取 所 有 的 依赖 库 ( 很 多 )。 


. 注册 Spring 的 ContextLoaderListener 来 整合 Struts2 和 Spring。 
. 使 用 Spring 的 LocalSessionFactoryBean 来 集成 Spring 和 Hibernate. 


.完成 所 有 连接 。 
参阅 它们 之 的 关系 : 


a 下 CN 一 


i 


Struts 2 «-- (ContextLoaderListener) --» Spring «-- (LocalSessionF: 


4 — — TH 
这 将 是 一 个 很 长 的 教程 ， 相 关 解 释 并 不 是 很 多 ， 请 务必 阅读 上 述 2 篇 文章 的 详细 情 
况 说 明 以 方面 学 习 。 

这 将 要 创建 一 个 客户 页 面 ， 以 添加 客户 和 列表 的 自 定义 函数 。 前 端 使 用 Struts2 显 
示 ，Spring 作 为 依赖 注入 引擎 ， 而 Hibernate 用 来 执行 数据 库 操作 。 让 我 们 开始 .… 





1. 工程 文件 夹 结构 
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在 本 章 中 ， 我 们 创建 一 个 ssh 的 web 工 程 ， 工 程 的 目录 结构 如 下 图 所 示 : 


4 49 ssh 
4 $9 src 
4 [B comyiibai 
> [D HibernateSessionFactory.java 
4 {8 comyiibai.customer.action 
> JI) CustomerAction,java 
4 §§ comyiibai.customer.bo 
> [D CustomerBo,java 
4 册 comyiibai.customer.bo.impl 
> [D CustomerBolmpl.java 
4 [B comyiibai.customer.dao 
> [D CustomerDAO java 
4 {8 comyiibai.customer.dao.impl 
> jJ] CustemerDAOImpl.java 
4 {B com yiibai.customer.hibernate 
& Customer.hbm.xml 


4 {8 comyiibai.customer.model 





>》 Customerjava 
4 {B comyiibai.customer.spring 
Æ CustomerBean.xml 
4 {B config.database.properties 
database.properties 
4 {B config.spring 
Æ DataSource.xml 
Æ HibernateSessionFactory.xml 


Æ SpringBeans.xml 
VE struts.xml 
mi, JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
ES) Struts 2 Core Libraries 
= Hibernate 3.2 Core Libraries 
mà MySQL 
Bi Struts 2 Spring Libraries 
BA Spring 2.5 Core Libraries 
BA Spring 2.5 Persistence Core Libraries 
4 (£» WebRoot 
( META-INF 
4 (£ pages 
[P customer jsp 
4 (z» WEB-INF 
& lib 
R? spring-form.tld 
R? spring.tld 
[Xf web.xml 
|J? indexjsp 


2. MySQL 表 结构 结构 
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z P (customer) zhi A, 


DROP TABLE IF EXISTS ‘yiibai . customer ; 
CREATE TABLE ‘yiibai . customer" ( 
"CUSTOMER ID' bigint(20) unsigned NOT NULL AUTO INCREMENT, 
"NAME, varchar(45) NOT NULL, 
"ADDRESS" varchar(255) NOT NULL, 
"CREATED DATE, datetime NOT NULL, 
PRIMARY KEY (CUSTOMER ID) 
) ENGINE-InnoDB AUTO INCREMENT-17 DEFAULT CHARSET=utf8; 


3. Hibernate 相 关 配 置 


只 有 模型 和 了 映射 文件 是 必需 的 ， 因 为 这 里 要 用 Spring 处 理 Hibernate 配 置 。 
Customer.java 一 创建 客户 表 对 应 的 一 个 类 。 


package com.yiibai.customer.model; 

import java.util.Date; 

public class Customer implements java.io.Serializable { 
private Long customerId; 
private String name; 
private String address; 


private Date createdDate; 


//getter and setter methods 


Customer.hbm.xml 一 Hibernate 的 客户 映射 文件 。 


<?xml version="1.0"?> 
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"» 
«!-- Generated 20 Julai 2010 11:40:18 AM by Hibernate Tools 3.2.5.t 
<hibernate-mapping> 
«class name="Ccom.yiibai.customer.model.Customer" 
table-"customer" catalog="yiibai"> 
«id name="CustomerId" type="java.lang.Long"> 
<column name="Customer_id" /> 
<generator class="identity" /> 
</id> 
<property name="name" type="string"> 
<column name="name" length="45" not-null="true" /> 
</property> 
«property name="address" type="string"> 
<column name="address" not-null="true" /> 
</property> 
<property name="createdDate" type="timestamp"> 
«column name="create_date" length="19" not-null-"true" 
</property> 
</class> 
</hibernate-mapping> 





5. Struts2 相 关 


实现 了 Bo 和 DAO 设计 模式 。 所 有 Bo 和 DAO 将 由 Spring Spring bean 配 置 文件 注 
入 。 在 DAO 中 ， 让 它 扩 展 Spring 的 HibernateDaoSupport 来 集成 Spring 和 
Hibernate。 


CustomerBo.java 


package com. yiibai.customer.bo; 


import java.util.List; 
import com.yiibai.customer.model.Customer; 


public interface CustomerBo{ 


void addCustomer(Customer customer); 
List«Customer» listCustomer(); 


CustomerBolmpl.java 


package com.yiibai.customer.bo.impl; 


import java.util.List; 

import com.yiibai.customer.bo.CustomerBo; 
import com.yiibai.customer.dao.CustomerDAO; 
import com.yiibai.customer.model.Customer; 


public class CustomerBoImpl implements CustomerBof{ 


CustomerDAO customerDAO; 

//DI via Spring 

public void setCustomerDAO(CustomerDAO customerDAO) { 
this.customerDAO - customerDAO; 


j 


//call DAO to save customer 
public void addCustomer(Customer customer ) { 
customerDAO.addCustomer(customer); 


j 


//call DAO to return customers 
public List<Customer> listCustomer(){ 
return customerDAO.listCustomer(); 


} 


CustomerDAO.java 


package com.yiibai.customer.dao; 


import java.util.List; 
import com.yiibai.customer.model.Customer; 


public interface CustomerDAO( 


void addCustomer(Customer customer); 
List<Customer> listCustomer(); 


CustomerDAOImpl.java 


package com. yiibai.customer.dao.impl; 


import java.util.List; 

import org.springframework.orm.hibernate3. support .HibernateDaoSuppc 
import com.yiibai.customer.dao.CustomerDAO; 

import com.yiibai.customer.model.Customer; 


public class CustomerDAOImpl extends HibernateDaoSupport 
implements CustomerDAO( 


//add the customer 

public void addCustomer(Customer customer ) { 
getHibernateTemplate().save(customer); 

} 


//return all the customers in list 
public List<Customer> listCustomer(){ 
return getHibernateTemplate().find( "from Customer"); 





CustomerAction.java — Struts2 的 动作 不 再 需要 扩展 ActionSupport， 它 将 由 
Spring 来 义理 。 


package com.yiibai.customer.action; 


import java.util.ArrayList; 
import java.util.Date; 
import java.util.List; 


import com.yiibai.customer.bo.CustomerBo; 
import com.yiibai.customer.model.Customer; 
import com.opensymphony.xwork2.ModelDriven; 


public class CustomerAction implements ModelDriven{ 


Customer customer - new Customer(); 
List«Customer» customerList = new ArrayList«Customer»(); 


CustomerBo customerBo; 

//DI via Spring 

public void setCustomerBo(CustomerBo customerBo) ( 
this.customerBo - customerBo; 

} 


public Object getModel() { 
return customer; 
j 


public List<Customer> getCustomerList() { 
return customerList; 
j 


public void setCustomerList(List<Customer> customerList) { 
this.customerList = customerList; 
} 


//save customer 

public String addCustomer() throws Exception{ 
//save it 
customer .setCreatedDate(new Date()); 
customerBo.addCustomer(customer); 
//reload the customer list 
customerList - null; 
customerList = customerBo.listCustomer(); 
return "success"; 


} 


//list all customers 
public String listCustomer() throws Exception{ 


customerList - customerBo.listCustomer(); 


return "success"; 


6. Spring 相关 配置 


几乎 所 有 的 配置 都 是 在 这 里 完成 是 由 Spring 专门 来 整合 。 
CustomerBean.xml — 声明 Spring 的 bean : Action, BO 和 DAO. 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/bean: 
http://www.springframework.org/schema/beans/spring-beans-2.5.x: 


«bean id="customerAction" class="com.yiibai.customer.action.Ct 
«property name="CcustomerBo" ref="CustomerBo" /> 
</bean> 


«bean id="customerBo" class-'com.yiibai.customer.bo.impl.Custor 
«property name="CustomerDAO" ref-z'customerDAO" /> 
</bean> 
<bean id-"customerDAO" class="com.yiibai.customer.dao.impl. ( 
«property name="SessionFactory" refz'"sessionFactory" /> 
</bean> 
</beans> 


i R 


database.properties — 声明 数据 库 详 细 信 息 





jdbc.driverClassName=com.mysql.jdbc.Driver 
jdbc.url=jdbc:mysql://localhost:3306/yiibai 
jdbc.username=root 

jdbc .password=password 


DataSource.xml - 创建 一 个 数据 库 源 的 Bean 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd'» 


«bean 
class="org.springframework.beans.factory.config.PropertyPlaceho- 
<property name="location"> 

<value>WEB- INF/classes/config/database/properties/database. prc 
</property> 
</bean> 


<bean id="dataSource" 
class="org.springframework. jdbc.datasource.DriverManagerDé 
«property name="driverClassName" value="${jdbc.driverClassName_ 
«property name="url" value="${jdbc.url}" /> 
«property name="username" value="${jdbc.username}" /> 
<property name="password" value="${jdbc.password}" /> 
</bean> 


</beans> 


ae: 





HibernateSessionFactory.xml — 创建 一 个 SessionFactory Bean 来 集成 Spring 和 
Hibernate。 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://ww.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<!-- Hibernate session factory --> 
<bean id="sessionFactory" 
class="org.springframework.orm.hibernate3.LocalSessionFactor yBe 


«property name="dataSource"> 
«ref bean="dataSource"/> 
</property> 


<property name="hibernateProperties"> 
<props> 
«prop key="hibernate.dialect">org.hibernate.dialect.MySQLI 
«prop key="hibernate.show_sql">true</prop> 
</props> 
</property> 


<property name="mappingResources"> 
<list> 
«value»com/yiibai/customer/hibernate/Customer.hbm.xmlc/v: 
</list> 
</property> 


</bean> 
</beans> 


E = 8 


SpringBeans.xml — 创建 一 个 核心 Spring 的 bean 配置 文件 ， 作 为 中 央 的 bean € 
HE. 





«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z"http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-2.5.xsd"> 


<!-- Database Configuration --> 
«import resource="config/spring/DataSource. xml"/> 
«import resource-'config/spring/HibernateSessionFactory.xml"/» 


«!-- Beans Declaration --> 
«import resource="com/yiibai/customer/spring/CustomerBean. xml", 


«/beans» 





ls] 





7. JSP nw 


JSP 页 面 来 显示 使 用 Struts2 标签 的 元 素 。 


customer.jsp 


«99 taglib prefix="s" uri="/struts-tags" %> 
<html> 
<head> 
</head> 


<body> 
<hi>Struts 2 + Spring + Hibernate integration example</h1i> 


<h2>Add Customer</h2> 
<s:form action="addCustomerAction" > 


<s:textfield name="name" label-"Name" value="" /> 
«s:textarea name="address" label="Address" value="" cols="50" rov 
<s:submit /> 

«/s:form» 


<h2>All Customers</h2> 


<s:if test-"customerList.size() > 0"> 
«table border="1px" cellpadding="8px"> 


<tr> 
<th>Customer Id</th> 
<th>Name</th> 
<th>Address</th> 
<th>Created Date</th> 
</tr> 
<s:iterator value="CustomerList" status="userStatus"> 
<tr> 
<td><s:property value-"customerId" /></td> 
<td><s:property value="name" /></td> 
<td><s:property value="address" /></td> 
<td><s:date name="createdDate" format="dd/MM/yyyy" /><, 
</tr> 
</s:iterator> 
</table> 
</s:if> 
<br/> 
<br/> 
</body> 
</html> 


«| EE 











8. struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 


"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 
«constant name-"struts.devMode" value-"true" /» 


«package name="default" namespace="/" extends-'struts-default": 


«action name-"addCustomerAction" 
class-"customerAction" method="addCustomer" > 


«result name="Success">pages/customer .jsp</result> 
</action> 


<action name="listCustomerAction" 
class="customerAction" method="listCustomer" > 
«result name="Success">pages/customer .jsp</result> 
</action> 
</package> 
</struts> 


EE 





9. Struts 2 + Spring 


要 集成 Struts2 和 Spring， 只 需 注 册 ContextLoaderListener 监 听 器 类 ， 定 义 一 


个 "contextConfigLocation" 参 数 要 求 Spring 容器 来 解析 "SpringBeans.xml”， 而 不 使 
用 默认 的 “applicationContext.xml”。 


web.xml 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app 2 3.dtd" > 


«web - app» 
<display-name>Struts 2 Web Application</display -name> 


<filter> 
<filter -name>struts2</filter -name> 
<filter-class> 
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExect 
</filter-class> 
</filter> 


<filter -mapping> 
<filter -name>struts2</filter -name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


<context -param> 
<param-name>contextConfigLocation</param-name> 
<param-value>/WEB-INF/classes/SpringBeans. xml</param-value> 
</context -param> 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 


</web-app> 
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在 浏览 器 中 打开 网 址 http://localhost:8080/ssh/listCustomerAction.action 





Struts2 + = + -— 
添加 顾客 
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Struts2 + Spring + Hibernate 集 成 实例 
添加 顾客 
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2. Struts2 + Spring 集成 实例 
3. Struts2 + Hibernate 使 用 Full Hibernate Plugin 插 件 集成 


代码 下 载 - http://pan.baidu.com/s/1mgzt1Xm ( 含 ssh 相 关 类 库 ， 详 见 lib 目录 ， 文 
件 大 小 约 : 18M)。 
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Struts2+Log4j 集 成 - Struts2 教 程 


在 本 教程 中 ， 我 们 学 习 如 何 将 log4j 框 架 在 Struts2 的 Web 应 用 程序 集成 。 所 有 需要 做 


的 有 : 


1. 包含 log4j.jar 作为 项 目 依赖 
2. 创建 一 个 log4j.properties 文件 ， 并 把 它 放 入 classpath 的 根 目 录 - 放 到 资源 文 


Fkh, 
相关 技术 和 工具 的 使 用 : 


1. Log4j 1.2.17 
2. Struts 2.1.8 

3. Tomcat 6 

4. MyEclipse 10 


1. 工程 结构 


这 里 我 们 创建 一 个 web 工 程 为 
4 È struts2log4j 
4 (8 src 
4 iH com yilbai.common.action 
四 WelcomeAction.java 
log4j.properties 
Et struts.xml 


: struts2log4j， 参 见 下 面 最 终 的 工程 结构 : 


mA JRE System Library [Sun JDK 1.6.0 13 


Ej, Java EE 6 Libraries 
=) Struts 2 Core Libraries 
4 BÀ Log4j 


m log4j-1.2.17 Jar D:\software\libraries\apache-log4j 


4 世 WebRoot 
& META-INF 
(& pages 
(£z WEB-INF 


J? indexjsp 


2. log4j.properties 


创建 log4j 的 属性 文件 ， 并 把 它 放 入 资源 文件 夹 ， 请 参阅 步骤 站 1。log4j.properties 


# Root logger option 
log4j.rootLogger=ERROR, stdout, file 


# Redirect log messages to console 

log4j .appender.stdout=org.apache.1log4j .ConsoleAppender 
10og4j.appender.stdout.Target-System.out 
log4j.appender.stdout.layout-org.apache.log4j.PatternLayout 
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm 


# Redirect log messages to a log file, support rolling backup file 
log4j.appender.file-org.apache.log4j.RollingFileAppender 
log4j.appender.file.File=${catalina.home}/logs/mystruts2app.log 
log4j.appender.file.MaxFileSize-5MB 
log4j.appender.file.MaxBackupIndex-10 
log4j.appender.file.layout-org.apache.log4j.PatternLayout 
1og4j.appender.file.layout.ConversionPattern-?«d(yyyy-MM-dd HH:mm:s: 


" M 





4. Struts2 Action 和 Logging 


一 个 简单 的 动作 返回 一 个 页 面 ， 并 显示 了 如 何 来 执行 log4j 消息 日 志 记 录 。 
WelcomeAction.java 


package com. yiibai.common.action; 


import org.apache.10g4j.Logger; 
import com.opensymphony.xwork2.ActionSupport; 


public class WelcomeAction extends ActionSupport { 
private static final long serialVersionUID - 1L; 


//get log4j 
private static final Logger logger = Logger.getLogger(WelcomeA: 


public String execute() throws Exception ( 
// logs debug message 


if (logger.isDebugEnabled()) ( 
logger.debug("execute()!") 
} 


// logs exception 
logger.error("This is Error message", new Exception("Testir 


, 


return SUCCESS; 





5. Struts2 配 置 


Struts2 的 配置 和 JSP 页 面 ， 如 果 想 了 解 的 话 。 struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"» 


«struts» 
«constant name-"struts.devMode" value-"true" /» 


«package name="welcome" namespace="/" extends-'struts-default": 
«action name-"welcome" class-"com.yiibai.common.action.Wel: 
«result name="Success">pages/success. jsp</result> 
</action> 
</package> 


</struts> 


a 





web.xml 


«web-app xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xm1/ns/javaee/web-app. 2 5.xsd" 
version-z"2.5"» 


<display-name>Struts 2 Web Application</display -name> 


<filter> 
<filter-name>struts2</filter -name> 
<filter-class> 
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAr 
</filter-class> 
</filter> 


<filter -mapping> 
<filter -name>struts2</filter -name> 
<url-pattern>/*</url-pattern> 
</filter -mapping> 


</web-app> 
[E E) 





pages/success.jsp 
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<%@ taglib prefix="s" uri="/struts-tags" %> 
<html> 
<head> 
</head> 


<body> 
<hi>Struts 2 + Log4j integration example</h1> 


</body> 
</html> 


6. 实例 测试 


运行 Struts 2 的 Web 应 用 程序 ， 并 访问 Welcome 的 动作 。 
在 浏览 器 中 打开 URL : http://localhost:8888/struts2log4j/welcome 
6.1 所 有 日 志 消 息 将 显示 在 控制 台中 。 





(9 MyEclipse Web Browser 25 i c m] 





http://localhost:8080/struts2log4j/welcome.action - 3X 0-0 e aa 


Struts2 + Log4j 集成 实例 


| 区 Problems | 4] Tasks 45 Servers a X X | Ex BH BGE mE-T3--H| 
myeclipseTomcatServer [Remote Java Application] D:\Program Files (x86)\MyEclipse\Common\binary\com.sun,java.jdk.win32.x86_64_1.6.0.013\bin\j 
ZU15-1Z-Z ZU:Z5:13 Org.apacne JK.server JKivialri Start ] i j E E 1 
信息 : Jk running ID=0 time=0/26 config=null 
2015-12-2 20:25:13 org.apache.catalina.startup.Catalina start 
信息 : Server startup in 7317 ms 
2015-12-02 20:25:27 ERROR WelcomeAction:21 - 这 是 一 条 错误 消息 ! 
java.lang.Exception: 只 是 测试 异常 抛 出 

at com,yiibai.common.action.WelcomeAction.execute(WelcomeAction.java:21) |= 

at sun.reflect.NativeMethodAccessoriImpl.invokeO(Native Method) 

at sun.reflect.NativeMethodAccessorimpl.invoke(NativeMethodAccessorimpl.java:39) 

at sun.reflect.DelegatingMethodAccessorimpl.invoke(DelegatingMethodAccessorimpl.java:25) 

at java.lang.reflect. Method.invoke(Method,.java:597) 

at com.opensymphony.xwork2.DefaultActionInvocation.invokeAction(DefaultActionInvocation.java:452) 

at com.opensymphony.xwork2.DefaultActionInvocation.invokeActionOnly(DefaultActionInvocation.java:291) 

at com.opensymphony.xwork2.DefaultActionInvocation.invoke(DefaultActionInvocation.java:254) 

at com.opensymphony.xwork2.interceptor.DefaultWorkflowInterceptor.doIntercept(DefaultWorkflowInterceptor.java:176) 








^ 


Figure : Eclipse 终端 


6.2 此 外 ， 日 志文 件 将 在 Tomcat 的 日 志文 件 夹 中 被 创建 。 
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图 片 : C:\mystruts2app.log 
FARA - http://pan.baidu.com/s/1nt7yVep 
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| ol ð| X% 
A mE, 、 计 算 机 ， Win7x64 (C) » >| +s] ^»! 
XP) RREO SEV IRM aH) — 
组 织 ~ Gary Hm 新 建文 件 夫 Ey Ol @ 
i 全 名称 修改 日 期 aem 大 小 
(8) setupinfidb.db 2015/11/9 16:52 Data Base File 5 KB 
E Sm Li setup.log 2015/11/9 16:05 ”文本 文档 1KB 
= L| mystruts2app.log 2015/12/220:25 文本 文档 0 KB 
Aie | (Smeg RE o T Veni 
"HM RAO S80 BO SEW AH : 
&& Win7x64 (C) 2015-12-02 20:25:27 ERROR WelcomeAction:21 - 这 是 一 条 错误 消息 ! ^ 
cs 软件 (D) java. lang. Exception: 只 是 测试 异常 抛 出 
文档 (E: at com. ylibai. common. action. WelcomeAction. execute (WelcomeAction. j 
Ea (E) at sun. reflect. NativellethodAccessorImpl. invokeO (Native Method) 
ca fe (F) = at sun. reflect. NativellethodAccessorI mpl. invoke (Nativelethod&ccess 
[T at sun. reflect. Ven apr i-a E im egatingMetk = 
at java. lang. reflect. Method. invoke (Method. java:597 
A 控制 面板 at com. opensymphony. xwork2. Default&ctionInvocation. invokeAction(L 
© wee at com. opensymphony. xwork2. DefaultActionInvocation. invokeActionOr 
vo at com. opensymphony. xwork2. DefaultActionInvocation. invoke (Defaul t| _ 
Ji B_1.2.6 设 计 图 at com. opensymphony. xwork2. interceptor. DefaultWorkflowInterceptor 
J Log4jAndStruts: at com. opensymphony. xwork2. interceptor. MethodFilterInterceptor. ir 
: at com. opensymphony. xwork2. DefaultActionInvocation. invoke (Default 
Ji settings at com. opensymphony. xwork2. validator. ValidationInterceptor. doInte 
J bin at org. apache. struts2. interceptor. validation. AmnotationValidatior 
B at com. opensymphony. xwork2. interceptor. MethodFilterInterceptor. ir 
src Sat DIE Ske Sees Seine eae ee ae ey RO Sinus eta 
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Struts2 配 置 Action 类 的 静态 参数 - Struts2 教 程 


在 某 些 情况 下 ， 可 能 需要 一 个 Action 类 分 配 一 些 预定 义 或 静态 的 参数 值 。 


为 动作 定义 静态 参数 
在 Struts2， 可 以 在 struts.xml 文件 中 的 通过 标记 进行 配置 ， 例 如 ， 


struts.xml 


<struts> 


«constant name="struts.custom.ii8n.resources" value="global" /> 
«constant name="Struts.devMode" value="true" /> 


«package name="default" namespace="/" extends="Sstruts-default"> 
«action name="locale" class="com.yiibai.common.action.LocaleAct 
<result name="SUCCESS">pages/welcome. jsp</result> 
<param name="EnglishParam">English</param> 
<param name="ChineseParam">Chinese</param> 
<param name="FranceParam">France</param> 
</action> 
</package> 
</struts> 


EJE 


它 分 配 三 个 预定 义 的 参数 值 到 LocaleAction Action 3 


从 动作 获取 静态 参数 


要 从 struts.xml 中 获取 静态 参数 值 ，Action 类 必须 实现 参数 化 Parameterizable 接 口 。 
动作 的 静态 参 数 是 由 staticParams 拦 截 ， 其 中 包括 在 默认 堆栈 控制 


动作 的 静态 参数 是 由 staticParams 拦 截 ， 包 括 在 默认 堆栈 “struts-default.xml” 中 控 
制 。 





1. Map 属 性 


在 操作 类 初始 化 期 间 ，staticParams 拦 截 器 将 通过 动作 类 的 setParams() 方 法 获取 预 
先 定义 的 参数 值 。 


V 
import com.opensymphony.xwork2.config.entities.Parameterizable; 


public class LocaleAction implements Parameterizable{ 
Map<String, String> params; 
A 


public void setParams(Map<String, String> params) { 
this.params = params; 
j 


2. JavaBean 属性 


在 动作 类 的 初始 化 ， 如 果 创 建 了 getter 和 setter 方 法 得 当 ，staticParams 拦 截 器 将 设 
置 预先 定义 的 参数 值 ， 以 对 应 于 该 “参数 "的 每 JavaBean 属 性 。 


One 
import com.opensymphony.xwork2.config.entities.Parameterizable; 


public class LocaleAction implements Parameterizablef{ 
String englishParam; 
String chineseParam; 
String franceParam; 
public String getEnglishParam() { 


return englishParam; 
} 


public void setEnglishParam(String englishParam) { 
this.englishParam = englishParam; 
} 


public String getChineseParam() { 
return chineseParam; 
} 


public void setChineseParam(String chineseParam) { 
this.chineseParam = chineseParam; 
} 


public String getFranceParam() { 
return franceParam; 
} 


public void setFranceParam(String franceParam) { 
this.franceParam - franceParam; 
} 


are 


2. 运行 实例 


在 浏览 器 中 打开 URL : http://localhost:8080/configure-param/locale.action 
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| € > C BG localhost:8080/configure-param/locale.action ax = 
Struts2 动 作 静 态 参 数 实 例 


Engli sh 





Chinese 
France 





代码 下 载 (configure-param) - http://pan.baidu.com/s/1dDmGDK9 
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Struts2 下 载 文 件 实例 - Struts2 教 程 


这 是 一 个 Struts2 的 例子 来 说 明 使 用 定制 返回 类 型 ， 人 允许 用 户 下载 文 件 。web 工 程 的 
4 5$ struts2download 
4 (8 src 
4 {8 com.yiibai.common.action 
加 DownloadActionjava 
Tt struts.xml 
=) JRE System Library [Sun JDK 1.6.0 13] 
mi Java EE 6 Libraries 
ES Struts 2 Core Libraries 
4 区 WebRoot 
(z» META-INF 
4 & pages 
J” downloadPage.jsp 
@ WEB-INF 
JP indexjsp 


文件 夹 结 构 如 下 所 示 : 


1. Action 


在 Action 类 中 ， 声 明 一 个 InputStream 的 数据 类 型 和 getter 方 法 。 


DownloadAction.java 


package com.yiibai.common.action; 

import java.io.File; 

import java.io.FileInputStream; 

import java.io.InputStream; 

import com.opensymphony.xwork2.ActionSupport; 

public class DownloadAction extends ActionSupport{ 
private InputStream fileInputStream; 
public InputStream getFileInputStream() { 


return filelnputStream; 
j 


public String execute() throws Exception ( 
fileInputStream = new FileInputStream(new File("C:NMfile-f« 
} 


7 | 一 E 








2. 视图 文件 
一 个 正常 的 页 面 ， 有 一 个 下 载 链接 ， 用 于 下 载 文 件 。 


downloadPage.jsp 


«99 taglib prefix="s" uri="/struts-tags" %> 
<html> 


<body> 
<hi>Struts 2 download file example</h1> 


«s:url id-"fileDownload" namespace="/" action="download" ></s:url> 


<div><div class-"ads-in-post hide if width less 800"> 

<script async srcz"//pagead2.googlesyndication.com/pagead/js/adsbyt 

<!-- 728x90 - After2ndH4 --» 

«ins class-"adsbygoogle hide if width less 800" 
style="display:inline-block;width:728px; height :90px" 
data-ad-client="ca-pub-2836379775501347" 
data-ad-slot="3642936086" 
data-ad-region="yiibairegion"></ins> 

<script> 

(adsbygoogle = window.adsbygoogle || []).push({}); 

</script> 

</div></div><h2>Download file - <s:a href="%{fileDownload}">fileAB( 

</h2> 


</body> 
</html> 


JEJE) 





3. struts.xml 


定义 下 载 文件 的 细节 。 <param name="inputName”> 值 是 从 Action 的 InputStream 
属性 的 名 称 。 


阅读 Struts2 的 数据 流 结果 文档 以 了 解 更 详细 信息 。 


struts.xml 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
«constant name-"struts.devMode" value="true" /> 


«package name="default" namespace="/" extends="Sstruts-default"> 
«action name="show"> 
«result name="Success">pages/downloadPage. jsp</result> 
</action> 


«action name="download" class="com.yiibai.common.action.Downloac 
<result name="Success" type="stream"> 
«param name="contentType">application/octet-stream</param> 
«param name="inputName">fileInputStream</param> 
«param name="contentDisposition">attachment ; filename="file- Fc 
</result> 
</action> 
</package> 


</struts> 


uoo B 





4. 执行 结 来 
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在 浏览 器 中 打开 : http://localhost:8080/struts2download/ — - 


/ [35 www.yiibai.com 


| € > C [3localhost8080/struts2download/show.action Q sv 
Struts2 下 载 文件 实例 


Ff: file-for— download. txt 





1. http://struts.apache.org/2.x/docs/stream-result.html 

2. http://www.iana.org/assignments/media-types/ 

3. http://www.yiibai.com/struts/struts-download-file-from-website-example.html 

4. http://www.yiibai.com/java/how-to-download-file-from-website-java-jsp.html 

5. http://struts.apache.org/2.x/docs/how-can-we-return-a-text-string-as-the- 
response.html 


代码 下 载 (struts2download) - http://pan.baidu.com/s/1jGg0Lzo 
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Struts2 和 JSON 实 例 - Struts2 教 程 


在 这 个 Struts2 例 子 ， 将 学 习 如 何 通 过 “struts2-json-plugin.jar 库 将 对 象 转 换 为 JSON 
格式 的 数据 。 


1. Action (JSON) 


这 是 一 个 将 被 转换 成 JSON 格 式 的 Action 类 。 


package com 


import 
import 
import 
import 


import 


public 


java. 
java. 
java. 
java. 


.yiibai.common.action; 


util.ArrayList; 
util.HashMap; 
util.List; 
util.Map; 


com.opensymphony. xwork2.Action; 


class 


private 
private 
private 
private 
private 
private 


JSONDataAction{ 


String stringi = "A"; 


String[] stringarray1 = {"Ai","Bi"}; 


int number1 = 123456789; 


int[] numberarray1 = {1,2,3,4,5,6,7,8,9}; 
List<String> lists = new ArrayList<String>(); 


Map<String, String> maps 


new HashMap<String, 


//no getter method, will not include in the JSON 
private String string2 = "B"; 


public JSONDataAction()f{ 


} 


list 
list 
list 
list 
list 


maps 
maps 
maps 
maps 
maps 


s.add("list1"); 
s.add("list2"); 
s.add("list3"); 
s.add("list4"); 
s.add("list5"); 


.put("key1", "value1"); 
.put("key2", "value2"); 
.put("key3", "value3"); 
.put("key4", "value4"); 
.put("key5", "value5"); 


public String execute() ( 


j 


return Action.SUCCESS; 


String?! 


public String getStringi() { 
return stringi; 
} 


public void setStringi(String stringi) { 
this.string1 = string1; 
} 


public String[] getStringarray1() { 
return stringarray1; 
j 


public void setStringarray1(String[] stringarray1) { 
this.stringarray1 = stringarrayi; 
} 


public int getNumber1() { 
return number1; 
} 


public void setNumberi(int numberi) { 
this.number1 = number1; 
} 


public int[] getNumberarray1() { 
return numberarray1; 
j 


public void setNumberarrayi(int[] numberarray1) { 
this.numberarray1 = numberarrayi; 
} 


public List<String> getLists() { 
return lists; 
} 


public void setLists(List<String> lists) { 
this.lists = lists; 
} 


public Map<String, String> getMaps() { 
return maps; 
} 


public void setMaps(Map<String, String> maps) { 
this.maps = maps; 
} 











3. struts.xml 


要 输出 JSON 数 据 ， 需 要 声明 一 个 包 ， 它 扩展 "json-default*， 会 将 结果 类 型 转 
为 "json”。 


<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
«constant name-"struts.devMode" value="true" /> 


<package name="default" namespace="/" extends="json-default"> 
<action name="getJSONResult" 
class="com.yiibai.common.action. JSONDataAction"> 
<result type="json" /> 
</action> 
</package> 


</struts> 


OE EE M 


4. 实例 


访问 动作 URL 时 ，JSONDataAction 属 性 将 被 转换 成 JSON 格 式 。 
http:/Nocalhost:8080/struts2json/getJSONResult.action 





ree) 





D 无 法 访问 http://localhos x \ 





€ C | D localhost:8080/struts2json/geUSONResult.action — Q v? 三 | 
I'lists" : ["List-1", “List-2", "list-3", "List-4", "list-5"], "maps" 


{"key4": "value4", "key3" : "value3", "key5" : "value5", "key2": "value2", "keyl":"valuel"], "numberl":12345 
6789, "numberarrayl":[1,2,3,4,5, 5, 1, 8, 8], "stringl": "A", "stringarrayl": ["A1", "B1"]] 

















JSON f& x ... 


{ 
UIESES a lst se list -2 ee lists 7 ist =4 St Sue 
"maps": 
{ 
"key4":"value4", "key3":"value3", "key5":"value5", "key2":"value: 


3 
"number1":123456789, 


"numberarray1":[1,2,3,4,5,6,7,8,9], 
"string1":"A", 
"stringarrayi":["A1","B1i"] 


} 








‘| 


希望 这 个 简单 的 例子 可 以 了 解 JSON 插 件 在 Struts2 是 如 何 工作 的 有 一 个 总 体 的 思 
路 。 不 过 ， 还 是 有 很 多 有 用 的 参数 不 包括 在 这 里 ， 请 务必 阅读 Struts2 JSON 插 件 文 
档 以 获取 更 多 详细 信息 。 下 载 源 代码 (struts2json) 一 
http://pan.baidu.com/s/1bnv8l9X 


SWING 教程 


JAVA 提供 了 一 组 丰富 的 平台 无 关 的 方式 来 创建 图 形 用 户 界 面 的 库 。 在 这 篇 文章 
中 ， 我 们 将 学 习 Swing GUI 控件 。 


读者 


本 教程 是 专 为 愿意 学 习 JAVA GUI 编程 软件 专业 人 员 提 供 简 单 轻松 的 学 习 步 又 。 本 
教程 会 给 你 很 大 的 JAVA GUI 编程 概念 的 理解 ， 并 完成 本 教程 后 可 以 把 自己 的 专业 知 
识 技术 提升 到 一 个 较 高 的 水 平 。 


前 提 条 件 


继续 本 教程 之 前 ， 你 应 该 有 一 个 基本 的 了 解 Java 编 程 语言 ， 文 本 编辑 器 和 执行 程序 
等 


Swing 介绍 - Swing 


Swing API 可 扩展 GUI 组 件 ， 以 减轻 开发 者 的 生活 创造 基于 JAVA 前 端 /GUI 应 用 。 它 
是 建立 在 AWT API 之 上 ， 并 作为 AWT API 的 更 换 ， 因 为 它 几 乎 每 一 个 控制 对 应 
AWT 控 制 。 Swing 组 件 遵循 模型 - 视图 - 控制 器 架构 ， 以 满足 以 下 标准 。 


e 一 个 单一 的 API 是 足够 支持 多 种 外 观 和 风格 。 
e API 模拟 驱动 ， 使 最 高 级 别 的 API 不 要 求 有 数据 。 
e API 使 用 Java Bean 的 模式 ， 使 生成 工具 和 IDE 可 以 提供 更 好 的 服务 给 开发 者 使 


Fit. 


MVC% 4j 


Swing API 架 构 如 下 松散 的 ， 基 于 MVC 架 构 ， 以 下 列 方式 支付 。 
。 模型 表示 组 件 的 数据 。 
e 查看 代表 组 件 的 数据 可 视 化 表示 形式 。 
e 控制 器 采用 的 视图 上 的 用 户 输入 ， 并 在 组 件 的 数据 的 变化 反映 。 


e Swing 组 件 模型 作为 一 个 单独 的 元 素 和 景观 ， 是 棒状 控制 器 部 分 用 户 界 面 中 的 
元 素 。 使 用 这 种 方式 ，Swing 具 有 可 插 拔 的 外 观 与 风格 架构 。 


Swing 特点 
e 重量 轻 - Swing 组 件 是 独立 的 原生 操作 系统 的 AP 与 Swing API 控 件 呈 现 大 多 采 
用 纯 JAVA 人 代码， 而 不 是 底层 的 操作 系统 调用 。 
e 丰富 的 控件 - Swing 提供 了 一 套 丰富 的 先进 的 控制 系统 ， 如 树 ， 
JTabbedPane， 滑 块 ， 颜 色 选 择 器 ， 表 格 控件 
e 高 度 可 定制 - Swing 控件 可 以 定制 视觉 外 观 是 非常 简单 的 方法 ， 独 立 的 内 部 表 
7JNo 


e 可 插 拔 的 外 观 和 感觉 - 基于 Swing GUI 应 用 程序 外 观 和 风格 基于 可 用 值 ， 可 以 
在 运行 时 改变 。 


Swing f k HRR - Swing 


本 节 闻 指导 如 何 下 载 和 设置 Java 在 您 的 机 器 上 。 请 按照 下 列 步 又 来 设置 环境 。 
Java SE 是 免费 的 ， 提 供 的 链接 下 载 Java。 所 以 根据 您 的 操作 系统 ， 下 载 一 个 版 


o 


按照 说 明 下 载 java 和 运行 .exe 在 你 的 机 器 上 安装 Java。 一 旦 在 机 器 上 安装 了 
Java， 还 需要 设置 环境 变量 指向 正确 的 安装 目录 : 


对 于 Windows 2000/XP/win7 路 径 : 


假设 您 已 经 安装 了 Java 在 c:Program Filesjavajdk 目录 : 
e 右键 单 击 ' 我 的 电脑 并 选择 ' 属 性 '。 
。 点 击 "环境 变量 ' 按钮 下 ' 高 级 ' 标签 。 


e 现在 在 ' 路 径 ' 变量 ， 它 也 包含 Java 可 执行 文件 的 路 径 。 例如 ， 如 果 路 径 当前 设 
EA 'C:WINDOWSSYSTEM32', 然后 可 更 改 你 的 路 径 为 
'C:WINDOWSSYSTEM32;c:Program Filesjavajdkin'. 


适用 于 Linux，UNIX，Solaris 和 FreeBSD 的 路 径 : 
应 设置 环境 变量 PATH 指向 Java 二 进 制 文件 已 经 安装 。 如 果 你 这 样 做 有 困难 ， 请 参 
阅 shell 文 件 。 


例如 ， 如 果 使 用 bash 作 为 shell， 添 加 以 下 行 到 结束 行 “.bashrc 文 件 中 : '.bashrc: 
export PATH=/path/to/java:$PATH' 


流行 的 Java 编 辑 器 : 
编写 Java 程 序 ， 需 要 一 个 好 的 文本 编辑 器 。 在 市 场 上 有 更 复杂 的 IDE。 但 现在 ， 可 
以 考虑 以 下 两 种 : 


e 记事 本 : 在 Windows 机 器 上 ， 你 可 以 使 用 任何 简单 的 文本 编辑 器 (如 记事 本 ) 
(本 教程 推荐 TextPad) 。 


e Netbeans : 是 一 个 Java IDE， 它 是 开源 和 免费 ， 可 下 载 
http://www.netbeans.org/index.htmll. 


e Eclipse : 也 是 一 个 Java IDE Eclipse 开源 社区 开发 的 ， 可 以 直接 从 网 上 下 载 
http://www.eclipse.org/. 
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Swing 控件 - Swing 


每 一 个 用 户 界面 参考 主要 有 以 下 三 个 方面 : 


e Ul 元 素 : 有 核心 视觉 元 素 ， 最 终 用 户 看 到 并 与 之 交互 。 GWT 提供 了 一 个 巨大 
的 名 单 变 化 更 复杂 ， 本 教程 我 们 从 基本 的 广泛 使 用 和 常见 的 元 素 。 


。 布局 : 他 们 定义 UI 元素 如 何 应 安排 在 屏幕 上 ， 并 提供 一 个 最 终 的 外 观 和 感觉 的 
GUI (图 形 用 户 界面 ) 。 在 “布局 "一 章 ， 这 部 分 将 被 覆盖 。 


e 行为 : 这 些 事件 发 生 时 ， 与 用 户 交 互 的 UI 元素 。 这 部 分 将 被 覆盖 在 事件 多 
理 “ 一 章 。 





每 个 Swing 控件 继承 属性 从 以 下 组 件 的 类 层次 结构 。 


Ne x & 描述 
1 Component 容器 是 一 个 抽象 基 类 的 非 菜单 用 户 界 面 控件 摆动 。 部 分 指 图 


形 表示 的 对 象 
2 Container Container 是 一 个 组 件 ， 它 可 以 包含 其 他 Swing 组 件 。 


JComponent JComponent 是 一 个 基 类 ， 所 有 Swing Ul 组 件 。 为 了 使 用 
3 继承 自 JComponent 的 swing 组 件 ， 组 件 必须 是 一 个 包容 层次 结构 ， 其 
根 是 一 个 顶层 的 Swing 容器 。 


SWING UI 元 素 : 


以 下 是 常用 的 控件 列表 而 设计 的 图 形 用 户 界面 使 用 Swing.。 
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控件 & 描述 


JLabel 一 个 JLabel 对 象 是 在 容器 中 放置 文本 的 一 个 组 成 部 分 。 
JButton 该 类 创建 标记 的 按钮 。 


JColorChooser JColorChooser 提 供 一 个 用 于 控制 窗 格 设计 ， 让 用 户 操作 
和 选择 颜色 。 


JCheck Box JCheckBox 的 是 一 个 图 形 化 的 组 件 可 以 在 一 个 (true) 或 关 
闭 (false) 状态 时 。 


JRadioButton JRadioButton 类 是 一 个 图 形 化 的 组 件 可 以 在 一 个 (true) 
或 关闭 (false) 状态 时 。 在 一 组 。 


JList JList 组 件 向 用 户 展示 一 个 滚动 的 文本 项 列表 。 
JComboBox JComboBox 组 件 为 用 户 提 供 了 一 个 选择 显示 菜单 。 
JTextField JTextField 的 对 象 是 一 个 文本 组 件 ， 它 允许 编辑 的 单行 文本 。 


JPasswordField JPasswordField 中 对 象 是 一 个 专门 用 于 输入 密码 的 文本 
组 件 。 


JTextArea JTextArea 对 象 是 一 个 文本 组 件 ， 它 允许 编辑 的 多 行文 本 。 
Imagelcon Imagelcon 的 控件 的 图 标 界面 ， 实 现 从 图 像 绘 制图 标 


JScrollbar Scrollbar 控 件 代表 一 个 滚动 条 组 件 以 让 用 户 从 范围 选择 的 
值 。 


JOptionPane JOptionPane 的 规定 设置 标准 对 话 框 ， 提 示 用 户 提供 值 或 
向 其 发 出 通知 。 


JFileChooser JFileChooser 的 控制 代表 一 个 对 话 杠 窗口， 用 户 可 以 选择 
一 个 文件 。 


JProgressBar 随 着 任务 的 进展 ， 进 度 条 接近 完成 显示 任务 的 完成 百 分 
Es 


JSlider JSlider 让 用 户 以 图 形 界 的 时 间 间 隔 内 滑动 旋钮 选择 一 个 值 。 


JSpinner JSpinner 让 用 户 从 一 个 有 序 序列 中 选择 一 个 数字 或 者 一 个 对 象 
值 的 单行 输入 字段 。 


Swing=(# 4432 - Swing 


什么 是 事件 ? 


一 个 对 象 的 状态 变化 被 称 为 事件 ， 即 事件 描述 源 状态 的 变化 。 事 件 产生 的 结果 与 用 
户 交互 的 图 形 用 户 界面 组 件 。 例 如 ， 点 击 一 个 按钮 ， 移 动 鼠 标 ， 通 过 键盘 输入 一 个 
字符 ， 从 列表 中 选择 一 个 项 目 ， 滚 动 页 面 的 活动 ， 使 一 个 事件 的 发 生 。 


事件 的 类 型 


事件 可 以 被 大 致 分 为 两 类 : 


e 前 台 事件 - 这 些 事件 需要 用 户 直 接 互 动 。 在 图 形 用 户 界面 中 的 图 形 组件 交 互 的 
人 产生 的 后 果 。 例 如 ， 点 击 一 个 按钮 ， 移 动 鼠 标 ， 通 过 键盘 输入 一 个 字符 ， 从 
列表 中 选择 一 个 项 目 ， 滚 动 页 面 等 


e 后 台 事 件 - 这 些 事件 ， 需 要 最 终 用 户 的 交互 是 已 知 的 作为 背景 的 事件 。 操 作 系 
统 的 中 断 ， 硬 件 或 软件 故障 ， 定 时 器 到 期 时 ， 操 作 完 成 的 背景 事件 的 例子 。 


事件 义理 是 什么 ? 


事件 处 理 机 制 ， 控 制 的 事件 ， 并 决定 如 果 一 个 事件 发 生 时 ， 会 发 生 什 么 。 这 种 机 制 
被 称 为 事件 处 理 程序 ， 在 事件 发 生 时 执行 的 代码 。 Java 使 用 代理 事件 模型 来 处 理事 
件 。 该 模型 定义 了 标准 的 机 制 来 生成 和 人 处理 事件 。 让 我 们 简要 介绍 这 种 模式 。 


代理 事件 模型 具有 以 下 的 主要 参与 者 ， 即 : 


。 源 - 源 是 一 个 对 象 ， 在 该 对 象 上 的 事件 发 生 。 它 的 处 理 器 提供 发 生 事 件 的 信息 
来 源 是 可 靠 的 。 JAVA 提供 与 源 对 象 的 类 。 


e 监听 器 - 它 也 被 称 为 作为 事件 handlerListener 是 负责 产生 响应 一 个 事件 。 从 
Java 实 现 的 角度 来 看 ， 监 听 器 也 是 一 个 对 象 。 等 待 直到 它 接收 到 一 个 事件 监听 
器 。 一 旦 收 到 事件 ， 监 听 器 进程 的 事件 就 返回 。 

这 种 方法 的 好 处 是 ， 用 户 界 面 逻 辑 完全 分 开 ， 生 成 该 事件 的 逻辑 。 用 户 界 面 元 素 是 
能 够 委派 的 事件 义理 单独 的 一 段 代 码 。 在 这 个 模型 中 ， 需 要 与 源 对 象 注册 监听 使 侦 
听 器 能 够 接收 事件 通知 。 这 是 一 个 有 效 的 方式 处 理事 件 ， 因 为 这 些 事件 通知 只 发 送 
给 那些 监听 器 要 接收 他 们 。 


参与 事件 处 理 的 步 又 


e 用 户 单 击 该 按钮 时 产生 该 事件 。 


。 现在 有 天 事件 类 的 对 象 是 自动 创建 的 信息 源 和 事件 在 同一 对 象 得 到 填充 。 
。 事件 对 象 被 转发 注册 监听 器 类 的 方法 。 
。 该 方法 现在 得 到 执行 并 返回 。 


要 记 住 的 要 点 有 天 监听 器 

e 为 了 设计 一 个 监听 类 ， 我 们 必须 开发 一 些 监听 器 接口 。 这 些 监 听 器 接口 预测 一 
些 公共 的 抽象 监听 器 类 必须 实现 的 回调 方法 。 

e 如 果 不 执行 任何 预定 义 的 接口 ， 类 不 能 作为 源 对 象 的 监听 器 类 。 


回调 方法 


这 些 方 法 所 提供 的 API 提 供 程 序 ， 被 定义 为 应 用 程序 员 和 应 用 程序 开发 者 调用 。 这 
里 的 回调 方法 代表 一 个 事件 的 方法 。 在 响应 一 个 事件 的 Java JRE 将 触发 回调 方法 。 
所 有 这 些 回 调 方法 的 监听 器 接口 。 


如 果 一 个 组 件 需要 一 些 监 听 器 会 听 的 事件 源 必 须 注册 自己 监听 。 


事件 义理 例子 


选择 使 用 任何 编辑 器 创建 以 下 java 程 序 在 D:/ > SWING > com > yiibai > gui > 


SwingControlDemo.java 


package com.yiibai.gui; 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 


public class SwingControlDemo { 


private JFrame mainFrame; 
private JLabel headerLabel; 
private JLabel statusLabel; 
private JPanel controlPanel; 


public SwingLayoutDemo( ){ 
prepareGUI(); 
} 


public static void main(String[] args){ 
SwingLayoutDemo swingLayoutDemo = new SwingLayoutDemo(); 
swingLayoutDemo.showEventDemo( ); 


j 


private void prepareGUI(){ 


j 


mainFrame = new JFrame("Java SWING Examples"); 
mainFrame.setSize(400, 400) ; 
mainFrame.setLayout(new GridLayout(3, 1)); 


headerLabel 
statusLabel 


- new JLabel("",JLabel.CENTER ); 
= new JLabel("",JLabel.CENTER); 
statusLabel.setSize(350,100); 
mainFrame.addwindowListener(new WindowAdapter() ( 
public void windowClosing(WindowEvent windowEvent ) { 
System.exit(0); 


j 
3); 
controlPanel - new JPanel(); 
controlPanel.setLayout(new FlowLayout()); 


mainFrame.add(headerLabel); 
mainFrame.add(controlPanel); 
mainFrame.add(statusLabel); 
mainFrame.setVisible(true); 


private void showEventDemo(){ 


} 


headerLabel.setText("Control in action: Button"); 


JButton okButton = new JButton("OK"); 
JButton submitButton = new JButton("Submit"); 
JButton cancelButton = new JButton("Cancel"); 


okButton.setActionCommand("OK"); 
submitButton.setActionCommand("Submit") ; 
cancelButton.setActionCommand("Cancel"); 


okButton.addActionListener(new ButtonClickListener()); 
submitButton.addActionListener(new ButtonClickListener( 
cancelButton.addActionListener(new ButtonClickListener( 


controlPanel.add(okButton); 
controlPanel.add(submitButton); 
controlPanel.add(cancelButton); 


mainFrame.setVisible(true); 


~ 


e 
De 


private class ButtonClickListener implements ActionListener { 


public void actionPerformed(ActionEvent e) { 
String command = e.getActionCommand(); 
if( command.equals( "OK" )) { 
statusLabel.setText("Ok Button clicked."); 


else if( command.equals( "Submit" ) ) { 


statusLabel.setText("Submit Button clicked."); 


J 
else { 

statusLabel.setText("Cancel Button clicked."); 
} 


编译 程序 ， 使 用 命令 提示 符 。 到 D:/ > SWING 然后 输出 以 下 命令 。 
D:AWT>javac comyiibaiguiSwingControlDemo. java 
如 果 没 有 错误 出 现 ， 这 意味 着 编译 成 功 。 使 用 下 面 的 命令 来 运行 程序 。 


D:AWT>java com.yiibai.gui.SwingControlDemo 


验证 下 面 的 输出 
Java SWING Examples Sel 


Control in action: JButton 











| OK |l Submit Cancel 





Ok Button clicked. 
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事件 监听 器 代表 负责 义理 事件 的 接口 。 Java 提供 了 各 种 事件 监听 器 类 ， 但 我 们 将 
讨论 那些 被 更 频繁 地 使 用 。 每 一 个 事件 监听 器 方法 具有 方法 的 EventObject 类 的 子 
类 的 对 象 ， 这 是 作为 一 个 单独 的 参数 。 例 如 ， 最 标 事件 侦 听 器 方法 将 接受 
MouseEvent 的 实例 ， 其 中 派生 的 事件 的 EventObject。 


EventListner 接口 


它 是 一 个 标记 接口 ， 每 一 个 监听 器 接口 扩展 。 这 个 类 定义 在 java.util 包 。 


4 Æ 
AX Fa HH 
以 下 是 声明 java.util.EventListener 接 口 : 


public interface EventListener 


Swing 事件 监听 器 接口 : 
以 下 是 常用 的 的 事件 监听 器 列表 。 


Sr. No. Control & Description 
ActionListener 该 接口 用 于 接收 动作 事件 。 
ComponentListener 该 接口 用 于 接收 组 件 事 件 。 
ltemListener 该 接口 用 于 接收 项 目 事件 。 

KeyListener 该 接口 用 于 接收 按键 事件 。 
MouseListener 该 接口 用 于 接收 鼠标 事件 。 
WindowListener 该 接口 用 于 接收 窗口 事件 。 
AdjustmentListener 该 接口 用 于 接收 调整 事件 。 
ContainerListener 该 接口 用 于 接收 容器 事件 。 
MouseMotionListener 此 接口 用 于 接收 鼠标 移动 事件 。 
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Swing 事件 适 配 右 - Swing 


适配器 是 抽象 类 ， 用 于 接收 各 种 事件 。 这 些 类 中 的 方法 是 空 的 。 这 些 类 
是 方便 创建 监听 器 对 象 。 


SWINGE A : 
以 下 是 常用 的 适配器 列表 ， 监 听 SWING GUI 事件 。 
Sr. No. 适配器 & 说 明 
1 FocusAdapter 接收 焦点 事件 的 抽象 适配器 类 。 
2 KeyAdapter 接收 按键 事件 的 抽象 适配器 类 。 
3 MouseAdapter 接收 鼠标 事件 的 抽象 适配器 类 。 
4 MouseMotionAdapter 接收 鼠标 移动 事件 的 抽象 适配器 类 。 
5 WindowAdapter 接收 窗口 事件 的 抽象 适配器 类 。 


Swing Layout 布 局 - Swing 


布局 的 意味 着 ， 在 容器 内 的 配置 的 组 件 。 在 其 他 的 方式 ， 我 们 可 以 认为 在 一 个 特定 
的 容器 内 的 位 置 放置 组 件 。 布 局 管理 器 所 控制 布点 的 任务 是 自动 完成 的 。 


布局 管理 器 


布局 管理 器 自动 定位 容器 内 的 所 有 组 件 。 如 果 我 们 不 使 用 布局 管理 器 ， 然 后 定位 组 
件 的 默认 布局 管理 器 。 这 是 可 能 的 手工 布局 的 控制 ， 但 由 于 以 下 两 个 原因 ， 它 变 得 
非常 困难 。 


e 这 是 非常 繁琐 的 容器 内 义理 大 量 的 控制 。 
e 通常 当 我 们 需要 安排 他 们 没有 给 出 一 个 组 件 的 宽度 和 高 度 信息 。 


Java 为 我 们 提供 了 各 种 布局 管理 器 来 定位 控制 。 属 性 如 大 小 ， 形 状 和 排列 变化 从 一 
个 布局 管理 器 ， 其 他 的 布局 管理 器 。 的 小 应 用 程序 或 应 用 程序 窗口 的 大 小 改变 时 ， 

即 布局 管理 器 applet 浏 览 器 或 应 用 程序 窗口 的 尺寸 适应 于 响应 的 大 小 ， 形 状 和 排列 
的 组 件 也 随 之 变化 。 


布局 管理 器 关联 的 与 每 个 容器 对 象 。 每 一 个 布局 管理 器 是 实现 布局 管理 接口 的 类 的 
一 个 对 象 。 


以 下 是 接口 定义 布局 管理 器 的 功能 。 


Sr. 


No. 接口 & 说 明 
1 LayoutManager 布局 管理 器 接口 声明 的 对 象 将 充当 一 个 布局 管理 器 类 需 
要 实现 的 方法 。 
2 LayoutManager2 LayoutManager2 中 的 子 接口 布局 管理 。 这 个 接口 是 为 
那些 知道 如 何 布 局 容器 的 基础 上 布局 约束 对 象 的 类 。 
AWT 布 局 管理 器 类 : 


以 下 是 常用 的 控件 列表 而 设计 的 图 形 用 户 界面 使 用 AWT。 


Sr. 
No. 


LayoutManager & Description 


BorderLayout The borderlayout arranges the components to fit in the 
five regions: east, west, north, south and center. 


CardLayout The CardLayout object treats each component in the 
container as a card. Only one card is visible at a time. 


FlowLayout The FlowLayout is the default layout.It layouts the 
components in a directional flow. 


GridLayout The GridLayout manages the components in form of a 
rectangular grid. 


GridBagLayout This is the most flexible layout manager class.The 
object of GridBagLayout aligns the component vertically,horizontally or 
along their baseline without requiring the components of same size. 


GroupLayout The GroupLayout hierarchically groups components in 
order to position them in a Container. 


SpringLayout A SpringLayout positions the children of its associated 
container according to a set of constraints. 


TutorialsPoint Java 技术 教程 


Swing Menu # X - Swing 


正如 我 们 所 知道 与 菜单 相关 的 每 一 个 顶层 窗口 有 一 个 菜单 栏 。 此 菜单 栏 包 括 提供 给 
最 终 用 户 的 各 种 菜单 的 选择 。 此 外 ， 每 个 选择 包含 这 就 是 所 谓 的 下 拉 菜 单 中 的 选项 
列表 。 菜 单 和 菜单 项 的 控件 是 MenuComponent 类 的 子 类 。 


菜单 层次 结构 


Yiibai.co 
菜单 控件 
Sr. di "T" 
N 控件 & 描述 
o. 
1 JMenuBar JMenuBar 的 对 象 是 与 顶层 窗口 。 
2 JMenultem 菜单 中 的 项 目 必 须 属 于 JMenultem 的 或 任何 其 子 类 。 
3 JMenu JMenu 对 象 是 从 菜单 栏 中 显示 一 个 下 拉 菜 单 组 件 。 
4 JCheckboxMenultem JCheckBoxMenultem 必须 为 JMenultem 的 子 
类 村 
5 JRadioButtonMenultem JRadioButtonMenultem 对 象 是 JMenultem 的 
HK 
Ro 
6 JPopupMenu JPopupMenu 弹 出 可 以 在 一 个 组 件 内 的 指定 位 置 动态 弹 


o 
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TestNG 教 程 


测试 是 检查 应 用 程序 的 功能 的 过 程 是 否 按 要 求 工作 ， 以 确保 在 开发 层面 ， 单 元 测试 
成 图 片 。 单 元 测试 是 单一 实体 (类 或 方法 ) 的 测试 。 单 元 测试 是 非常 必要 的 ， 每 一 
个 软件 公司 向 他 们 的 客户 提供 高 质量 的 产品 。 

JUnit 带动 开发 人 员 了 解 测 斌 的 实用 性 ， 尤 其 是 单元 测试 的 时 候 比 任何 其 他 测试 框 
架 。 人 凭借 一 个 相当 简单 ， 务 实 ， 严 说 的 架构 ，JUnit 已 经 能 够 "感染 "了 一 大 批 开 发 人 
员 。 JUnit 的 特点 ， 可 以 看 看 Junit 特点 。 

其 中 JUnit 缺 点 : 

e 最 初 的 设计 ， 使 用 于 单元 测试 ， 现 在 只 用 于 各 种 测试 

e 不 能 依赖 测试 

e 配置 控制 欠 佳 (安装 /拆卸 ) 

e 侵入 性 (强制 扩展 类 ， 并 以 某 种 方式 命名 方法 ) 

e 静态 编程 模型 〈 不 必要 的 重新 编译 ) 

e 不 同 的 适合 管理 复杂 项 目 中 的 测试 可 以 是 非常 棘手 . 


TestNG 是 什么 ? 


TestNG 按 照 其 文档 的 定义 是 : 


TestNG 是 一 个 测试 框架 ， 其 灵感 来 自 JUnit 和 NUnit 的 ， 但 引入 了 一 些 新 的 功能 ， 使 
其 功能 更 强大 ， 使 用 更 方便 。 


TestNG 是 一 个 开源 自动 化 测试 框架 ;TestNG 表 示 下 一 代 。 TestNG 是 类 似 于 
JUnit (特别 是 JUnit 4) ， 但 它 不 是 一 个 JUnit 扩 展 。 它 的 灵感 来 源 于 JUnit。 它 的 目 
的 是 优 于 JUnit 的 ， 尤 其 是 当 测 试 集成 的 类 。 TestNG 的 创造 者 是 Cedric Beust ( 塞 
德里 克 : 博 伊 斯 特 ) 

TestNG 消 除了 大 部 分 的 旧 框 架 的 限制 ， 使 开发 人 员 能 够 编写 更 加 有 灵活 和 强大 的 测 
试 。 因为 它 在 很 大 程度 上 借鉴 了 Java 注 解 (JDK5.0 引 入 的 ) 来 定义 的 测试 ， 它 也 
可 以 告诉 你 如 何 使 用 这 个 新 功能 在 真实 的 Java 语 言 生产 环境 中 。 


TestNG 的 特点 
e 注解 


e TestNG 使 用 Java 和 面向 对 象 的 功能 


支持 综合 类 测试 (例如 ， 默 认 情 况 下 ， 没 有 必要 创建 一 个 新 的 测试 每 个 测试 方 
法 的 类 的 实例 ) 


独立 的 编译 时 间 测 试 代码 运行 时 配置 /数据 信息 
灵活 的 运行 时 配置 


主要 介绍 “测试 组 ”。 当 编译 测试 ， 只 要 问 TestNG 运 行 所 有 的 “前 端的 测试 ， 
BR”, "e", “数据库” 等 


支持 依赖 测试 方法 ， 并 行 测试 ， 负 载 测 试 ， 局 部 故障 
灵活 的 插件 API 
支持 多 线程 测试 
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测试 是 检查 应 用 程序 的 功能 的 过 程 是 否 按 要 求 工作 ， 以 确保 在 开发 层面 ， 单 元 测试 
成 图 片 。 单 元 测试 是 单一 实体 (类 或 方法 ) 的 测试 。 单 元 测试 是 非常 必要 的 ， 每 一 
个 软件 公司 向 他 们 的 客户 提供 高 质量 的 产品 。 

JUnit 带动 开发 人 员 了 解 测 斌 的 实用 性 ， 尤 其 是 单元 测试 的 时 候 比 任何 其 他 测试 框 
架 。 人 凭借 一 个 相当 简单 ， 务 实 ， 严 说 的 架构 ，JUnit 已 经 能 够 "感染 "了 一 大 批 开 发 人 
员 。 JUnit 的 特点 ， 可 以 看 看 Junit 特点 。 

其 中 JUnit 缺 点 : 

e 最 初 的 设计 ， 使 用 于 单元 测试 ， 现 在 只 用 于 各 种 测试 

e 不 能 依赖 测试 

e 配置 控制 欠 佳 (安装 /拆卸 ) 

e 侵入 性 (强制 扩展 类 ， 并 以 某 种 方式 命名 方法 ) 

e 静态 编程 模型 〈 不 必要 的 重新 编译 ) 

e 不 同 的 适合 管理 复杂 项 目 中 的 测试 可 以 是 非常 棘手 . 


TestNG 是 什么 ? 


TestNG 按 照 其 文档 的 定义 是 : 


TestNG 是 一 个 测试 框架 ， 其 灵感 来 自 JUnit 和 NUnit 的 ， 但 引入 了 一 些 新 的 功能 ， 使 
其 功能 更 强大 ， 使 用 更 方便 。 


TestNG 是 一 个 开源 自动 化 测试 框架 ;TestNG 表 示 下 一 代 。 TestNG 是 类 似 于 
JUnit (特别 是 JUnit 4) ， 但 它 不 是 一 个 JUnit 扩 展 。 它 的 灵感 来 源 于 JUnit。 它 的 目 
的 是 优 于 JUnit 的 ， 尤 其 是 当 测 试 集成 的 类 。 TestNG 的 创造 者 是 Cedric Beust ( 塞 
德里 克 : 博 伊 斯 特 ) 

TestNG 消 除了 大 部 分 的 旧 框 架 的 限制 ， 使 开发 人 员 能 够 编写 更 加 有 灵活 和 强大 的 测 
试 。 因为 它 在 很 大 程度 上 借鉴 了 Java 注 解 (JDK5.0 引 入 的 ) 来 定义 的 测试 ， 它 也 
可 以 告诉 你 如 何 使 用 这 个 新 功能 在 真实 的 Java 语 言 生产 环境 中 。 


TestNG 的 特点 
e 注解 


e TestNG 使 用 Java 和 面向 对 象 的 功能 


支持 综合 类 测试 (例如 ， 默 认 情 况 下 ， 没 有 必要 创建 一 个 新 的 测试 每 个 测试 方 
法 的 类 的 实例 ) 


独立 的 编译 时 间 测 试 代码 运行 时 配置 /数据 信息 
灵活 的 运行 时 配置 


主要 介绍 “测试 组 ”。 当 编译 测试 ， 只 要 问 TestNG 运 行 所 有 的 “前 端的 测试 ， 
BR”, "e", “数据库” 等 


支持 依赖 测试 方法 ， 并 行 测试 ， 负 载 测 试 ， 局 部 故障 
灵活 的 插件 API 
支持 多 线程 测试 
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TestNG 是 一 个 Java 的 框架 ， 所 以 第 一 个 要 求 是 JDK 要 安装 在 你 的 机 器 上 。 


JDK 1.5 或 以 上 

内 存 没有 最 低 要 求 
磁盘 空间 没有 最 低 要 求 
操作 系统 没有 最 低 要 求 


步骤 1 -验证 Java 安 装 在 你 的 机 器 上 


现在 ， 打 开 控 制 台 并 执行 以 下 的 java 命 倒 。 


OS 任务 Sp 
Windows 打开 命令 控制 台 c:> java -version 
Linux 打开 命令 终端 $ java -version 
Mac 打开 命令 终端 machine:~ joseph$ java -version 


让 我 们 来 验证 所 有 的 操作 系统 的 输出 : 


Windows 


java version "1.7.0_25" 
Java(TM) SE Runtime Environment (build 1.7.0_25-b15) 
Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed mode) | 


Se ni 


Linux 


java version "1.7.0_25" 
Java(TM) SE Runtime Environment (build 1.7.0_25-b15) 
Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed mode) | 


s] 一 | 








Mac 


java version "1.7.0 25" 
Java(TM) SE Runtime Environment (build 1.7.0 25-b15) 
Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed mode) | 


al »] 


如 果 你 没有 安装 Java， 安 装 Java 软 件 开发 工具 包 (SDK) mi: 
http://www.oracle.com/technetwork/java/javase/downloads/index.html. 我 们 假设 本 
教程 中 安装 和 使 用 Java1.7.0_25 版 本 。 








第 二 步 : 设置 JAVA 环境 


设置 JAVA_HOME 环 境 变量 指向 的 基本 目录 的 位 置 ， 在 你 的 机 器 上 安装 Java。 例 
如 : 


OS 输出 
Windows ”设置 环境 变量 JAVA HOME 为 C:Program FilesJavajdk1.7.0 25 
Linux export JAVA_HOME=/usr/local/java-current 
Mac export JAVA_HOME=/Library/Java/Home 


添加 Java 编 译 器 的 位 置 ， 系 统 路 径 。 


OS 输出 
; Append the string; C:Program FilesJavajdk1.7.0 25in to the end 
Windows ， 
of the system variable, Path. 
Linux export PATH=$PATH:$JAVA_HOME/bin/ 
Mac not required 


验证 Java 安 装 使 用 命令 java-version 如 上 所 述 。 


第 3 步 : 下 载 TestNG 的 为 档 文件 


下 载 最 新 版 本 的 TestNG 的 jar 文 件 ， 详 细 请 点 击 访问 http://www.testng.org.。 在 写 这 
篇 教程 的 时 候 ， 我 下 载 TestNG 中 -6.8.jar， 并 将 testng-6.8.jar 其 复制 到 C:>TestNG 
目录 。 
OS 压缩 文件 名 
Windows testng-6.8.jar 
Linux testng-6.8.jar 


Mac testng-6.8.jar 


步骤 4 : 设置 TestNG 的 环境 


设置 TESTNG_HOME 环 境 变量 指向 TestNG 的 jar 存放 在 您 的 机 器 上 的 基本 目录 位 
置 。 假设 ， 我 们 已 经 储存 了 testng-6.8.jar， TestNG 各 种 操作 系统 上 的 文件 夹 如 
下 : 


OS 输出 
Windows Set the environment variable TESTNG HOME to C:TESTNG 
Linux export TESTNG_HOME=/usr/local/TESTNG 
Mac export TESTNG_HOME=/Library/TESTNG 


第 5 步 : 设置 CLASSPATH € © 


设置 CLASSPATH 环 境 变 量 指向 TestNG 的 jar 文 件 位 置 。 假 设 ， 我 们 已 经 储存 了 
ET -6.8.jar, TestNG 在 各 种 操作 系统 上 的 文件 夹 如 下 : 


2> 输出 
Windows ， 设 置 环境 变量 CLASSPATH 为 
%CLASSPATH%;%TESTNG_HOME% estng-6.8.jar; 
UE export CLASSPATH=$CLASSPATH:$TESTNG_HOME/testng- 
6.8 jar: 
Mac export CLASSPATH=$CLASSPATH:$TESTNG_HOME/testng- 
6.8 jar: 


步骤 6 : 测试 TestNG 的 设置 


创建 一 个 Java 类 文件 名 TestNGSimpleTest C: > TestNG_WORKSPACE 


import org.testng.annotations.Test; 
import static org.testng.Assert.assertEquals; 


public class TestNGSimpleTest { 


@Test 
public void testAdd() { 
String str = "TestNG is working fine"; 


assertEquals("TestNG is working fine", str); 


TestNG 的 几 种 不 同 的 方法 可 以 被 调用 : 


e testng.xml 文件 

e ant 

e MAIT 
让 我 们 调用 使 用 testng.xml 文 件 。 创 建 一 个 XML 文件 名 称 testng.xml C: > 
TestNG_WORKSPACE 执行 测试 用 例 (s) 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suite1i"> 
«test name="testi"> 
<classes> 
<class name="TestNGSimpleTest"/> 
</classes> 
</test> 
</suite> 


第 7 步 : 检查 结果 
类 编译 使 用 javac 编 译 如 下 : 


C:TestNG_WORKSPACE>javac TestNGSimpleTest.java 


现在 ， 调 用 testng.xml 看 到 的 结果 : 


C:TestNG_WORKSPACE>java -cp "C:TestNG WORKSPACE" org.testng.TestNG 
B —— ———— Á——ná 


验证 输出 





Suite1 
Total tests run: 1, Failures: 0, Skips: 0 
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编写 TestNG 测 试 基本 上 包括 以 下 步骤 : 
e 测试 和 编写 业务 逻辑 ， 在 代码 中 插入 TestNG 的 注解 .. 


e 添加 一 个 testng.xml 文 件 或 build.xml 中 在 测试 信息 (例如 类 名 ， 您 想 要 运行 的 
组 ， 等 ..) 


e 运行 TestNG. 


在 这 里 ， 我 们 将 看 到 一 个 完整 的 例子 了 TestNG 测 试 使 用 POJO 类 ， 业 务 逻 辑 类 ， 闻 
通过 TestNG 的 运行 测试 XML。 


创建 EmployeeDetails.java 在 C: > TestNG_WORKSPACE 是 一 个 POJO X. 


public class EmployeeDetails { 


private String name; 
private double monthlySalary; 
private int age; 


jf ite 

* @return the name 

iA 

public String getName() ( 
return name; 

} 


ff vise 

* @param name the name to set 

Us 

public void setName(String name) { 
this.name - name; 

} 


JE 

* @return the monthlySalary 

pia 

public double getMonthlySalary() { 
return monthlySalary; 

} 


WE 

* @param monthlySalary the monthlySalary to set 

yr 

public void setMonthlySalary(double monthlySalary) { 
this.monthlySalary - monthlySalary; 

j 


jf site 

* @return the age 

We 

public int getAge() { 
return age; 

} 


JEE e 

* @param age the age to set 
= 

public void setAge(int age) { 
this.age = age; 


} 


EmployeeDetails 类 是 用 来 
e get/set 员工 的 名 字 的 值 
e get/set 员工 月 薪 的 值 
e get/set 员 工 年 龄 的 值 


创建 一 个 EmpBusinessLogic.java 在 C: > TestNG_WORKSPACE 其 中 包含 业务 逻 
B 


public class EmpBusinessLogic { 
// Calculate the yearly salary of employee 
public double calculateYearlySalary(EmployeeDetails employeeDet: 
double yearlySalary=0; 
yearlySalary - employeeDetails.getMonthlySalary() * 12; 
return yearlySalary; 


j 


// Calculate the appraisal amount of employee 
public double calculateAppraisal(EmployeeDetails employeeDetail: 
double appraisal-0; 
if(employeeDetails.getMonthlySalary() < 10000)( 
appraisal - 500; 
jelse( 
appraisal - 1000; 


return appraisal; 





EmpBusinessLogic 类 用 于 计算 
e 考核 支付 予 奢 员 


现在 ， 让 我 们 创建 一 个 TestNG 类 名 称 为 TestEmployeeDetails.java 在 C: > 
TestNG_WORKSPACE. TestNG 类 是 一 个 Java 类 ， 它 包含 至 少 一 个 TestNG 的 注 

AR, 这 个 类 包含 测试 用 例 进行 测试 。 可 以 配置 ，@BeforeXXX 和 @AfterXXX 注 解 了 
TestNG 测 试 (在 本 章 ， 我 们 会 看 到 这 样 TestNG - Execution Procedure) 它 人 允许 执行 
一 些 Java 逮 辑 的 目标 点 之 前 和 之 后 。 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class TestEmployeeDetails { 
EmpBusinessLogic empBusinessLogic = new EmpBusinessLogic(); 
EmployeeDetails employee = new EmployeeDetails(); 


@Test 
public void testCalculateAppriasal() { 
employee. setName("Rajeev"); 
employee.setAge(25); 
employee. setMonthlySalary(8000); 
double appraisal = empBusinessLogic 
.calculateAppraisal(employee) ; 
Assert.assertEquals(500, appraisal, 0.0, "500"); 
} 


// test to check yearly salary 

@Test 

public void testCalculateYearlySalary() { 
employee. setName("Rajeev"); 
employee.setAge(25); 
employee.setMonthlySalary(8000); 
double salary - empBusinessLogic 

.calculateYearlySalary(employee); 

Assert.assertEquals(96000, salary, 0.0, "8000"); 


TestEmployeeDetails 测试 方法 ， 用 于 类 EmpBusinessLogic， 它 
。 懂 员 测 试 的 年 薪 
。 测试 评估 员工 的 金额 


之 前 ， 你 可 以 运行 测试 ， 但 是 必须 使 用 特殊 的 XML 文件 ， 通 常 命 名 为 testng.xml 配 
置 TestNG。 此 文件 的 语法 很 简单 ， 其 内 容 如 下 。 创 建 这 个 文件 C: > 
TestNG_WORKSPACE: 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suite1i"> 
«test name="test1i"> 
<classes> 
<class name="TestEmployeeDetails"/> 
</classes> 
</test> 
</suite> 


以 上 文件 的 详情 如 下 : 


TutorialsPoint Java 技术 教程 
e suite 代 表 一 个 XML 文件 。 它 可 以 包含 一 个 或 多 个 测试 ， 并 被 定义 由 <suite> 标 
记 
e 标签 <test> 代 表 一 个 测试 ， 并 可 以 包含 一 个 或 多 个 TestNG 的 类 


e <Cclass> 的 标签 代表 一 个 TestNG 的 类 是 一 个 Java 类 ， 它 包含 至 少 一 个 TestNG 的 
注解 。 它 可 以 包含 一 个 或 多 个 测试 方法 。 


编译 使 用 javac 测 试用 例 类 。 

C:TestNG_WORKSPACE>javac EmployeeDetails.java EmpBusinessLogic. javé 
SSS = E: 
现在 TestNG 用 下 面 的 命令 : 





C:TestNG_WORKSPACE>java -cp "C:TestNG WORKSPACE" org.testng.TestNG 
SS SSS SS LLL B 
如 果 所 有 配置 正确 的 话 ， 你 应 该 看 到 测试 结果 ， 在 控制 台中 。 此 外 ，TestNG 创 建 了 


一 个 非常 漂亮 的 HTML 报 告 ， 会 自动 在 当前 目录 下 创建 一 个 文件 夹 名 为 testoutput 
。 如 果 打 开 并 加 载 的 index.html， 会 看 到 类 似 下 面 的 图 片 中 的 一 个 页 面 : 
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TestNG 基 本 注解 (注释 ) - TestNG 教 程 


传统 的 方式 来 表示 JUnit 3 中 的 测试 方法 是 测试 自己 的 名 字 前 级 。 标 记 一 个 类 中 的 某 
些 方法 ， 具 有 特殊 的 意义 ， 这 是 一 个 非常 有 效 的 方法 ， 但 命名 不 很 好 的 扩展 (如 果 
我 们 想 添 加 更 多 标签 为 不 同 的 框架 ? ) ， 而 非 缺 乏 灵 活性 (如果 我 们 要 通过 额外 的 
参数 测试 框架 ) 。 

注释 被 正式 加 入 到 JDK 5 中 的 Java 语 言 和 TestNG 作 出 选择 使 用 注释 注释 测试 类 。 


这 里 是 TestNG 的 支持 列表 中 的 注解 : 


注解 
@BeforeSuite 


@AfterSuite 


@BeforeClass 


@AfterClass 


@BeforeTest 


@AfterTest 


@BeforeGroups 


@AfterGroups 


@BeforeMethod 
@AfterMethod 


@DataProvider 


@Factory 


@Listeners 
@Parameters 


@Test 


描述 
注解 的 方法 将 只 运行 一 次 ， 运 行 所 有 测试 前 此 套件 中 。 
注解 的 方法 将 只 运行 一 次 此 套件 中 的 所 有 测试 都 运行 之 
Hho 
注解 的 方法 将 只 
注解 的 方法 将 只 运行 一 次 后 已 经 运行 在 当前 类 中 的 所 有 测 
试 方法 。 
注解 的 方法 将 被 运行 之 前 的 任何 测试 方法 属于 内 部 类 的 
<test> 标 签 的 运行 。 
注解 的 方法 将 被 运行 后 ， 所 有 的 测试 方法 ， 属 于 内 部 类 的 
<test> 标 签 的 运行 。 
组 的 列表 ， 这 种 配置 方法 将 之 前 运行 。 此 方法 是 保证 在 运 
行 属于 任何 这 些 组 第 一 个 测试 方法 ， 该 方法 被 调用 。 
组 的 名 单 ， 这 种 配置 方法 后 ， 将 运行 。 此 方法 是 保证 运行 
后 不 久 ， 最 后 的 测试 方法 ， 该 方法 属于 任何 这 些 组 被 调 
用 。 
注解 的 方法 将 每 个 测试 方法 之 前 运行 。 
被 注释 的 方法 将 被 运行 后 ， 每 个 测试 方法 。 
标志 着 一 个 方法 ， 提 供 数据 的 一 个 测 斌 方法。 注解 的 方法 
必须 返回 一 个 Object[] []， 其 中 每 个 对 象 [的 测试 方法 的 参 
数列 表 中 可 以 分 配 。 该 @Test 方法 ， 希 望 从 这 个 


DataProvider 的 接收 数据 ， 需 要 使 用 一 个 dataProvider 名 称 
等 于 这 个 注解 的 名 字 。 


作为 一 个 工厂 ， 返 回 TestNG 的 测试 类 的 对 象 将 被 用 于 标记 
的 方法 。 该 方法 必须 返回 Object[]。 


定义 一 个 测试 类 的 监听 器 。 
介绍 如 何 将 参数 传递 给 @Test 方 法 。 
标记 一 个 类 或 方法 作为 测试 的 一 部 分 。 


4 


运行 一 次 先行 先 试 在 当前 关中 的 方法 调 


使 用 注释 的 好 处 
以 下 是 一 些 使 用 注释 的 好 处 : 
。 TestNG 的 标识 的 方法 关心 寻找 注解 。 因 此 ， 方 法 名 并 不 限于 任何 模式 或 格式 。 


e 我 们 可 以 通过 额外 的 参数 注解 。 
e 注释 是 强 类 型 的 ， 所 以 编译 器 将 标记 任何 错误 。 


e 测试 类 不 再 需要 任何 东西 (如 测试 案例 ， 在 JUnit3) 扩展 。 
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本 教程 介绍 了 TestNG 中 执行 程序 的 方法 ， 这 意味 着 该 方法 被 称 为 第 一 和 一 个 接着 。 
下 面 是 执行 程序 的 TestNG 测 试 API 的 方法 的 例子 。 


创建 一 个 Java 类 文件 名 TestngAnnotation.java 在 C:>TestNG_WORKSPACE 测 试 注 
解 。 


import org.testng.annotations.Test; 

import org.testng.annotations.BeforeMethod; 
import org.testng.annotations.AfterMethod; 
import org.testng.annotations.BeforeClass; 
import org.testng.annotations.AfterClass; 
import org.testng.annotations.BeforeTest; 
import org.testng.annotations.AfterTest; 
import org.testng.annotations.BeforeSuite; 
import org.testng.annotations.AfterSuite; 


public class TestngAnnotation { 
// test case 1 
@Test 
public void testCase1() { 
System.out.println("in test case 1"); 
} 


// test case 2 

@Test 

public void testCase2() { 
System.out.println("in test case 2"); 

} 


@BeforeMethod 

public void beforeMethod() { 
System.out.println("in beforeMethod") ; 

j 


QAf terMethod 

public void afterMethod() { 
System.out.println("in afterMethod"); 

} 


@BeforeClass 

public void beforeClass() { 
System.out.println("in beforeClass"); 

} 


@AfterClass 
public void afterClass() { 
System.out.println("in afterClass"); 


} 


@BeforeTest 

public void beforeTest() { 
System.out.println("in beforeTest"); 

} 


@AfterTest 

public void afterTest() { 
System.out.println("in afterTest"); 

j 


QBeforeSuite 

public void beforeSuite() ( 
System.out.println("in beforeSuite"); 

j 


QAfterSuite 

public void afterSuite() (1 
System.out.println("in afterSuite"); 

j 


接 下 来 ， 让 我 们 创建 的 文件 testng.xml f£ C: > TestNG WORKSPACE 执行 注 
解 。 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suite1i"> 
«test name="testi"> 
<classes> 
<class name="TestngAnnotation"/> 
</classes> 
</test> 
</suite> 


编译 使 用 javac 测 试用 例 类 。 


C:TestNG WORKSPACE»javac TestngAnnotation.java 


现在 运行 testng.xml， 将 运行 提供 的 测试 用 例 类 中 定义 的 测试 用 例 。 


C:TestNG WORKSPACE>java org.testng.TestNG testng.xml 


验证 输出 。 


beforeSuite 
beforeTest 
beforeClass 
beforeMethod 
test case 1 
afterMethod 
beforeMethod 
test case 2 
afterMethod 
afterClass 
afterTest 
afterSuite 


Suite 


见 上 面 的 输出 ，TestNG 是 执行 过 程 如 下 : 


o 


首先 所 有 beforeSuite () 方法 只 执行 一 次 。 
最 后 ，afterSuite 的 〈) 方法 只 执行 一 次 。 
即使 方法 beforeTest(), beforeClass(), afterClass() 和 afterTest() 方法 只 执行 一 


beforeMethod () 方法 执行 每 个 测 斌 用例， 但 在 此 之 前 执行 的 测试 用 例 。 
afterMethod () 方法 执行 每 个 测 斌 用例， 但 测试 用 例 执行 后 。 


In between beforeMethod() and afterMethod() each test case executes. 


TestNG 执 行 测试 - TestNG 教 程 
使 用 TestNG 类 执行 测试 用 例 。 这 个 类 的 主 和 人口 点 在 TestNG 的 框架 运行 测试 。 用 户 
可 以 创建 自己 的 TestNG 的 对 象 ， 并 调用 它 以 许多 不 同 的 方式 : 
e 在 现 有 的 testng.xml 
e 合成 testng.xml， 完 全 从 Java 创 建 
。 直接 设 定 测试 类 
您 还 可 以 定义 哪些 群体 包括 或 排除 ， 分 配 参数 ， 命 令 行 参数 : 
e -d outputdir: 指定 输出 目录 
e -testclass class_name: 指定 了 一 个 或 多 个 类 名 
e -testjar jar_name: 指定 的 jar 包 含 测 试 
e -sourcedir src1;src2: ; 分 隔 源 目录 列表 (只 有 当 使 用 的 javadoc 注 释 ) 


e -target 


-groups 
e -testrunfactory 
-listener 


testng.xml 现 有 在 下 面 的 例子 中 ， 我 们 将 创建 TestNG 的 对 象 。 


创建 一 个 类 


e 创建 一 个 Java 类 进行 测试 为 MessageUtiljava 在 C: > TestNG_WORKSPACE 


Vas 

* This class prints the given message on console. 
A 

public class MessageUtil { 


private String message; 


//Constructor 

//üparam message to be printed 

public MessageUtil(String message) { 
this.message - message; 


j 


// prints the message 

public String printMessage(){ 
System.out.println(message); 
return message; 


创建 测试 例 类 
e 创建 一 个 Java 测 试 类 SampleTest.java 
。 您 的 测试 类 添加 一 个 的 测试 方法 testPrintMessage () 
e 添加 注释 @Test 到 方法 testPrintMessage() 
e 实现 测试 条 件 和 使 用 的 assertEquals API TestNG 的 检查 条 件 
创建 一 个 Java 类 文件 名 SampleTest.java 在 C: > TestNG_WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class SampleTest { 


String message = "Hello World"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test 
public void testPrintMessage() { 

Assert.assertEquals(message, messageUtil.printMessage()); 
} 


} 
mi = 0] 








创建 testng.xml 


接 下 来 ， 让 我 们 创建 testng.xml 文 件 在 C: > TestNG_WORKSPACE 执行 测试 用 
例 ， 此 文件 捕获 整个 测试 XML。 这 个 文件 可 以 很 容易 地 描述 所 有 的 测试 套件 和 它们 
的 参数 在 一 个 文件 中 ， 你 可 以 检查 你 的 代码 库 或 e-mail 给 同事 。 这 也 使 得 它 容易 提 
取 测 斌 或 分 裂 的 几 个 运行 时 配置 的 子 集 〈 例 如 ， TestNG 的 database.xml RÅ 运行 
测试 ， 行 使 数据 库 ) 。 


<?xml version="1.0" encoding="UTF-8"?> 
«suite name="Sample test Suite"> 
«test name="Sample test"> 
<classes> 
<class name="SampleTest" /> 
</classes> 
</test> 
</suite> 


情况 下 使 用 javac 编 译 测试 
C:TestNG_WORKSPACE>javac MessageUtil.java SampleTest.java 


现在 ， 运 行 这 个 testng.xml， 将 运行 中 定义 的 测试 用 例 <test> 标签 


C:TestNG WORKSPACE»java -cp "C:TestNG WORKSPACE" org.testng.TestNG 
| ————— sci] 
验证 输出 。 





Hello World 


Sample test Suite 
Total tests run: 1, Failures: 0, Skips: 0 
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TestNG 套 件 测试 


测试 套件 的 测试 是 为 了 测试 软件 程序 的 行为 或 一 系列 行为 的 情况 下 ， 是 一 个 集合 。 
在 TestNG， 我 们 不 能 定义 一 套 测试 源 代码 ， 但 它 代 表 的 套件 是 一 个 XML 文 件 执 行 特 
征 。 这 也 人 允许 灵活 的 配置 要 运行 的 测试 。 套 件 可 以 包含 一 个 或 多 个 测试 和 被 定义 由 
<suite> 标 签 。 

testng.xml 中 有 <suite> 根 标签 。 它 描述 了 一 个 测试 套件 ， 这 反 过 来 又 是 由 多 个 
<test> 区 段 组 成 。 


下 表 列 出 了 所 有 的 <suite> 可 接受 合法 属性 。 


属性 描述 
name 此 套件 的 名 称 。 这 是 一 个 强制 性 的 属性 。 
verbose 这 个 运行 级 别 或 见长 。 
parallel 由 TestNG 运行 不 同 的 线程 来 运行 此 套件 。 


thread-count ”使 用 的 线程 数 ， 如 果 启 用 并 行 模 式 (忽略 其 他 方式 ) 。 
annotations 在 测试 中 使 用 注释 的 类 型 。 
time-out 默认 的 超时 时 间 ， 将 用 于 本 次 测试 中 发 现 的 所 有 测试 方法 。 


在 本 章 中 ， 我 们 会 告诉 你 一 个 例子 ， 有 两 个 Test1 & Test2 测 试 类 一 起 运行 测试 套 
件 。 


创建 一 个 类 


创建 一 个 Java 类 进行 测试 MessageUtil.java 在 C: > JUNIT WORKSPACE 


7s 
* This class prints the given message on console. 
ey 
public class MessageUtil { 
private String message; 


// Constructor 

// @param message to be printed 

public MessageUtil(String message) { 
this.message = message; 

j 


// prints the message 

public String printMessage() { 
System.out.println(message); 
return message; 


} 


// add "Hi!" to the message 

public String salutationMessage() { 
message = "Hi!" + message; 
System.out.println(message); 
return message; 


创建 测试 用 例 类 
创建 一 个 Java 类 文件 名 Test1.java TEC: > TestNG_WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class Testi { 
String message = "Manisha"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test 

public void testPrintMessage() { 
System.out.println("Inside testPrintMessage()"); 

Assert.assertEquals(message, messageUtil.printMessage()); 


j 


创建 一 个 Java 类 文件 名 Test2.java TEC: > TestNG WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class Test2 { 
String message = "Manisha"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test 

public void testSalutationMessage() { 
System.out.println("Inside testSalutationMessage()"); 
message = "Hi!" + "Manisha"; 
Assert.assertEquals(message,messageUtil.salutationMessage(;: 





现在 ， 让 我 们 编辑 写 入 testng.xml TEC: > TestNG_ WORKSPACE ， 将 包含 <suite> 
标签 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suitei"> 
«test name="exampletesti"> 
<classes> 
<class name="Testi" /> 
</classes> 
</test> 
<test name="exampletest2"> 
<classes> 
<class name="Test2" /> 
</classes> 
</test> 
</suite> 


Suite1 包括 exampletest1 和 exampletest2. 
所 有 Java 类 编译 使 用 javac。 


C:TestNG_WORKSPACE>javac MessageUtil.java Testi.java Test2.java 


tH 


见 在 运行 testng.xml， 将 运行 提供 的 测试 用 例 类 中 定义 的 测试 用 例 。 


C:TestNG WORKSPACE»java -cp "C:TestNG_WORKSPACE" org.testng.TestNG 


«| mE — ] 











验证 输出 。 


TutorialsPoint Java 技术 教程 


Inside testPrintMessage( ) 
Manisha 

Inside testSalutationMessage() 
Hi!Manisha 


Suite1 
Total tests run: 2, Failures: 0, Skips: 0 


您 也 可 以 检查 测试 输出 文件 夹 ;下 Suite1 文 件 夹 中 ， 可 以 看 到 两 个 HTML 创 建 的 
exampletest1.html 和 exampletest2.html 内 容 如 下 : 








fires die etiba entr ka ser Mer feet chine meme] 


b /ioa,ecorn 











(Hover nive eethod move to see The test chess name) 


/ioa,econ 
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有 时 ， 我 们 的 代码 是 没有 准备 好 ， 如 果 测 试用 例 写 入 到 测试 方法 /代码 将 无 法 运行 ， 
在 这 种 情况 下 ，@Test(enabled = false) 有 助 于 禁用 此 测试 案例 。 


测试 方法 是 标注 了 @Test(enabled = false)， 那 么 并 不 是 已 经 准备 好 测试 的 测试 用 例 


现在 ， 让 我 们 来 看 看 测试 @Test(enabled = false) 动作 。 


创建 一 
e 创建 一 个 Java 类 进行 测试 为 MessageUtiljava 在 C: > TestNG_WORKSPACE 


hs 

* This class prints the given message on console. 
255 

public class MessageUtil { 


private String message; 


//Constructor 

//üparam message to be printed 

public MessageUtil(String message) { 
this.message = message; 

} 


// prints the message 

public String printMessage()( 
System.out.println(message); 
return message; 


j 


// add "Hi!" to the message 
public String salutationMessage(){ 
message = "Hi!" + message; 
System.out.println(message); 
return message; 
} 
} 


创建 测 iA 案例 类 关 


e 创建 Java 测 试 类 为 IgnoreTest.java. 
e 测试 类 添加 测试 方法 testPrintMessage()，testSalutationMessage()。 


e 添加 注释 @Test(enabled = false) 到 方法 testPrintMessage(). 
创建 一 个 Java 类 文件 名 IgnoreTest.java 在 C: > TesiNG WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class IgnoreTest { 
String message = "Manisha"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test(enabled = false) 
public void testPrintMessage() { 
System.out.println("Inside testPrintMessage()"); 


message - "Manisha"; 
Assert.assertEquals(message, messageUtil.printMessage()); 
} 
@Test 


public void testSalutationMessage() { 
System.out.println("Inside testSalutationMessage()"); 


message = "Hi!" + "Manisha"; 
Assert.assertEquals(message, messageUtil.salutationMessage()); 
J 


LLL mg] 


创建 testng.xml 
创建 一 个 文件 testng.xml C: > TestNG_WORKSPACE 用 来 执行 测试 案例 


<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http 
«suite name="Suite1i"> 
«test name="testi"> 
<classes> 
<class name="IgnoreTest" /> 
</classes> 
</test> 


</suite> 





编译 MessageUtil 的 测试 用 例 类 使 用 javac。 


C:TestNG_WORKSPACE>javac MessageUtil.java IgnoreTest.java 


现在 ， 运 行 testng.xml， 将 无 法 运行 testPrintMessage () 定义 的 测试 用 例 在 测试 案 
例 类 。 


C:TestNG_WORKSPACE>java -cp "C:TestNG_WORKSPACE" org.testng.TestNG 
‘ — 








验证 输出 。 testPrintMessage () 测试 用 例 没 有 测试 。 


Inside testSalutationMessage() 
Hi!Manisha 


Suite1 
Total tests run: 1, Failures: 0, Skips: 0 


也 可 以 忽略 一 组 测试 将 在 下 一 章 中 讨论 


TestNG 组 测试 - TestNG 教 程 


在 TestNG 中 组 测试 是 一 个 新 的 创新 功能 ， 它 不 存在 于 JUnit 框 架 ， 它 允许 调度 到 适 

当 的 部 分 方法 和 瓶 坯 复杂 的 测试 方法 分 组 。 您 不 仅 可 以 声明 属于 群体 的 那些 方法 ， 

但 你 也 可 以 指定 一 组 包含 其 他 组 。 然 后 ，TestNG 可 调用 和 要 求 包 括 一 组 特定 的 群体 
(或 正则 表达 式 ) ， 而 排除 另 一 个 集合 。 这 给 了 你 最 大 的 有 灵活 性 ， 如 何 分 区 测试 ， 

如 果 想 运行 两 套 不 同 的 测试 背靠背 ， 不 要 求 重 新 编译 任何 东西 。 


组 指定 testng.xml 文 件 使 用 <groups> 标 签 。 它 可 以 发 现 无 论 是 根据 <test> 或 <suite> 
标签 。 组 指定 <suite> 标 签 适用 于 所 有 的 的 <test> 标 签 下 方 。 


现在 ， 让 我 们 看 一 个 例子 ， 如 何 组 测试 。 


创建 一 个 类 


e 创建 一 个 Java 类 进行 测试 为 MessageUtiljava 在 C: > TestNG_WORKSPACE 


7s 
* This class prints the given message on console. 
ey 
public class MessageUtil { 
private String message; 


// Constructor 

// @param message to be printed 

public MessageUtil(String message) { 
this.message = message; 


} 


// prints the message 

public String printMessage() { 
System.out.println(message); 

return message; 


} 


// add "tutorialspoint" to the message 

public String salutationMessage() { 
message = "tutorialspoint" + message; 

System.out.println(message); 

return message; 


} 


// add "www." to the message 
public String exitMessage() { 
message = "www." + message; 
System.out.println(message); 
return message; 


j 


创建 测 iA 案例 类 关 


。 创建 一 个 Java 测 试 类 为 GroupTestExample.java. 
e 测试 类 添加 测试 方法 testPrintMessage () 和 testSalutationMessage () 。 
。 组 的 测试 方法 两 个 类 别 为 : 


o 检 入 登记 测试 (checkintest) : 提交 新 的 代码 之 前 ， 你 应 该 运行 这 些 测 
试 。 他 们 通常 应 快 ，5 只 要 确保 没有 被 打破 的 基本 功能 。 


o oe iX (functest) : 这 些 测试 应 该 洱 理 软件 的 所 有 功能 ， 每 天 至 少 运 
一 次 ， 虽 然 理想 情况 下 ， 会 希望 他 们 不 断 运 行 。 


创建 Java 类 文件 名 GroupTestExample.java 在 C: > TestNG_WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class GroupTestExample { 
String message = ".com"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test(groups = { "functest", "checkintest" }) 
public void testPrintMessage() { 
System.out.println("Inside testPrintMessage()"); 


message - ".com"; 
Assert.assertEquals(message, messageUtil.printMessage()); 
} 


@Test(groups = { "checkintest" }) 
public void testSalutationMessage() { 
System.out.println("Inside testSalutationMessage()"); 


message = "tutorialspoint" + ".com"; 
Assert.assertEquals(message, messageUtil.salutationMessage()); 
} 


@Test(groups = { "functest" }) 

public void testingExitMessage() { 
System.out.println("Inside testExitMessage()"); 
message = "www." + "tutorialspoint"+".com"; 

Assert.assertEquals(message, messageUtil.exitMessage()); 


} 
| 


创建 testng.xml 


创建 一 个 文件 testng.xml C: > TestNG_WORKSPACE 来 执行 测试 用 例 ， 在 这 里 ， 
我 们 将 只 执行 这 些 测试 ， 属 于 组 functest。 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suite1"> 
«test name="testi"> 
<groups> 
<run> 
<include name="functest" /> 
</run> 
</groups> 
<classes> 
<class name="GroupTestExample" /> 
</classes> 
</test> 
</suite> 


编译 MessageUtil 的 测试 用 例 类 使 用 javac。 


C:TestNG WORKSPACE>javac MessageUtil.java GroupTestExample. java 


现在 ， 运 行 testng.xml， 只 运行 的 方法 testPrintMessage () ， 因 为 它 属 于 组 
functest。 


C:TestNG_WORKSPACE>java -cp "C:TestNG WORKSPACE" org.testng.TestNG 
a — 


验证 输出 。 只 有 的 方法 testPrintMessage () 被 执行 。 





Inside testPrintMessage() 
,Com 

Inside testExitMessage() 
www. .Com 


Suite1 
Total tests run: 2, Failures: 1, Skips: 0 


组 中 组 


组 也 可 以 包含 其 他 组 。 这 些 组 称 为 MetaGroups。 例 如 ， 您 可 能 希望 定义 一 个 组 中 
的 所 有 ， 包 括 checkintest 和 functest。 让 我 们 修改 testng.xml 文 件 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suitei"> 
«test name="testi"> 
<groups> 
«define name="all1"> 
«include name="functest"/> 
<include name="checkintest"/> 
</define> 
<run> 
«include name="all"/> 
</run> 
</groups> 
<classes> 
<class name="GroupTestExample" /> 
</classes> 
</test> 
</suite> 


执行 上 述 testng.xml 将 执行 所 有 三 个 测试 会 给 你 下 面 的 结果 : 


Inside testPrintMessage( ) 

.com 

Inside testSalutationMessage() 
tutorialspoint.com 

Inside testExitMessage() 
www.tutorialspoint.com 


Suite1 
Total tests run: 3, Failures: 0, Skips: 0 


排斥 组 


可 以 忽略 一 个 组 使 用 <exclude> 标 签 ， 如 下 图 所 示 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suitei"> 
«test name="testi"> 
<groups> 
«define name="all1"> 
«exclude name="functest"/> 
<include name="checkintest"/> 
</define> 
<run> 
«include name="all"/> 
</run> 
</groups> 
<classes> 
<class name="GroupTestExample" /> 
</classes> 
</test> 
</suite> 


TestNG zx: INA - TestNG 教 程 


TestNG 跟 踪 异 常 处 理 代码 提供 了 一 个 选项 。 可 以 测试 是 否 需 要 代码 抛 出 异常 或 不 抛 
出 。 @Test 注 释 expectedExceptions 参数 一 起 使 用 。 现 在 ， 让 我 们 来 看 看 
@Test (expectedExceptions) 在 动作 中 。 


创建 一 


e 创建 一 个 Java 类 进行 测试 说 MessageUtil.java 在 C: > TestNG_WORKSPACE 
e 在 printMessage () 方法 里 添加 一 个 错误 条 件 


Ci 

* This class prints the given message on console. 
und 

public class MessageUtil { 


private String message; 


//Constructor 

//üparam message to be printed 

public MessageUtil(String message) { 
this.message - message; 

} 


// prints the message 

public void printMessage(){ 
System.out.println(message); 
int a -0; 
int b = 1/a; 

} 


// add "Hi!" to the message 
public String salutationMessage(){ 
message = "Hi!" + message; 
System.out.println(message); 
return message; 
j 
} 


创 建 测 试 案例 类 关 


e 创建 一 个 Java 测 试 类 为 ExpectedExceptionTest.java。 
e 添加 的 ArithmeticException 和 testPrintMessage () 测试 用 例 的 预期 异常 。 


创建 一 个 Java 类 文件 名 ExpectedExceptionTest.java 在 C: > 
TestNG WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class ExpectedExceptionTest { 
String message = "Manisha"; 
MessageUtil messageUtil - new MessageUtil(message); 


QTest(expectedExceptions - ArithmeticException.class) 
public void testPrintMessage() ( 
System.out.println("Inside testPrintMessage()"); 
messageUtil.printMessage(); 
} 
@Test 
public void testSalutationMessage() { 
System.out.println("Inside testSalutationMessage()"); 
message = "Hi!" + "Manisha"; 
Assert.assertEquals(message,messageUtil.salutationMessage()), 
} 
} 


gb | 


创建 测试 运行 
创建 testng.xml 在 C: > TestNG_WORKSPACE 执行 测试 案例 。 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" > 
«suite name="Suite1"> 

«test name="test1i"> 

<classes> 
«class name="ExpectedExceptionTest" /> 

</classes> 

</test> 
</suite> 


编译 MessageUtil 测试 用 例 类 使 用 javac 


C:TestNG_WORKSPACE>javac MessageUtil.java TestJunit.java 


现在 ， 运 行 测试 运行 ， 这 将 运行 提供 的 测试 用 例 类 中 定义 的 测试 用 例 。 


C:TestNG_WORKSPACE>java -cp "C:TestNG_WORKSPACE" org.testng.TestNG 
‘ Say 








验证 输出 。testPrintMessage () 测试 的 情况 下 会 获得 通过 。 


Inside testPrintMessage() 
Manisha 

Inside testSalutationMessage() 
Hi!Manisha 


Suite1 
Total tests run: 2, Failures: 0, Skips: 0 


TestNG/K # 31 iX, - TestNG 教 程 


有 时 候 ， 你 可 能 需要 在 一 个 特定 的 顺序 调用 方法 在 测试 案例 ， 或 你 想 分 享 一 些 数据 
和 方法 之 间 的 状态 。TestNG 支 持 这 种 依赖 测试 方法 之 间 的 显 式 依赖 它 支 持 声明 。 


TestNG 人 允许 指定 依赖 ， 无 论 与 否 : 
e 使 用 属性 dependsOnMethods 在 @Test 注释 OR 
。 使 用 属性 dependsOnGroups 在 @Test 注 解 。 


使 用 属性 dependsOnMethods 例 如 


创建 一 个 类 
创建 一 个 Java 类 进行 测试 为 MessageUtil.java 在 C: > TestNG_ WORKSPACE 


public class MessageUtil { 
private String message; 


// Constructor 

// @param message to be printed 

public MessageUtil(String message) { 
this.message = message; 


} 


// prints the message 

public String printMessage() { 
System.out.println(message); 

return message; 


j 


// add "Hi!" to the message 

public String salutationMessage() { 
message = "Hi!" + message; 
System.out.println(message); 

return message; 


j 


创建 DE TK 案例 类 
e 创建 一 个 Java 测 试 类 为 DependencyTestUsingAnnotation.java. 


e 添加 方法 testPrintMessage(), testSalutationMessage() 和 
initEnvironmentTest() 到 测试 类 


e 添加 属性 dependsOnMethods = { "initEnvironmentTest" } to the (Test 注释 
oftestSalutationMessage() 方法 . 


创建 Java 类 文件 名 DependencyTestUsingAnnotation.java 在 C: > 
TestNG_WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class DependencyTestUsingAnnotation { 
String message = "Manisha"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test 
public void testPrintMessage() { 
System.out.println("Inside testPrintMessage()"); 


message - "Manisha"; 
Assert.assertEquals(message, messageUtil.printMessage()); 
J 


QTest(dependsOnMethods = ( "initEnvironmentTest" }) 
public void testSalutationMessage() ( 
System.out.println("Inside testSalutationMessage()"); 


message = "Hi!" + "Manisha"; 

Assert.assertEquals(message, messageUtil.salutationMessage()); 
} 

@Test 


public void initEnvironmentTest() { 
System.out.println("This is initEnvironmentTest"); 


) 
UH 
创建 TESTNG.XML 


创建 一 个 文件 testng.xml 在 C: > TestNG_WORKSPACE 来 执行 测试 用 例 


<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http 
«suite name="Suite1"> 

«test name="testi"> 

<classes> 

<class name="DependencyTestUsingAnnotation" /> 

</classes> 

</test> 
</suite> 


4 | = 
编译 MessageUtil 的 测试 用 例 类 使 用 javac 








C:TestNG WORKSPACE»javac MessageUtil.java DependencyTestUsingAnnot: 
* — — 8 








现在 运行 testng.xml 这 将 会 运行 testSalutationMessage() 只 有 在 执行 
ofinitEnvironmentTest() 方法 之 后 


C:TestNG WORKSPACE»java -cp "C:TestNG WORKSPACE" org.testng.TestNG 
: | m Ext] ene ; 








验证 输出 


This is initEnvironmentTest 
Inside testPrintMessage( ) 
Manisha 

Inside testSalutationMessage() 
Hi!Manisha 


Suitei 


示例 ， 使 用 属性 dependsOnGroups 
也 可 以 依赖 于 整个 群 组 的 方法 。 让 我 们 来 看 看 下 面 的 例子 : 


创建 一 个 类 
创建 一 个 Java 类 进行 测试 为 MessageUtil.java 在 C: > TestNG_ WORKSPACE 


public class MessageUtil { 
private String message; 


// Constructor 

// @param message to be printed 

public MessageUtil(String message) { 
this.message = message; 


} 


// prints the message 

public String printMessage() { 
System.out.println(message); 

return message; 


} 


// add "Hi!" to the message 

public String salutationMessage() { 
message = "Hi!" + message; 
System.out.println(message); 

return message; 


j 


创建 测试 案例 类 


e 创建 一 个 Java 测 试 类 说 依赖 TestUsingAnnotation.java. 


e 添加 测试 方法 testPrintMessage(), testSalutationMessage() 和 
initEnvironmentTest() 测试 类 和 他 们 的 组 "初始 化 " 


。 添加 属性 { "init.*" ) to the @Test 注释 
testSalutationMessage() 方法 


创建 Java 类 文件 名 DependencyTestUsingAnnotation.java 在 C: > 
TestNG_WORKSPACE 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class DependencyTestUsingAnnotation { 
String message = "Manisha"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test(groups = { "init" }) 
public void testPrintMessage() { 
System.out.println("Inside testPrintMessage()"); 


message - "Manisha"; 
Assert.assertEquals(message, messageUtil.printMessage()); 
} 


@Test(dependsOnGroups = { "init.*" }) 
public void testSalutationMessage() { 
System.out.println("Inside testSalutationMessage()"); 


message = "Hi!" + "Manisha"; 
Assert.assertEquals(message, messageUtil.salutationMessage()); 
} 


@Test(groups = { "init" }) 
public void initEnvironmentTest() { 
System.out.println("This is initEnvironmentTest"); 


j 


DM [1 


在 这 个 例子 中 ，testSalutationMessage () 被 声明 为 根据 任何 一 组 匹配 正则 表达 
式 “ 的 init”， 这 保证 了 ， 一 种 方法 ，testPrintMessage 的 () 和 
initEnvironmentTest () 将 始终 前 testSalutationMessage () 被 调用 。 


> 如 果 一 个 方法 失败 ， 取 决 于 你 有 一 个 很 难 依赖 于 它 (alwaysRun= false, ZEA 
认 的 ) ， 没 有 标记 的 方法 依赖 于 它 的 失败 ， 但 作为 跳 过 。 跳 过 的 方法 将 被 报告 为 例 
如 在 最 终 报告 〈 在 HTML 中 ， 既 不 是 红 也 不 是 绿 的 颜色 ) ， 这 是 很 重要 的 ， 因 为 跳 
过 的 方法 不 一 定 是 失败 。 


创建 TESTNG.XML 


创建 一 个 文件 testng.xml C: > TestNG_WORKSPACE 执行 测试 案例 


<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http 
«suite name="Suite1i"> 

«test name="testi"> 

<classes> 

<class name="DependencyTestUsingAnnotation" /> 

</classes> 

</test> 
</suite> 





gj 





编译 MessageUtil 的 测试 用 例 类 使 用 javac 


C:TestNG WORKSPACE>javac MessageUtil. java DependencyTestUsingAnnot: 





s= 


现在 ， 运 行 testng.xml， 这 将 运行 testSalutationMessage () 方法 后 ， 才 执行 
initEnvironmentTest () 方法 。 


C:TestNG WORKSPACE»java -cp "C:TestNG_WORKSPACE" org.testng.TestNG 
H—— ———— —— É — B — jm 


验证 输出 





This is initEnvironmentTest 
Inside testPrintMessage( ) 
Manisha 

Inside testSalutationMessage() 
Hi!Manisha 


Suite1 
Total tests run: 3, Failures: 0, Skips: 0 


dependsOnGroups Vs dependsOnMethods 
e 在 使 用 组 ， 我 们 不 再 面临 重 构 的 问题 。 只 要 我 们 不 修改 dependsOnGroups 或 
组 属性 ， 我 们 的 测试 将 继续 运行 ， 设 立 适 当 的 依赖 。 


。 每 当 一 个 新 的 方法 需要 添加 依存 关系 图 中 ， 我 们 需要 做 的 就 是 把 它 正 确 的 组 
中 ， 并 确保 它 依赖 于 正确 的 组 。 我 们 不 需要 修改 任何 其 他 方法 。 


TestNG 参 数 化 测试 - TestNGA FE 


在 TestNG 的 另 一 个 有 趣 的 功能 是 参数 测试。 在 大 多 数 情况 下 ， 你 会 遇 到 这 样 一 个 场 
景 ， 业 务 逻 辑 需 要 一 个 巨大 的 不 同 数 量 的 测试 。 参 数 测试 ， 人 允许 开发 人 员 运 行 同样 
的 测试 ， 一 通 又 一 通 使 用 不 同 的 值 。 


TestNG 让 你 直接 传递 参数 测试 方法 两 种 不 同 的 方式 : 
e 使 用 testng.xml 
e 数据 提供 程序 


专递 参数 使 用 testng.xml 


有 了 这 种 技术 ， 在 testng.xml 文 件 中 定义 的 简单 参数 ， 然 后 在 源 文件 中 引用 这 些 参 
数 。 让 我 们 看 看 下 面 的 例子 中 如 何 使 用 这 种 技术 来 传递 参数 。 


创建 测试 案例 类 
e 创建 一 个 Java 测 试 类 ParameterizedTest1 java. 


e il 试 方法 parameterTest () 添加 到 测试 类 。 此 方法 需要 一 个 字符 串 作 为 输入 参 


o 


e 添加 注释 QParameters("myName") 到 此 方法 。 该 参数 将 被 传递 testng.xml， 
在 下 一 步 我 们 将 看 到 一 个 值 。 


创建 Java 类 文件 名 ParameterizedTest1.java 在 C: > TestNG_WORKSPACE 


import org.testng.annotations.Parameters; 
import org.testng.annotations.Test; 


public class ParameterizedTesti { 
@Test 
@Parameters("myName" ) 
public void parameterTest(String myName) { 
System.out.println("Parameterized value is : " + myName); 
} 


} 
EJE : ii 


创建 TESTNG.XML 


创建 testng.xml C: > TestNG_WORKSPACE 执行 测试 案例 


<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http 
«suite name="Suitei"> 
<test name="testi"> 
<parameter name-"myName" value="manisha"/> 
<classes> 
<class name="ParameterizedTesti" /> 
</classes> 
</test> 
</suite> 


«| n 








> 我 们 还 可 以 定义 参数 在 <suite> 级 别 。 假 设 我 们 已 经 定义 在 两 个 <suite> 和 <test> 级 
别 myName， 在 这 种 情况 下 ， 常 规 的 作用 域 规则 适用 。 这 意味 着 ， 任 何 类 里 面 
<test> 标 签 业 查看 值 参数 定义 在 <test>， 而 testng.xml 文 件 中 的 类 的 其 余部 分 将 看 到 
定义 在 <suite> 中 值 


编译 使 用 javac 的 测试 用 例 类 。 
C:TestNG_WORKSPACE>javac ParameterizedTesti.java 
现在 ， 运 行 testng.xml， 其 中 将 运行 parameterTest 方 法 。TestNG 的 将 试图 找到 一 个 


命名 myName 的 第 一 <test> 标 签 的 参数 ， 然 后 ， 如 果 它 不 能 找到 它 ， 它 会 搜索 包围 
在 的 <suit> 标 签 。 


C:TestNG WORKSPACE»java -cp "C:TestNG WORKSPACE" org.testng.TestNG 





验证 输出 。 


Parameterized value is : manisha 


Suite1 
Total tests run: 1, Failures: 0, Skips: 0 


TestNG 对 testng.xml 的 参数 的 类 型 指定 的 值 会 自动 党 斌 转换。 下 面 是 支持 的 类 
型 : 


e String 
e int/Integer 
e boolean/Boolean 


e byte/Byte 


e char/Character 
e double/Double 
e float/Float 

e long/Long 

e short/Short 


千 递 参数 与 数据 提供 者 


当 你 需要 通过 复杂 的 参数 或 参数 需要 创建 从 Java ( 复 厅 的 对 象 ， 对 象 读 取 属性 文件 
或 数据 库 等 ..) ， 在 这 种 情况 下 ， 可 以 将 参数 传递 使 用 数据 提供 者 。 数 据 提供 者 
@DataProvider 的 批注 的 方法 。 这 个 注解 只 有 一 个 字符 串 属性 : 它 的 名 字 。 如 果 不 
提供 名 称 ， 数 据 提供 者 的 名 称 会 自动 默认 方法 的 名 称 。 数 据 提供 者 返回 一 个 对 象 数 
组 。 


让 我 们 看 看 下 面 的 例子 使 用 数据 提供 者 。 第 一 个 例子 是 @DataProvider 的 使 用 
Vector，String 或 Integer 作为 参数 ， 第 二 个 例子 是 关于 @DataProvider 的 使 用 对 象 
作为 参数 。 

实例 1 


在 这 里 @DataProvider 通过 整数 和 布尔 参数 。 


创建 Java 类 


创建 一 个 java 类 PrimeNumberChecker.java。 这 个 类 检查 ， 如 果 是 素数 。 创 建 这 个 
X f£ C: > TestNG_WORKSPACE 


public class PrimeNumberChecker { 
public Boolean validate(final Integer primeNumber) ( 
for (int i = 2; i « (primeNumber / 2); i++) ( 
if (primeNumber % i == 0) { 
return false; 


} 


return true; 


创建 测 | 1) TK 案例 类 


e 创建 一 个 Java 测 试 类 ParamTestWithDataProvider1.java. 


e 定义 方法 primeNumbers () ， 其 定义 为 DataProvider 使 用 注释 。 此 方法 返回 
的 对 象 数组 的 数组 。 


e 测试 方法 testPrimeNumberChecker () 添加 到 测试 类 中 。 此 方法 需要 一 个 整 
数 和 布尔 值 作为 输入 人 参数。 这 个 方法 验证 ， 如 果 传 递 的 参数 是 一 个 素数 。 


e 添加 注释 @Test(dataProvider = "test1") 到 此 方法 。dataProvider 的 属性 被 映 
射 到 "test1". 


创建 Java 类 文件 名 ParamTestWithDataProvider1.java 在 C: > 
TestNG WORKSPACE 


import org.testng.Assert; 

import org.testng.annotations.BeforeMethod; 
import org.testng.annotations.DataProvider; 
import org.testng.annotations.Test; 


public class ParamTestWithDataProvideri { 
private PrimeNumberChecker primeNumberChecker; 


QBeforeMethod 
public void initialize() { 

primeNumberChecker - new PrimeNumberChecker(); 
} 


@DataProvider(name = "test1") 
public static Object[][] primeNumbers() { 
return new Object[][] { { 2, true }, { 6, false }, { 19, ti 
{ 22, false P, { 23, true } }; 


} 


// This test will run 4 times since we have 5 parameters define 
@Test(dataProvider = "testi") 
public void testPrimeNumberChecker(Integer inputNumber, 
Boolean expectedResult) { 
System.out.println(inputNumber + " " + expectedResult); 
Assert.assertEquals(expectedResult, 
primeNumberChecker.validate(inputNumber)); 





创建 TESTNG.XML 


创建 testng.xml C: > TestNG_WORKSPACE 执行 测试 案例 。 


<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http 
«suite name="Suitei"> 
<test name="testi"> 
<classes> 
<class name="ParamTestWithDataProvider1i" /> 
</classes> 
</test> 
</suite> 





‘| 
编译 使 用 javac 的 测试 用 例 类 。 





C:TestNG WORKSPACE».javac ParamTestWithDataProvideri.java PrimeNuml 





is fTtestng.xml. 


C:TestNG WORKSPACE»java -cp "C:TestNG WORKSPACE" org.testng.TestNG 
T E) 


验证 输出 。 





2 true 

6 false 
19 true 
22 false 
23 true 


Suite1 
Total tests run: 5, Failures: 0, Skips: 0 


在 这 里 ，@DataProvider 传递 对 象 作为 参数 。 


创建 Java 类 


创建 一 个 Java 类 Bean.java, 对 象 带 有 get/set Aik, 在 C: > 
TestNG_WORKSPACE. 


public class Bean { 
private String val; 
private int i; 
public Bean(String val, int i){ 
this.val=val; 
this.i-i; 


j 
public String getVal() ( 
return val; 


} 
public void setVal(String val) { 
this.val = val; 


J 
public int getI() { 
return i; 


public void setI(int i) { 
this. i = i; 


} 


创建 DE TK 案例 类 
e 创建 一 个 Java 测 试 类 ParamTestWithDataProvider2.java. 


e 定义 方法 primeNumbers () ， 其 定义 为 DataProvider 使 用 注释 。 此 方法 返回 的 
对 象 数组 的 数组 。 


e. 添加 测试 类 中 测试 方法 TestMethod () 。 此 方法 需要 对 象 的 bean 作 为 参数 。 


。 添加 注释 @Test(dataProvider = "test1") 到 此 方法 . dataProvider 属性 被 映射 到 
"test". 


创建 Java 类 文件 名 ParamTestWithDataProvider2.java f£ C: > 
Test NG WORKSPACE 


import org.testng.annotations.DataProvider; 
import org.testng.annotations.Test; 


public class ParamTestWithDataProvider2 { 
@DataProvider(name = "testi") 
public static Object[][] primeNumbers() { 
return new Object[][] { { new Bean("hi I am the bean", 111. 
} 


@Test(dataProvider = "test1") 
public void testMethod(Bean myBean) { 
System.out.println(myBean.getVal() + " " + myBean.getI()); 





创建 TESTNG.XML 


创建 一 个 文件 testng.xml C: > TestNG_WORKSPACE 来 执行 测试 用 例 . 


<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http 
«suite name="Suitei"> 
<test name="testi"> 
<classes> 
<class name="ParamTestWithDataProvider2" /> 
</classes> 
</test> 
</suite> 


SSS aay] 





编译 使 用 javac 的 测试 用 例 类 。 


C:TestNG_WORKSPACE>javac ParamTestWithDataProvider2.java Bean.java 
—_ Sa E) 
运行 testng.xml. 


C:TestNG WORKSPACE»java -cp "C:TestNG_WORKSPACE" org.testng.TestNG 
d m m 





验证 输出 。 


hi I am the bean 111 


Suite1 
Total tests run: 1, Failures: 0, Skips: 0 


TestNG 运 行 JUnit 测 试 - TestNG 教 程 


现在 ， 您 已 经 了 解 了 TestNG 和 它 的 各 种 测试 ， 如 果 现 在 担心 如 何 重 构 现 有 的 JUnit 
代码 ， 那 就 没有 必要 ， 使 用 TestNG 提 供 了 一 种 方法 ， 从 JUnit 和 TestNG 按 照 自己 的 
节 泰 。 也 可 以 使 用 TestNG 执 行 现 有 JUnit 测 试用 例 。 


TestNG 可 以 自动 识别 和 运行 JUnit 测 斌 ， 所 以 你 可 以 使 用 TestNG 运 行 所 有 的 测试 ， 
并 编写 新 的 测试 使 用 TestNG。 所 有 你 必须 做 的 就 是 把 JUnit 的 库 TestNG 的 类 路 径 
上 ， 它 可 以 发 现 并 使 用 JUnit 类 ， 改 变 测 试 运行 从 JUnit 和 TestNG Ant 中 ， 然 后 运行 
TestNG 的 “mixed” 模 式 。 这 种 方式 可 以 在 同一 个 项 目 中 所 有 的 测试 ， 即 使 是 在 同一 
个 包 中 ， 并 开始 使 用 TestNG。 这 种 方法 还 可 以 转换 您 现 有 的 JUnit 测 试 到 TestNG。 


让 我 们 来 看 看 下 面 的 例子 中 ， 并 党 试 了 上 述 功能 : 


创建 JUnit 测 试用 例 类 


创建 一 个 Java 类 ， 这 是 一 个 JUnit 测 试 类 ， TestJunitjava 在 C: > 
TestNG_WORKSPACE 


import org.junit.Test; 
import static org.testng.AssertJUnit.assertEquals; 


public class TestJunit { 
@Test 
public void testAdd() { 
String str= "Junit testing using TestNG"; 
assertEquals("Junit testing using TestNG",str); 


现在 ， 让 我 们 来 编写 testng.xml 在 C: > TestNG_WORKSPACE 应 该 包涵 «suite» 
标签 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd"> 
<suite name="Converted JUnit suite" > 
<test name="JUnitTests" junit="true"> 
<classes> 
<class name="TestJunit" /> 
</classes> 
</test> 
</suite> 


要 执行 JUnit 测 试用 例 定义 属性 junit="true" 如 上 面 的 xml 文 件 中 . JUnit 测 试用 例 类 
TestJunit 定 义 在 类 名 。 


JUnit 4 中 ，TestNG 将 使 用 org.junit.runner.JUnitCore 运行 测试 。 
所 有 Java 类 编译 使 用 javac。 


C:TestNG_WORKSPACE>javac TestJunit.java 


现在 运行 testng.xml， 这 将 运行 TestNG 的 JUnit 测 试用 例 。 


C:TestNG_WORKSPACE>java -cp "C:TestNG_WORKSPACE:C:TestNG_WORKSPACE- 





在 这 里 ， 我 已 经 放 在 了 junit-4.11.jar 在 C:TestNG_WORKSPACElibjunit-4.11 jar F 
面 . 


验证 输出 。 


Converted JUnit suite 


Total tests run: 1, Failures: 0, Skips: 0 


TestNG 测 试 结果 报告 - TestNG 教 程 


报告 是 任何 测试 的 执行 是 最 重要 的 部 分 ， 原 因 是 它 可 以 帮助 用 户 了 解 执行 测试 ， 故 
障 点 和 失败 的 原因 的 结果 。 记 录 ， 另 一 方面 ， 重 要 的 是 要 留意 执行 流程 ， 或 在 任何 
故障 的 情况 下 进行 调试 。 


TestNG 上 默认 情况 下 ， 会 产生 不 同类 型 的 测试 执行 报告 。 这 包括 HTML 和 和 XML 报表 输 
出 。 TestNG 的 还 允许 用 户 自己 写 的 报告 ， 并 用 它 使 用 TestNG。 还 有 一 个 选项 来 写 
你 自己 的 记录 器 ， 在 运行 时 通过 TestNG 的 通知 。 


主要 有 两 种 方法 来 生成 报告 使 用 TestNG : 


e 监听 器 : 为 了 实现 一 个 监听 类 ， 类 有 实现 theorg.testng。 ITestListener 接 口 。 这 
些 类 在 运行 时 通知 了 TestNG 测 试 开 始 时 ， 结 束 后 ， 失 败 ， 跳 过 或 传递 。 

e 记录 器 : 为 了 实现 一 个 报表 类 ， 实 现 一 个 org.testng.IReporter 接 口 。 这 些 类 一 

整套 运行 结束 时 调用 。 调 用 时 ， 该 对 象 包含 整个 测试 运行 的 信息 传递 到 这 个 


米 
Fo 


下 表 列 出 了 不 同 的 情况 报告 和 记录 的 例子 : 

自 定义 日 志 这 个 例子 说 明 如 何 编 写 您 自己 的 记录 。 

自 定义 记录 器 这 个 例子 说 明了 如 何 编 写 自己 的 记录 器 。 

HTML 和 XML 报告 ”这 个 例子 说 明了 默认 的 HTML 和 XML 报告 TestNG 产 生 。 
JUnit 报告 这 个 例子 说 明了 TestNG 的 报告 生成 Junit 的 报告 。 


TestNG 插 件 与 ANT - TestNG 教 程 


在 这 个 例子 中 ， 我 们 将 演示 如 何 使 用 ANT 运 行 TestNG。 让 我 们 遵循 的 步骤 : 


步骤 1 : FikApache Ant 


下 载 Apache Ant 


OS 压缩 文件 名 
Windows apache-ant-1.8.4-bin.zip 
Linux apache-ant-1.8.4-bin.tar.gz 
Mac apache-ant-1.8.4-bin.tar.gz 
步骤 2 : 设置 Ant 环 境 


设置 ANT_HOME 环 境 变 量 指向 参考 基本 目录 的 位 置 ，ANT 库 存储 在 您 的 机 器 上 。 
例如 ， 我 们 已 经 存储 了 Ant 库 apache-ant-1.8.4， 各 种 操作 系统 上 的 文件 夹 如 下 : 


OS 输出 
设置 环境 变量 ANT_HOME to C:Program FilesApache Software 


Windows Foundationapache-ant-1.8.4 
Linux export ANT_HOME=/usr/local/apache-ant-1.8.4 
Mac export ANT_HOME=/Library/apache-ant-1.8.4 


附加 的 Ant 编 译 系 统 路 径 位 置 ， 在 不 同 的 操作 系统 如 下 : 


OS 输出 
Windows 追加 字符 串 ;%ANT_HOMEin 系统 变量 的 结尾 
Linux export PATH=$PATH:$ANT_HOME/bin/ 
Mac not required 


第 3 步 : 下 载 TestNG 


FAhttp://www.testng.org. 


OS Archive name 


Windows testng-6.8.jar 
Linux testng-6.8.jar 
Mac testng-6.8.jar 


第 4 步 : 创建 项 目 结构 


e 创建 文件 夹 TestNGWithAnt TEC: > TestNG_WORKSPACE 

e 创建 文件 夹 src f£ C: > TestNG_WORKSPACE > TestNGWithAnt 
e 创建 文件 夹 test 在 C: > TestNG_WORKSPACE > TestNGWithAnt 
e 创建 文件 夹 lib 在 C: > TestNG_WORKSPACE > TestNGWithAnt 


e 创建 MessageUtil 类 在 C: > TestNG_WORKSPACE > TestNGWithAnt > src X 
(tx. 


ak 

* This class prints the given message on console. 
=y 

public class MessageUtil { 


private String message; 


//Constructor 

//@param message to be printed 

public MessageUtil(String message){ 
this.message = message; 

} 


// prints the message 

public void printMessage(){ 
System.out.println(message); 
return message; 

} 


// add "Hi!" to the message 

public String salutationMessage(){ 
message = "Hi!" + message; 
System.out.println(message); 
return message; 

} 


} 


e 创 Æ TestMessageUtil 类 在 C: > TestNG_WORKSPACE > TestNGWithAnt > 
src 目录 . 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class TestMessageUtil { 
String message = "Manisha"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test 

public void testPrintMessage() { 
System.out.println("Inside testPrintMessage()"); 
Assert.assertEquals(message,messageUtil.printMessage()); 


j 


QTest 

public void testSalutationMessage() ( 
System.out.println("Inside testSalutationMessage()"); 
message = "Hi!" + "Manisha"; 
Assert.assertEquals(message,messageUtil.salutationMessage(;: 





e 拷贝 testng-6.8.jar 到 C: > TestNG_WORKSPACE > TestNGWithAnt > lib 3c 
ES 


创建 ANT build.xml 
首先 ， 我 们 需要 定义 TestNG 的 ant 任 务 如 下 : 


«taskdef name="testng" classname="org.testng.TestNGAntTask"> 
<classpath> 
<pathelement location="lib/testng-6.8.jar"/> 
</classpath> 
</taskdef> 


然后 我 们 使 用 <testng> TestNG 的 测试 案例 Ant 来 执行 任务 。 
C: > TestNG_WORKSPACE > TestNGWithAnt > build.xml 内 容 如 下 : 


<project name="TestNGTest" default="test" basedir="."> 
<!-- Define <testng> task --> 
«taskdef name="testng" classname="org.testng.TestNGAntTask"> 
<classpath> 
<pathelement location="lib/testng-6.8.jar"/> 
</classpath> 
</taskdef> 
<property name="testdir" location="test" /> 
«property name="Srcdir" location="src" /> 
«property name-"libdir" location-"lib" /> 
«property name="full-compile" value="true" /> 
<path id="classpath.base"/> 
<path id="classpath.test"> 
<fileset dir="${libdir}"> 
«include namez'"**/*,jar" /> 
</fileset> 
<pathelement location="${testdir}" /> 
«pathelement location="${srcdir}" /> 
«path refid="classpath.base" /> 
</path> 
<target name="Clean" > 
«delete verbose="${full-compile}"> 
<fileset dir="${testdir}" includes="**/*.class" /> 
</delete> 
</target> 
«target name-"compile" depends="clean"> 
«javac srcdir="${srcdir}" destdir="${testdir}" 
verbose="${full-compile}"> 
<classpath refid="classpath.test"/> 
</javac> 
</target> 
<target name="test" depends="compile"> 
<testng outputdir="${testdir}" classpathref="classpath.test"> 
«xmlfileset dir="${srcdir}" includes="testng.xml"/> 
</testng> 
</target> 
</project> 


SSS AUM[ 


执行 下 列 ant 命 令 。 


C:TestNG WORKSPACETestNGWithAnt»ant 


验证 输出 


test: 
[testng] [TestNG] Running: 
[testng] C:TestNG WORKSPACETestNGWithAntsrc estng.xml 
[testng] 
[testng] Inside testPrintMessage() 
[testng] Manisha 
[testng] Inside testSalutationMessage() 
[testng] Hi!Manisha 
[testng] 
[testng] Emme eme pm — m 
[testng] Plug ANT test Suite 
[testng] Total tests run: 2, Failures: 0, Skips: 0 
[testng] pa rejen reyra pe eneee e a pary rea ye e pan yras ye e apaa e pa y eeaeee peer a ar pje 
[testng] 


BUILD SUCCESSFUL 
Total time: 1 second 


TestNG Eclipse 插件 - TestNG 教 程 


用 eclipse 设 置 TestNG， 下 面 的 步骤 必须 遵循 : 


步骤 1 : 下 载 TestNG 的 为 档 文件 


FA http:/www.testng.org 


OS 压缩 文件 名 
Windows testng-6.8.jar 
Linux testng-6.8.jar 
Mac testng-6.8.jar 


假设 你 上 面 复 制 的 JAR 文 件 到 C:>TestNG Xt x. 


第 二 步 : 设置 Eclipse 环境 

e 打开 eclipse -> 右键 单 击 项 目 ， 然 后 单 击 property > Build Path > Configure 
Build Path 并 添加 testng-6.8.jar 在 库 中 使 用 Add External Jar 按钮 . 

i © Properties for Testlunit k-aj 


type filter text Java Build Path P vw 


























Resource PT 一 
Beaninfo Path ( Source [e Projects | BA Libraries | 5; Order and Export | 


Builders JARs and class folders on the build path: 
FindBugs *« junit-4.10.jar - C:\JUNIT 
Geogle BA JRE System Library [jdk1.6.0 21] 
HTML Code Formatter 
Java Build Path 
Java Code Style 








Add JARs... 





Add External JARS., — 








uei Macinble ss 
Java Compiler 


| 

| 

| 
Java Editor | | Add Library... 

| 

| 

| 

| 





Javadoc Location 

JS Code Formatter 
PMD 

Project Natures 
Project References 
Run/Debug Settings 
Server 

Task Repository 
Task Tags 

Tomcat 

Validation 

XML Code Formatter 
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e 我 们 假设 你 的 eclipse 中 TestNG 插 件 已 经 内 置 ， 如 果 不 是 ， 那 么 请 使 用 更 新 站 
点 获取 最 新 版 本 : 


o 在 你 的 eclipse IDE, 选择 Help / Software updates / Find and Install. 
o 搜索 新 功能 安装 。 
o 新 的 远程 站 点 。 


For Eclipse 3.4 and above, enter http://beust.com/eclipse. 


o 


o 


For Eclipse 3.3 and below, enter http://beust.com/eclipse1. 
o Make sure the check box next to URL is checked and click Next. 
o 然后 Eclipse 会 引导 帮 您 完成 整个 过 程 。 


现在 ， 你 的 eclipse 已 经 可 以 使 用 TestNG 测 试用 例 的 开发 做 好 准备 。 


步骤 3 : 确认 Eclipse 已 经 安装 TestNG 


e 在 eclipse 中 创建 一 个 项 目 TestNGProject 
e 创建 一 类 MessageUtil 在 项 目测 试 。 


Jo 

* This class prints the given message on console. 
is 

public class MessageUtil { 


private String message; 


//Constructor 

//üparam message to be printed 

public MessageUtil(String message) { 
this.message - message; 


} 


// prints the message 
public String printMessage(){ 
System.out.println(message); 
return message; 
} 
} 


e 在 项 目 中 创建 一 个 测试 类 TestNGExample 


import org.testng.Assert; 
import org.testng.annotations.Test; 


public class TestNGExample { 
String message = "Hello World"; 
MessageUtil messageUtil = new MessageUtil(message) ; 


@Test 
public void testPrintMessage() { 
Assert.assertEquals(message,messageUtil.printMessage()); 


m 
4 
0 
n 


Ò Project Explorer zd Iù TestNGExample.java £i 


Y i$ TestNGProject import org.testng,Assert; 
" i src import org.testng.annotations.Test; 
( 


Y ® (default package] 
public class TestNGExample ( 
String message = "Hello World"; 
* (Jj TestNGExample java MessageUtil messageUtil = new MessageUtil (message) ; 
> mA JRE System Library [Javast 


> UF) MessageUtil java 


> ww Lestng-6.8.jar 


LY Test 
1 public void testPrintMessage() 4 

Assert.assertEqual s(message ,messagevtil.printMessage( |); 
j 


最 后 ， 通 过 右 击 程序 和 TestNG 的 运行 验证 程序 的 输出 。 


验证 结果 。 


Or D ss 3'4 
cid x a E cael 
> Project Explorer Hi Eis 有 1 TetNCExamplejeve 1 ^m" 
wf Test NCProject isport org, testing. Assert 


lapert org. testng. annotations. Test; 


* ih (defaut package) 
> i Messageutit java peblic class TestWéE»asmple [ 
* UJ; TestNGExample java 
* m JRE System Library , © comeole AD Revelts of running cass Test GEXxample 22. de Junit . 


* E testing 6a ja 
Tests: t/t Methods: 1 (118 ms] 
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Apache Tika 是 什么 ? 


Apache Tika 用 于 文件 类 型 检测 和 从 各 种 格式 的 文件 内 容 提取 的 库 。 


ile Tika 使 用 现 有 的 各 种 文件 解析 器 和 文档 类 型 的 检测 技术 来 检测 和 提取 
2 Jio 

使 用 Tika， 人 们 可 以 开发 出 通用 型 检测 器 和 内 容 提取 到 的 不 同类 型 的 文件 ， 如 
电子 表格 ， 文 本 文件 ， 图 像 ，PDF 文 件 甚至 多 媒体 输入 格式 ， 在 一 定 程度 上 提 
取 结 构 化 文本 以 及 元 数据 。 


Tika 提 供用 于 解析 不 同文 件 格 式 的 一 个 通用 API。 它 采用 83 个 现 有 的 专业 解析 
器 库 ， 为 每 个 文档 类 型 。 


所 有 这 些 解 析 器 库 是 根据 一 个 叫做 Parser 接 口 单一 接口 封装 。 





TXT 


为 什么 用 Tika? 


据 filext.com 网 站 统计 ， 大 约 有 1.5 万 至 51K 的 内 容 类 型 ， 并 且 这 个 数字 还 在 与 日 俱 
增 。 数 据 被 存储 在 不 同 的 格式 ， 如 文本 文档 ，excel 表 格 ，PDF， 图 像 和 多 媒体 文 
件 ， 人 和信 举 几 例 。 因 此 ， 应 用 程序 如 搜索 引 警 和 内 容 管理 系统 需要 从 这 些 文档 类 型 容 
易 提 取 数 据 的 额外 的 支持 。Apache Tika 通过 提供 一 个 通用 的 APl 来 检测 并 提取 多 
种 文件 格式 的 数据 服务 达到 这 一 目的 。 


Apache Tika 应 用 


有 各 种 各 样 的 应 用 程序 使 用 Apache Tika。 在 这 里 ， 我 们 将 讨论 严重 依赖 Apache 
Tika 几 个 突出 的 应 用 。 


搜索 引擎 
开发 搜索 引擎 索引 的 数字 文档 的 文本 内 容 使 Tika 被 广泛 使 用 。 
e. 搜索 引擎 是 用 于 搜索 的 网 页 信息 和 索引 文件 的 信息 处 理 系统 。 
。 抓 取 工 具 是 通过 Web 抓 取 获 取 使 用 一 些 素 引 技术 被 索引 的 文件 搜索 引擎 的 重要 
组 成 部 分 。 此 后 ， 抓 取 工 具 传 送 这 些 索 引文 件 提取 成 分 。 
e 提取 成 分 的 职责 是 提取 文档 中 的 文本 和 元 数据 。 这 样 提取 的 内 容 和 元 数据 是 对 
搜索 引擎 非常 有 用 。 该 提取 组 件 包含 在 Tika 中 。 


e eee ti 它 来 建立 一 个 搜索 索引 搜索 引擎 的 索引 器 。 此 
外 ， 该 搜索 引擎 使 用 许多 其 它 方式 提取 的 内 容 也 是 如 此 。 






































response , request T d 7 
to user >» sl 4 ; 
| crawl 
m CH 
ERE 人 
collection of documents data search [ sec N 
4—— + 
| index 
search engine 
The above diagram is the architecture of " 
search engine mise podi e of the 
earch engine internally uses apache Tika 
文档 分 析 
e 在 人 工 智 能 领域 ， 有 一 定 的 工具 来 自动 分 析 文 件 在 语义 层面 ， 并 提取 各 种 数据 
来 自 他 们 。 


e 在 这 种 应 用 中 ， 这 些 文件 是 基于 在 文档 的 所 提取 的 内 容 的 突出 方面 进行 分 类 
这 些 工具 使 用 提 Tika 内 容 提 取 分 析 从 纯 文 本 到 不 同 的 数字 文档 文件 。 


些 组 织 管理 他 们 的 数字 ee 种 称 为 数字 资产 管理 (DAM) 的 特殊 
应 用 程序 的 照片 ， 电子 书 ， 音乐 和 视频 。 


。 这样 的 应 用 程序 采取 的 文件 类 型 检测 器 和 元 数据 提取 器 的 帮助 下 到 的 各 种 文件 
进行 分 类 。 
内 容 分 析 


e. 像 亚马逊 网 站 建议 根据 自己 的 兴趣 刚刚 发 布 了 他 们 的 网 站 内 容 向 个 人 用 户 。 要 
做 到 这 一 点 ， 这 些 网 站 遵循 机 器 学 习 技 术 ， 或 采取 了 类 似 Facebook 的 社交 媒体 
网 站 的 帮助 下 ， 以 提取 所 需 的 信息 ， 如 喜欢 和 用 户 的 利益 。 此 收集 到 的 信息 将 
在 HTML 标 签 或 其 他 格式 需要 另外 的 内 容 类 型 检测 和 提取 的 形式 。 


e 为 一 个 文件 ， 内 容 分 析 ， 我 们 有 实现 ， 如 UIMA 和 Mahout 的 机 器 学 习 技术 的 技 
术 。 这 些 技术 是 在 聚 类 和 分 析 中 的 文件 中 的 数据 是 有 用 的 。 


e Apache Mahout 是 一 个 框架 ， 它 提供 基于 Apache Hadoop 的 ML 算法 - 一 个 云 计 
算 平台 。 Mahout 提供 了 下 面 的 某 个 集群 和 过 滤 技术 的 架构 。 按 照 这 个 架构 ， 
程序 员 可 以 编写 自己 的 ML 算法 ， 通 过 采取 各 种 文本 和 元 数据 的 组 合 来 产生 建 
议 。 提 供 输入 这 些 算 法 ， 最 近 Mahout 的 版 本 使 用 Tika 提 取 二 进 制 内 容 的 文本 和 
元 数据 。 

e Apache UIMA 分 析 和 处 理 各 种 编程 语言 ， 并 产生 UIMA 注 解 。 在 内 部 ， 它 使 用 
提 卡 注解 者 抽取 文档 中 的 文本 和 元 数据 。 


历史 


年 份 开发 

2006 ”Tika 的 想法 是 在 Lucene 项 目 管理 委员 会 eis 

2006 ”Tika 及 其 在 Jackrabbit 项 目 有 用 的 概念 进行 了 讨论 。 

2007 . Tika i# AApacheS##1b 23. 

2008 版 本 0.1 和 0.2 发 布 ，Tika 从 孵化 器 到 Lucene 子 项 目 独 立 。 

2009 版 本 0.3，0.4， 和 0.5 发 布 。 

2010 版 本 0.6 和 0.7 发 布 ，Tika 进 入 Apache 的 项 级 项 目 。 

2011 ”Tika1.0 发 布 ， 并 Tika 的 书籍 “Tika in Action "也 在 同一 年 被 发 布 。 
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应 用 程序 员 可 以 很 容易 地 在 他 们 的 应 用 程序 集成 Tika。Tika 提 供 了 一 个 命令 行 界 面 
和 图 形 用 户 界面 ， 使 它 比 较 人 性 化 。 


在 本 章 中 ， 我 们 将 讨论 构成 Tika 架 构 的 四 个 重要 模块 。 下 图 显示 了 Tika 的 四 个 模块 
的 体系 结构 : 


语言 检测 机 制 。 
MIME 检 测 机 制 。 
Parser 接 口 。 
Tika Facade 类 . 


Tika Architecture 





MIME detection mechanism 


Sa 
MIME type MIME type 
repository identfer 





语言 检测 机 制 


每 当 一 个 文本 文件 被 传递 到 Tika， 它 将 检测 在 其 中 的 语言 。 它 接受 没有 语言 的 注释 
文件 和 通过 检 令 测 该 语 言 添加 在 该 文件 的 元 数据 信息 。 


2: Biz sl, Tika 有 一 类 叫做 语言 标识 符 在 包 org.apache.tika.language 及 语言 识 
资 资料 库 里 面包 含 了 语言 检测 从 给 定 文本 的 算法 。Tika 内 部 使 用 N-gram 算 法 语言 


B 


MIME 检 测 机 制 


Tika 可 以 根据 MIME 标 准 检测 文档 类 型 。Tika 默 认 MIME 类 型 检测 是 使 用 
org.apache.tika.mime.mimeTypes。 它 使 用 org.apache.tika.detect.Detector 接口 大 
部 分 内 容 类 型 检测 。 


内 部 Tika 使 用 多 种 技术 ， 如 文件 匹配 替换 ， 内 容 类 型 提示 ， 魔 术 字 节 ， 字 符 编码 ， 
以 及 其 他 一 些 技术 。 


解析 器 接口 


org.apache.tika.parser 解析 器 接口 是 Tika 解 析 文 档 的 主要 接口 。 该 接口 从 提取 文档 
中 的 文本 和 元 数据 ， 并 总 结 了 其 对 外 部 用 户 愿 意 写 解析 器 插件 。 


采用 不 同 的 具体 解析 器 类 ， 具 体 为 各 个 文档 类 型 ，Tika 支持 大 量 的 文件 格式 。 这 些 
eede a MEME 
部 F 用 器 库 。 


Tika Facade 类 


使 用 的 Tika facade 类 是 从 Java 调 用 Tika 的 最 简单 和 起 接 的 方式 ， 而 且 也 浴 用 了 外 观 
的 设计 模式 。 可 以 在 Tika API 的 org.apache.tika 包 Tika 找到 外 观 facade 类 。 


通过 实现 基本 用 例 ，Tika 作 为 facade 的 代理 。 它 抽象 了 的 Tika 库 的 底层 复 订 性 ， 例 
站 并 提供 给 用 户 一 个 简单 的 接口 来 
FB. 


Tika 的 特点 


。 统 一 解析 器 接口 : Tika 封 装 在 一 个 单一 的 解析 器 接口 的 第 三 方 解 析 器 库 。 由 于 
这 个 特征 ， 用 户 逸 出 从 选择 合适 的 解析 器 库 的 负担 ， 并 使 用 它 ， 根 据 所 遇 到 的 
文件 类 型 。 


。 低 内 存 占用 : Tika 因 此 消耗 更 少 的 内 存 资源 也 很 容易 戏 入 Java 应 用 程序 。 也 可 
以 用 Tika 平 台 像 移动 那样 PDA 资 源 少 ， 运 行 该 应 用 程序 。 


DRE EE: 从 应 用 连结 内 容 检 测 和 提取 可 以 预期 的 。 
灵活 元 数据 : Tika 理 解 所 有 这 些 都 用 来 描述 文件 的 元 数据 模型 。 


e 解析 器 集成 : Tika 可 以 使 用 可 在 单一 应 用 程序 中 每 个 文件 类 型 的 各 种 解析 器 
库 。 

。 MIME 类 型 检测 : Tika 可 以 检测 并 从 所 有 包括 在 MIME 标 准 的 媒体 类 型 中 提取 内 
容 。 


e 语言 检测 : Tika 包 括 语言 识别 功能 ， 因 此 可 以 在 一 个 多 语种 网 站 基于 语言 类 型 
的 文档 中 使 用 。 


Tika 的 功能 
Tika 支 持 多 种 功能 : 
e 文档 类 型 检测 
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e 内 容 提取 
元 数据 提取 


e 语言 检测 


文件 类 型 检测 
Tika 使 用 不 同 的 检测 技术 ， 检 测绘 它 的 文件 的 类 型 。 


一 到 
VIDEO 





内 容 提 取 


Tika 有 一 个 解析 器 库 ， 可 以 分 析 各 种 文档 格式 的 内 容 ， 并 提取 它们 。 然 后 检测 所 述 
文档 的 类 型 ， 它 从 解析 器 库 选 择 的 适当 的 分 析 器 ， 并 传递 该 文档 。 不 同类 别 的 Tika 
方法 来 解析 不 同 的 文件 格式 。 





元 效 据 提取 


随 着 内 容 ，Tika 提 取 具 有 相同 的 程序 的 文件 的 元 数据 中 的 内 容 的 提取 。 对 于 某 些 文 
件 类 型 ，Tika 有 接口 类 提取 元 数据 。 
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在 内 部 ，Tika 如 下 像 一 个 n-gram 算法 来 检测 所 述 内 容 的 语言 的 给 定 文档 中 。Tika 取 
决 于 类 ， 如 语言 识别 和 Profiler 的 语言 识别 。 
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TIKA 环 境 配置 - Tika 教 程 


本 章 将 指导 完成 设置 Apache Tika 在 Windows 和 Linux 的 配置 过 程 。 用 户 管理 是 必要 
的 ， 同 时 安装 了 Apache Tika. 


JDK Java SE 2 JDK 1.6 或 以 上 
AF 1 GB RAM (推荐 ) 

硬盘 空间 无 最 小 要 求 

操作 系统 版 本 Windows XP 或 以 上 , Linux 


第 1 步 : 验证 安装 Java 


为 了 验证 Java 安 装 ， 打 开 控 制 台 并 执行 下 面 的 Java 命 倒 。 


OS 任务 fp 
Windows 打开 命令 控制 台 \>java -version 
Linux 打开 命令 终端 $java -version 


如 果 Java 已 经 正确 地 在 您 的 系统 已 经 安装 ， 那 么 应 该 得 到 以 下 输出 之 一 ， 具 体 取决 
于 您 所 使 用 的 平台 上 。 


OS 输出 


Java version "1.7.0 60"Java (TM) SE Run Time Environment 
Windows (build 1.7.0 60-b19)Java Hotspot (TM) 64-bit Server VM (build 
24.60-b09, mixed mode) 


java version "1.7.0 25"Open JDK Runtime Environment (rhel- 
Lunix 2.3.10.4.el6 4-x86 64)Open JDK 64-Bit Server VM (build 23.7- 
b01, mixed mode) 


e. 假设 本 教程 的 读者 都 在 继续 本 教程 之 前 把 Java1.7.0_60 安 装 在 他 们 的 系统 中 。 


。 如 果 没 有 安装 Java SDK， 从 下 载 其 最 新 版 本 
http://www.oracle.com/technetwork/java/javase/downloads/index.htmll and 
have it installed. 


第 2 步 : 设置 Java 环 境 


设置 JAVA_HOME 环 境 变量 指向 到 安装 在 机 器 上 的 Java 基 本 目录 的 位 置 。 例 如 ， 
OS 输出 
Windows ”设置 环境 变量 JAVA HOME to C:\ProgramFiles\java\jdk1.7.0_60 
Linux export JAVA_HOME=/usr/local/java-current 


附加 Java 编 译 器 的 位 置 到 系统 路 径 的 完整 路 径 。 


OS 输出 


Append the String; C:\Program Files\Java\jdk1.7.0_60\bin to the 
end of the system variable PATH. 


Linux export PATH=$PATH:$JAVA_HOME/bin/ 


Windows 


验证 命 邻 java 版本， 命令 提示 符 如 上 所 述 。 


第 3 步 : 设置 Apache Tika 环 境 

可 以 在 自己 的 环境 中 通过 使 用 集成 Apache Tika : 
mpi, 

Tika API, 

Tika (CLI) 的 命令 行 界 面 ， 


Tika 的 图 形 用 户 界面 (GUI) , & 
源 代码 


对 于 任何 一 种 方法 ， 首 先 ， 必 须 下 载 的 Tika 源 代码 。 
Tika 的 源 代 码 在 http://Tika.apache.org/download.htmll， 在 那里 找到 两 个 链接 : 


apache-tika-1.6-sre.zip: 它 包 含 的 Tika 的 源 代 码 以 及 Tika -app-1.6.jar: 它 是 一 个 包 
含 Tika 应 用 程序 的 JAR 文 件 。 


下 载 这 两 个 文件 。Tika 的 官方 网 站 的 快照 如 下 所 示 。 


Apeche Tika - Download 


m IBM Test 000-610: D d > Red Hat Enterprise 


Th k : mee" Apache 


Software Foundation 


J 10101100 
101110101100 110 


Download Apache Tika aram 


Apache Tika 1.6 is now available. See the CHANGES txt © file for more information 
on the list of updates in this initial release 


e Japache-tika-1.6-sre zip [9 (source archive, PGP signature ©) 
SHA1: 65644121446130fa29f1b62bcd75fb33344a6ba3 
MDS: ee3426654feb7a5b21477d174b6ddc71 

è EEC (runnable jar, PGP signature ©) 

SHA]: 99df0d8c3f6a2be498d275053e611fb5afdfOa9d 
MDS: 2d8af1f228000f cda92bd0dda20b80a8 











Apache Tika releases are available under the Apache License, Version 2.0 ©. See the 


下 载 文 件 后 ， 设 置 类 路 径 的 JAR 文 件 tika-app-1.6.jar。 添 加 jar 文件 的 完整 路 径 ， 
如 图 表 所 示 。 


Os Output 
添加 字符 串 “C:\jars\Tika-app-1.6.jar” 到 用 户 环境 变量 
Windows: | (CLASSPATH 
I Export CLASSPATH=$CLASSPATH:/usr/share/jars/Tika-app- 
1.6.tar: 


Apache 提 供 Tika 应 用 程序 ， 使 用 Eclipse 的 图 形 用 户 界 面 (GUI) 应 用 程序 。 


使 用 Eclipse 构建 Tika-Maven 


e 打开 Eclipse， 并 创建 一 个 新 的 项 目 。 
e 如 果 在 Eclipse 中 没有 Maven， 按 照 给 定 的 步骤 进行 设置 。 


o 打开 link http://wiki.eclipse.org/M2E_updatesite_and_gittags. 在 那里 ， 会 
发 现 m2e 插 件 版 本 以 表格 格式 
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Dp etnies 7120 OS OT 7 
(EMN te Ee EEEE T 3 
































e 挑选 的 最 新 版 本 ， 并 保存 在 URL 网 址 的 p2 列 的 路 径 。 


和 选择 安装 新 
软 


File Edit Source Refactor Navigate Search Project Run Window 
R ts Y o X Q - a [C] - a * Welcome 
= Ovo v 





Help Contents 
Quick Access 时 i 2P Search 
| DD) aliParsersjave — |J) TikaExjava 23 | ": Rd 
| Key Assist... Ctrl+ Shift+L 
Tips and Tricks... 
s } Cheat Sheets... 


9, Check for Updates 


Install New Software... 


WD Installation Details 
fọ Eclipse Marketplace... 
S About Eclipse 


i 
2 public class TikaEx { 

















e €i Add 按钮 ， 输 入 任何 想 要 的 名 称 ， 它 是 可 选 的 。 现 在 贴 在 位 置 字段 中 
保存 的 URL。 

e 一 个 新 的 插件 选择 在 上 一 步 中 添加 的 名 字 ， 选 中 复 选 框 在 它 前 面 ， 然 后 单 击 下 
一 步 Next。 
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Available Software 
Check the items that you wish to install. ‘sy 


Werk with: | maven eclipse pluin -http//download.ecipse v| Ada.. | 


Find more software by working with the “Available Software Sites" preferences. 








| type filter text 


b [v] 000 Maven Integration for Eclipse 


| 
| Name | 


SelectAll | | DeselectAll | 1 item selected 





Details 


Show only the latest versions of available software Hide iterns that are alre 
[V| Group items by category What is already installed 
[V] Show only software applicable to target environment 

[V] Contact all update sites during install to find required software 








e 继续 安装 。 完 成 后 ， 重 新 启动 Eclipse。 
e 现在 ， 右 键 单 击 该 项 目 ， 并 在 配置 选择 Convert to Maven 项 目 。 


° NM MM MAGN 输入 组 ID 为 org.apache.tika， 进 入 Tika 的 
最 新 版 本 ， 选 择 jar 包 ， 然 后 单 击 Finish。 


Maven 项 目 己 成 功 安装 ， 并 且 项 目 转化 成 Maven。 现 在 ， 必 须 配置 pom.xml 文 件 。 


配置 XML 文件 


可 以 通过 Tika Maven 的 依赖 http://mvnrepository.com/artifact/org.apache.tika 
下 面 显 示 的 是 Apache Tika 完 整 的 Maven 依 赖 。 
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<dependency> 
«groupId»org.apache.Tika«c/groupId» 
<artifactId>Tika-core</artifactId> 
<version>1.6</version> 


<groupiId>org.apache.Tika</groupId> 
<artifactId> Tika-parsers</artifactId> 
<version> 1.6</version> 


«groupId» org.apache.Tika</groupId> 
<artifactId>Tika</artifactId> 
<version>1.6</version> 


«groupId»org.apache.Tika«c/groupId» 
< artifactId>Tika-serialization</artifactId> 
« version»1.6« /version» 


^ 


groupId»org.apache.Tika« /groupId» 
< artifactId>Tika-app< /artifactId> 
< version>1.6< /version> 


«groupId»org.apache.Tika«c/groupId» 
<artifactId>Tika-bundle</artifactId> 
<version>1.6</version> 

</dependency> 


TIKAS4 API - Tika 教 程 
用 六 可 以 在 使 用 Tike AVAL HE BRERA Tka, Ata ARS KAA 


它 是 一 个 外 网 类 ，Tika 抽 象 的 背后 有 其 功能 的 复杂 性 。 除 了 这 一 点 ， 用 
ee ie TENTE ee 


User Applications 









Document 


Type 
Content 
Extraction 






Detection 


Tika # (facade) 


这 是 最 突出 的 Tika 类 库 和 正面 设计 模式 。 因 此 ， 抽 象 所 有 的 内 部 实现 ， 并 提供 了 简 
单 的 方法 来 访问 Tika 功 能 。 下 表 列 出 该 类 的 构造 画 数 以 及 它们 的 描述 。 


package : org.apache.tika 


class: Tika 
S.No. HERA% HH 
1 Tika () 使 用 默认 配置 ， 构 建 Tika 类 。 
2 Tika (Detector detector) 通 过 接受 检测 实例 作为 参数 创建 Tika 的 外 观 
3 Tika (Detector detector, Parser parser) 创 建 一 个 Tika 外 观 通 过 接受 


伟 测 和 解析 器 实例 作为 参数 。 


Tika (Detector detector, Parser parser, Translator translator) 创 建 


: 一 个 Tika 外 观 通过 接受 检测 器 ， 解 析 器 ， 并 且 转 换 实例 作为 参数 。 
5 Tika (TikaConfig config) 创 建 一 个 Tika 外 观 通 过 接受 TikaConfig 类 作 


为 参数 的 对 象 。 


方法 和 说 明 


以 下 是 Tika 外 观 类 的 重要 方法 : 


S.No. 


方法 和 描述 


String parseToString (File file) 此 方法 及 其 所 有 变种 分 析 作为 参数 传 
递 的 文件 ， 并 返回 字符 串 格 式 提取 的 文本 内 容 。 默 认 情 况 下 ， 这 个 字 
符 串 参数 的 长 度 是 有 限 的 。 


int getMaxStringLength () 返 回 由 parseToString 方 法 返回 字符 串 的 最 
大 长 度 。 


void setMaxStringLength (int maxStringLength) 设 置 由 
parseToString 方 法 返回 的 字符 串 的 最 大 长 度 。 


Reader parse (File file) 该 方法 及 其 所 有 变型 解析 作为 参数 传递 的 文 
件 ， 并 返回 java.io.Reader 对 象 的 形式 ， 所 提取 的 文本 内 容 。 


String detect (InputStream stream, Metadata metadata) 该 方法 及 
其 所 有 变 接 受 InputStream 对 象 和 元 数据 对 象 作为 参数 ， 检 测 出 给 定 文 
档 的 类 型 ， 并 返回 该 文件 类 型 的 名 称 作为 字符 串 对 象 。 这 种 方法 提炼 
使 用 Tika 的 检测 手段 。 


String translate (InputStream text, String targetLanguage) 此 方法 
及 其 所 有 变种 接受 InputStream 对 象 ， 并 表示 ， 我 们 希望 我 们 的 文字 被 
2 AFFE, FIHPENMAMBHNES, Zi A a MR 


Di 


解析 器 接口 


这 是 Tika 包 的 所 有 解析 器 类 实现 的 接口 。 


package : org.apache.tika.parser 


Interface : Parser 


方法 和 说 明 


以 下 是 TikaParser 接 口 的 重要 方法 : 


S.No. 


方法 及 描述 


parse (InputStream stream, ContentHandler handler, Metadata 
metadata, ParseContext contexft) 这 个 方法 将 给 定 的 文档 解析 到 
XHTML 和 SAX 事 件 序列 。 解 析 后 ， 将 放置 在 ContentHandler 类 的 对 
象 ， 并 在 元 数据 的 类 的 对 象 的 元 数据 ， 所 提取 的 文件 的 内 容 。 


Metadata # 


这 个 类 实现 了 各 种 接口 ， 如 素材 ， 地 理 ，HttpHeaders， 消 息 ， 微 软 Office， 气 候 预 
测 ，TIFF，TikaMetadataKeys，TikaMimeKeys，Serializable 接 口 ， 支 持 各 种 数据 
模型 。 下 表 列 出 了 构造 本 数 和 这 个 类 的 方法 及 其 说 明 。 


package : org.apache.tika.metadata 


class : Metadata 


S.No. 构造 方法 及 描述 
1 Metadata() 构 造 一 个 新 的 ， 空 的 元 数据 。 
S.No. 方法 及 描述 


add (Property property, String value) 增 加 了 一 个 元 数据 属性 / 值 映 射 
到 给 定 的 文件 。 使 用 此 功能 ， 可 以 将 该 值 设置 为 一 个 属性 。 


add (String name, String value) 增 加 了 一 个 元 数据 属性 / 值 映 射 到 给 
2 定 的 文件 。 使 用 这 种 方法 ， 我 们 可 以 使 用 新 名 称 的 值 设置 为 一 个 文 
件 ， 从 现 有 的 元 数据 。 


String get (Property property) 返 回 给 定 的 元 数据 属性 的 值 GORA 


Hie) . 

4 String get (String name) 返 回 给 定 元 数据 的 名 称 的 值 (如 果 有 的 
Eb s 

5 Date getDate (Property property) 返 回 日 期 的 元 数据 属性 的 值 。 

6 String[] getValues (Property property) 返 回 的 元 数据 属性 的 所 有 的 
值 。 

7 String[] getValues (String name) 返 回 给 定 元 数据 的 名 称 的 所 有 的 
值 。 

8 String[] names() 返 回 元 数据 对 象 的 元 数据 元 素 的 所 有 的 名 字 。 

9 set (Property property, Date date) 设 置 给 定 的 元 数据 属性 的 日 期 值 

10 set(Property property, String[] values) 设 置 多 个 值 到 一 个 元 数据 属 
ME. 

jo BB 标 IR ARE 


IE XR T SOGEPNESBURE. FRIE T 3x 3 B345358 ES 23UZL CC LB TRIS, 
package : org.apache.tika.language 


class : Language Identifier 


S.No. 


S.No. 


构造 器 和 说 明 


Languageldentifier (LanguageProfile profile) 实 例 化 的 语言 标识 
符 。 在 这 里 必须 通过 一 个 LanguageProfile 对 象 作为 参数 。 


Languageldentifier (String content) 这 个 构造 画 数 可 以 通过 从 文本 内 
容 传递 一 个 String 实 例 化 一 个 语言 标识 符 

构造 器 和 说 明 
String getLanguage () 返 回 给 当前 Languageldentifier 对 象 的 语言 。 
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Tika 支 持 的 文件 格式 


下 面 的 表 显 示 了 Tika 支 持 的 文件 格式 。 


文件 格式 类 库 
XML org.apache.tika.parser.xml 
HTML org.apache.tika.parser.htmll and it uses Tagsoup Library 
MS-Office 
Compound org.apache.tika.parser.microsoftorg.apache.tika.parser.micros 
eocument les and it uses Apache Poi library 
till 2007 ooxml 
2007 onwards 
OpenDocument 
Format org.apache.tika.parser.odf 
openoffice 
portable | 
Document e ASS PARIERA and this package uses Apache Pdi 
Format(PDF) ry 
Electronic 
Ee a org.apache.tika.parser.epub 
Format (digital g-ap AP s 
books) 
Rich Text : 
formal org.apache.tika.parser.rtf 
Compression : I 
and packaging WORD alias and this package uses Common c 
formats RN 
Text format org.apache.tika.parser.txt 
Feed and 
syndication org.apache.tika.parser.feed 
formats 


Audio formats 


Imageparsers 


org.apache.tika.parser.audio and org.apache.tika.parser.mp3 


org.apache.tika.parser.jpeg 


Videoformats 


java class files 
and jar files 


Mobxformat 
(email 
messages) 


Cad formats 
FontFormats 


executable 
programs and 
libraries 


org.apache.tika.parser.mp4 and org.apache.tika.parser.video 
parser internally uses Simple Algorithm to parse flash video fc 


org.apache.tika.parser.asm 


org.apache.tika.parser.mbox 


org.apache.tika.parser.dwg 


org.apache.tika.parser.font 


org.apache.tika.parser.executable 
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MIME 标准 


多 用 途 Internet 邮 件 扩展 (MIME) 标 准 ， 用 于 识别 文件 类 型 的 最 佳 标 准 。 这 些 标准 的 

知识 有 助 于 在 内 部 相互 作用 的 浏览 器 。 

当 浏 览 器 遇 到 一 个 媒体 文件 ， 它 选择 可 用 它 来 显示 其 内 容 的 兼容 软件 。 在 情况 下 ， 

a enn ene ee QUEE 
件 软件 。 


Tika 类 型 检测 


Tika 支 持 MIME 所 提供 的 所 有 互联 网 媒体 文件 类 型 。 每 当 一 个 文件 通过 Tika 检 测 到 该 
文件 ， 其 文件 类 型 。 检 测 的 介质 类 型 ，Tika 内 部 通过 以 下 机 制 。 


文件 扩展 名 


检查 文件 扩展 名 是 检测 的 文件 的 格式 的 最 简单 和 最 广泛 使 用 的 方法 。 许 多 应 用 程序 
和 操作 系统 提供 这 些 扩展 的 支持 。 下 面 所 示 是 一 些 已 知 文件 类 型 的 扩展 名 。 


文件 名 扩展 名 
image .jpg 
audio .mp3 
java archive file jar 
java class file .class 


内 容 类 型 提示 


每 当 从 数据 库 中 检索 文件 或 将 其 附加 到 另 一 个 文档 ， 可 能 会 失去 该 文件 的 名 称 或 扩 
展 名 。 在 这 种 情况 下 ， 该 文件 所 提供 的 元 数据 被 用 于 检测 文件 的 扩展 名 。 


ERF 

遵守 文件 的 原始 字 节 ， 可 以 为 每 个 文件 找到 一 些 独特 的 字符 模式 。 一 些 文件 具有 特 
殊 的 字 节 前 缀 称 为 被 专门 制 成 并 包含 在 一 个 文件 中 ， 用 于 识别 文件 类 型 的 目的 魔术 
字 节 。 

例如 ， 可 以 找到 CA FE BA 在 一 个 PDF 文件 (十 六 进 制 格式 ) 的 一 个 java 文 件 和 PDF 
% (ASCII 格 式 ) 。 Tika 使 用 此 信息 来 识别 的 文件 的 媒体 类 型 。 


字符 编码 

文件 纯 文 本 使 用 不 同类 型 的 字符 编码 的 编码 。 这 里 的 主要 挑战 是 确定 在 文件 中 使 用 
的 字符 编码 的 类 型 。Tika 一 样 的 标记 和 字 节 的 频率 来 识别 所 使 用 的 纯 文 本 内 容 的 编 
码 系 统 字符 编码 技术 。 

XML 根 字 符 

为 了 检测 XML 文档 ，Tika 解 析 XML 文 档 并 提取 ， 如 根 元 素 ， 命 名 空间 和 引用 的 架 
构 ， 从 文件 的 真实 介质 类 型 ， 可 以 找到 的 信息 。 

使 用 Facade 类 类 型 检测 


facade 类 的 detect() 方法 被 用 于 检测 文档 类 型 。 这 个 方法 接受 一 个 文件 作为 输入 。 
下 面 显 示 的 是 文件 类 型 检测 与 Tika 外 观 类 的 示例 程序 。 


import java.io.File; 
import org.apache.tika.Tika; 
public class Typedetection { 
public static void main(String[] args) throws Exception { 


//assume example.mp3 is in your current directory 
File file = new File("example.mp3");// 


//Instantiating tika facade class 
Tika tika = new Tika(); 


//detecting the file type using detect method 


String filetype = tika.detect(file); 
System.out.println(filetype); 


将 以 上 代码 保存 为 TypeDetection.java 并 在 命令 提示 符 上 使 用 以 下 命令 运行 它 : 


javac TypeDetection. java 
java TypeDetection 


audio/mpeg 


TIKA 内 容 提取 - Tika 教 程 
Tika 使 用 不 同 的 解析 器 库 来 提取 给 解析 器 的 内 容 。 它 选择 了 正确 的 语法 分 析 器 提取 
给 定 的 文档 类 型 


解析 文件 ， 一 般 用 于 Tika 外 观 facade 类 的 parseToString() 方 法 。 下 面 显 示 的 是 所 涉 
及 分 析 过 程 的 步 又 和 这 些 由 Tika 的 ParsertoString() 方 法 提取 。 





抽象 的 分 析 过 程 : 


e 最 初 ， 当 我 们 传 一 个 文件 到 Tika， 它 使 用 与 之 适合 的 类 型 检测 机 制 和 检测 文件 
类 型 。 


e 一 且 文 档 类 型 是 已 知 的 ， 它 选择 从 解析 器 库 中 合适 的 解析 器 。 解 析 器 库 中 包含 
的 类 使 用 外 部 库 。 


s 2 提取 文本 ， 并 且 还 抛 出 了 不 可 读 格 式 异 
常 解析 器 。 


使 用 Tika 内 容 提 取 
下 面 给 出 的 是 程序 使 用 Tika facade 类 从 文件 中 提取 文本 : 


import 
import 


import 
import 


import 
public 


pub 


java.io.File; 
java.io. IOException; 


org.apache.tika.Tika; 
org.apache.tika.exception.TikaException; 


org.xml.sax.SAXException; 
class TikaExtraction { 
lic static void main(final String[] args) throws IOException, 


//Assume sample.txt is in your current directory 
File file - new File("sample.txt"); 


//Instantiating Tika facade class 

Tika tika - new Tika(); 

String filecontent - tika.parseToString(file); 
System.out.println("Extracted Content: " + filecontent); 





将 以 上 代码 保存 为 TikaExtraction.java 并 在 命令 提示 符 下 运行 : 


javac 
java T 


TikaExtraction.java 
ikaExtraction 


注意 : 假设 sample.txt 是 具有 下 列 内 容 。 


Hi stu 


dents welcome to yiibai 


它 提供 了 以 下 的 输出 : 


Extrac 


ted Content: Hi students welcome to yiibai 


使 用 Parser 接 口内 容 提 取 


Tika 解析 器 包 提供 了 使 用 它 可 以 分 析 一 个 文本 文档 的 几 个 接口 和 类 。 下 面 给 出 的 是 
org.apache.tika.parser 包 的 框架 图 。 


Parser Interface 


CompositeParser 









C2 






AutoDetectParser 


有 几 个 可 用 的 解析 器 类 ， 如 PDF 格式 分 析 器 ，Mp3Passer，OfficeParser 等 ， 逐 一 
分 析 各 自 的 文件 。 所 有 这 些 类 都 实现 了 解析 器 接口 。 


CompositeParser 
给 出 的 图 表 显 示 Tika 通 用 解析 器 类 CompositeParser 主 AutoDetectParser。 由 于 


CompositeParser 类 遵循 复合 设计 模式 ， 可 以 用 一 组 解析 器 实例 作为 一 个 单独 的 解 
析 器 。CompositeParser 类 也 可 以 访问 所 有 实现 解析 器 接口 的 类 。 


AutoDetectParser 


这 是 CompositeParser 的 子 类 ， 它 提供 了 自动 类 型 检测 。 使 用 此 功能 ， 
AutoDetectParser 自 动 发 送 收 到 的 文件 到 使 用 该 复合 方法 适当 分 析 器 类 。 


parse() 方 法 


除了 parseToString()， 还 可 以 使 用 分 析 器 接口 的 parse() 方 法 。 该 方法 的 原型 如 下 所 
人 小 \o 


parse([InputStream](http://docs.oracle.com/javase/6/docs/api/java/: 
[ParseContext](https://tika.apache.org/1.6/api/org/apache/tika/par: 


[Ri pesce 
下 表 列 出 了 它 接 受 作为 参数 的 四 个 对 象 。 





S.No. 对 象 及 描述 


1 InputStream stream 包 含 任何 文件 的 InputStream 对 象 的 内 容 
ContentHandler handlerTika 通 过 文档 作为 XHTML 内 容 到 此 你 理 ， 此 
2 后 该 文件 正在 使 用 SAX API 人 处 理 。 它 提供 了 在 一 个 文件 有 效 的 后 处 理 
的 内 容 。 
3 Metadata metadata 元 数据 对 象 是 用 来 既 作 为 源 和 文件 的 元 数据 的 目 
标 。 
4 ParseContext context 此 对 象 使 用 在 如 遇 有 客户 端点 用 程序 想 要 定制 
解析 过 程 。 
例如 : 
下 面 给 出 一 个 例子 ， 说 明 如 何 使 用 parse() 方 法 。 
d: 


要 使 用 解析 器 接口 的 parse() 方 法 ， 实 例 化 任何 为 其 提供 实现 这 个 接口 的 类 。 


也 有 个 别 解析 器 类 ， 如 PDFParser，OfficeParser，XMLParser 等 等 。 可 以 使 用 这 
些 个 人 文件 解析 器 。 或 者 也 可 以 使 用 CompositeParser 或 AutoDetectParser 在 内 部 
使 用 的 所 有 解析 器 类 ， 并 提取 使 用 合适 的 解析 器 文档 的 内 容 。 


Parser parser = new AutoDetectParser(); 
(or) 

Parser parser = new CompositeParser(); 
(or) 


object of any individual parsers given in Tika Library 


步骤 2 : 
创建 一 个 处 理 类 的 对 象 。 下 面 给 出 的 是 三 个 内 容 处 理 程序 : 


S.No. 类 及 描述 
BodyContentHandler 这 个 类 采用 XHTML 输出 的 主体 部 分 ， 并 写 和 人 该 

1 内 容 到 输出 写 入 或 输出 流 。 然 后 重 定向 XHTML 内 容 到 另 一 个 内 容 义 理 
程序 实例 。 

2 LinkContentHandler 这 个 类 检测 ， 并 挑选 XHTML 文档 的 所 有 H- 参 考 
标签 和 转发 那些 使 用 类 似 网 络 礁 虫 工具 。 

3 TeeContentHandler 这 个 类 可 以 帮助 在 同时 使 用 多 个 工具 。 


由 于 我 们 的 目标 是 要 提取 的 文件 的 文本 内 容 ， 实 例 化 BodyContentHandler 如 下 图 所 
小: 


BodyContentHandler handler = new BodyContentHandler( ); 


步骤 3 : 
创建 的 元 数据 对 象 ， 如 下 所 示 : 


Metadata metadata = new Metadata(); 


步骤 4 : 
创建 任何 输入 流 对 象 ， 并 通过 您 的 文件 应 该 被 提取 到 它 。 


Filelnputstream 


通过 将 文件 路 径 作 为 参数 实例 化 一 个 文件 对 象 ， 这 个 对 象 传递 给 的 FilelnputStream 
3 BS 44385 WAX. 


注意 : 传递 给 文件 对 象 的 路 径 不 应 包含 空格 。 
使 用 这 些 输入 流 类 的 问题 是 ， 它 们 不 支持 随机 访问 读 取 ， 来 高 效 地 人 处理 某 些 文件 格 
式 是 必需 。 要 解决 此 问题 ，Tika 提 供 TikalnputStream。 


File file=new File(filepath) 
FileInputStream inputstream-new FileInputStream(file); 


(or) 


InputStream stream = TikaInputStream.get(new File(filename)); 


步骤 5 : 
创建 一 个 解析 的 上 下 文 对 象 ， 如 下 所 示 : 


ParseContext context -new ParseContext(); 


步骤 6 : 
实例 化 解析 器 对 象 ， 调 用 parse 方 法 ， 并 通过 所 有 需要 的 对 象 ， 如 下 面 的 原型 : 


parser.parse(inputstream, handler, metadata, context); 


下 面 给 出 的 是 程序 使 用 的 解析 器 接口 内 容 提取 : 


import java.io.File; 
import java.io.FileInputStream; 
import java.io.IOException; 


import org.apache.tika.exception.TikaException; 
import org.apache.tika.metadata.Metadata; 
import org.apache.tika.parser.AutoDetectParser; 
import org.apache.tika.parser.ParseContext; 
import org.apache.tika.parser.Parser; 

import org.apache.tika.sax.BodyContentHandler; 


import org.xml.sax.SAXException; 
public class ParserExtraction { 
public static void main(final String[] args) throws IOException, SA) 


//Assume sample.txt is in your current directory 
File file = new File("sample.txt"); 


//parse method parameters 

Parser parser = new AutoDetectParser(); 
BodyContentHandler handler = new BodyContentHandler(); 
Metadata metadata = new Metadata(); 

FileInputStream inputstream = new FileInputStream(file); 
ParseContext context = new ParseContext(); 


//parsing the file 
parser.parse(inputstream, handler, metadata, context); 
System.out.println("File content : " + Handler.toString()); 





将 以 上 代码 保存 为 ParserExtraction.java 并 在 命令 提示 符 下 运行 : 


javac ParserExtraction.java 
java ParserExtraction 


假设 sample.txt 包含 以 下 内 容 。 
Hi students welcome to yiibai 
它 提 供 了 以 下 的 输出 : 


File content : Hi students welcome to yiibai 


TIKA 元 数据 提取 - Tika 教 程 


除了 内 容 ，Tika 还 可 以 从 一 个 文件 中 提取 元 数据 。 元 数据 是 什么 ， 但 用 文件 所 提供 
res 如 果 我 们 考虑 一 个 音频 文件 ， 艺 术 家 名 ， 专 辑 名 ， 标 题 下 自 带 的 元 数 
fo 


XMP 标 准 
可 扩展 元 数据 平台 (XMP) 是 用 于 义理 和 涉及 到 的 文件 的 内 容 存储 信息 的 标准 。 它 是 


由 Adobe 系 统 公司 的 XMP 创 建 提 供 了 用 于 定义 ， 创 建 和 元 数据 的 处 理 标 准 。 可 以 赃 
入 该 标准 为 多 种 文件 格式 ， 如 PDF，JPEG，JPEG，GIF，JPG，HTML 等 。 


Property 类 


Tika 使 用 属性 类 遵循 XMP 属 性 定义 。 它 提供 了 PropertyType 和 值 类 型 榴 举 捕获 的 元 
数据 的 名 称 和 值 。 


Metadata # 


这 个 类 实现 了 各 种 接口 ， 如 ClimateForcast, CativeCommons,Geographic, TIFF 等 
提供 各 种 元 数据 模型 的 支持 。 此 外 ， 此 类 提供 各 种 方法 来 提取 一 个 文件 的 内 容 。 


Metadata 名 称 


我 们 可 以 从 它 的 元 数据 对 象 用 的 方法 () 提 取 一 个 文件 的 所 有 元 数据 的 名 称 的 列表 。 
它 返回 所 有 的 名 字 作 为 一 个 字符 串 数 组 。 使 用 元 数据 的 名 称 ， 就 可 以 得 到 使 用 get() 
方法 的 值 。 它 需要 一 个 元 数据 的 名 称 ， 并 返回 与 它 相 关联 的 值 。 


String[] metadaNames = metadata.names(); 


String value = metadata.get(name); 


使 用 解析 法 提取 元 数据 


当 我 们 分 析 一 个 使 用 文件 parse()， 传 递 一 个 空 的 元 数据 对 象 作为 一 个 参数 。 这 种 方 
法 提取 指定 的 文件 的 元 数据 (如 果 该 文件 中 包含 有 )， 并 将 它们 放置 在 元 数据 对 象 。 
因此 ， 在 使 用 parse() 解 析 文 件 后 ， 就 可 以 提取 该 对 象 的 元 数据 。 


Parser parser = new AutoDetectParser(); 

BodyContentHandler handler = new BodyContentHandler(); 

Metadata metadata = new Metadata(); //empty metadata object 
FileInputStream inputstream = new FileInputStream(file); 
ParseContext context = new ParseContext(); 
parser.parse(inputstream, handler, metadata, context); 

// now this metadata object contains the extracted metadata of the 
metadata.metadata.names(); 





«| 
下 面 给 出 的 是 一 个 完整 的 程序 ， 从 文本 文件 中 提取 元 数据 。 





import 
import 
import 


import 
import 
import 
import 
import 
import 


import 
public 


pub 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.AutoDetectParser; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.Parser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 
class GetMetadata { 
lic static void main(final String[] args) throws IOException, 


//Assume that boy.jpg is in your current directory 
File file-new File("boy.jpg"); 


//Parser method parameters 

Parser parser - new AutoDetectParser(); 
BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FileInputStream(file); 
ParseContext context = new ParseContext(); 


parser.parse(inputstream, handler, metadata, context); 
System.out.println(handler.toString()); 


//getting the list of all meta data elements 
String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 





将 以 上 代码 保存 为 GetMetadata.java 并 在 命令 提示 符 处 使 用 以 下 命令 运行 它 : 


javac 
java 


GetMetadata .java 
GetMetadata 


注意 : 假设 下 面 的 图 片 是 boy.jpg 





rer 
TE] boy.jpg - Windows Photo Viewer [c5 | © jm OU 


File ~ Print ~ E-mail Burn * Open v 





它 提供 了 以 下 的 输出 : 


Resolution Units: inch 

Compression Type: Baseline 

Data Precision: 8 bits 

Number of Components: 3 

tiff:ImageLength: 1000 

Component 2: Cb component: Quantization table 1, Sampling factors : 
Component 1: Y component: Quantization table 0, Sampling factors 1 
Image Height: 1000 pixels 

X Resolution: 300 dots 

Original Transmission Reference: 53616c7465645f5fd22a84941585d89cc; 
Image Width: 714 pixels 

IPTC-NAA record: 92 bytes binary data 

Component 3: Cr component: Quantization table 1, Sampling factors : 
tiff:BitsPerSample: 8 

Application Record Version: 4 

tiff:Imagewidth: 714 

Content-Type: image/jpeg 

Y Resolution: 300 dots 


eS 
还 可 以 得 到 想 要 的 元 数据 值 。 


添加 新 的 元 效 据 值 





可 以 添加 使 用 元 数据 类 的 add() 方 法 新 的 元 数据 值 。 下 面 给 出 的 是 该 方法 的 语法 。 在 
这 里 要 添加 的 作者 名 字 。 


metadata.add("author","Tutorials yiibai"); 


元 数据 Metadata 类 预定 义 的 属性 包括 类 ， 如 ClimateForcast，CativeCommons， 
Geographic 继 承 等 ， 以 支持 各 种 数据 模型 的 属性 。 下 面 示 出 的 是 从 由 提 卡 实施 遵循 
XMP 元 数据 标准 的 TIFF 图 像 格式 的 TIFF 接 口 继承 了 软件 数据 类 型 的 使 用 。 


metadata.add(Metadata.SOFTWARE, "ms paint"); 


下 面 给 出 的 是 演示 如 何 将 元 数据 值 添加 到 一 个 给 定 文件 的 完整 程序 。 这 里 的 元 数据 
元 素 的 列表 被 显示 在 输出 ， 这 样 就 可 以 增加 新 的 值 之 后 ， 观 察 在 列表 中 的 变化 。 


import 
import 
import 
import 


import 
import 
import 
import 
import 
import 


import 
public 


pub 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 
java.util.Arrays; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.AutoDetectParser; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.Parser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 
class AddMetadata { 
lic static void main(final String[] args) throws IOException, 


//create a file object and assume sample.txt is in your curre 
File file - new File("Example.txt"); 


//Parser method parameters 

Parser parser - new AutoDetectParser(); 
BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FileInputStream(file); 
ParseContext context = new ParseContext(); 


//parsing the document 
parser.parse(inputstream, handler, metadata, context); 


//list of meta data elements before adding new elements 
System.out.println( " metadata elements :"  +Arrays.toString| 


//adding new meta data name value pair 
metadata.add("Author", "Tutorials Point"); 
System.out.println(" metadata name value pair is successfull\ 


//printing all the meta data elements after adding new elemer 
System.out.println("Here is the list of all the metadata eler 
System.out.println( Arrays.toString(metadata.names())); 





将 以 上 代码 保存 为 AddMetadata.java 类 ， 然 后 从 命令 提示 符 下 运行 它 : 


javac 


AddMetadata .java 


java AddMetadata 


假设 example.txt 有 下 列 内容 : 


Hi students welcome to yiibai 


它 提供 了 以 下 的 输出 : 


metadata elements of the given file :[Content-Encoding, Content-Tyț 
metadata name value pair is successfully added 


Here is the list of all the metadata elements after adding new el: 
[Content-Encoding, Author, Content-Type] 


E pere nenene nenene nenene nene nenene senene 
4 wu P 


设 定 值 ， 用 现 有 的 元 数据 元 素 


可 以 设置 值 ， 使 用 set() 方 法 在 现 有 的 元 数据 元 素 。 使 用 set() 方 法 设置 的 时 间 属 性 的 
语法 如 下 : 






metadata.set(Metadata.DATE, new Date()); 


还 可 以 设置 多 个 值 ， 以 使 用 set() 方 法 的 属性 。 使 用 set() 方 法 多 个 值 设 定 为 作者 属性 
的 语法 如 下 : 


metadata.set(Metadata.AUTHOR, "ram ,raheem ,robin "); 


下 面 给 出 的 是 一 个 完整 的 程序 演示 set() 方 法 。 


import java.io.File; 
import java.io.FileInputStream; 
import java.io.IOException; 


import java.util.Date; 


import org.apache.tika.exception.TikaException; 
import org.apache.tika.metadata.Metadata; 
import org.apache.tika.parser.AutoDetectParser; 
import org.apache.tika.parser.ParseContext; 
import org.apache.tika.parser.Parser; 

import org.apache.tika.sax.BodyContentHandler; 


import org.xml.sax.SAXException; 


public class SetMetadata ( 


public static void main(final String[] args) throws IOException, 


//Create a file object and assume example.txt is in your cur! 
File file - new File("example.txt"); 


//parameters of parse() method 

Parser parser - new AutoDetectParser(); 
BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FileInputStream(file); 
ParseContext context = new ParseContext(); 


//Parsing the given file 
parser.parse(inputstream, handler, metadata, context); 


//list of meta data elements elements 
System.out.println( " metadata elements and values of the gi\ 
String[] metadataNamesb4 = metadata.names(); 


for(String name : metadataNamesb4) { 
System.out.println(name + ": " + metadata.get(name) ); 
} 


//setting date meta data 
metadata.set(Metadata.DATE, new Date()); 


//setting multiple values to author property 
metadata.set(Metadata.AUTHOR, "ram ,raheem ,robin "); 


//printing all the meta data elements with new elements 
System.out.println("List of all the metadata elements after 
String[] metadataNamesafter = metadata.names(); 


for(String name : metadataNamesafter) { 
System.out.println(name + ": " + metadata.get(name)); 





将 以 上 代码 保存 为 SetMetadata.java 并 在 命令 提示 符 下 运行 : 


javac SetMetadata.java 
java SetMetadata 


注意 : 假设 sample.txt 有 下 列 内 容 : 


Hi students welcome to yiibai 


在 输出 中 ， 可 以 看 到 新 添加 的 元 数据 元 素 。 


metadata elements and values of the given file 

Content-Encoding: ISO-8859-1 

Content-Type: text/plain; charset-ISO-8859-1 

Here is the list of all the metadata elements after adding new el: 
date: 2014-09-24T07:01:32Z 

Content-Encoding: ISO-8859-1 

Author: ram, raheem, robin 

Content-Type: text/plain; charset-ISO-8859-1 








TIKA;& S72 0) - Tika 教 程 


必要 的 语言 检测 


对 于 基于 它们 写 在 一 个 多 语种 网 站 的 语言 文件 分 类 ， 语 言 检测 工具 是 必要 的 。 这 个 
a 
的 元 数据 。 


算法 性 能 分 析 语 料 库 


什么 是 语料库 ? 

为 了 检测 一 个 文档 的 语言 ， 语 言 信 息 被 构造 和 用 已 知 的 语言 的 信息 进行 比较 。 设 置 
这 些 已 知 的 语言 文字 被 称 为 语料库 。 

语料库 是 一 种 书面 语言 ， 解 释 了 语言 用 于 实际 生活 中 的 文本 的 集合 。 

语料库 是 从 书本 ， 成 绩 单 ， 而 像 其 他 的 互联 网 数据 资源 开发 。 语 料 库 的 精度 取决 于 
我 们 使 用 帧 性 能 分 析 算 法 。 

什么 是 性 能 分 析 算 法 ? 

仿 测 语言 的 常用 方法 是 使 用 字典 。 在 给 定 的 一 段 文本 中 使 用 的 词语 将 与 词 典 进行 匹 
Ac. 

在 语言 中 常用 的 单词 的 列表 将 是 最 简单 有 效 的 话 料 库 用 于 检测 特定 的 语言 ， 例 如 ， 
a, an, 在 英文 中 。 

使 用 Word 设 置 为 语料库 


使 用 字 集 ， 一 个 简单 的 算法 是 框架 找到 两 个 语料库 ， 其 将 等 于 的 匹配 单词 的 频率 之 
间 的 差异 的 总 和 之 间 的 距离 。 


此 类 算法 有 以 下 问题 : 


。 因为 匹配 单词 的 频率 非常 少 ， 则 该 算法 不 能 有 效 地 与 几 个 句子 小 文本 工作 。 它 
需要 大 量 的 文字 进行 准确 匹配 。 


。 它 不 能 检测 到 字 边 界 具 有 语言 复合 句 ， 而 那些 具有 类 似 空 格 或 标点 符号 无 字 分 
VR 


由 于 在 使 用 字 集 作为 语料库 这 些 困难 ， 单 个 字符 或 字符 组 会 被 考虑 。 


使 用 字符 集 为 主体 


因为 这 是 在 一 种 语言 中 常用 的 字符 是 有 限 的 数目 ， 很 容易 应 用 基于 单词 的 频率 ， 而 
不 是 字符 的 算法 。 这 种 算法 的 工作 更 为 出 色 的 情况 下 在 一 个 或 极 少数 语言 中 使 用 的 
特定 的 字符 集 。 


此 算法 存在 下 列 缺点 : 
e. 它 是 难以 区 分 具有 相似 性 质 的 频率 两 种 语 


。 没有 任何 特定 的 工具 或 算法 来 具体 确定 的 帮助 下 (如 文集 ) 所 使 用 的 多 语言 字 
符 集 的 语言 。 


o 


N-gram 算法 


上 述 的 缺点 就 产生 了 利用 给 定 长 度 的 字符 序列 为 分 析 语 料 的 一 种 新 方法 。 个 字符 的 
这 样 的 序列 被 称 为 N-gram， 在 一 般 情 况 下 ，N 表 示 该 字符 序列 的 长 度 。 


e 人 元 算法 是 一 种 有 效 的 方法 来 检测 语言 ， 特 别 是 在 案件 欧洲 语言 如 英语 的 。 
。 该 算法 与 短文 正常 工作 。 


e 虽然 有 高 级 语言 纹 算 法 来 检测 多 个 语言 中 具有 更 吸引 人 的 特征 的 多 语言 文档 ， 
Tika 使 用 3-grams 算 法 ， 因 为 它 适 合 于 大 多 数 实际 情况 。 


Tika;& &1$ jJ 


在 所 有 由 ISO639-1 标 准 的 184 标 准 语 言 ，Tika 可 检测 18 种 语言 。 语 言 检测 Tika 是 通 
过 使 用 Languageldentifier 类 的 getLanguage() 方 法 。 此 方法 返回 字符 串 格式 的 语言 
代号 。 下 面 给 出 由 Tika 检 测 出 的 18 语 言 代码 对 的 列表 中 : 


da 一 Danish de 一 German et 一 Estonian el 一 Greek 
en 一 English es 一 Spanish fi—Finnish fr—French 
hu—Hungarian is—Icelandic it—ltalian nl—Dutch 
no—Norwegian pl—Polish pt—Portuguese ru—Russian 
sv—Swedish th—Thai 


实例 化 Languageldentifier 类 ， 则 应 该 将 内 容 传递 的 字符 串 格 式 将 被 提取 ， 或 
LanguageProfile 类 对 象 。 


Languageldentifier object=new LanguageIdentifier("this is english": 
-| ë E 
下 面 给 出 的 是 Tika 语 言 检测 的 示例 程序 。 





import java.io.IOException; 


import org.apache.tika.exception.TikaException; 
import org.apache.tika.language.LanguageIdentifier; 


import org.xml.sax.SAXException; 

public class LanguageDetection { 
public static void main(String args[])throws IOException, SAXEx« 
Languageldentifier identifier - new LanguageIdentifier("this 


String language = identifier.getLanguage( ); 
System.out.println("Language of the given content is : " + lé 





将 以 上 代码 保存 为 LanguageDetection.java 并 在 命 命 提示 符 处 使 用 以 下 命 命运 行 
它 : 


javac LanguageDetection.java 
java LanguageDetection 


它 提供 了 以 下 的 输出 : 


Language of the given content is : en 


语言 检测 文档 


要 检测 一 个 给 定 的 文档 的 语言 ， 必 须 使 用 parse() 方 法 来 解析 它 。parse() 方 法 解析 处 
理 程 序 对 象 ， 这 是 传递 给 它 的 参数 的 内 容 ， 并 将 其 存储 。 通 过 Languageldentifier 类 
对 象 处理 ,构造 本 数 的 字符 串 的 格式 如 下 图 所 示 : 


parser.parse(inputstream, handler, metadata, context); 
Languageldentifier object = new LanguageIdentifier(handler.toStrinc¢ 





下 面 给 出 的 是 一 个 演示 如 何 检测 一 个 给 定 的 文档 的 语言 完整 的 程 


对 


import 
import 
import 


import 
import 
import 
import 
import 
import 
import 


import 
public 


pub 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.AutoDetectParser; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.Parser; 
org.apache.tika.sax.BodyContentHandler; 
org.apache.tika.language.*; 


org.xml.sax.SAXException; 
class DocumentLanguageDetection { 
lic static void main(final String[] args) throws IOException, 


//Instantiating a file object 
File file - new File("Example.txt"); 


//Parser method parameters 

Parser parser - new AutoDetectParser(); 
BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FilelnputStream content - new FileInputStream(file); 


//Parsing the given document 
parser.parse(content, handler, metadata, new ParseContext()), 


Languageldentifier object = new LanguagelIdentifier(handler. tc 
System.out.println("Language name :" + object.getLanguage()), 





将 以 上 代码 保存 为 SetMetadata.java 并 在 命令 提示 符 下 运行 : 


javac 
java 


SetMetadata.java 
SetMetadata 


注意 : 假设 sample.txt 有 下 列 内 容 : 


Hi stu 


dents welcome to yiibai 


它 提供 了 以 下 的 输出 : 


Language name :en 


随 着 Tika jar，Tika 提 供 了 一 个 图 形 用 户 界 面 应 用 程序 (GUI) 和 命令 行 界面 
和 的 应 用 程序 。 可 以 像 其 他 Java 应 用 程序 在 命令 提示 符 下 运行 Tika 的 应 用 程 
Fo 
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TIKA 图 形 界面 /GUI - Tika 教 程 


图 形 用 户 界 面 (GUID) 
e Tika 提供 了 一 个 jar 文 件 连同 下 面 的 链接 它 的 源 代 码 : 
http://tika.apache.org/download.htmll. 
e 下 载 文件 ， 并 设置 JAR 类 文件 路 径 。 
提取 源 代码 zip 文 件 夹 ， 打 开 tika-app 文 件 夹 。 


在 解压 缩 文件 夹 “tika-1.6\tika-app\src\main\java\org\apache\Tika\gui” 后 ， 会 看 
到 两 个 类 文件 : ParsingTransferHandler.java 和 TikaGUl.java。 


编译 这 两 个 类 文件 并 执行 TikaaGUl.java 类 文件 ， 它 会 打开 下 面 的 窗口 。 


Le 


[File |View 





Open... 
Open URL... 


Exit 





现在 让 我 们 看 看 如 何 利 用 Tika 的 GUI。 


在 GUI 上 ， 点 击 open 打 开 ， 浏 览 并 选择 一 个 文件 ， 该 文件 将 被 提取 ， 或 将 其 拖 动 到 
窗口 的 空白 。 


Tika 提取 的 文件 的 内 容 ， 并 在 五 个 不 同 的 格式 显示 出 来 ， 即 。 元 数据 ， 格 式 化 文 
本 ， 纯 文本 ， 主 要 内 容 和 结构 化 文本 。 可 以 选择 任何 想 要 的 格式 。 


以 同样 的 方式 ， 会 发 现在 “tika-1.6\tika-app\src\main\java\org\apachel\tika\cli* 文 件 
夹 中 的 CLI 类 。 


Ur E 当 我 们 把 图 像 托 放 在 图 形 用 户 界面 上 ，Tika 提 取 并 显示 其 
元 数据 。 
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Apache’ 


1113 [010 r] 
1 0010101 
851109011 
1010:100:011 
11130101:001:101 


Welceax 1 Apache Tika version 1.5! 


To see what Tika can do, just drop 
2 Se x a URL t this window. 


Use te View nenu to stich views. 
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下 面 给 出 的 程序 是 用 来 提取 PDF 文件 内 容 和 元 数据 。 


Import 
Import 
Import 


Import 
Import 
Import 
Import 
Import 


Import 


public 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.pdf.PDFParser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 


class PdfParse ( 


public static void main(final String[] args) throws IOException, 


BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//parsing the document using PDF parser 
PDFParser pdfparser - new PDFParser(); 
pdfparser.parse(inputstream, handler, metadata,pcontext); 


//getting the content of the document 
System.out.println("Contents of the PDF :" + handler.toStrint 


//getting metadata of the document 
System.out.println("Metadata of the PDF:"); 
String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name+ " : " + metadata.get(name)); 





tei Lik 3a A PdfParse.ava, 3f38:1 (FH P IBIBg eg Min m mE : 


javac 


PdfParse.java 


java PdfParse 
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下 面 给 出 的 是 Example.pdf 文 件 的 快照 : 


Apache Tika is a framework for content type detection and content 
extraction which was designed by Apache software foundation. It detects 
and extracts metadata and structured text content from different types of 
documents such as spreadsheets, text documents, images or PDFs including 
audio or video input formats to certain extent. 








Date created 9/28/2014 5:31 AM 

Date modified 9/28/2014 5:31 AM 

Attributes A 

Owner Krishna Kasyap Krishna Kasyap 
Computer KRISHNAKASYAP this computer) 





执行 上 述 程序 后 ， 会 得 到 如 下 的 输出 
输出 : 
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3099 


Contents of the PDF: 


Apache Tika is a framework for content type detection and content 4 
which was designed by Apache software foundation. It detects and e 
and structured text content from different types of documents such 
text documents, images or PDFs including audio or video input form: 


Metadata of the PDF: 


dcterms:modified : 2014-09-28T12:31:16Z 
meta:creation-date : 2014-09-28T12:31:16Z 
meta:save-date : 2014-09-28T12:31:16Z 
dc:creator : Krishna Kasyap 
pdf:PDFVersion : quo 

Last-Modified : 2014-09-28T12:31:16Z 
Author : Krishna Kasyap 

dcterms:created : 2014-09-28T12:31:16Z 
date : 2014-09-28T12:31:16Z 

modified : 2014-09-28T12:31:16Z 

creator : Krishna Kasyap 

xmpTPg:NPages : 1 

Creation-Date : 2014-09-28T12:31:16Z 
pdf:encrypted : false 

meta:author : Krishna Kasyap 

created : Sun Sep 28 05:31:16 PDT 2014 
dc:format : application/pdf; version-1.5 
producer : Microsoft& Word 2013 
Content-Type : application/pdf 
xmp:CreatorTool : Microsoft® Word 2013 


Last-Save-Date : 2014-09 -287T12:31:16Z 





TIKA 提 取 ODF - Tika 教 程 


下 面 给 出 的 是 程序 从 打开 Office 文 档 格式 (ODF) 中 提取 内 容 和 元 数据 。 


Import 
Import 
Import 


Import 
Import 
Import 
Import 
Import 
Import 


public 


pub 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.odf.OpenDocumentParser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 
class OpenDocumentParse { 
lic static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//Open Document Parser 

OpenDocumentParser openofficeparser = new OpenDocumentParser 
openofficeparser.parse(inputstream, handler, metadata, pconte> 
System.out.println("Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 

String[] metadataNames = metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + " : " + metadata.get(name)); 





符 下 编译 


javac 


将 以 上 代码 保存 为 OpenDocumentParse.java， 并 通过 使 用 以 下 命令 ， 在 命令 提示 
OpenDocumentParse.java 
penDocumentParse 


java O 


7z 


下 面 给 出 的 是 example_open_document_ presentation.odp 的 快照 : 


Apache Tika 


Apache Tikais a framework for content type detection 
and content extraction which was designed by Apache 
software foundation. It detects and extracts metadata 
and structured text content from different types of 
documents such as spreadsheets, text documents, 
images or PDFs including audio or video input formats 
to certain extent. 





本 文档 具有 以 下 属性 : 
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example open document, presentation.odp 


kem type OpenDocument Presentation 
Folder path — C^ TikaExamples images 

Size 2.65 MB 

Date created 9/28/2014 7:14 AM 

Date modified 9/28/2014 8:11 AM 

Attributes A 

Computer KRISHNAKASYAP (this computer) 





执行 上 述 程序 后 ， 将 得 到 下 面 的 输出 。 
输出 : 
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Contents of the document: 

Apache Tika 

Apache Tika is a framework for content type detection and content 4 
by Apache software foundation. It detects and extracts metadata an 
different types of documents such as spreadsheets, text documents, 
or video input formats to certain extent. 


Metadata of the document: 

editing-cycles: 4 

meta:creation-date: 2009-04-16T11:32:32.86 
dcterms :modified: 2014-09-28T07:46:13.03 
meta:save-date: 2014-09-28T07:46:13.03 
Last-Modified: 2014-09-28T07:46:13.03 
dcterms:created: 2009-04-16T11:32:32.86 
date: 2014-09-28T07:46:13.03 

modified: 2014-09-28T07:46:13.03 
nbObject: 36 

Edit-Time: PT32M6S 

Creation-Date: 2009-04-16T11:32:32.86 
Object-Count: 36 


meta:object-count: 36 
generator: OpenOffice/4.1.0$Win32 OpenOffice.org project/410mi18$t 
Content-Type: application/vnd.oasis.opendocument.presentation 


Last-Save-Date: 2014-09-28T07:46:13.03 


EE] 
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下 面 给 出 的 程序 是 用 于 从 Microsoft Office 文 档 中 提取 内 容 和 元 数据 。 


Import 
Import 
Import 


Import 
Import 
Import 
Import 
Import 


Import 


public 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.microsoft.ooxml.OOXMLParser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 


class MSExcelParse { 


public static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//00Xml parser 

OOXMLParser msofficeparser = new OOXMLParser (); 
msofficeparser.parse(inputstream, handler, metadata,pcontext: 
System.out.println("Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 





保存 上 述 代 码 保存 为 MSExelParse.java， 并 通过 使 用 下 面 的 命 分 从 命令 提示 编译 : 


javac 


MSExcelParse.java 


java MSExcelParse 


下 面 给 出 的 是 example_msExcel.xlsx 文件 的 快照 
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Ix E] EH e = example, msExcel.xlsx - Excel ? EFE 
; HOME INSERT PAGE LAYOUT FORMULAS 


X V f 


C 





Name Age Designation 

Ramu 50 Manager 

raheem 40 Assistant manager 
Robert 30 Superviser 

sita 25 Clerck 








sameer 25 Section incharge 


Content created 9/15/2006 5:00 PM 
Date last saved 9/28/2014 9:14 AM 
Last printed 


Content 


8.01 KB 

9/28/2014 8:12 AM 
9/28/2014 9:14 AM 
9/28/2014 9:14 AM 





执行 上 述 程序 后 ， 将 得 到 下 面 的 输出 。 
输出 : 
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3106 


Contents of the document: 


Sheet1 

Name Age Designation Salary 
Ramu 50 Manager 50, 000 
Raheem 40 Assistant manager 40, 000 
Robert 30 Superviser 30, 000 
sita 25 Clerk 25,000 
sameer 25 Section in-charge 20,000 


Metadata of the document: 


meta:creation-date: 2006-09-16T00:00:00Z 
dcterms:modified: 2014-09-28T15:18:41Z 
meta:save-date: 2014-09-28T15:18:41Z 
Application-Name: Microsoft Excel 
extended-properties:Company: 

dcterms:created: 2006-09-16T00:00:00Z 
Last-Modified: 2014-09-28T15:18:41Z 
Application-Version: 15.0300 

date: 2014-09-28T15:18:41Z 

publisher: 

modified: 2014-09-28T15:18:41Z 

Creation-Date: 2006-09-16T00:00:00Z 
extended-properties:AppVersion: 15.0300 
protected: false 

dc: publisher: 

extended-properties:Application: Microsoft Excel 
Content-Type: application/vnd.openxmlformats-officedocument.sprt 
Last-Save-Date: 2014-09-28T15:18:41Z 


ler e C eae 
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下 面 给 出 的 程序 是 用 来 提取 文本 文档 的 内 容 和 元 数据 : 


import 
import 
import 


import 
import 
import 
import 
import 
import 


public 


pub 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.sax.BodyContentHandler; 
org.apache.tika.parser.txt.TXTParser; 


org.xml.sax.SAXException; 
class TextParser ( 
lic static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FileInputStream(new File("t 
ParseContext pcontext-new ParseContext(); 


//Text document parser 

TXTParser  TexTParser - new TXTParser(); 
TexTParser.parse(inputstream, handler, metadata,pcontext); 
System.out.println("Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + " : " + metadata.get(name)); 





保存 上 述 代 码 作 为 TextParserjava， 并 通过 使 用 下 面 的 命 分 从 命令 提示 编译 : 


javac 


TextParser.java 


java TextParser 


下 面 给 出 的 是 example.txt 文 件 的 快照 : 
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E 


Ei 





At yiibai.com, we strive hard to provide quality tutorials for 
self-learning purpose in the domains of Academics, 
Information Technology, Management and Computer Programming Languages. 


The endeavour started by Hema su, who is the founder and 

the managing director of Yiibai Pvt. Ltd. 

He came up with the website yiibai.cbm in year 2012 

with the help of handpicked freelancers, 

with an array of tutorials for computer programming languages. 





文本 文件 具有 以 下 属性 : 


Folder path — C^ TikaExamples images 

Size 488 bytes 

Date created 9/28/2014 5:20 AM 

Date modified 9/28/2014 9:04 AM 

Attributes A 

Owner KrishnaKasyap\Krishna Kasyap 
Computer KRISHNAKASYAP (this computer) 
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Contents of the document: 


At Yiibai.com, we strive hard to provide quality tutorials for self-learning purpose in 
the domains of Academics, Information Technology, Management and Computer 
Programming Languages. 


The endeavour started by Hema su, who is the founder and the managing director 
of Yiibai Pvt. Ltd. He came up with the website yiibai.com in year 2014 with the 
help of handpicked freelancers, with an array of tutorials for computer 
programming languages. 


Metadata of the document: Content-Encoding: windows-1252 Content-Type: 
text/plain; charset=windows-1252 
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下 面 给 出 的 是 该 程序 用 于 从 HTML 文 档 提取 内 容 和 元 数据 。 


import 
import 
import 


import 
import 
import 
import 
import 


import 


public 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.html.HtmlParser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 


class HtmlParse { 


public static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//Html parser 

HtmlParser htmlparser - new HtmlParser(); 
htmlparser.parse(inputstream, handler, metadata,pcontext); 
System.out.println("Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 





保存 上 述 代 码 保存 为 HtmlParse.java， 并 通过 使 用 下 面 的 命令 从 命令 提示 编译 : 


javac 
java H 


HtmlParse.java 
tmlParse 


下 面 给 出 的 是 example.htmll 文档 的 快照 。 
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<th>Name</th> 
<th>Salary</th> 
<th>age</th> 
</tr> 


<tr> 

<td>Ramesh Raman</td> 
<td>50000</td> 
<th>20</th> 

</tr> 


«tr» 

«td»Shabbir Hussein</td> 
<td>70000</td> 
<th>25</th> 

</tr> 

<tr> 

<td>umesh Raman</td> 
«td»50000«/td» 
<th>30</th> 

</tr>] 

</table> 

</body> 

</html> 





HTML 文 档 有 以 下 属性 : 
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€ example.html Properties 











Folder path — C^ TikaExamples 
Size 412 bytes 
Date created 9/28/2014 5:20 AM 
Date modified 9/28/2014 9:43 AM 
A 
Owner KrishnaKasyap Krishna Kasyap 
Computer KRISHNAKASYAP (his computer) 




















执行 上 述 程序 后 ， 将 得 到 下 面 的 输出 。 


输出 : 
Contents of the document : 
Name Salary age 
Ramesh Raman 50000 20 
Shabbir Hussein 70000 25 
Umesh Raman 50000 30 
Somesh 50000 35 


Metadata of the document: 

title: HTML Table Header 

Content -Encoding: windows -1252 

Content-Type: text/html; charset=windows -1252 
dc:title: HTML Table Header 
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下 面 给 出 的 程序 是 用 来 从 XML 文 档 提 取 内 容 和 元 数据 : 


import 
import 
import 


import 
import 
import 
import 
import 


import 


public 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.xml.XMLParser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 


class XmlParse ( 


public static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream - new FilelnputStream(new File("[ 
ParseContext pcontext - new ParseContext(); 


//Xml parser 

XMLParser xmlparser - new XMLParser(); 
xmlparser.parse(inputstream, handler, metadata, pcontext); 
System.out.println("Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 





保存 上 述 代 码 保 存 为 XmlParse.java， 并 通过 使 用 下 面 的 命令 从 命令 提示 编译 : 


javac 


XmlParse. java 


java XmlParse 


下 面 给 出 的 是 pom.xml 文 件 的 快照 
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Kproject xmlns-' ‘http: / /maven. apac apache. .org POM/4.0.0" 
xmlns:xsi-"http: / /www. w3. or g/2 1/00 Se -instance" 
xs i:schemaLocation="http://maven. apache. «FOL PON/A. 9.0 
http: //maven. apache. or g/xsd/maven-4.0.0.xsd"» 
«modelversion»4.0.0«/modelversion» 
«groupId»org j- Space. tika</groupId> 
arti actId>tika</artifactid> 
«version»1.6«/version» 
«dependencies» 
«dependency» 
cart ifact test Mecha cn grouze 
«artifactId»ti mia factid- 
«ver sion>1. 6</versi on> 
</dependency> 


<dependency> 


<gr oupId>or g papama, . tika</groupiId> 


de actId»tika-parsers«/artifactid» 
«versi omi. 6«/version» 


«/depend -— 
</dependenc es> 


we 
s 


Tifac Id>maven-compiler-plugin</artifactId> 
«version-3.1«/version- 
«conf igur ation» 

ON cers 7«/sour ce» 

geo. 7«/target» 
« cont guration> 
«/plugin» 
AL uw 
«/bui 1d» 





本 文档 具有 以 下 属性 : 
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XML Document 

C:\ Tika Examples 

986 bytes 
Date created 9/28/2014 11:12 AM 
Date modified 3/27/2014 11:36 PM 


Owner KrishnaKasyap Krishna Kasyap 


Computer KRISHNAKASYAP (this computer) 








执行 上 述 程序 后 ， 将 得 到 下 面 的 输出 。 
输出 : 
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Contents of the document: 
4.0.0 

org.apache.tika 

tika 

1.6 

org.apache.tika 
tika-core 

1.6 

org.apache.tika 
tika-parsers 

1.6 

src 

maven-compiler -plugin 
Shab 

abe 

abo 


Metadata of the document: 
Content-Type: application/xml 
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下 面 给 出 的 是 该 程序 提取 .class 文 件 的 内 容 和 元 数据 。 


import 
import 
import 


import 
import 
import 
import 
import 


import 


public 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.asm.ClassParser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 


class JavaClassParse { 


public static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//Html parser 

ClassParser ClassParser = new ClassParser(); 
ClassParser.parse(inputstream, handler, metadata, pcontext); 
System.out.println("Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + " : " + metadata.get(name)); 





保存 上 述 代 码 作 为 JavaClassParse.java， 并 通过 使 用 下 面 的 命令 从 命令 提示 编译 : 


javac 
java J 


JavaClassParse.java 
avaClassParse 


下 面 给 出 的 是 Example.java 编 译 执行 后 ， 将 得 到 example.class 文 件 的 快照 : 


TutorialsPoint Java 技术 教程 


Bii * © = | Bamplejava - WordPad 


package tutorialspoint.tika.examples; 
public class Example[ 
public static void main(String args[]){ 
System.out.println("this is a sample example"); 


Example class 
CLASS File 
Folder path — C^ TikaExamples 
Size 461 bytes 
Date created 9/28/2014 11:38 AM 
Date modified 9/28/2014 11:39 AM 
Attributes A 
Owner KrishnaKasyap\Krishna Kasyap 
Computer KRISHNAKASYAP this computer) 





执行 上 述 程序 后 ， 将 得 到 下 面 的 输出 。 
输出 : 


TIKA 提 取 .class 文 件 - Tika 教 程 3119 


Contents of the document: 

package yiibai.tika.examples; 

public synchronized class Example { 
public void Example(); 
public static void main(String[]); 


j 


Metadata of the document: 
title: Example 
resourceName: Example.class 
dc:title: Example 


TIKA 提 取 JAR 文 件 - Tika 教 程 


下 面 给 出 的 程序 是 用 来 从 一 个 Java 存 档 (JAR) 文 件 提取 内 容 和 元 数据 : 


import 
import 
import 


import 
import 
import 
import 
import 
import 


public 


pub 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.sax.BodyContentHandler; 
org.apache.tika.parser.pkg.PackageParser; 


org.xml.sax.SAXException; 
class PackageParse ( 
lic static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//Package parser 

PackageParser packageparser - new PackageParser(); 
packageparser.parse(inputstream, handler, metadata,pcontext), 
System.out.println("Contents of the document: " + handler.tos 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 





保存 上 述 代 码 为 PackageParse.java， 并 通过 使 用 下 面 的 命令 从 命令 提示 编译 : 


javac 
java P 


PackageParse.java 
ackageParse 


在 这 里 ， 我 们 通过 下 面 的 Example.java 文 件 得 到 jar 文 件 。 
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package tutorialspoint.tika.examples; 
public class Example[ 
public static void main(String args[]){ 
System.out.println("this is a sample example"); 


| example jar 
Type Executable Jar File 
Folderpath — C^ TikaExamples 
Size 1.15 KB 
Date created 9/28/2014 5:20 AM 
Date modified 9/28/2014 12:45 PM 
Attributes A 
Owner KrishnaKasyap Krishna Kasyap 
Computer KRISHNAKASYAP this computer) 





执行 上 述 程序 后 ， 将 得 到 下 面 的 输出 。 
输出 : 


TIKA 提 取 JAR 文 件 - Tika 教 程 3122 


Contents of the document: 
META- INF/MANIFEST .MF 
yiibai/tika/examples/Example.class 


Metadata of the document: 
Content-Type: application/zip 


TIKA 提 取 图 像 文件 - Tika 教 程 


下 面 给 出 的 该 程序 是 从 一 个 JPEG 图 像 中 提取 的 内 容 和 元 数据 。 


import 
import 
import 


import 
import 
import 
import 
import 
import 


public 


pub 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.jpeg.JpegParser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 
class JpegParse { 
lic static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FileInputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//Jpeg Parse 

JpegParser  JpegParser - new JpegParser(); 
JpegParser.parse(inputstream, handler, metadata,pcontext); 
System.out.println("Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 





保存 上 述 代码 为 JpegParse.java， 并 通过 使 用 下 面 的 命令 从 命令 提示 编译 : 


javac 
java J 


JpegParse. java 
pegParse 


在 这 里 ， 我 们 通过 下 面 的 example.jpeg 文 件 : 
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JPEG 文 件 具 有 以 下 属性 : 


TIKA 提 取 图 像 文 件 - Tika 教 程 3125 


TutorialsPoint Java 技术 教程 





在 执行 上 面 的 应 用 程序 ， 会 得 到 如 下 的 输出 。 
输出 : 


TIKA 提 取 图 像 文 件 - Tika 教 程 3126 


Contents of the document: 


Metadata of the document: 

IPTC-NAA record: 92 bytes binary data 

Number of Components: 3 

Image Height: 1000 pixels 

Resolution Units: inch 

Data Precision: 8 bits 

tiff:BitsPerSample: 8 

Compression Type: Baseline 

Component 1: Y component: Quantization table 0, Sampling factors 1 
Component 2: Cb component: Quantization table 1, Sampling factors : 
tiff:ImageLength: 1000 

Component 3: Cr component: Quantization table 1, Sampling factors : 

X Resolution: 300 dots 

tiff:ImageWidth: 714 

Application Record Version: 4 

Image Width: 714 pixels 

Original Transmission Reference: 
53616c7465645f5fd22a84941585d89cc735d889c9d5ac58a01f af 2c92ee3c6f9I 

Y Resolution: 300 dots 


[s C SaaS 





TIKA 提 取 mp4 文 件 - Tika 教 程 


下 面 给 出 的 程序 是 用 来 从 mp4 文 件 提取 内 容 和 元 数据 : 


import 
import 
import 


import 
import 
import 
import 
import 


import 


public 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.mp4.MP4Parser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 


class Mp4Parse ( 


public static void main(final String[] args) throws IOException, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("« 
ParseContext pcontext - new ParseContext(); 


//Html parser 

MP4Parser MP4Parser = new MP4Parser(); 
MPAParser.parse(inputstream, handler, metadata, pcontext); 
System.out.println("Contents of the document: :" + handler. 
System.out.println("Metadata of the document:"); 

String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 





保存 上 述 代码 保存 为 JpegParsejava， 并 通过 使 用 下 面 的 命令 从 命令 提示 编译 : 


javac 
java M 


Mp4Parse. java 
p4Parse 


下 面 给 出 的 是 example.mp4 的 快照 属性 : 


TutorialsPoint Java 1x ZU 


é example.mp4 Properties 





(General | Securty | Detais | Previous Versions | 











Property 


CUTTS 
Video 
Length 
Frame width 
Frame height 
Data rate 
Total bitrate 
Frame rate 
Audio 
Bit rate 
Channels 


Value 


640 

360 

433kbps 

529kbps 

24 frames/second 


95kbps 
2 (stereo) 


Audio sample rate 44 kHz 
Media 

Contributing artists 

Year 

Genre 


Origin 


Nine 24 = <= 


R P 




















执行 上 述 程序 后 ， 得 到 如 下 的 输出 
输出 : 


Contents of the document: 


Metadata of the document: 
dcterms:modified: 2014-01-06T12:10:27Z 
meta:creation-date: 1904-01-01T00:00:00Z 
meta:save-date: 2014-01-06T12:10:27Z 
Last-Modified: 2014-01-06T12:10:27Z 
dcterms:created: 1904-01-01T00:00:00Z 
date: 2014-01-06T12:10:27Z 
tiff:ImageLength: 360 

modified: 2014-01-06T12:10:27Z 
Creation-Date: 1904-01-01T00:00:00Z 
tiff:ImageWidth: 640 

Content-Type: video/mp4 
Last-Save-Date: 2014-01-06T12:10:27Z 


DANA 
4 A9] 





TIKA 提 取 MP3 文 件 - Tika 教 程 


下 面 给 出 的 程序 是 用 于 提取 MP3 文 件 内 容 和 元 数据 : 


import 
import 
import 


import 
import 
import 
import 
import 
import 


import 


public 


java.io.File; 
java.io.FileInputStream; 
java.io. IOException; 


org.apache.tika.exception.TikaException; 
org.apache.tika.metadata.Metadata; 
org.apache.tika.parser.ParseContext; 
org.apache.tika.parser.mp3.LyricsHandler; 
org.apache.tika.parser.mp3.Mp3Parser; 
org.apache.tika.sax.BodyContentHandler; 


org.xml.sax.SAXException; 


class Mp3Parse ( 


public static void main(final String[] args) throws Exception, 


//detecting the file type 

BodyContentHandler handler - new BodyContentHandler(); 
Metadata metadata - new Metadata(); 

FileInputStream inputstream = new FilelnputStream(new File("t 
ParseContext pcontext - new ParseContext(); 


//Mp3 parser 

Mp3Parser Mp3Parser = new Mp3Parser(); 
Mp3Parser.parse(inputstream, handler, metadata, pcontext); 
LyricsHandler lyrics - new LyricsHandler(inputstream,handler: 


while(lyrics.hasLyrics()) 1 
System.out.println(lyrics.toString()); 
} 


System.out.println( "Contents of the document:" + handler.toS! 
System.out.println("Metadata of the document:"); 
String[] metadataNames - metadata.names(); 


for(String name : metadataNames) { 
System.out.println(name + ": " + metadata.get(name)); 








保存 上 述 代 码 保存 为 JpegParse.java， 并 通过 使 用 下 面 的 命令 从 命令 提示 编译 : 
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javac Mp3Parse.java 
java Mp3Parse 


在 这 里 ， 我 们 传递 一 个 example.mp3 文 件 具 有 以 下 属性 : 


A example.mp3 Properties 





Audio 
Bit rate 
Origin 
Publisher 
Encoded by 
Author URL 
Copyright 


Content 








执行 上 述 程序 后 ， 将 得 到 下 面 的 输出 。 
如 果 给 定 的 文件 有 任何 的 歌词 ， 我 们 的 应 用 程序 将 捕获 和 显示 ， 和 输出 。 
输出 : 


TIKA 提 取 MP3 文 件 - Tika 教 程 3131 


Contents of the document: 
Kanulanu Thaake 

Arijit Singh 

Manam (2014), track 01/06 
2014 

Soundtrack 

30171.65 

eng - 

DRGM 

Arijit Singh 

Manam (2014), track 01/06 
2014 

Soundtrack 

30171.65 

eng - 

DRGM 


Metadata of the document: 
xmpDM:releaseDate: 2014 

xmpDM: duration: 30171.650390625 
xmpDM:audioChannelType: Stereo 
dc:creator: Arijit Singh 
xmpDM:album: Manam (2014) 
Author: Arijit Singh 
xmpDM:artist: Arijit Singh 
channels: 2 
xmpDM:audioSampleRate: 44100 
xmpDM:logComment: eng - 

DRGM 

xmpDM:trackNumber: 01/06 
version: MPEG 3 Layer III Version 1 
creator: Arijit Singh 
xmpDM:composer: Music : Anoop Rubens | Lyrics 
xmpDM:audioCompressor: MP3 
title: Kanulanu Thaake 
samplerate: 44100 

meta:author: Arijit Singh 
xmpDM:genre: Soundtrack 
Content-Type: audio/mpeg 
xmpDM:albumArtist: Manam (2014) 
dc:title: Kanulanu Thaake 


: Vanamali 


XStream 教 程 


XStream 是 一 个 简单 的 基于 Java 库 ，Java 对 象 序列 化 到 XML， 反 之 亦 然 ( 即 : 可 以 
轻易 的 将 Java 对 象 和 xml 文 档 相 互 转换 )。 


TER 


使 用 方便 - XStream 的 API 提 供 了 一 个 高 层次 外 观 ， 以 简化 常用 的 用 例 。 
无 需 创建 映射 - XStream 的 API 提 供 了 默认 的 映射 大 部 分 对 象 序列 化 。 
性 能 - XStream 快 速 和 低 内 存 占 用 ， 适 合 于 大 对 象 图 或 系统 。 
干净 的 XML - XStream 创 建 一 个 干净 和 紧 凌 XML 结 果 ， 这 很 容易 阅读 。 


不 需要 修改 对 象 - XStream 可 序列 化 的 内 部 字段 ， 如 私有 和 最 终 字段 ， 支 持 非 
公有 制 和 内 部 类 。 黑 认 构 造 范 数 不 是 强制 性 的 要 求 。 


完整 对 象 图 支持 - XStream 人 允许 保持 在 对 象 模型 中 遇 到 的 重复 引用 ， 并 支持 循 
环 引 用 。 


可 自 定 义 的 转换 策略 - 定制 策略 可 以 允许 特定 类 型 的 定制 被 表示 为 XML 的 注 


o 


安全 框架 - XStream 提 供 了 一 个 公平 控制 有 关 解 组 的 类 型 ， 以 防止 操纵 输入 安 
全 问题 。 


错误 消息 - 出 现 异常 是 由 于 格式 不 正确 的 XML 时 ，XStream 抛 出 一 个 统一 的 例 
外 ， 提 供 了 详细 的 诊断 ， 以 解决 这 个 问题 。 


另 一 种 输出 格式 - XStream 支 持 其 它 的 输出 格式 ， 如 JSON。 


常见 的 用 途 
。 传 输 
。 持 久 化 
-mE 


单元 测试 


XStream 环 境 设 置 - XStream 教程 


本 地 环境 设置 

如 果 愿 意 设 置 Java 编 程 语 言 环境 ， 那 么 这 部 分 指导 如 何 下 载 和 设置 Java 在 机 器 上 。 
请 按照 以 下 步骤 来 设置 环境 。 

Java SE 是 免费 的 ， 提 供 的 链接 下 载 Java。 所 以 ， 根 据 操 作 系 统 版 本 下 载 。 


按照 说 明 下 载 java 并 运行 .exe 到 机 器 上 安装 Java。 机 器 上 安装 了 Java 以 后 ， 还 需要 
设置 环境 变量 指向 正确 的 安装 目录 : 


为 Windows 2000/XP 设 置 路 径 : 


假设 安装 在 c:Program FilesjavajdkE x : 
e 在 “我 的 电脑 "右键 单 击 并 选择 “属性 ”。 
e 在 “高 级 "选项 卡 下 单 击 “ 环 境 变量 "按钮 。 
e 现在 ， 改 变 “Path” 变 量 ， 因 此 ， 它 也 包含 了 Java 可 执行 文件 的 路 径 。 例 如 ， 如 


果 路 径 当 前 设置 为 “C:WINDOWSSYSTEM32”， 然 后 更 改 您 的 路 径 
如 “C:WINDOWSSYSTEM32;c:Program Filesjavajdkin”。 


为 Linux，UNIX，Solaris 和 FreeBSD 设 置 Java 路 径 : 


环境 变量 PATH 应 设置 为 指向 已 安装 的 Java 二 进 制 文件 的 位 置 。 请 参考 shell 文 件 。 


例如 ， 如 果 使 用 bash 作 为 shell， 那么 将 下 面 的 行 添加 到 '.bashrc' 文 件 的 结尾 : 
export PATH=/path/to/java:$PATH' 


流行 的 Java 编 辑 器 : 
编写 Java 程 序 ， 需 要 一 个 文本 编辑 器 。 在 市 场 上 有 很 多 可 用 更 复杂 的 IDE。 现 在 ， 
可 以 考虑 下 列 之 一 : 


e Notepad: 在 Windows 机 器 上 ， 可 以 使 用 像 记 事 本 的 任何 简单 的 文本 编辑 器 
(推荐 本 教程 ) ，TextPad。 


e Netbeans: 是 一 个 Java IDE， 它 是 开源 和 免费 的 ， 可 从 以 下 地 址 下 载 
http://www.netbeans.org/index.html. 


e Eclipse: 也 是 一 个 Java IDE 由 Eclipse 开源 社区 开发 ， 可 以 从 下 
载 http://www.eclipse.org/. 


下 载 XStream 的 轨 档 文件 


下 载 最 新 的 版 本 XStream 的 jar 文 件 从 xstream-1.4.7.jar， 在 写 这 篇 教程 的 时 候 ， 下 
载 的 是 XStream-1.4.7.jar 并 将 其 复制 到 C : > XStream 文件 夹 中 。 


OS Ja EE 
Windows xstream-1.4.7 .jar 
Linux xstream-1.4.7.jar 
Mac xstream-1.4.7.jar 
设置 XStream 环 境 


将 用 xstream_home 环 境 变 量 指向 Guava jar 存储 在 计算 机 上 的 基本 目录 位 置 。 假 
设 ， 我 们 已 经 提取 XStream-1.4.7.jar 在 各 种 操作 系统 XStream 文 件 夹 ， 如 下 所 示 。 


OS 输出 
Windows 设置 环境 变量 XStream_HOME 为 C:XStream 
Linux export XStream_HOME=/usr/local/XStream 
Mac export XStream_HOME=/Library/XStream 
ix 2 CLASSPATH X = 


设置 CLASSPATH 环境 变量 指向 XStream jar 位 置 。 假 设 ， 我 们 已 经 存储 
XStream-1.4.7.jar f£ XStream 文件 夹 的 不 同 的 操作 系统 如 下 。 


oS 输出 
Windows ， 设 置 环境 变量 CLASSPATH 为 
%CLASSPATH%;%XStream_HOME%xstream-1.4.7.jar;.; 
[RU export CLASSPATH-$CLASSPATH:$XStream HOME/xstream- 
1.4.7 jar:. 
Mac export CLASSPATH-$CLASSPATH:$XStream HOME/xstream- 


1.4.7 jar:. 


XStream A i] zi FARE - XStream 教 程 


在 进入 XStream 库 的 细节 之 前 ， 让 我 们 来 看 看 应 用 程序 操作 。 在 这 个 例子 中 ， 我 们 
创建 Student 和 Address 类 。 还 将 创建 一 个 Student 对 象 ， 然 后 将 其 序列 化 到 一 个 
XML 字符 串 。 然 后 反 序 列 化 的 同一 个 XML 字符 串 ， 以 重新 获得 学 生 对 象 。 


创建 一 个 名 为 XStreamTester 的 Java 类 文件 在 C:\>XStream_WORKSPACE. 
文件 : XStreamTesterjava 


import java.io.ByteArrayInputStream; 
import java.io.ByteArrayOutputStream; 


import javax.xml.transform.OutputKeys; 

import javax.xml.transform.Source; 

import javax.xml.transform. Transformer; 

import javax.xml.transform.sax.SAXSource; 

import javax.xml.transform.sax.SAXTransformerFactory; 
import javax.xml.transform.stream.StreamResult; 


import org.xml.sax.InputSource; 


import com.thoughtworks.xstream. XStream; 
import com.thoughtworks.xstream.io.xml.StaxDriver; 


public class XStreamTester ( 
public static void main(String args[]){ 
XStreamTester tester = new XStreamTester(); 
XStream xstream = new XStream(new StaxDriver()); 


Student student = tester.getStudentDetails(); 


//Object to XML Conversion 
String xml = xstream.toXML(student); 
System.out.println(formatXml(xm1l)); 


//XML to Object Conversion 
Student studenti = (Student)xstream.fromXML ( xm1) ; 
System.out.println(student1); 


} 


private Student getStudentDetails(){ 
Student student = new Student(); 
student.setFirstName("Mahesh"); 
student.setLastName("Parashar"); 
student.setRollNo(1); 
student.setClassName("1st"); 


Address address - new Address(); 


} 


address.setArea("H.No. 16/3, Preet Vihar."); 
address.setCity("Delhi"); 
address.setState("Delhi"); 
address.setCountry("India"); 
address.setPincode(110012); 


student.setAddress(address); 
return student; 


public static String formatXml(String xml){ 
try{ 


} 


Transformer serializer= SAXTransformerFactory.newInstance| 
serializer.setOutputProperty(OutputKeys.INDENT, "yes"); 
serializer.setOutputProperty("(http://xml.apache.org/xs1t: 
Source xmlSource-new SAXSource(new InputSource(new ByteAr! 
StreamResult res = new StreamResult(new ByteArrayOutputS!1 
serializer.transform(xmlSource, res); 

return new String(((ByteArrayOutputStream)res.getOutputSti 


jcatch(Exception e){ 


j 


return xml; 


class Student ( 
private String firstName; 
private String lastName; 
private int rollNo; 
private String className; 
private Address address; 


public String getFirstName() ( 
return firstName; 


public void setFirstName(String firstName) { 
this.firstName - firstName; 


j 


public String getLastName() { 
return lastName; 


public void setLastName(String lastName) { 
this.lastName - lastName; 


j 


public int getRollNo() ( 
return rollNo; 


public void setRollNo(int rollNo) ( 
this.rollNo - rollNo; 


} 


public String getClassName() { 
return className; 


} 


} 


public void setClassName(String className) { 
this.className = className; 


} 
public Address getAddress() { 
return address; 


public void setAddress(Address address) { 
this.address = address; 
} 


public String toString(){ 
StringBuilder stringBuilder = new StringBuilder(); 
stringBuilder.append("Student [ "); 
stringBuilder.append("\nfirstName: "); 
stringBuilder.append(firstName); 
stringBuilder.append("\nlastName: "); 
stringBuilder.append(lastName); 
stringBuilder.append("\nrollNo: "); 
stringBuilder.append(rollNo); 
stringBuilder.append("\nclassName: "); 
stringBuilder.append(className); 
stringBuilder.append("\naddress: "); 
stringBuilder.append(address); 
stringBuilder.append(" ]"); 
return stringBuilder.toString(); 


class Address { 


private String area; 
private String city; 
private String state; 
private String country; 
private int pincode; 


public String getArea() ( 
return area; 


public void setArea(String area) { 
this.area - area; 


public String getCity() ( 
return city; 


public void setCity(String city) { 
this.city = city; 
} 


public String getState() { 
return state; 


public void setState(String state) { 
this.state = state; 
} 


public String getCountry() { 
return country; 


public void setCountry(String country) { 
this.country = country; 


public int getPincode() { 
return pincode; 


public void setPincode(int pincode) { 
this.pincode = pincode; 
} 


public String toString(){ 
StringBuilder stringBuilder - new StringBuilder(); 
stringBuilder.append("NnAddress [ "); 
stringBuilder.append("\narea: "); 
stringBuilder.append(area); 
stringBuilder.append("\ncity: "); 
stringBuilder.append(city); 
stringBuilder.append("\nstate: "); 
stringBuilder.append(state); 
stringBuilder.append("\ncountry: "); 
stringBuilder.append(country); 
stringBuilder.append("\npincode: "); 
stringBuilder.append(pincode); 
stringBuilder.append(" ]"); 
return stringBuilder.toString(); 





使 用 javac 编 译 器 编译 如 下 类 : 


C:\XStream_WORKSPACE>javac XStreamTester.java 


现在 运行 XStreamTester 看 到 结果 : 


C:\XStream_WORKSPACE>java XStreamTester 


验证 输出 


<?xml version="1.0" encoding="UTF-8"?> 
<Student> 
<firstName>Mahesh</firstName> 
<lastName>Parashar</lastName> 
«rollNo»1«/rollNo» 
«className»1st«/className» 
«address» 
<area>H.No. 16/3, Preet Vihar.«/area» 
<city>Delhi</city> 
<state>Delhi</state> 
<country>India</country> 
<pincode>110012</pincode> 
</address> 
</Student> 


Student [ 
firstName: Mahesh 
lastName: Parashar 
rollNo: 1 
className: ist 
address: 

Address [ 

area: H.No. 16/3, Preet Vihar. 
City: Delhi 

state: Delhi 
country: India 
pincode: 110012 ] ] 


记 住 以 下 步 又 
以 下 是 这 里 要 考虑 的 重要 步 又 。 


第 1 步 : 创建 XStream 对象。 


通过 它 传递 一 个 StaxDriver 创 建 XStream 对 象 。StaxDriver 使 用 SAX 解 析 器 (可 从 
Java6)， 一 个 快速 的 XML 解析 器 。 


XStream xstream = new XStream(new StaxDriver()); 


第 2 步 : 序列 化 对 象 到 XML。 
使 用 toXML() 方法 来 获取 对 象 的 XML 字符 串 表 示 。 


//Object to XML Conversion 
String xml = xstream.toXML(student); 


第 3 步 : 反 序 列 化 XML 获得 对 象 。 
使 用 ffomXML() 方 法 来 从 XML 对 象 。 


//XML to Object Conversion 
Student studenti = (Student)xstream. fromXML(xm1); 


XStream: & - XStream 教 程 


混 生 是 一 种 技术 来 定制 生成 XML 或 者 使 用 XStream 特 定 的 格式 化 XML。 假 设 ， 一 个 
下 面 的 XML 格式 是 用 于 序列 化 / 反 序 列 化 Student 对 象 。 


<student name="Suresh"> 
<note> 
<title>first</title> 
<description>My first assignment .</description> 
</note> 
<note> 
<title>second</title> 
<description>My second assignment .</description> 
</note> 
</student> 


ARE ETHBSXMLARZX, GLA BHRH X, 


class Student { 
private String studentName; 
private List<Note> notes = new ArrayList<Note>(); 


public Student(String name) { 
this.studentName = name; 


public void addNote(Note note) { 
notes.add(note); 
j 


public String getName()( 
return studentName; 
} 


public List<Note> getNotes()( 
return notes; 
} 


} 


class Note { 
private String title; 
private String description; 


public Note(String title, String description) { 
this.title = title; 
this.description = description; 


} 


public String getTitle(){ 
return title; 
} 


public String getDescription(){ 
return description; 
} 


我 们 使 用 XStream 测试 上 述 对 象 序列 化 。 


创建 一 个 Java 类 名 为 XStreamTester 在 文件 
C:\>XStream_WORKSPACE\com\yiibai\xstream. 


File: XStreamTester java 


package com.yiibai.xstream; 


import java.io.ByteArrayInputStream; 
import java.io.ByteArrayOutputStream; 
import java.util.ArrayList; 

import java.util.List; 


import javax.xml.transform.OutputKeys; 


import 
import 
import 
import 
import 
import 


import 
import 


public 
pub 


} 


pri 


j 
pub 


j 


javax.xml.transform.Source; 
javax.xml.transform.Transformer; 
javax.xml.transform.sax.SAXSource; 
javax.xml.transform.sax.SAXTransformerFactory; 
javax.xml.transform.stream.StreamResult; 


org.xml.sax.InputSource; 


com.thoughtworks.xstream.XStream; 
com.thoughtworks.xstream.io.xml.StaxDriver; 


class XStreamTester ( 

lic static void main(String args[]){ 
XStreamTester tester - new XStreamTester(); 
XStream xstream - new XStream(new StaxDriver()); 
Student student - tester.getStudentDetails(); 
//Object to XML Conversion 
String xml - xstream.toXML(student); 
System.out.println(formatXml(xm1l)); 


vate Student getStudentDetails()( 
Student student = new Student("Mahesh"); 
student.addNote(new Note("first","My first assignment.")); 


student.addNote(new Note("second","My Second assignment.")); 


return student; 


lic static String formatXml(String xml){ 
try{ 


Transformer serializer= SAXTransformerFactory.newInstance| 
serializer.setOutputProperty(OutputKeys. INDENT, "yes"); 
serializer.setOutputProperty("(http://xml.apache.org/xs1t: 
Source xmlSource-new SAXSource(new InputSource(new ByteAr! 
StreamResult res = new StreamResult(new ByteArrayOutputS! 
serializer.transform(xmlSource, res); 

return new String(((ByteArrayOutputStream)res.getOutputSti 


jcatch(Exception e){ 


j 


return xml; 


class Student ( 
private String studentName; 
private List<Note> notes = new ArrayList<Note>(); 
public Student(String name) { 

this.studentName - name; 


public void addNote(Note note) ( 
notes.add(note); 


j 


public String getName(){ 


return studentName; 

} 

public List<Note> getNotes()( 
return notes; 

} 


} 


class Note { 

private String title; 

private String description; 

public Note(String title, String description) { 
this.title = title; 
this.description = description; 

} 

public String getTitle(){ 
return title; 

} 


public String getDescription(){ 
return description; 





验证 结果 


使 用 javac 编 译 器 编译 如 下 类 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>javac XStreamTester.java 


现在 运行 XStreamTester 看 到 的 结果 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>java XStreamTester 


验证 输出 


<?xml version="1.0" encoding="UTF-8"?> 
<com.yiibai.xstream.Student> 
<studentName>Mahesh</studentName> 
<notes> 
<com. yiibai.xstream.Note> 
<title>first</title> 
<description>My first assignment .</description> 
</com.yiibai.xstream.Note> 
<com.yiibai.xstream.Note> 
<title>second</title> 
<description>My Second assignment .</description> 
</com.yiibai.xstream.Note> 
</notes> 
</com.yiibai.xstream.Student> 


在 上 面 的 结果 ， 我 们 已 经 看 到 了 Student 对 象 名 称 是 完全 合格 的 。 要 替换 它 作为 学 
生 的 标签 ， 按 照 下 面 的 链接 。 


XB 
类 EE 


另外 ， 在 上 述 结果 中 可 以 看 出 ， 所 需 studentName 要 重 命名 来 命名 。 要 取代 它 ， 按 
照 下 面 的 链接 。 


rm ELE X 
"e EGER 


人 
的 链 o 


BARA E 


在 上 面 的 结果 ， 我 们 可 以 看 到 这 个 名 字 来 作为 一 个 子 节点 ， 需 要 将 它 作为 根 节点 的 
属性 。 蔡 换 它 ， 按 照 下 面 的 链接 。 


Bite Qe 


3 
D 


XStream} f# - XStream 教 程 


XStream 支 持 注释 做 同样 的 任务 ， 正 如 我 们 在 前 面 的 章节 中 是 自动 配置 ， 而 不 是 代 
码 1 所 做 的 。 在 前 面 的 章节 中 ， 我 们 已 经 看 到 了 下 面 的 代码 配置 。 


xstream.alias("student", Student.class); 
xstream.alias("note", Note.class); 
xstream.useAttributeFor(Student.class, "studentName"); 
xstream.aliasField("name", Student.class, "studentName"); 
xstream.addImplicitCollection(Student.class, "notes"); 


下 面 的 代码 片段 来 说 明 使 用 annoations 更 容易 的 方式 做 同样 的 工作 。 


@xStreamAlias("student" ) //define class level alias 
class Student { 


@xStreamAlias("name" ) //define field level alias 
@xStreamAsAttribute //define field as attribute 
private String studentName; 


@xStreamImplicit //define list as an implicit collectior 
private List<Note> notes = new ArrayList<Note>(); 


@xStreamOmitField //omit a field to not to be a part of 
private int type; 





让 我 们 使 用 XStream 测 试 上 面 的 注释 。 
创建 一 个 Java 类 名 为 XStreamTester 文 件 在 
C:\>XStream_WORKSPACE\com\yiibai\xstream. 


File: XStreamTester. java 


package com.yiibai.xstream; 


import java.io.ByteArrayInputStream; 
import java.io.ByteArrayOutputStream; 
import java.util.ArrayList; 

import java.util.List; 


import javax.xml.transform.OutputKeys; 
import javax.xml.transform.Source; 
import javax.xml.transform. Transformer; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 
pub 


} 


pri 


j 
pub 


j 


javax.xml.transform.sax.SAXSource; 
javax.xml.transform.sax.SAXTransformerFactory; 
javax.xml.transform.stream.StreamResult; 


org.xml.sax.InputSource; 


com.thoughtworks.xstream.XStream; 
com.thoughtworks.xstream.annotations.XStreamAlias; 
com.thoughtworks.xstream.annotations.XStreamAsAttribute; 
com.thoughtworks.xstream.annotations.XStreamImplicit; 
com.thoughtworks.xstream.annotations.XStreamOmitField; 
com.thoughtworks.xstream.io.xml.StaxDriver; 


class XStreamTester ( 

lic static void main(String args[]){ 
XStreamTester tester - new XStreamTester(); 
XStream xstream - new XStream(new StaxDriver()); 
Student student - tester.getStudentDetails(); 
xstream.processAnnotations(Student.class); 


//Object to XML Conversion 
String xml - xstream.toXML(student); 
System.out.println(formatXml(xm1l)); 


vate Student getStudentDetails(){ 
Student student = new Student("Mahesh"); 
student.addNote(new Note("first","My first assignment.")); 


student.addNote(new Note("second","My Second assignment.")); 


student.setType(1); 
return student; 


lic static String formatXml(String xml){ 
try{ 


Transformer serializer= SAXTransformerFactory.newInstance| 
serializer.setOutputProperty(OutputKeys. INDENT, "yes"); 
serializer.setOutputProperty("(http://xml.apache.org/xs1t: 
Source xmlSource-new SAXSource(new InputSource(new ByteAr! 
StreamResult res = new StreamResult(new ByteArrayOutputS!1 
serializer.transform(xmlSource, res); 

return new String(((ByteArrayOutputStream)res.getOutputSti 


jcatch(Exception e){ 


j 


return xml; 


QXStreamAlias("student") 
class Student ( 


QXStreamAlias ("name") 
@xStreamAsAttribute 


private String studentName; 


QXStreamImplicit 
private List<Note> notes = new ArrayList<Note>(); 


public Student(String name) { 
this.studentName - name; 
} 


public void addNote(Note note) { 
notes.add(note); 
} 


public String getName(){ 
return studentName; 
j 


public List«Note» getNotes()( 
return notes; 
} 


@xStreamOmitField 
private int type; 


public int getType(){ 
return type; 
j 


public void setType(int type){ 
this.type - type; 
j 


j 


QXStreamAlias ("note") 

class Note { 
private String title; 
private String description; 


public Note(String title, String description) { 
this.title - title; 
this.description - description; 


j 


public String getTitle(){ 
return title; 
j 


public String getDescription(){ 
return description; 
} 








验证 结果 


使 用 javac 编 译 器 编译 如 下 类 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>javac XStreamTester.java 


现在 运行 XStreamTester 看 到 的 结果 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>java XStreamTester 


<?xml version="1.0" encoding="UTF-8"?> 
<student name="Mahesh"> 
<note> 
<title>first</title> 
<description>My first assignment .</description> 
</note> 
<note> 
<title>second</title> 
<description>My Second assignment .</description> 
</note> 
</student> 


为 了 告诉 XStream 框 架 来 处 理 注 释 ， 需 要 XML 序列 化 之 前 添加 下 面 的 命令 。 
xstream.processAnnotations(Student.class); 
或 者 


xstream.autodetectAnnotations(true); 


XStream xt Ri - XStream 教程 


XStreamizKjava.io.ObjectlnputStreamf?f[ljava.io.ObjectOutputStream£ X 3z 3, 
使 对 象 流 可 以 被 序列 化 或 XML 序列 化 。 当 大 对 象 集 要 被 处 理 ， 保 持 在 存储 器 中 的 一 
个 对 象 ， 这 是 特别 有 用 的 。 


语法 : createObjectOutputStream() 


ObjectOutputStream objectOutputStream = xstream.createObjectOutput: 
.:d ES 





语法 :createObjectlnputStream() 


ObjectInputStream objectInputStream = xstream.createObjectInputStre 
剧本 
现在 ， 让 我 们 用 XStream 对 象 流 测 试 代码 。 


创建 一 个 Java 类 名 为 XStreamTester 文 件 在 
C:\>XStream_WORKSPACE\com\yiibai\xstream. 





File: XStreamTester.java 


package com.yiibai.xstream; 


import java.io.FileInputStream; 
import java.io.FileOutputStream; 
import java.io.IOException; 

import java.io.ObjectInputStream; 
import java.io.ObjectOutputStream; 


import com.thoughtworks.xstream.XStream; 
import com.thoughtworks.xstream.annotations.XStreamAlias; 
import com.thoughtworks.xstream.io.xml.StaxDriver; 


public class XStreamTester { 
public static void main(String args[]){ 
XStreamTester tester = new XStreamTester(); 
XStream xstream = new XStream(new StaxDriver()); 
xstream.autodetectAnnotations(true); 


Student studenti 
Student student2 


new Student ("Mahesh", "Parashar"); 
new Student( "Suresh" A "Kalra" ) : 


Student student3 
Student student4 


try { 
ObjectOutputStream 


objectOutputStream. 
objectOutputStream. 
objectOutputStream. 
objectOutputStream. 
objectOutputStream. 
objectOutputStream. 


new Student("Ramesh", "Kumar" ); 
new Student("Naresh", "Sharma" ); 


objectOutputStream = xstream.createObje 


writeObject(student1); 
writeObject(student2); 
writeObject(student3); 
writeObject(student4); 
writeObject("Hello World"); 
close(); 


ObjectInputStream objectInputStream = xstream. 


Student student5 
Student student6 
Student student? 
Student student8 


(Student )objectInputStream. 
(Student )objectInputStream. 
(Student )objectInputStream. 
(Student )objectInputStream. 


createObject 
readObject(: 
readObject(: 
readObject(: 
readObject(: 


String text - (String)objectInputStream.readObject(); 
System.out.println(student5); 
System.out.println(student6); 
System.out.println(student7); 
System.out.println(student8); 
System.out.println(text); 


) catch (IOException e) { 
e.printStackTrace(); 

) catch (ClassNotFoundException e) { 
e.printStackTrace(); 


} 
} 


@XStreamAlias("student") 
class Student { 


private String firstName; 
private String lastName; 


public Student(String firstName, String lastName) { 
this.firstName = firstName; 
this.lastName = lastName; 


} 


public String getFirstName() { 


return firstName; 


} 


public String getLastName() { 


return lastName; 


} 


public String toString(){ 


return "Student [ firstName: "+firstName+", lastName: "+ lasi 


} 
«| B 








验证 结果 


使 用 javac 编 译 器 编译 如 下 类 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>javac XStreamTester.java 


现在 运行 XStreamTester 看 到 的 结果 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>java XStreamTester 


验证 输出 


Student [ firstName: Mahesh, lastName: Parashar ] 
Student [ firstName: Suresh, lastName: Kalra ] 
Student [ firstName: Ramesh, lastName: Kumar ] 
Student [ firstName: Naresh, lastName: Sharma ] 
Hello World 


查看 test.txt 的 内 容 在 C:\>XStream_WORKSPACE\com\yiibai\xstream X fF 3k , 


<?xml version="1.0" ?> 
<object-stream> 
<student> 
<firstName>Mahesh</firstName> 
<lastName>Parashar</lastName> 
</student> 
<student> 
<firstName>Suresh</firstName> 
<lastName>Kalra</lastName> 
</student> 
<student> 
<firstName>Ramesh</firstName> 
<lastName>Kumar</lastName> 
</student> 
<student> 
<firstName>Naresh</firstName> 
<lastName>Sharma</lastName> 
</student> 
<string>Hello World</string> 
</object-stream> 


XStream xt Ri - XStream 教程 


XStreamizKjava.io.ObjectlnputStreamf?f[ljava.io.ObjectOutputStream£ X 3z 3, 
使 对 象 流 可 以 被 序列 化 或 XML 序列 化 。 当 大 对 象 集 要 被 处 理 ， 保 持 在 存储 器 中 的 一 
个 对 象 ， 这 是 特别 有 用 的 。 


语法 : createObjectOutputStream() 


ObjectOutputStream objectOutputStream = xstream.createObjectOutput: 
.:d ES 





语法 :createObjectlnputStream() 


ObjectInputStream objectInputStream = xstream.createObjectInputStre 
剧本 
现在 ， 让 我 们 用 XStream 对 象 流 测 试 代码 。 


创建 一 个 Java 类 名 为 XStreamTester 文 件 在 
C:\>XStream_WORKSPACE\com\yiibai\xstream. 





File: XStreamTester.java 


package com.yiibai.xstream; 


import java.io.FileInputStream; 
import java.io.FileOutputStream; 
import java.io.IOException; 

import java.io.ObjectInputStream; 
import java.io.ObjectOutputStream; 


import com.thoughtworks.xstream.XStream; 
import com.thoughtworks.xstream.annotations.XStreamAlias; 
import com.thoughtworks.xstream.io.xml.StaxDriver; 


public class XStreamTester { 
public static void main(String args[]){ 
XStreamTester tester = new XStreamTester(); 
XStream xstream = new XStream(new StaxDriver()); 
xstream.autodetectAnnotations(true); 


Student studenti 
Student student2 


new Student ("Mahesh", "Parashar"); 
new Student( "Suresh" A "Kalra" ) : 


Student student3 
Student student4 


try { 
ObjectOutputStream 


objectOutputStream. 
objectOutputStream. 
objectOutputStream. 
objectOutputStream. 
objectOutputStream. 
objectOutputStream. 


new Student("Ramesh", "Kumar" ); 
new Student("Naresh", "Sharma" ); 


objectOutputStream = xstream.createObje 


writeObject(student1); 
writeObject(student2); 
writeObject(student3); 
writeObject(student4); 
writeObject("Hello World"); 
close(); 


ObjectInputStream objectInputStream = xstream. 


Student student5 
Student student6 
Student student? 
Student student8 


(Student )objectInputStream. 
(Student )objectInputStream. 
(Student )objectInputStream. 
(Student )objectInputStream. 


createObject 
readObject(: 
readObject(: 
readObject(: 
readObject(: 


String text - (String)objectInputStream.readObject(); 
System.out.println(student5); 
System.out.println(student6); 
System.out.println(student7); 
System.out.println(student8); 
System.out.println(text); 


) catch (IOException e) { 
e.printStackTrace(); 

) catch (ClassNotFoundException e) { 
e.printStackTrace(); 


} 
} 


@XStreamAlias("student") 
class Student { 


private String firstName; 
private String lastName; 


public Student(String firstName, String lastName) { 
this.firstName = firstName; 
this.lastName = lastName; 


} 


public String getFirstName() { 


return firstName; 


} 


public String getLastName() { 


return lastName; 


} 


public String toString(){ 


return "Student [ firstName: "+firstName+", lastName: "+ lasi 


} 
«| B 








验证 结果 


使 用 javac 编 译 器 编译 如 下 类 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>javac XStreamTester.java 


现在 运行 XStreamTester 看 到 的 结果 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>java XStreamTester 


验证 输出 


Student [ firstName: Mahesh, lastName: Parashar ] 
Student [ firstName: Suresh, lastName: Kalra ] 
Student [ firstName: Ramesh, lastName: Kumar ] 
Student [ firstName: Naresh, lastName: Sharma ] 
Hello World 


查看 test.txt 的 内 容 在 C:\>XStream_WORKSPACE\com\yiibai\xstream X fF 3k , 


<?xml version="1.0" ?> 
<object-stream> 
<student> 
<firstName>Mahesh</firstName> 
<lastName>Parashar</lastName> 
</student> 
<student> 
<firstName>Suresh</firstName> 
<lastName>Kalra</lastName> 
</student> 
<student> 
<firstName>Ramesh</firstName> 
<lastName>Kumar</lastName> 
</student> 
<student> 
<firstName>Naresh</firstName> 
<lastName>Sharma</lastName> 
</student> 
<string>Hello World</string> 
</object-stream> 


XStream25 5 JSON - XStream 教 程 


XStream 支 持 JSON 通 过 初始 化 XStream 对 象 适 当 的 驱动 程序 。 XStream 目 前 支持 
JettisonMappedXmlDriver 和 JsonHierarchicalStreamDriver。 


现在 ， 让 我 们 使 用 XStream 人 处 理 JSON 的 代码 测试 。 


创建 一 个 Java 类 名 为 XStreamTester 文 件 在 
C:\>XStream_WORKSPACE\com\yiibai\xstream. 


File: XStreamTester java 


package com.yiibai.xstream; 


import 


import 
import 
import 
import 
import 


public 


} 


java.io.Writer; 


com. 
com. 


com 


com. 
com. 


thoughtworks.xstream. 
thoughtworks.xstream. 
. thoughtworks.xstream. 
thoughtworks.xstream. 
thoughtworks.xstream. 


class XStreamTester ( 
public static void main(String args[]){ 
XStreamTester tester - 
XStream xstream = new XStream(new JsonHierarchicalStreamDi 
public HierarchicalStreamWriter createWriter(Writer wr: 

return new Jsonwriter(writer, JsonWriter.DROP ROOT. 


3): 


j 


Student student - new S 


XStream; 

annotations.XStreamAlias; 
io.HierarchicalStreamwriter; 
io.json.JsonHierarchicalStreamDrivt 
io.json.Jsonwriter; 


new XStreamTester(); 


tudent ("Mahesh", "Parashar"); 


xstream.setMode(XStream.NO REFERENCES) ; 
xstream.alias("student", Student.class); 


System.out.println(xstream.toXML(student)); 


QXStreamAlias("student") 
class Student ( 


private String firstName; 
private String lastName; 


public Student(String firstName, String lastName) { 
this.firstName - firstName; 


this.lastName = lastName; 


} 


public String getFirstName() { 
return firstName; 
} 


public String getLastName() { 
return lastName; 
} 


public Strang toString(){ 
return "Student [ firstName: "+firstName+", lastName: "+ lé 





验证 结果 


使 用 javac 编 译 器 编译 如 下 类 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>javac XStreamTester.java 


现在 运行 XStreamTester 看 到 的 结果 : 


C:\XStream_WORKSPACE\com\yiibai\xstream>java XStreamTester 


验证 输出 
{ 
"firstName": "Mahesh", 
"LastName": "Parashar" 


} 


